OpenWrt固件编译与刷机问题排查指南：以AX1800 PRO为例

问题现象分析

在OpenWrt固件开发过程中，开发者Kuron88遇到了一个典型的刷机问题：为AX1800 PRO路由器编译的固件在通过uboot刷入后无法正常启动，具体表现为不分配IP地址且WiFi功能失效。然而，通过旧版固件保存配置升级sys固件的方式却能正常工作。

日志关键点解读

从TTL串口输出的启动日志中，我们可以观察到几个关键信息：

1. 硬件识别阶段：系统正确识别了IPQ6018LA处理器和512MB内存配置，表明底层硬件初始化正常。

2. 存储设备检测：日志显示成功识别了eMMC存储设备，但NAND闪存检测失败（"Nand Flash error. Status = 80"），这与预期行为一致。

3. 内核加载：Linux内核（6.1.112版本）被正确加载并解压，设备树也成功验证，说明固件镜像结构完整。

4. 文件系统挂载：系统成功挂载了squashfs只读根文件系统，但后续尝试挂载覆盖层(overlay)时失败，导致系统进入只读模式。

5. 无线驱动问题：ath11k无线驱动加载时出现关键错误："failed to load board data file: -12"，表明校准数据加载失败，这直接导致WiFi功能不可用。

根本原因分析

结合日志和问题描述，可以确定问题的根本原因在于：

1. 校准数据缺失：系统无法从预期的位置（/dev/mmcblk0p15）读取无线校准数据，日志中明确显示"caldata: failed to extract calibration data"。

2. 分区配置问题：uboot直接刷写factory固件时，可能没有正确处理校准数据分区的保留和迁移，而通过sysupgrade方式则保留了原有配置。

3. 文件系统权限：系统进入只读模式，导致无法创建必要的运行时文件和配置。

解决方案与最佳实践

针对这类问题，建议采取以下解决方案：

1. 校准数据处理：

   • 确保编译配置中包含设备特定的校准数据
   • 在打包固件时正确包含校准数据分区
   • 实现校准数据自动迁移机制

2. 分区表兼容性：

   • 检查uboot环境变量设置
   • 验证factory固件的分区布局与设备预期是否匹配
   • 考虑添加分区表验证步骤

3. 文件系统处理：

   • 实现更健壮的overlay挂载失败处理机制
   • 添加必要的文件系统检查工具

4. 无线驱动配置：

   • 确保ath11k驱动配置正确
   • 验证boarddata文件路径和加载机制

开发者注意事项

对于OpenWrt固件开发者，特别是针对AX1800 PRO这类设备时，应当注意：

1. 使用最新稳定的uboot版本（问题中提到的2024年4月9日版本已修复相关问题）

2. 在编译配置中明确包含设备特定的校准数据和boarddata文件

3. 实现双重刷机路径测试：既测试uboot直接刷写factory镜像，也测试sysupgrade路径

4. 添加详细的启动日志收集机制，便于问题诊断

5. 考虑实现校准数据自动备份和恢复功能

通过系统性地分析启动日志和问题表现，开发者可以更有效地定位和解决OpenWrt固件开发中的各类问题，确保固件的稳定性和功能性。