从零到一：RV1106嵌入式设备蓝牙协议栈移植的避坑指南-开发者社区

从零到一：RV1106嵌入式设备蓝牙协议栈移植的避坑指南

1. 嵌入式蓝牙开发环境搭建

在RV1106平台上移植蓝牙协议栈，首先需要搭建完整的开发环境。Buildroot作为嵌入式Linux系统构建工具，能够高效地集成BlueZ蓝牙协议栈。以下是关键步骤：

获取Buildroot源码：

wget https://buildroot.org/downloads/buildroot-2023.02.6.tar.gz tar xvfz buildroot-2023.02.6.tar.gz cd buildroot-2023.02.6

配置交叉编译工具链： RV1106通常使用Rockchip提供的arm-rockchip830-linux-uclibcgnueabihf工具链。在Buildroot配置中需要指定：

BR2_TOOLCHAIN_EXTERNAL=y BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y BR2_TOOLCHAIN_EXTERNAL_PATH="/path/to/toolchain" BR2_TOOLCHAIN_EXTERNAL_PREFIX="arm-rockchip830-linux-uclibcgnueabihf"

启用蓝牙相关配置：在menuconfig中需要勾选以下关键选项：

BR2_PACKAGE_BLUEZ5_UTILS=y BR2_PACKAGE_BLUEZ5_UTILS_CLIENT=y BR2_PACKAGE_BLUEZ5_UTILS_TOOLS=y BR2_PACKAGE_DBUS=y

注意：uClibc与glibc的兼容性问题可能导致编译失败，这是RV1106平台蓝牙移植的主要挑战之一。

2. BlueZ5与uClibc兼容性问题解决

BlueZ5从5.27版本开始依赖glibc的wordexp功能，而RV1106 SDK默认使用uClibc库。以下是典型错误及解决方案：

2.1 wordexp.h缺失错误

编译时会报错：

src/shared/shell.c:25:10: fatal error: wordexp.h: No such file or directory #include <wordexp.h>

解决方案：修改BlueZ源码中所有包含wordexp.h的文件，替换为：

#include <android/compat/wordexp.h>

涉及的文件通常包括：

src/shared/shell.c
client/player.c
client/main.c
tools/btmgmt.c
tools/obexctl.c

2.2 WRDE_APPEND未定义错误

错误信息：

src/shared/shell.c:419:11: error: 'WRDE_APPEND' undeclared flags |= WRDE_APPEND;

解决方案：将WRDE_APPEND替换为WRDE_NOCMD：

//flags |= WRDE_APPEND; flags |= WRDE_NOCMD; // 修改后

2.3 依赖库问题

BlueZ5依赖的完整库列表：

库名称	作用	是否必需
glib	基础库	必需
dbus	进程通信	必需
readline	命令行编辑	可选
libffi	外部函数接口	必需
zlib	压缩库	必需

在uClibc环境下，可能需要手动编译这些依赖库。

3. 蓝牙驱动加载与测试

3.1 常见蓝牙模块驱动加载

对于RTL8723BS模块：

insmod hci_uart.ko ./rtk_hciattach -n -s 115200 /dev/ttyS5 rtk_h5 &

对于AIC8800模块：

insmod /oem/usr/ko/aic8800_btlpm.ko hciattach -s 1500000 /dev/ttyS1 any 1500000 flow nosleep &

3.2 射频开关控制

通过rfkill管理蓝牙射频状态：

# 查看射频设备 cat /sys/class/rfkill/rfkill*/uevent # 开启蓝牙 echo 1 > /sys/class/rfkill/rfkill2/state hciconfig hci0 up

3.3 基本功能测试

设备检测：

hciconfig -a

输出示例：

hci0: Type: Primary Bus: UART BD Address: 84:20:96:B1:4D:92 ACL MTU: 820:8 SCO MTU: 255:16 UP RUNNING Name: 'BlueZ 5.65' Class: 0x000000 HCI Version: 4.0 (0x6) Revision: 0x373e

设备扫描：

hcitool scan

输出示例：

Scanning ... 70:BB:E9:F2:5F:FA 小米手机

低功耗蓝牙扫描：

hcitool lescan

4. 高级功能配置与问题排查

4.1 bluetoothctl无响应问题

在uClibc环境下，bluetoothctl可能无法正常工作，这是因为：

bluetoothctl依赖完整的readline和history库
uClibc对这些库的支持不完整

替代方案：

使用hcitool进行基本操作
考虑使用btstack替代BlueZ（需要商业授权）

4.2 蓝牙协议栈配置优化

在Buildroot配置文件中建议的完整蓝牙配置：

BR2_PACKAGE_BLUEZ5_UTILS=y BR2_PACKAGE_BLUEZ5_UTILS_CLIENT=y BR2_PACKAGE_BLUEZ5_UTILS_TOOLS=y BR2_PACKAGE_BLUEZ5_UTILS_DEPRECATED=y BR2_PACKAGE_BLUEZ5_UTILS_EXPERIMENTAL=y BR2_PACKAGE_DBUS_CPP=y BR2_PACKAGE_DBUS_TRIGGERD=y

4.3 常见问题排查表

问题现象	可能原因	解决方案
hci0无法up	射频未开启	检查rfkill状态
扫描不到设备	蓝牙版本不匹配	确认设备支持BLE或经典蓝牙
频繁断开连接	电源管理问题	禁用省电模式
编译失败	依赖缺失	检查glib、dbus等库

5. 实际应用案例

5.1 手机连接RV1106蓝牙

在RV1106上启动蓝牙服务：

hciconfig hci0 up hciconfig hci0 piscan

在手机上搜索并配对设备
验证连接：

hcitool con

5.2 蓝牙数据透传实现

使用RFCOMM创建串口透传：

# 在RV1106上 sdptool add --channel=3 SP rfcomm listen /dev/rfcomm0 3 # 在客户端连接 rfcomm connect /dev/rfcomm0 <RV1106蓝牙MAC> 3

5.3 功耗优化配置

通过hciconfig调整功耗模式：

# 启用低功耗模式 hciconfig hci0 down hciconfig hci0 up hciconfig hci0 lm accept,hold,sniff,park

在嵌入式开发中遇到蓝牙问题时，建议首先检查硬件连接和驱动加载状态，再逐步验证协议栈各层功能。RV1106的uClibc环境虽然带来一些限制，但通过合理的配置和修改，仍然可以实现稳定的蓝牙功能。

从零到一：RV1106嵌入式设备蓝牙协议栈移植的避坑指南