22、USB蓝牙适配器开发：从驱动加载到设备连接

说实话，USB蓝牙适配器这块，我当年刚接触时也踩过不少坑。你想想看，一个USB插进去，系统怎么知道它是蓝牙？驱动怎么加载上去？HCI协议又是什么鬼？今天咱们就把这些事掰扯清楚。

我个人习惯把USB蓝牙适配器开发分成三个层次：驱动层、协议层、应用层。驱动层负责让系统认识这个硬件，协议层负责蓝牙设备间的通信，应用层才是我们最终连接耳机、手柄的地方。

USB蓝牙适配器原理：HCI协议到底是什么？

HCI，全称Host Controller Interface，说白了就是主机和蓝牙控制器之间的“翻译官”。蓝牙芯片本身是个小电脑，它有自己的固件，负责处理射频信号、基带协议这些脏活累活。而Android系统这边，需要通过HCI协议给蓝牙芯片下命令，比如“扫描周围设备”、“连接某某设备”、“发送音频数据”。

HCI协议定义了三种数据包类型：

  • 命令包：主机发给控制器，比如“查询远程设备名称”
  • 事件包：控制器回复主机，比如“查询完成，设备名称是XXX”
  • 数据包：双向传输的实际数据，比如音频流、手柄按键信息

我在项目中遇到过一个问题：某款USB蓝牙适配器插上后，系统能识别到USB设备，但蓝牙功能就是打不开。后来一查，发现是HCI传输层的USB端点配置不对。蓝牙HCI在USB上通常使用两个Bulk端点（一个输入、一个输出）和一个Interrupt端点。如果固件把端点类型配错了，驱动就收不到事件包。

核心要点：USB蓝牙适配器本质上是一个USB设备，它通过HCI协议与主机通信。Android系统通过USB驱动加载蓝牙HCI驱动，然后通过HCI命令控制蓝牙芯片。

Android端USB蓝牙驱动加载：从插上到能用

当用户把USB蓝牙适配器插到Android设备上时，系统内部发生了一系列事情。我把它总结成下面这张图：

Android USB蓝牙适配器驱动加载流程 1. USB设备插入 USB核心层检测到新设备 2. 枚举与匹配 读取VID/PID，匹配驱动 3. 加载USB驱动 usbcore加载usbhid或自定义驱动 4. 蓝牙HCI驱动注册 hci_uart/hci_usb 驱动绑定 5. 初始化HCI 发送HCI_Reset等初始化命令 6. 蓝牙协议栈启动 BlueZ/ Fluoride 接管 7. 应用层可用 蓝牙设置界面显示“已开启” 关键文件路径： /kernel/drivers/bluetooth/btusb.c /hardware/libhardware/modules/bluetooth/

嗯，这里要注意一点：Android从4.2开始，蓝牙协议栈从BlueZ换成了Fluoride（后来叫Bluetooth Stack）。但不管上层怎么变，底层的HCI驱动接口基本没动过。我当年做Android 4.4的平板项目时，就因为这个切换踩过坑——BlueZ的HCI初始化序列和Fluoride不完全一样，导致某款CSR芯片的适配器死活连不上。

经验之谈：如果你在调试USB蓝牙适配器时发现驱动加载了但蓝牙打不开，先检查dmesg里有没有"hci0: command 0x0c03 timeout"之类的错误。这通常是HCI初始化命令超时，可能是USB端点配置问题，也可能是蓝牙芯片固件没启动。

蓝牙HCI命令与事件处理：核心通信机制

HCI命令和事件，说白了就是一套“请求-响应”机制。主机发一个命令包，控制器回一个事件包。但这里有个坑：命令和事件不是一一对应的。有些命令会触发多个事件，有些事件是异步发生的（比如连接断开事件）。

HCI命令包的格式如下：

// HCI命令包结构
struct hci_command_hdr {
    uint16_t opcode;    // 操作码，高6位是OGF，低10位是OCF
    uint8_t  plen;      // 参数长度
} __packed;

// 举个例子：HCI_Reset命令
// OGF = 0x03 (控制器与基带命令)
// OCF = 0x0003 (Reset)
// opcode = (0x03 << 10) | 0x0003 = 0x0C03
// plen = 0 (Reset命令没有参数)

uint8_t reset_cmd[] = { 0x03, 0x0C, 0x00 };
// 注意：小端序，所以先发0x03，再发0x0C

事件包的格式更简单：

// HCI事件包结构
struct hci_event_hdr {
    uint8_t  evt;       // 事件码
    uint8_t  plen;      // 参数长度
} __packed;

// Command Complete事件 (事件码0x0E)
// 表示命令执行完成，包含命令的返回状态
// 比如HCI_Reset成功后，会收到：
// evt = 0x0E, plen = 4
// 参数: NumHCICommandPackets(1字节) + CommandOpcode(2字节) + Status(1字节)

我曾经调试过一个蓝牙手柄连接问题，现象是手柄能扫描到，但一连接就断。抓了HCI日志后发现，主机发了Create Connection命令后，控制器回了Connection Complete事件，但状态码是0x0E（连接超时）。后来发现是手柄的蓝牙版本和适配器不兼容——适配器是蓝牙4.0，手柄是蓝牙2.0，但适配器没有开启BR/EDR模式。

避坑指南：我曾经在调试某款Realtek USB蓝牙适配器时，发现它需要先加载固件才能正常工作。如果不加载固件，HCI_Reset命令会返回成功，但后续的HCI_ReadLocalVersion会返回错误。解决办法是在驱动初始化阶段，先通过USB控制传输把固件bin文件刷到芯片里，然后再发HCI命令。

实战：通过USB蓝牙适配器连接蓝牙耳机/手柄

好了，理论说完了，咱们来点实际的。下面是一个完整的Android端USB蓝牙适配器开发流程，从驱动加载到设备连接。

第一步：确认硬件兼容性

不是所有USB蓝牙适配器都能在Android上直接用。我建议优先选择以下芯片方案：

芯片型号 蓝牙版本 Android兼容性 备注
CSR8510 4.0 良好 经典方案，驱动成熟
Realtek RTL8761 5.0 需加载固件 性能好，但初始化复杂
Broadcom BCM20702 4.0 良好 树莓派常用，Android也支持
Intel Wireless-AC 9260 5.0 需定制内核 M.2接口，需转接

第二步：编写HCI驱动初始化代码

在Android系统中，USB蓝牙适配器的驱动通常由内核的btusb.c处理。但如果你想在用户空间直接操作HCI，可以使用以下方式：

// 打开HCI设备节点
int fd = open("/dev/hci0", O_RDWR);
if (fd < 0) {
    // 如果打不开，可能是权限问题或驱动没加载
    // 检查 /sys/class/bluetooth/ 下有没有 hci0
    perror("open hci0 failed");
    return -1;
}

// 发送HCI_Reset命令
uint8_t reset_cmd[] = { 0x03, 0x0C, 0x00 };
struct hci_filter flt;
hci_filter_clear(&flt);
hci_filter_set_ptype(HCI_EVENT_PKT, &flt);
hci_filter_set_event(EVT_CMD_COMPLETE, &flt);
setsockopt(fd, SOL_HCI, HCI_FILTER, &flt, sizeof(flt));

int ret = write(fd, reset_cmd, sizeof(reset_cmd));
if (ret < 0) {
    perror("write reset cmd failed");
    close(fd);
    return -1;
}

// 等待Command Complete事件
uint8_t buf[256];
ret = read(fd, buf, sizeof(buf));
if (ret > 0) {
    // 解析事件包
    uint8_t evt = buf[0];  // 应该是0x0E
    uint8_t status = buf[3]; // 状态码，0表示成功
    printf("Reset status: 0x%02x\n", status);
}

close(fd);

第三步：扫描并连接蓝牙设备

连接蓝牙耳机或手柄，本质上就是发送HCI_Inquiry（查询）和HCI_Create_Connection（创建连接）命令。但实际开发中，我们通常不会直接操作HCI层，而是通过Android的BluetoothAdapter API：

// Android Java层代码
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
if (adapter == null) {
    // 没有蓝牙硬件或驱动未加载
    return;
}

// 开始扫描
adapter.startDiscovery();

// 注册广播接收器监听扫描结果
BroadcastReceiver receiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (BluetoothDevice.ACTION_FOUND.equals(action)) {
            BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
            String name = device.getName();
            String address = device.getAddress();
            
            // 如果是目标设备（比如蓝牙耳机），发起连接
            if ("My Bluetooth Headset".equals(name)) {
                // 停止扫描
                adapter.cancelDiscovery();
                // 连接（需要BluetoothSocket）
                // ...
            }
        }
    }
};

但这里有个坑：如果你用的是USB蓝牙适配器，而Android设备本身也有蓝牙模块，系统可能会优先使用内置蓝牙。我遇到过这种情况：插上USB适配器后，/dev/hci0还是内置蓝牙，USB适配器变成了/dev/hci1。这时候需要通过代码指定使用哪个适配器。

我的做法：在init.rc里加一条服务，启动时检查USB蓝牙适配器，如果检测到就禁用内置蓝牙，把USB适配器设为默认。具体实现是写一个native程序，通过ioctl操作HCI设备，调用HCI_Write_Simple_Pairing_Mode等命令配置适配器。

第四步：处理蓝牙耳机/手柄的特殊需求

蓝牙耳机和手柄在连接后的处理不太一样：

  • 蓝牙耳机：需要建立SCO（同步面向连接）链路传输音频。Android中通常通过BluetoothHeadset API或直接操作A2DP profile。
  • 蓝牙手柄：通常使用HID（人机交互设备）profile。Android系统会自动识别并映射成输入设备，你可以在/dev/input/下看到新的事件节点。

我曾经帮一个游戏公司调试蓝牙手柄，发现手柄连接后按键没反应。查了半天，发现是手柄的HID报告描述符里把按键映射成了Consumer Usage（比如音量键），而不是Gamepad Usage。解决方案是在蓝牙协议栈里加一个HID报告描述符的解析和重映射逻辑。

实战总结：USB蓝牙适配器开发的核心就三件事——让驱动认出来、让HCI跑起来、让上层用起来。大部分坑都出在驱动加载和HCI初始化阶段，只要这两步走通了，后面的蓝牙连接和Android原生开发没什么区别。

好了，关于USB蓝牙适配器开发的内容就这些。记住，遇到问题先看dmesg，再看HCI日志，最后才怀疑硬件。这个顺序能帮你省下大量调试时间。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →