3. Linux 蓝牙子系统：BlueZ 架构、内核模块与用户空间工具

Linux 蓝牙子系统以 BlueZ 为核心，是官方蓝牙协议栈实现。它采用分层架构，将内核驱动、协议处理与用户空间工具分离，既保证了中断处理的实时性，又提供了灵活的调试接口。本章深入剖析 BlueZ 的层次结构、关键内核模块（bluetooth.ko、btusb.ko）以及常用用户空间工具（bluetoothctl、hcitool、gatttool），为后续中断处理与兼容性调试打下基础。

3.1 BlueZ 架构概述

BlueZ 自 Linux 2.4.6 起成为官方蓝牙协议栈，支持 Classic Bluetooth 和 Bluetooth Low Energy (BLE)。其架构核心原则是：内核只做最底层的传输与中断处理，协议逻辑与用户交互全部上移到用户空间。这种设计使得调试和扩展更加灵活。

层次	组件	职责	中断相关性
用户空间	bluetoothd, bluetoothctl, hcitool, gatttool	协议栈配置、设备发现、GATT 操作、服务管理	无直接中断处理，通过 HCI socket 接收事件
内核核心	bluetooth.ko	HCI 核心层、L2CAP、SCO、RFCOMM 协议实现	处理来自底层的中断事件，分发到上层协议
内核传输	btusb.ko	USB 传输管理、中断端点处理、URB 提交与完成	直接处理 USB 中断，是中断入口点
芯片驱动	btintel.ko, btbcm.ko, btqca.ko	芯片特定初始化、固件加载、Patch RAM	可能涉及芯片中断配置

3.2 内核蓝牙模块详解

3.2.1 bluetooth.ko — 蓝牙核心模块

bluetooth.ko 是蓝牙子系统的核心模块，提供以下关键功能：

• HCI 核心层：管理 HCI 命令、事件、数据通道的注册与分发。
• 协议注册框架：支持 L2CAP、SCO、RFCOMM 等协议的动态注册。
• Socket 接口：提供 AF_BLUETOOTH 协议族，用户空间通过 socket 与内核交互。
• 设备管理：负责蓝牙适配器的添加、移除、电源管理。

加载与验证：

# 加载核心模块
sudo modprobe bluetooth

# 查看模块信息
modinfo bluetooth | grep -E "description|author|version"

# 确认模块已加载
lsmod | grep bluetooth

3.2.2 btusb.ko — USB 传输与中断处理模块

btusb.ko 是绝大多数 USB 蓝牙适配器的驱动模块，直接负责中断处理。其核心工作流程如下：

1. 探测阶段：匹配 USB VID/PID，初始化端点配置，分配 URB。
2. 中断 URB 提交：为中断 IN 端点提交 URB，等待硬件事件。
3. 中断处理：当蓝牙控制器产生事件（如连接完成、断开、数据到达），USB 主机控制器触发中断，调用 URB 完成回调。
4. 事件分发：回调函数将 HCI 事件包送入 bluetooth.ko 的事件队列。

btusb 模块加载与参数：

# 加载 btusb 模块（自动依赖 bluetooth.ko）
sudo modprobe btusb

# 查看模块参数（如重置、调试开关）
modinfo -p btusb

# 启用 btusb 调试输出（动态调试）
echo 'module btusb +p' > /sys/kernel/debug/dynamic_debug/control

3.2.3 芯片特定驱动模块

不同蓝牙芯片厂商提供专用驱动模块，用于处理固件加载、Patch RAM 和芯片特定配置：

模块名	适用芯片	主要功能
btintel.ko	Intel Wireless-AC 系列	加载 Intel 专用固件、配置 Boot Parameters
btbcm.ko	Broadcom/Cypress 芯片	加载 BCM 固件、设置 UART 时钟
btqca.ko	Qualcomm Atheros 芯片	加载 QCA 固件、NVM 配置
hci_uart.ko	UART 接口蓝牙模块	HCI UART 传输层（H4、H5 协议）

3.3 用户空间工具实战

用户空间工具是调试蓝牙中断与兼容性问题的重要助手。以下三个工具覆盖了从底层 HCI 到高层 GATT 的调试需求。

3.3.1 bluetoothctl — 现代交互式控制工具

bluetoothctl 是 BlueZ 5 推荐的交互式工具，通过 DBus 与 bluetoothd 通信。常用命令：

# 启动交互式 shell
bluetoothctl

# 在交互式 shell 中执行
power on
scan on
devices
pair XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX
info XX:XX:XX:XX:XX:XX

# 非交互式模式（适合脚本）
bluetoothctl -- power on
bluetoothctl -- scan on
bluetoothctl -- devices

命令	用途	中断调试价值
show	显示控制器信息	查看 HCI 版本、支持的命令
scan on	开始扫描	触发大量中断事件，测试中断吞吐
pair	配对设备	验证中断驱动的配对流程
monitor	监控 HCI 事件	实时查看中断产生的事件流

3.3.2 hcitool — 经典 HCI 调试工具

hcitool 直接通过 HCI socket 与内核交互，不依赖 bluetoothd，适合底层调试：

# 扫描设备（经典蓝牙）
sudo hcitool scan

# 查看本地控制器信息
sudo hcitool dev
sudo hcitool info hci0

# 发送原始 HCI 命令（高级调试）
sudo hcitool cmd 0x03 0x0005  # 读取本地名称

# 持续监听 HCI 事件
sudo hcitool event

3.3.3 gatttool — BLE GATT 操作工具

gatttool 用于 BLE 设备的服务发现、特征读写和通知订阅，是调试 BLE 中断事件（如通知、指示）的核心工具：

# 连接 BLE 设备并进入交互模式
gatttool -b XX:XX:XX:XX:XX:XX -I

# 在交互模式中
connect
primary
characteristics
read-handle 0x0020
write-handle 0x0022 --value=0100
notify-handle 0x0023  # 订阅通知

# 非交互模式：读取特征值
gatttool -b XX:XX:XX:XX:XX:XX --char-read --handle=0x0020

操作	对应中断事件	调试要点
连接	HCI_LE_Connection_Complete	检查中断是否及时触发
通知订阅	HCI_LE_Notification	验证中断驱动的数据推送
写命令	HCI_LE_Write_Command	确认写操作无中断丢失

3.4 工具选择与中断调试场景对照

根据不同的中断调试需求，选择合适的工具组合：

调试场景	推荐工具	关注点
中断是否产生	btmon + hcitool event	观察 HCI 事件流是否连续
中断延迟	usbmon + 内核 trace	测量 URB 完成时间戳
中断丢失	btmon + dmesg	检查是否有 URB 错误或超时
兼容性问题	bluetoothctl info + hcitool info	对比不同适配器的 HCI 版本
BLE 通知调试	gatttool + btmon	验证 ATT 通知的 HCI 事件

3.5 模块加载顺序与依赖检查

正确的模块加载顺序是中断处理正常工作的前提。典型加载流程如下：

# 1. 加载蓝牙核心模块
modprobe bluetooth

# 2. 加载 USB 传输模块（自动依赖 bluetooth）
modprobe btusb

# 3. 芯片特定驱动（自动依赖 btusb）
modprobe btintel   # Intel 芯片示例

# 4. 检查模块依赖关系
lsmod | grep -E "bluetooth|btusb|btintel"

模块依赖关系示例输出：

Module                  Size  Used by
btintel                24576  0
btusb                  57344  0
bluetooth            1048576  2 btintel,btusb

3.6 本章小结