前言：在嵌入式開發過程中，選用成熟高性能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.2Makefile 配置

修改驅動編譯配置文件，指定 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中添加：

ifBCMDHDsource"drivers/net/wireless/rockchip_wlan/rkwifi/Kconfig"+source"drivers/net/wireless/rockchip_wlan/rtl8821cs/Kconfig"endif
source"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 聯網測試

配網命令：

nmclidev 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 driverisrequiredifyou want to use RTL BluetoothwithURAT interface.Say Y here tocompilesupportforRTL Bluetooth urat devicesinto the kernelorsay M tocompileitasmodule (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，為嵌入式開發者提供更多選型參考。若您在開發使用中遇到任何問題，請關注眺望電子公眾號并聯系我們，獲取完整測試報告與軟硬件設計參考資料，我們將竭誠為您服務！