嵌入式分享#21：嵌入式外设调试思路——WiFi & BT 调试篇
一、调试前：先确认接口与软件资源
WiFi 常见通信接口包括PCIe、SDIO、USB；BT 常见通信接口包括UART、SDIO、USB。
模组厂商通常需要提供两类资源：
- 固件：控制模组硬件行为；
- 模组驱动源码：SDK 一般会提供常用模组驱动，没有时需要向模组厂商索取。
二、WiFi 模组识别流程
2.1 SDIO 接口
开机时，内核 MMC 框架会识别 SDIO 卡。典型流程如下：
- 解析设备树
sdio_pwrseq节点中的reset-gpios，拉高WL_REG_ON； - 通过
SDIO_CLK/CMD/DATA发送初始化指令； - 先用约 200～400 kHz 的低频读取 SDIO 基本信息；
- 确认 SDIO 2.0/3.0、1/4-bit 总线等能力后，提高到相应的工作频率。
示例日志（不同平台的控制器编号和地址可能不同）：
# 解析 dts 的 mmc-pwrseq 节点，获取 WL_REG_ON dwmmc_rockchip ff4a0000.dwmmc: allocated mmc-pwrseq # 低频初始化 mmc_host mmc0: Bus speed (slot 0) = 400000Hz # 高频工作模式 mmc_host mmc0: Bus speed (slot 0) = 50000000Hz # SDIO 2.0 mmc0: new high speed SDIO card at address 0001 # SDIO 3.0 mmcx: new ultra high speed SDR104 SDIO card at address 00012.2 USB / PCIe 接口
识别完成后，可分别使用lsusb和lspci查看设备：
# USB Bus 001 Device 002: ID 0bda:f179 Realtek Semiconductor Corp. RTL8188FTV # PCIe 0002:21:00.0 Network controller: Broadcom Inc. Device 449d (rev 02)三、通用调试思路
拿到模组后，建议按以下顺序推进：
- 硬件检查：确认供电、接口、时钟、复位脚和天线连接正常；
- 设备树 / 内核配置：核对控制器、GPIO、复位和中断配置；
- 驱动与固件：确认驱动和模组匹配，并检查
/lib/firmware/下固件是否正确加载； - 模组识别状态：PCIe 使用
lspci，USB 使用lsusb，SDIO 查看 MMC 日志； - 连接与网络验证：扫描 AP，并使用
wpa_supplicant验证连接。
蓝牙的总体思路相同。DTS 配置通常更简单：使用什么通信接口，就配置对应的 UART、SDIO 或 USB 控制器。
四、三类典型问题与排查方向
务必先看日志，再根据异常定位；不要在没有日志依据时盲目修改配置。
| 问题类型 | 优先检查项 |
|---|---|
| SDIO/USB/PCIe 设备识别不到 | 供电、复位脚、时钟、接口控制器、设备树、硬件连线 |
| 已识别但固件加载失败 | 固件路径、文件名、版本匹配、权限及加载日志 |
| 能识别但连接/性能异常 | AP 扫描、认证配置、天线与射频、吞吐、断连日志 |
4.1 设备识别不到
重点确认WL_REG_ON、电源时序和接口信号。SDIO 场景还要核对 1/4-bit 配置、卡检测和时钟频率；USB/PCIe 场景先确认总线枚举是否成功。
4.2 Firmware 加载失败
从内核日志中确认驱动请求的固件名称和路径，检查固件版本是否与模组硬件匹配，并确认根文件系统包含相应文件。
4.3 连接和性能问题
设备已识别后，再逐层验证：扫描是否正常、认证是否成功、吞吐是否达标、是否存在概率断连。结合wpa_supplicant、驱动日志和厂商开发文档分析。
五、小结
WiFi/BT 调试可以抽象为硬件与时序 → 总线枚举 → 驱动/固件 → 协议连接 → 性能稳定性五个层次。每一层先用日志确认事实，再缩小范围，通常比直接反复修改 DTS 更高效。
