)
RK3588 适配 WiFi 模组 — (SDIO)
相比常见的USB方案，SDIO（Secure Digital Input Output）接口的WiFi/BT模块能带来更高的集成度和数据吞吐能力，更适合高性能要求的产品。但相应地，它的驱动配置和调试也更复杂一些。
🤔 SDIO vs. USB：哪个是更优选？
为了让你快速判断哪种接口更合适，这里有一个简单的对比：
| 特性 | SDIO方案 | USB方案 |
|---|---|---|
| 速度与延迟 | 更高，延迟更低 | 通常较低，略逊于SDIO |
| 集成度 | 高，节省PCB面积 | 低，占用USB接口 |
| 驱动配置 | 复杂，需配置设备树 | 通常即插即用，相对容易 |
| 成本 | 较高，对布线有要求 | 较低，灵活性高 |
| 选型建议 | 适用于高性能嵌入式、工业设备 | 适用于开发、原型验证 |
📝 RK3588平台支持的常见SDIO WiFi模组
我将这些模组分成了三类，方便你根据自己的项目需求选择：
👍 省心优选：主流稳定型
这类芯片（尤其是Broadcom方案）因其丰富的开源资源和社区支持，在RK3588平台上更容易上手。
| 芯片型号/模块 | 规格参数 | 驱动方案 | 特点/官方参考 |
|---|---|---|---|
| AP6256 | - 核心：BCM43456 - 双频(2.4G/5G) - 蓝牙5.2 - 1T1R | Broadcom (brcmfmac) | -RK3588 SDK原生支持，是官方支持的型号之一 -AP模式稳定，可作为高效热点 - 驱动位于 kernel/drivers/net/wireless/rockchip_wlan/rkwifi/bcmdhd/ |
| AP6398S | - 核心：Broadcom - WiFi 5(867Mbps) - 2T2R - 蓝牙5.0 | Broadcom (brcmfmac) | - 同样是RK官方支持的型号 -高性能WiFi 5代表，适合对速率要求高的场景 |
| AP6275S | - 核心：BCM4375 - WiFi 6(1200Mbps) - 2T2R - 蓝牙5.0 | Broadcom (brcmfmac) | -WiFi 6入门，是WiFi 5模组的理想升级型号 -潜力大，主线支持在不断完善，已有用户成功点亮 |
🚀 性能之选：新一代高性能型
这些模组采用了更新的技术标准，性能更强。
| 芯片型号/模块 | 规格参数 | 驱动方案 | 特点/官方参考 |
|---|---|---|---|
| RTL8822CS | - 核心：Realtek - WiFi 5(867Mbps) - 2T2R | Realtek (rtw88) | - 性能稳定，社区有大量测试数据，已知吞吐量在50-90Mbit/s之间 -主线内核的 rtw88驱动已完美支持 |
| RTL8821CS | - 核心：Realtek - WiFi 5(433Mbps) - 1T1R | Realtek (rtw88) | - 性能均衡，实测中下载速度可达50Mbps - 性价比之选，同样受 rtw88驱动支持 |
| RTL8852BE | - 核心：Realtek - WiFi 6(1200Mbps) - 蓝牙5.2 - 2T2R | Realtek (rtw89) | -高性能WiFi 6模范，速度可达1201Mbps - 布局复杂，多见于PCIE接口，但部分模块也支持SDIO |
| WQ9201B | - 核心：物奇 - WiFi 6/6E(1200Mbps) - 蓝牙5.4 - 2T2R | WQ9201B (第三方) | - 最新的高性能WiFi 6方案，支持蓝牙5.4 -驱动资源依赖厂商或社区，目前需验证 |
⚠️ 特定应用：官方参考设计
如果你的项目遵循RK官方参考设计，这些型号是稳妥之选。
| 芯片型号/模块 | 规格参数 | 驱动方案 | 特点/官方参考 |
|---|---|---|---|
| AP6275P | - 核心：BCM43752 - WiFi 6(1200Mbps) - 2T2R | Broadcom (brcmfmac) | - 常用于RK官方EVB评估板 - 常见为PCIE接口，但在主线内核已有一些驱动补丁支持 |
| AP6398S | - 核心：Broadcom - WiFi 5(867Mbps) - 2T2R - 蓝牙5.0 | Broadcom (brcmfmac) | - 常见于RK3588 EVB板参考设计 - 驱动和支持成熟 |
| RTL8822BS | - 核心：Realtek - WiFi 5(867Mbps) - 2T2R | Realtek (rtw88) | - 常见于RK3588 EVB板 - rtw88驱动在主线内核已有稳定支持 |
🐾 选择建议小结
- 追求省心：从AP6256（WiFi 5基础款）或AP6275S（WiFi 6进阶款）开始。
- 追求性能：可选择RTL8822CS（高性能WiFi 5）或WQ9201B（前沿WiFi 6），前者驱动成熟，后者代表更新技术。
- 预算为王：RTL8821CS是性价比很高的入门WiFi 5选择。
作者：炭烤毛蛋 ，点击博主了解更多。
提示: 使用WiFi网卡前须提前适配软件。
文章目录
- RK3588 适配 WiFi 模组 --- (SDIO)
- 🤔 SDIO vs. USB：哪个是更优选？
- 📝 RK3588平台支持的常见SDIO WiFi模组
- 👍 省心优选：主流稳定型
- 🚀 性能之选：新一代高性能型
- ⚠️ 特定应用：官方参考设计
- 🐾 选择建议小结
- 1. 核查原理图，适配模组
- 1.1 WiFi 模组 E-KEY
- 1.2 WiFi 模组 WiFi供电
- 1.3 WiFi 模组 WiFi 控制信号
- 1.4 WiFi 模组 BT控制信号
- 2. 内核适配模组
- 2.1 设备树适配 WiFi 模组
- 2.2 验证WiFi功能
- 2.3 验证蓝牙功能
- 3 异常情况分析
- 3.1 蓝牙连接报错
- 3.2 WiFi 链接报错
- 3.3 WiFi 性能不达标
- Tips
- 结语
1. 核查原理图，适配模组
1.1 WiFi 模组 E-KEY
M.2 E-KEY 可由支持多种 WiFi 模组，从Pcie、SDIO 到 USB 协议；模组自带的蓝牙模组则支持 UART、SDIO 和 USB 协议；额外有 I2S 端口，支持蓝牙通话功能。
1.2 WiFi 模组 WiFi供电
WiFi 供电 VCC3V3_WF 由 VCC5V0_SYS 经 DCDC供电，启动时只需要使能控制 EKEY_EN。
1.3 WiFi 模组 WiFi 控制信号
控制信号
WiFi 唤醒主控 WIFI_WAKE_HOST 采用 GPIO3_D5；
WiFi 开启控制 WIFI_REG_ON
