全志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_RTKBTUSBm启用Realtek USB蓝牙驱动CONFIG_UHIDy支持HID协议CONFIG_TUNy支持蓝牙PAN网络CONFIG_INPUT_UINPUTy支持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_btusbUSB实现的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_DEBUGFSy CONFIG_BT_HCIUART_DEBUGy在项目开发中我们最终实现了稳定的蓝牙4.0连接传输速率达到实际应用要求。整个过程虽然充满挑战但通过系统性的分析和逐步验证最终解决了所有技术难题。