保姆级教程：在RK3288 Android11上搞定RTL8723DS的WiFi与蓝牙（附完整设备树和配置文件修改）

RK3288 Android11平台RTL8723DS无线模块深度适配指南

当一块搭载RTL8723DS无线模块的开发板放在你面前时，如何快速激活它的WiFi和蓝牙功能？这个问题困扰过不少嵌入式开发者。本文将带你从硬件原理到软件配置，完整走通RK3288平台上RTL8723DS模块的适配流程。

1. 硬件原理与准备工作

RTL8723DS是一款集成了WiFi和蓝牙功能的COMBO芯片，采用SDIO接口连接WiFi，UART接口连接蓝牙。在RK3288平台上，我们需要重点关注几个关键硬件连接：

• 电源管理：WL_ON引脚控制模块供电，通常需要配置为GPIO输出模式
• 时钟源：32KHz时钟输入对蓝牙功能至关重要
• 接口分配：
  • WiFi：SDIO0接口
  • 蓝牙：UART4接口（根据原理图确认）

硬件检查清单：

1. 确认原理图中RTL8723DS的供电电压（通常为3.3V）
2. 检查32K时钟源是否连接到RK808芯片的CLK32KOUT1引脚
3. 确认SDIO和UART接口的GPIO引脚分配

2. 设备树配置详解

设备树(DTS)是Linux内核识别硬件的关键配置。以下是RK3288上RTL8723DS的核心设备树配置：

&sdio0 { status = "okay"; clock-frequency = <50000000>; bus-width = <4>; cap-sd-highspeed; cap-sdio-irq; keep-power-in-suspend; non-removable; mmc-pwrseq = <&sdio_pwrseq>; pinctrl-names = "default"; pinctrl-0 = <&sdio0_bus4 &sdio0_cmd &sdio0_clk>; rtl8723ds: wifi@1 { compatible = "realtek,rtl8723ds"; reg = <1>; }; }; &uart4 { status = "okay"; pinctrl-names = "default"; pinctrl-0 = <&uart4_xfer &uart4_cts &uart4_rts>; };

关键配置说明：

• mmc-pwrseq：指定SDIO电源序列控制器
• bus-width：设置SDIO总线宽度为4位
• non-removable：标记设备为不可热插拔
• uart4配置：确保CTS/RTS流控引脚正确映射

注意：实际GPIO引脚号需根据具体开发板原理图调整

3. 内核驱动配置

RK3288 Android11内核需要启用以下配置选项：

Device Drivers ---> [*] Network device support ---> [*] Wireless LAN ---> <*> Realtek 8723D SDIO WiFi [*] Bluetooth subsystem support ---> [*] Bluetooth device drivers ---> <*> HCI UART driver [*] UART protocol H5 <*> Realtek Bluetooth support

配置完成后，建议执行make savedefconfig保存配置，并检查生成的.config文件中是否包含：

CONFIG_RTL8723DS=m CONFIG_BT_HCIUART=y CONFIG_BT_HCIUART_H5=y CONFIG_BT_RTK=y

4. 系统配置文件修改

Android系统层需要调整多个配置文件以确保WiFi和蓝牙正常工作：

4.1 WiFi相关配置

修改init.rc文件，添加WiFi模块加载和初始化：

on boot # WiFi power control write /sys/class/gpio/export 132 # GPIO8_A4 write /sys/class/gpio/gpio132/direction out write /sys/class/gpio/gpio132/value 1 # Load WiFi firmware insmod /vendor/lib/modules/8723ds.ko

4.2 蓝牙相关配置

更新蓝牙配置文件rtkbt.conf：

# Bluetooth device node BtDeviceNode=/dev/ttyS4 # Firmware configuration FwPatchFilePath=/vendor/etc/firmware/rtlbt/ # Enable HCI snoop log RtkBtsnoopDump=true BtSnoopFileName=/data/misc/bluedroid/btsnoop_hci.cfa

同时需要修改ueventd.rc文件，确保蓝牙设备节点权限正确：

/dev/ttyS4 0660 bluetooth net_bt /dev/vflash 0660 bluetooth net_bt

5. 固件与调试

RTL8723DS需要特定的固件文件才能正常工作：

/vendor/etc/firmware/rtlbt/ └── rtl8723d_config └── rtl8723d_fw

调试技巧：

• WiFi日志查看：dmesg | grep rtl
• 蓝牙HCI日志：hcidump -Xt
• 射频测试：rfkill list检查设备状态

常见问题排查：

1. WiFi无法识别：检查SDIO接口电压和时钟
2. 蓝牙无法打开：确认32K时钟源是否稳定
3. 连接不稳定：调整UART波特率（建议115200）

6. 性能优化建议

经过基础功能验证后，可以考虑以下优化措施：

• 电源管理：配置wakeup-source属性实现低功耗
• 吞吐量优化：
  • 调整SDIO时钟频率（最高可达50MHz）
  • 启用WiFi PMF（Protected Management Frames）
• 蓝牙共存：
  • 配置btcoex参数改善WiFi/蓝牙同时工作性能
  • 调整天线匹配电路

实际项目中，我们发现将tx_queue_len从默认的1000调整为2000可以显著提升大文件传输稳定性：

# 查看当前队列长度 cat /sys/class/net/wlan0/tx_queue_len # 设置新值 echo 2000 > /sys/class/net/wlan0/tx_queue_len

7. 测试验证流程

完整的测试应该包括：

1. 基础功能测试：
   • WiFi扫描、连接、Ping测试
   • 蓝牙配对、文件传输
2. 稳定性测试：
   • 长时间大数据量传输
   • 快速开关WiFi/蓝牙
3. 兼容性测试：
   • 不同路由器兼容性
   • 多种蓝牙设备配对测试

测试工具推荐：

• WiFi测试：iwconfig,iperf3
• 蓝牙测试：bluetoothctl,btmon
• 功耗测试：powertop