保姆级教程：在Firefly RK3568开发板上搞定RTL8723蓝牙模块（附完整命令与设备树修改）
从零构建Firefly RK3568与RTL8723蓝牙模块的完整实战指南
开篇：为什么选择RK3568与RTL8723组合？
在嵌入式开发领域，Rockchip RK3568凭借其四核Cortex-A55架构和Mali-G52 GPU，成为中高端嵌入式设备的首选方案。而RTL8723作为一款高度集成的WiFi+蓝牙Combo芯片，以其低功耗和稳定连接特性深受开发者青睐。当这两者相遇，便构成了物联网网关、智能家居中枢等场景的理想硬件组合。
但现实往往比理论复杂——官方文档的缺失、驱动适配的晦涩、设备树配置的陷阱，让不少开发者在这套组合面前望而却步。本文将彻底解决这些问题，不仅提供可复现的操作步骤，更会深入每个命令背后的原理，让你真正掌握嵌入式蓝牙开发的精髓。
1. 开发环境搭建：从裸机到编译工具链
1.1 硬件准备清单
在开始之前，请确认你已备齐以下硬件：
- Firefly ROC-RK3568-PC开发板（建议选择4GB内存版本）
- RTL8723DS模块（注意确认是UART接口版本）
- 微型USB转TTL串口调试器（推荐CP2102芯片）
- 5V/3A电源适配器（瞬时电流不足会导致蓝牙初始化失败）
1.2 软件工具链配置
不同于常规ARM开发，RK3568需要特定的交叉编译工具链：
# 安装必备工具 sudo apt-get install git-core gnupg flex bison gperf build-essential \ zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache \ libgl1-mesa-dev libxml2-utils xsltproc unzip device-tree-compiler # 获取官方工具链 wget https://releases.linaro.org/components/toolchain/binaries/6.3-2017.05/aarch64-linux-gnu/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu.tar.xz tar -xvf gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu.tar.xz export CROSS_COMPILE=$(pwd)/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-注意：工具链版本必须严格匹配，新版gcc可能导致内核模块兼容性问题
2. 内核定制化编译与固件烧写
2.1 获取和配置内核源码
Firefly官方维护的内核已经包含了对RTL8723的基础支持：
git clone --depth=1 https://gitlab.com/firefly-linux/kernel/rk356x/kernel.git cd kernel make ARCH=arm64 firefly_defconfig关键配置项检查：
| 配置项 | 推荐值 | 作用 |
|---|---|---|
| CONFIG_BT | y | 启用蓝牙核心功能 |
| CONFIG_BT_HCIUART | y | UART传输协议支持 |
| CONFIG_BT_HCIUART_RTL | y | 特定Realtek芯片支持 |
2.2 设备树关键修改
原始设备树中UART8默认禁用，需要修改arch/arm64/boot/dts/rockchip/rk3568-firefly-roc-pc.dts：
&uart8 { status = "okay"; pinctrl-names = "default"; pinctrl-0 = <&uart8m0_xfer &uart8m0_ctsn &uart8m0_rtsn>; bluetooth { compatible = "realtek,rtl8723ds-bt"; enable-gpios = <&gpio0 RK_PC1 GPIO_ACTIVE_HIGH>; device-wake-gpios = <&gpio0 RK_PC3 GPIO_ACTIVE_HIGH>; host-wake-gpios = <&gpio0 RK_PC4 GPIO_ACTIVE_HIGH>; }; };编译并烧写新内核：
make ARCH=arm64 -j$(nproc) bindeb-pkg sudo dd if=arch/arm64/boot/Image of=/dev/sdX bs=4M status=progress3. 蓝牙驱动深度编译与调试
3.1 驱动模块独立编译
Realtek提供的驱动包通常包含以下关键组件：
hci_uart.ko：HCI协议栈的UART传输层rtk_hciattach：固件加载工具
典型Makefile配置示例：
KERNEL_SRC ?= /path/to/your/kernel ARCH ?= arm64 CROSS_COMPILE ?= aarch64-linux-gnu- obj-m += hci_uart.o hci_uart-y := hci_ldisc.o hci_h4.o hci_rtk_h5.o rtk_coex.o all: make -C $(KERNEL_SRC) M=$(PWD) modules clean: make -C $(KERNEL_SRC) M=$(PWD) clean3.2 固件部署与权限设置
Realtek蓝牙需要两个关键固件文件：
rtl8723fs_fw：蓝牙协议栈固件rtl8723fs_config：射频参数配置
部署命令序列：
sudo mkdir -p /lib/firmware/rtlbt sudo cp rtl8723fs_* /lib/firmware/rtlbt/ sudo chmod 644 /lib/firmware/rtlbt/rtl8723fs_*4. 蓝牙服务初始化与问题排查
4.1 完整的启动脚本
创建/usr/local/bin/bt-init.sh：
#!/bin/bash # 加载内核模块 insmod /lib/modules/$(uname -r)/hci_uart.ko # 设置串口权限 chmod 666 /dev/ttyS8 # 初始化蓝牙芯片 rtk_hciattach -n -s 115200 /dev/ttyS8 rtk_h5 & # 电源管理序列 echo 0 > /sys/class/rfkill/rfkill0/state sleep 0.5 echo 1 > /sys/class/rfkill/rfkill0/state sleep 0.5 # 验证状态 hciconfig -a4.2 常见故障排查指南
现象：hciattach报错"Can't initialize device: Connection timed out"
解决方案：
- 检查串口号是否正确：
dmesg | grep ttyS8 - 验证电压：测量RTL8723的VCC引脚应在3.3V±5%
- 检查流控：确认RTS/CTS接线正确
现象：蓝牙可见但无法配对
调试步骤：
# 启用调试日志 echo 8 > /proc/sys/kernel/printk hcidump -Xt &5. 高级配置与性能优化
5.1 蓝牙功耗管理
通过sysfs接口调整功耗参数：
| 参数路径 | 默认值 | 推荐值 | 作用 |
|---|---|---|---|
| /sys/kernel/debug/bluetooth/hci0/auto_sleep | 1 | 0 | 禁用自动休眠 |
| /sys/kernel/debug/bluetooth/hci0/sleep_idle_threshold | 500 | 200 | 空闲超时(ms) |
5.2 射频参数调优
编辑/lib/firmware/rtlbt/rtl8723fs_config：
[SYSTEM] # 发射功率等级(0-15) txpwr_lvl=12 [BAND] # 2.4GHz信道衰减补偿 ch_1_11_offset=-56. 系统集成与自动化
6.1 systemd服务配置
创建/etc/systemd/system/rtk-bluetooth.service：
[Unit] Description=Realtek Bluetooth Service After=sys-devices-platform-ff180000.serial-tty-ttyS8.device [Service] Type=forking ExecStart=/usr/local/bin/bt-init.sh Restart=on-failure [Install] WantedBy=multi-user.target6.2 压力测试方案
使用bluetoothctl进行批量连接测试：
for i in {1..10}; do bluetoothctl connect XX:XX:XX:XX:XX:XX sleep 1 bluetoothctl disconnect XX:XX:XX:XX:XX:XX done在实际项目中，我发现RTL8723的UART波特率可以提升到3Mbps以获得更低的传输延迟，但这需要同步修改内核中的HCI_UART_H4配置。另外，在高温环境下建议降低发射功率以避免芯片过热导致的连接不稳定。