保姆级教程：在Firefly RK3568开发板上搞定RTL8723蓝牙模块（附完整驱动编译与设备树修改）
从零构建Firefly RK3568与RTL8723蓝牙模块的完整开发指南
开篇：为什么选择RK3568与RTL8723的组合？
在嵌入式开发领域，Rockchip RK3568凭借其四核Cortex-A55架构和Mali-G52 GPU，成为中高端嵌入式设备的首选方案。而RTL8723作为一款高度集成的WiFi+蓝牙组合模块，以其低功耗和稳定连接特性广受欢迎。当这两者相遇，便构成了物联网网关、智能家居中枢等应用的理想硬件基础。
但现实往往比理论复杂——官方文档的缺失、驱动适配的坑点、设备树配置的玄学，让不少开发者在这套组合面前望而却步。本文将带你穿越这些迷雾，从源码编译到设备树调试，手把手构建完整的蓝牙功能栈。
1. 开发环境准备：搭建高效的交叉编译体系
1.1 硬件清单确认
在开始之前，请确认你已备齐以下硬件：
- Firefly ROC-RK3568-PC开发板（建议选择4GB内存版本）
- RTL8723模块（注意区分SDIO和UART版本）
- 5V/3A电源适配器
- 调试串口转USB模块（如CH340）
- 网线（用于快速传输文件）
特别注意：不同批次的RK3568开发板可能使用不同的PMIC方案，这会影响后续的电源管理配置。
1.2 软件工具链配置
推荐使用Ubuntu 20.04 LTS作为开发主机系统，按以下步骤配置环境：
# 安装基础依赖 sudo apt update && sudo apt install -y git make gcc bison flex libssl-dev \ libncurses-dev bc python3 device-tree-compiler lzop # 获取交叉编译工具链 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-1.3 内核源码获取与基础编译
Firefly官方维护的内核源码需要从特定仓库获取：
git clone --depth=1 https://gitlab.com/firefly-linux/kernel/rk356x-kernel.git cd rk356x-kernel make ARCH=arm64 rockchip_defconfig make ARCH=arm64 menuconfig # 可选：进行内核配置调整 make ARCH=arm64 -j$(nproc)编译完成后，在内核根目录会生成arch/arm64/boot/Image和arch/arm64/boot/dts/rockchip/rk3568-roc-pc.dtb文件，这些是后续刷机的基础。
2. RTL8723驱动深度解析与定制编译
2.1 驱动源码结构剖析
RTL8723的蓝牙部分采用HCI over UART协议，需要两个核心组件：
- hci_uart.ko：Linux内核的HCI UART协议驱动
- rtk_hciattach：Realtek专有的固件加载工具
典型的驱动源码目录结构如下：
rtk_bt_driver/ ├── firmware/ # 固件二进制文件 ├── hci_uart/ # 内核模块源码 ├── rtk_hciattach/ # 用户空间工具 └── tools/ # 辅助脚本2.2 内核模块编译实战
进入hci_uart目录，创建如下Makefile：
KERNEL_SRC ?= /path/to/rk356x-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) clean执行编译：
make KERNEL_SRC=~/rk356x-kernel ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-2.3 rtk_hciattach工具编译
这个用户空间工具负责固件加载和协议初始化：
cd rtk_hciattach export CC=aarch64-linux-gnu-gcc make clean && make编译产物rtk_hciattach需要push到开发板的/usr/bin目录。
3. 设备树深度定制：让硬件真正工作起来
3.1 UART接口配置奥秘
RK3568的UART8默认可能未启用，需要修改设备树：
&uart8 { status = "okay"; pinctrl-names = "default"; pinctrl-0 = <&uart8m0_xfer &uart8m0_ctsn &uart8m0_rtsn>; bluetooth { compatible = "realtek,rtl8723bs-bt"; enable-gpios = <&gpio0 RK_PC5 GPIO_ACTIVE_HIGH>; device-wake-gpios = <&gpio0 RK_PC6 GPIO_ACTIVE_HIGH>; host-wake-gpios = <&gpio0 RK_PC7 GPIO_ACTIVE_HIGH>; }; };关键点说明：
pinctrl-0指定了UART引脚复用配置- GPIO需要根据实际硬件连接调整
- CTS/RTS流控建议启用以确保稳定传输
3.2 电源管理配置
在设备树中添加电源域控制：
&vcc3v3_bt { regulator-name = "vcc3v3_bt"; regulator-always-on; gpio = <&gpio0 RK_PB7 GPIO_ACTIVE_HIGH>; enable-active-high; };3.3 射频干扰规避
对于2.4GHz频段的干扰问题，可以添加以下配置：
&wireless_bluetooth { brcm,bt-pcm-int-params = [01 02 00 01 01]; brcm,bt-pcm-mode = 1; brcm,bt-pcm-sample-rate = 8000; brcm,bt-pcm-frame-type = 1; brcm,bt-pcm-sync-mode = 0; brcm,bt-pcm-clock-mode = 1; };4. 系统集成与调试实战
4.1 固件部署策略
Realtek蓝牙需要两个关键固件文件：
rtl8723fs_fw：主固件rtl8723fs_config：配置参数
推荐部署到/lib/firmware/rtl_bt/目录：
mkdir -p /lib/firmware/rtl_bt cp rtl8723fs_fw /lib/firmware/rtl_bt/ cp rtl8723fs_config /lib/firmware/rtl_bt/ chmod 644 /lib/firmware/rtl_bt/*4.2 服务化启动脚本
创建/usr/lib/systemd/system/rtk-bluetooth.service：
[Unit] Description=Realtek Bluetooth Service After=sys-devices-platform-ff180000.serial-tty-ttyS8.device [Service] Type=forking ExecStart=/usr/bin/rtk_hciattach -n -s 115200 /dev/ttyS8 rtk_h5 Restart=on-failure [Install] WantedBy=multi-user.target4.3 深度调试技巧
当遇到连接问题时，按顺序检查：
射频状态：
cat /sys/class/rfkill/rfkill0/stateHCI层通信：
hcitool dev hciconfig hci0 ver协议分析：
btmon -w debug_log.snoop
4.4 性能优化参数
在/etc/bluetooth/main.conf中添加：
[LE] MinConnectionInterval=6 MaxConnectionInterval=16 ConnectionLatency=0 SupervisionTimeout=4005. 典型问题解决方案库
5.1 模块加载顺序陷阱
正确的驱动加载顺序应该是：
- 加载hci_uart内核模块
- 启动rtk_hciattach工具
- 初始化射频电源
- 加载固件
常见错误是顺序颠倒导致设备无法识别。
5.2 波特率自适应问题
虽然RTL8723支持自适应波特率，但初始握手必须使用115200。成功连接后可以通过以下命令切换：
hcitool cmd 0x3f 0x0031 0x01 0x00 0x00 0x01 0x005.3 电源管理冲突
当WiFi和蓝牙共用一个模块时，需要协调两者的电源状态：
echo 1 > /sys/module/rtw88/parameters/btcoex_enable6. 进阶：构建完整的蓝牙协议栈
6.1 BlueZ配置优化
编译最新版BlueZ并启用实验性功能：
./configure --prefix=/usr --mandir=/usr/share/man \ --sysconfdir=/etc --localstatedir=/var \ --enable-experimental --enable-midi \ --enable-mesh --enable-btpclient6.2 低功耗模式调优
修改/etc/bluetooth/main.conf：
[General] ControllerMode = le FastConnectable = true JustWorksRepairing = always [Policy] AutoEnable=true ReconnectAttempts=7 ReconnectIntervals=1,2,3,5,8,13,216.3 蓝牙Mesh支持
加载必要的内核模块：
modprobe bluetooth_6lowpan modprobe btusb echo 1 > /sys/kernel/debug/bluetooth/6lowpan_enable在开发过程中，记得定期检查内核日志获取详细调试信息：
dmesg | grep -i bluetooth journalctl -u bluetooth -f