眺望电子RK3588_SDIO_WiFi_Support List更新

前言： 在嵌入式开发过程中，选用成熟高性能WiFi模组保障功能稳定性与可靠性，同时需要考虑供应链的稳定与驱动的成熟度，往往是项目落地的关键环节。眺望电子针对企业项目技术服务过程中，将持续对外围电路做support list更新，方便用户选型使用。本章主要是详细说明RK3588 下RTL8821CS完整调试过程。

 一、WiFi模组介绍 

本次推荐的6221A-SRC 模块（基于瑞昱 RTL8821CS 方案）具备以下核心优势：

• 高性能无线能力：支持 Wi-Fi 5（802.11a/b/g/n/ac）和蓝牙双模，Wi-Fi 最大传输速率 150Mbps，蓝牙 3Mbps，满足高流量场景需求；

• 兼容性优异：与正基 AP6255/AP6256 模块 Pin to Pin 兼容，无需修改硬件设计即可替换；

• 成熟稳定：采用瑞昱成熟方案，驱动支持完善，适配 RK3588 等主流嵌入式平台。

二、RTL8821C WIFI调试

 2.1  驱动准备与路径配置

将rtl8821cs的wifi驱动包复制到rk3588的SDK内，路径如下

~/kernel/drivers/net/wireless/rockchip_wlan/，并命名为rtl8821cs

 2.2   Makefile 配置

修改驱动编译配置文件，指定 WiFi 芯片类型和接口模式：

• 配置 WiFi IC：CONFIG_RTL8821C = y（其他设为 n）

• 配置接口：CONFIG_SDIO_HCI = y（其他设为 n）

 2.3   设备树（DTS）配置

在 Fuction.dtsi 中添加 WiFi 硬件信息，关键配置唤醒脚和引脚定义：

wireless-wlan {      compatible = "wlan-platdata";      pinctrl-names = "default";      pinctrl-0 = <&wifi_host_wake_irq>;      wifi_chip_type = "rtl8821cs";      WIFI,host_wake_irq = <&gpio1 RK_PD6 GPIO_ACTIVE_HIGH>;      status = "okay";};  wireless-wlan {      wifi_host_wake_irq: wifi-host-wake-irq {    rockchip,pins = <1 RK_PD6 RK_FUNC_GPIO &pcfg_pull_down>;  };};

 2.4   Kconfig 与 Makefile 添加编译项

在~/kernel/drivers/net/wireless/rockchip_wlan/Kconfig中添加：

if BCMDHDsource "drivers/net/wireless/rockchip_wlan/rkwifi/Kconfig"+ source "drivers/net/wireless/rockchip_wlan/rtl8821cs/Kconfig"endifsource "drivers/net/wireless/rockchip_wlan/cywdhd/Kconfig"source "drivers/net/wireless/rockchip_wlan/infineon/Kconfig"

在~/kernel/drivers/net/wireless/rockchip_wlan/Makefile中添加：

# SPDX-License-Identifier: GPL-2.0obj-$(CONFIG_BCMDHD) += rkwifi/obj-$(CONFIG_CYW_BCMDHD) += cywdhd/obj-$(CONFIG_INFINEON_DHD) += infineon/+ obj-$(CONFIG_RTL8821CS) += rtl8821cs/

 2.5  内核编译与驱动加载                                                                                                                                                                                     

• 进入内核配置菜单，勾选对应驱动（路径：Device Drivers > Network device support > Wireless LAN > Rockchip Wireless LAN support > Broadcom Wireless Device Driver Support），编译为模块；

• 编译后在/kernel/drivers/net/wireless/rockchip_wlan/rtl8821cs生成 KO 文件，拷贝到开发板；

• 重新烧录修改后的内核，使用insmod 8821cs.ko加载驱动，生成 wlan0 节点。

 2.6   联网测试

配网命令：

nmcli dev wifi connect "Talowe-2.4G-0" password "Talowe888" ifname wlan0udhcpc -i wlan0

wifi模块就完成了配网，进行网络连接，可以进行ping百度和iperf测试。

 三、RTL8821C 蓝牙调试 

 3.1  蓝牙驱动配置

将rtl8821cs的蓝牙驱动包复制到rk3588的SDK内，路径如下

~/kernel/drivers/bluetooth/bluetooth_uart_driver。

 3.2  蓝牙设备树配置

在Fuction.dtsi中添加以下信息，gpio0 PD3为REG_ON引脚，gpio4 PC为蓝牙唤醒引脚。

wireless-bluetooth {compatible = "bluetooth-platdata";uart_rts_gpios = <&gpio3 RK_PD2 GPIO_ACTIVE_LOW>;pinctrl-names = "default", "rts_gpio";pinctrl-0 = <&uart9m2_rtsn>;pinctrl-1 = <&uart9_gpios>;BT,power_gpio = <&gpio0 RK_PD3 GPIO_ACTIVE_HIGH>; // BT_REG_ONBT,wake_host_irq = <&gpio4 RK_PC2 GPIO_ACTIVE_HIGH>; // BT_WAKE_HOSTstatus = "okay";};wireless-bluetooth {uart9_gpios: uart9-gpios {rockchip,pins = <3 RK_PD2 RK_FUNC_GPIO &pcfg_pull_none>;};};

 3.3  蓝牙驱动编译配置

在~/kernel/drivers/bluetooth/Kconfig中添加：​​​​​​​

config RTL_8821_UART_BTtristate "RTL_8821_uart_bt driver"helpRTL Bluetooth HCI uart driver.This driver is required if you want to use RTL Bluetoothwith URAT interface.Say Y here to compile support for RTL Bluetooth urat devicesinto the kernel or say M to compile it as module (btrtluart).

在~/kernel/drivers/bluetooth/Makefile中添加：​​​​​​​

obj-$(CONFIG_BT_HCIUART_NOKIA) += hci_nokia.oobj-$(CONFIG_BT_HCIRSI)  += btrsi.o+ obj-$(CONFIG_RTL_8821_UART_BT)  += bluetooth_uart_driver/

 四、固件加载与节点验证 

• .在内核的配置中勾选对应的驱动进行编译，路径：Networking support > Bluetooth subsystem support > Bluetooth device drivers

• 勾选对应的驱动文件后,保存配置文件编译内核进行烧录,将蓝牙的固件拷贝到RK3588开发板的/lib/firmware/rtlbt路径中

• 等待固件加载完成，查看蓝牙节点

 总结 

6221A-SRC  作为一款成熟的 WiFi & 蓝牙模组，通过本文的驱动配置、设备树修改、编译与加载步骤，可见在 RK3588 平台上调试十分简单快捷，工程师可快速完成模组集成，降低项目开发周期。眺望电子也将持续更新外围电路 support list，为嵌入式开发者提供更多选型参考。

若您在开发使用中遇到任何问题，请关注眺望电子并联系我们，获取完整测试报告与软硬件设计参考资料，我们将竭诚为您服务！