RK WiFi BT 模组移植调试方法
- 作者：Witheart
- 更新时间：20250221
概要：本文介绍了 RK WiFi BT 模组的移植调试方法，包括硬件检查、设备树配置、驱动加载以及日志分析等关键步骤，以帮助开发者快速定位和解决问题。
1. 硬件检查
1.1 硬件焊接与连接检查
- 确保 PIN 脚连接正确，特别是在改版时检查所有可选的外围电路连接是否符合设计要求。
1.2 SDIO 设备识别
- 模组上电后，无论驱动是否加载成功，只要设备树配置正确，都会进行 SDIO 扫卡。
- 如果扫卡成功，设备信息会保存在
/sys/bus/sdio/devices/目录下的具体设备uevent文件中。 - 读取
uevent信息，如果能获取到设备信息，说明硬件连线和 SDIO 通信正常。 - 有的模组在驱动加载不成功时也可能报sdio_err，是驱动本身sdio通信有误，只要扫到卡了，一般不是硬件或者设备树配置问题
2. 设备树检查
2.1 重点检查项
- 复位引脚
- 电源引脚
- SDIO 通信引脚
- UART 通信引脚
确保上述引脚的设备树配置正确，以保证模块正常工作。
3. 电平测量
3.1 关键电平检查
- 模块供电电压
- 复位引脚电压
- VIO 电平（如果是 SDIO 3.0，一般要求 SDIO 相关 PIN 电压为 1.8V，不能为 3.3V）
使用万用表或示波器测量关键电压，以确保电源供电符合要求。
4. 驱动加载检查
4.1 获取最新驱动
- 如果硬件和设备树配置均无问题，则可能是驱动问题。
- 向厂家获取最新的驱动包，并确认其是否适用于当前调试的模组。
4.2 查看已加载的驱动
- 使用
lsmod命令查看当前已加载的驱动模块。 - 如果驱动未自动加载，可以尝试使用
insmod手动加载驱动。
4.3 VID:PID 校验
- 驱动未自动加载的常见原因之一是
VID:PID设置不正确。 - 可在
/sys/bus/sdio/devices/目录下的具体设备uevent文件中查找正确的VID:PID，并进行匹配调整。
5. 日志分析
5.1 关键日志查看
- dmesg：查看系统日志，检查驱动加载情况和错误信息。
- logcat：相比
dmesg，logcat可以提供更完整的信息，重点关注：- mmcx 部分日志
- 驱动加载日志
- 驱动输出信息
6. 与厂家沟通
WiFi BT 模组的调试在很大程度上依赖于厂家 FAE（现场应用工程师）的支持，遇到问题时应积极与厂家沟通，以获得更高效的技术支持。