OpenWRT/LEDE项目中小米AX6s路由器5G WiFi失效问题分析与解决

问题背景

在OpenWRT/LEDE开源路由器固件项目中，小米AX6s路由器在编译自定义固件后出现了5G WiFi功能失效的问题。该问题表现为无线设置界面仅显示2.4GHz的MT7622无线控制器，或者在使用其他固件保留配置升级后，5G WiFi被识别为"通用802.11无线控制器(radio1)"。

技术分析

通过系统日志分析，发现问题的根源在于PCIe初始化失败。具体错误信息显示：

mtk-pcie 1a143000.pcie: missing hifsys node
mtk-pcie: probe of 1a143000.pcie failed with error -22

这表明系统在初始化PCIe控制器时，无法找到必要的hifsys节点，导致PCIe设备探测失败，错误代码-22表示无效参数。由于AX6s的5G WiFi模块是通过PCIe接口连接的，这一失败直接导致了5G WiFi功能不可用。

根本原因

深入分析表明，该问题源于设备树(DTS)配置不完整。在MediaTek(联发科)平台的PCIe控制器初始化过程中，需要正确配置hifsys(硬件接口系统)相关节点，这是MediaTek芯片特有的硬件抽象层。缺少这些配置会导致PCIe控制器无法正常初始化，进而影响依赖PCIe接口的5G WiFi模块。

解决方案

针对这一问题，开发团队通过以下步骤进行了修复：

1. 完善设备树配置，添加必要的hifsys节点定义
2. 确保PCIe控制器的资源分配正确
3. 验证5G WiFi模块的驱动加载顺序和依赖关系

修复后的代码已合并到主分支，用户可以通过以下方式解决：

• 使用最新版本的LEDE源码重新编译固件
• 或等待下一个稳定版本发布后升级

技术细节

对于想要深入了解的技术人员，这里提供更多细节：

MediaTek平台的PCIe控制器需要与hifsys硬件抽象层配合工作。hifsys负责管理芯片内部的各种硬件接口和时钟资源。在设备树中，需要明确定义：

1. PCIe控制器的寄存器映射范围
2. 相关的时钟和复位控制
3. 电源管理配置
4. 中断路由

只有当这些配置完整且正确时，PCIe控制器才能正常初始化，进而使5G WiFi模块正常工作。

用户建议

对于遇到类似问题的用户，建议：

1. 检查系统日志中是否有PCIe初始化错误
2. 确保使用最新版本的固件
3. 如果自行编译，检查设备树配置是否完整
4. 避免在升级时保留可能导致冲突的旧配置

总结

小米AX6s路由器的5G WiFi失效问题是一个典型的设备树配置不完整导致的硬件初始化失败案例。通过完善MediaTek平台特有的hifsys配置，开发团队成功解决了这一问题。这提醒我们在移植OpenWRT到新硬件平台时，需要特别注意平台特有的硬件抽象层和初始化流程。