【RK3506实战-09】RK3506 + RTL8852BS（SDIO）WiFi6 驱动调试实战-编程实验室

主控：RK3506（3×A7 + M0）
WiFi：RTL8852BS（SDIO 4bit，WiFi6/802.11ax，5G+2.4G）
接口：SDMMC1（SDIO）
内核：Linux 5.10 / 6.1（Rockchip SDK）
系统：Buildroot / Yocto / 原厂 Linux

一、硬件原理与上电时序（SDIO 必看）

1.1 引脚连接（RK3506 ↔ RTL8852BS）

RK3506	RTL8852BS	说明
SDMMC1_CLK	CLK	SDIO 时钟
SDMMC1_CMD	CMD	命令线
SDMMC1_D0~D3	DATA0~3	4bit 数据
GPIO_PB0	WL_REG_ON	模组电源使能（3.3V，高有效）
GPIO_PB1	WL_HOST_WAKE	主机唤醒 WiFi（输入）
3.3V	VDD	供电
GND	GND	地
ANT	天线	必须接，否则无信号

1.2 上电时序（关键！否则驱动加载失败）

拉低WL_REG_ON→ 延时 10ms
拉高WL_REG_ON（3.3V）→ 延时 50ms
初始化 SDIO 控制器 → 识别模组（vendor=0x024c，device=0x8852）

二、设备树 DTS 配置（rk3506-evb.dts）

路径：arch/arm64/boot/dts/rockchip/rk3506-evb.dts

2.1 SDMMC1 控制器（WiFi 用）

dts

&sdmmc1 { status = "okay"; bus-width = <4>; /* SDIO 4bit */ max-frequency = <150000000>; /* 150MHz，WiFi6稳定 */ non-removable; /* 板载，不可热插拔 */ pinctrl-names = "default"; pinctrl-0 = <&sdmmc1_clk &sdmmc1_bus>; /* WiFi电源时序控制 */ mmc-pwrseq = <&wifi_pwrseq>; /* RTL8852BS 节点 */ wifi@1 { compatible = "realtek,rtl8852bs"; reg = <1>; wl-reg-on-gpios = <&gpio RK_PB0 GPIO_ACTIVE_HIGH>; wl-host-wake-gpios = <&gpio RK_PB1 GPIO_ACTIVE_HIGH>; }; }; /* WiFi电源时序节点（必须） */ wifi_pwrseq: mmc-pwrseq { compatible = "rockchip,mmc-pwrseq"; reset-gpios = <&gpio RK_PB0 GPIO_ACTIVE_LOW>; reset-delay-us = <10000>; /* 拉低10ms */ power-delay-us = <50000>; /* 拉高50ms */ };

2.2 编译设备树

make dtbs # 生成 rk3506-evb.dtb，烧录后重启

三、内核配置（WiFi6 + SDIO 依赖）

make menuconfig

3.1 MMC/SD/SDIO 核心

Device Drivers → MMC/SD/SDIO support → [*] MMC support → [*] SDIO support → [*] Rockchip SDMMC controller support

3.2 无线协议栈（WiFi6 必需）

Networking support → [*] Wireless → [*] cfg80211 → [*] mac80211 → [*] 802.11ax (WiFi6) support

3.3 Realtek SDIO 驱动

Device Drivers → Network device support → Wireless LAN → <M> Realtek wireless LAN support → <M> RTL8852BS SDIO WiFi6 adapter

3.4 保存配置

make savedefconfig cp defconfig arch/arm64/configs/rk3506_defconfig

四、RTL8852BS 驱动编译（RK3506）

4.1 驱动源码获取

Realtek 原厂驱动（RK 平台适配版）：

# 从Rockchip SDK获取（推荐） cd external/rkwifibt/realtek/ git clone https://github.com/rockchip-linux/rkwifibt.git cd rkwifibt/realtek/RTL8852BS

或第三方适配：

git clone https://gitcode.com/gh_mirrors/rt/rtl8852bs.git cd rtl8852bs

4.2 修改 Makefile 适配 RK3506

makefile

# 平台选择 CONFIG_PLATFORM_I386_PC = n CONFIG_PLATFORM_ARM_ROCKCHIP = y # 内核路径（改为你的SDK路径） KERNELDIR ?= /home/xxx/rk3506-sdk/kernel ARCH ?= arm64 CROSS_COMPILE ?= /home/xxx/rk3506-sdk/prebuilts/gcc/linux-x86/arm/gcc-arm-10.3-2021.07-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-

4.3 编译

make clean make -j8 # 生成：8852bs.ko

五、固件部署（RTL8852BS 必需）

5.1 固件文件

固件：fw_8852bs.bin（Realtek 原厂，与驱动匹配）
路径：/vendor/etc/firmware/或/lib/firmware/

mkdir -p /vendor/etc/firmware/ cp fw_8852bs.bin /vendor/etc/firmware/

六、驱动加载与初始化

6.1 手动加载（调试）

# 拷贝驱动到系统 cp 8852bs.ko /lib/modules/$(uname -r)/ depmod -a # 加载驱动 insmod 8852bs.ko # 查看加载状态 lsmod | grep 8852bs dmesg | grep -i 8852

6.2 正常日志（成功标志）

rtw_8852bs: Driver initialization ok sdio 1:0001:1: wlan0: RTL8852BS WiFi6 registered

6.3 查看 SDIO 设备

cat /proc/mmc # 看到：sdmmc1:0001: 024c:8852 (Realtek)

七、wpa_supplicant 配置 WiFi6 联网

7.1`/etc/wpa_supplicant.conf`（WiFi6 关键）

conf

ctrl_interface=/var/run/wpa_supplicant ap_scan=1 country=CN network={ ssid="你的WiFi6_SSID" psk="你的密码" key_mgmt=WPA-PSK ieee80211w=2 /* WiFi6/WPA3 强制开启 */ freq_list=2412 5180 /* 2.4G + 5G */ priority=1 }

7.2 启动 WiFi

# 后台运行 wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf # 查看连接状态 wpa_cli -i wlan0 status # 获取IP udhcpc -i wlan0 # 测试外网 ping 223.5.5.5

八、WiFi6 特性验证

8.1 查看网卡能力

iw dev wlan0 info

WiFi6 成功标志：

supported wifi generations: 802.11b 802.11g 802.11n 802.11ac 802.11ax

8.2 扫描 WiFi

iw dev wlan0 scan | grep SSID

九、常见问题与排错（SDIO 高频坑）

问题 1：dmesg 报`sdio: error while initializing card`

原因：上电时序错误（WL_REG_ON 未按 10ms 低→50ms 高）
解决：检查设备树wifi_pwrseq延时，或硬件 GPIO 电平

问题 2：能识别 SDIO（024c:8852），但无 wlan0

原因：固件缺失 / 路径错
解决：dmesg | grep firmware→ 补fw_8852bs.bin

问题 3：驱动加载报`symbol not found`

原因：内核未开启CFG80211/MAC80211
解决：重新配置内核，开启无线协议栈

问题 4：WiFi6 路由连不上，只能连 5G

原因：未加ieee80211w=2
解决：wpa_supplicant.conf 增加该配置

问题 5：WiFi 丢包、速率低

原因：SDIO 时钟低 / 天线差
解决：设备树设max-frequency=150MHz；接原厂天线，远离干扰源

十、量产优化

开机自启：在/etc/init.d/添加脚本，上电自动加载8852bs.ko并启动 wpa_supplicant
固件固化：将fw_8852bs.bin编译进根文件系统
降日志：关闭驱动调试打印，降低 CPU 占用
电源管理：配置 WiFi 休眠，降低功耗

总结

RK3506 + RTL8852BS（SDIO）WiFi6 调试核心：

严格上电时序（WL_REG_ON 10ms 低→50ms 高）
设备树正确配置 SDMMC1 + 电源时序节点
内核开启 SDIO + WiFi6 协议栈
匹配驱动与固件
wpa_supplicant 加 ieee80211w=2 开启 WiFi6

整套方案稳定适配 RK3506 5.10/6.1 内核，可直接用于工控、IoT 网关、智能家电量产。

后续预告

下一篇文章：【RK3506实战-10】RK3506 Linux 接入 ESP32-SDIO WiFi 超详细实战

原创不易，如果本文对你有帮助，欢迎点赞、收藏、关注三连！有任何问题都可以在评论区留言，我会及时回复。