全志A33安卓6.0上，搞定RTL8723BU蓝牙驱动移植的完整踩坑记录
全志A33安卓6.0平台RTL8723BU蓝牙驱动移植实战：从内核配置到HAL层适配的完整指南
在嵌入式开发领域，蓝牙模块的移植工作往往充满挑战，尤其是当面对全志A33这类资源受限的平台时。本文将详细记录在Android 6.0系统上为RTL8723BU蓝牙模块完成驱动移植的全过程，重点解决libbt-vendor_usb.so缺失这一关键问题。不同于简单的操作步骤罗列，我们将深入每个环节的技术原理，帮助开发者理解背后的逻辑。
1. 环境准备与驱动源码处理
移植工作的第一步是确保开发环境配置正确。全志A33平台使用的Linux内核版本为3.4，这个相对较旧的内核版本需要特别注意兼容性问题。建议使用Ubuntu 14.04或16.04作为开发环境，因为这些版本的工具链与Android 6.0的构建系统兼容性最佳。
获取RTL8723BU的官方驱动包后，需要重点关注两个核心文件：
drivers/bluetooth/ ├── rtk_btusb.c └── rtk_btusb.h这两个文件包含了USB蓝牙设备的核心驱动逻辑。将它们复制到内核源码目录后，还需要修改Kconfig和Makefile来启用驱动编译选项：
# drivers/bluetooth/Kconfig 新增配置项 config BT_RTKBTUSB tristate "RTK HCI USB driver" depends on USB help RTK Bluetooth HCI USB driver # drivers/bluetooth/Makefile 新增编译条目 obj-$(CONFIG_BT_RTKBTUSB) += rtk_btusb.o内核配置文件中需要确保以下关键选项已启用：
| 配置项 | 值 | 作用 |
|---|---|---|
| CONFIG_BT_RTKBTUSB | m | 启用Realtek USB蓝牙驱动 |
| CONFIG_UHID | y | 支持HID协议 |
| CONFIG_TUN | y | 支持蓝牙PAN网络 |
| CONFIG_INPUT_UINPUT | y | 支持AVRCP协议 |
2. 内核编译与驱动加载验证
完成内核配置后，使用全志提供的编译脚本构建内核模块：
./build.sh kernel编译生成的rtk_btusb.ko模块需要放置在系统的指定位置。修改设备初始化脚本init.sun8i.rc，添加模块加载指令：
on early-fs # 加载蓝牙驱动 insmod /system/vendor/modules/rtk_btusb.ko驱动加载后，检查设备节点是否创建成功：
adb shell ls /dev/rtk_btusb如果看到设备节点，说明内核层驱动已正常工作。此时还需要设置正确的设备权限：
# ueventd.sun8i.rc /dev/rtk_btusb 0660 bluetooth net_bt_stack3. Android系统层配置调整
Android系统对蓝牙的支持分为多个层次，需要逐层进行配置。首先在BoardConfig.mk中声明蓝牙支持：
BOARD_HAVE_BLUETOOTH := true BOARD_HAVE_BLUETOOTH_RTK := true BLUETOOTH_HCI_USE_RTK_H5 := true关键配置项说明：
- BOARD_HAVE_BLUETOOTH：启用基础蓝牙支持
- BOARD_HAVE_BLUETOOTH_RTK：指定使用Realtek方案
- BLUETOOTH_HCI_USE_RTK_H5：启用H5协议支持
接着修改astar_d7.mk产品配置文件，继承Realtek的蓝牙固件支持：
$(call inherit-product, hardware/realtek/bt/firmware/rtl8723b/device-rtl.mk)蓝牙服务需要特定的目录结构和权限，在init.sun8i.rc中添加：
on boot # 创建蓝牙数据目录 mkdir /data/misc/bluedroid 0770 bluetooth net_bt_stack # 设置设备权限 chmod 0660 /dev/rtk_btusb chown bluetooth net_bt_stack /dev/rtk_btusb4. 解决libbt-vendor_usb.so缺失问题
当完成上述配置后，很多开发者会遇到HAL层缺少libbt-vendor_usb.so的问题。这是因为Realtek提供的参考实现通常只包含UART方式的支持，而我们需要为USB方式创建独立的实现。
解决方案是在hardware/realtek/bluetooth/libbt-vendor/目录下创建两个子目录：
libbt-vendor/ ├── uart/ # 原始UART实现 └── usb/ # 新增USB实现USB实现需要包含以下关键文件：
usb/ ├── Android.mk ├── include/ │ ├── bt_vendor_rtk.h │ ├── upio.h │ └── vnd_buildcfg.h └── src/ ├── bt_vendor_rtk.c └── upio.c关键修改点在vnd_buildcfg.h中定义设备节点：
#define BLUETOOTH_UART_DEVICE_PORT "/dev/rtk_btusb"USB实现的Android.mk需要正确配置：
LOCAL_SRC_FILES := \ src/bt_vendor_rtk.c \ src/upio.c LOCAL_MODULE := libbt-vendor_usb include $(BUILD_SHARED_LIBRARY)最后，在顶层目录的Android.mk中添加子目录构建：
include $(call all-subdir-makefiles)5. 固件编译与功能验证
完成所有修改后，使用以下命令单独编译蓝牙HAL层：
mmm hardware/realtek/bluetooth/libbt-vendor/编译成功后，检查生成的库文件：
ls out/target/product/astar-d7/system/lib/libbt-vendor_usb.so系统启动后，通过以下命令验证蓝牙功能：
logcat | grep Bluetooth hciconfig -a常见问题排查技巧：
- 驱动加载失败：检查dmesg输出，确认USB设备识别正常
- 权限问题：确保/dev/rtk_btusb设备权限正确
- HAL层崩溃：检查logcat中bluetooth相关的错误日志
6. 性能优化与稳定性提升
移植完成后，还可以进行一些优化工作：
- 电源管理：在驱动中实现合理的电源控制逻辑
- 共存机制：配置WiFi/BT共存参数减少干扰
- 日志级别：调整驱动日志级别平衡性能与调试需求
修改内核配置增加蓝牙相关调试支持：
CONFIG_BT_DEBUGFS=y CONFIG_BT_HCIUART_DEBUG=y在项目开发中，我们最终实现了稳定的蓝牙4.0连接，传输速率达到实际应用要求。整个过程虽然充满挑战，但通过系统性的分析和逐步验证，最终解决了所有技术难题。