📚 课程目录第2章 Linux蓝牙子系统架构

Linux内核蓝牙驱动调试与HCI日志分析实战 - 第2节

2.1 BlueZ 协议栈：Linux 蓝牙的基石

BlueZ 是 Linux 官方蓝牙协议栈，自 Linux 2.4.6 内核起成为标准组件。它实现了 Bluetooth Core Specification 定义的全部层次，从控制器接口到高层应用 Profile。理解 BlueZ 的层次结构是调试蓝牙驱动的第一步。

  核心事实：BlueZ 并非单一程序，而是一组内核模块、库和用户空间守护进程的集合。其代码仓库位于 https://github.com/bluez/bluez，当前稳定版本为 5.x 系列。

2.1.1 BlueZ 层次架构总览

下图展示了 BlueZ 协议栈的完整分层，从最底层的硬件控制器到最顶层的应用接口：

2.1.2 各层次职责与关键组件

层次	关键组件	主要职责
应用层	PulseAudio, GNOME Bluetooth, 自定义 App	通过 D-Bus 调用 BlueZ 服务，实现音频、文件传输、输入设备等 Profile
D-Bus 接口	org.bluez 总线	提供标准化的对象路径与方法调用，屏蔽底层协议细节
用户空间守护进程	bluetoothd, bluetoothctl, hciconfig	管理适配器、设备、连接、配对；提供 CLI 调试接口
HCI 套接字	AF_BLUETOOTH / SOCK_RAW	用户空间与内核蓝牙子系统的通信通道，传递 HCI 命令/事件/数据
内核蓝牙子系统	L2CAP, RFCOMM, SCO, BNEP, HIDP	实现蓝牙核心协议，管理连接状态，调度数据包
控制器驱动	btusb, hci_uart, hci_vhci	与具体硬件传输层交互，将 HCI 帧发送到控制器
蓝牙硬件	BR/EDR/BLE 射频芯片	物理层射频收发、基带处理、链路控制

调试切入点：大多数驱动级调试工作集中在“控制器驱动”和“内核蓝牙子系统”两层。HCI 日志捕获通常在内核的 HCI 核心层或通过 HCI 套接字在用户空间完成。

2.2 内核蓝牙子系统 (Bluetooth Core)

内核蓝牙子系统位于 Linux 内核的 net/bluetooth/ 目录下，是 BlueZ 协议栈的内核态核心。它实现了 Bluetooth Core Specification 中定义的 Host 侧协议栈，包括 HCI 核心、L2CAP、RFCOMM、SCO、BNEP 和 HIDP 等协议层。

2.2.1 内核模块组成

蓝牙子系统由多个可加载内核模块组成，每个模块对应一个协议或功能单元：

2.2.2 核心数据结构与接口

内核蓝牙子系统的核心数据结构定义在 include/net/bluetooth/ 头文件中。最重要的结构体包括：

数据结构	头文件	作用
`struct hci_dev`	hci_core.h	表示一个蓝牙控制器实例，包含设备状态、缓冲队列、命令发送回调等
`struct hci_conn`	hci_core.h	表示一条蓝牙连接，包含连接句柄、链路类型、加密状态
`struct sk_buff`	skbuff.h	内核网络子系统通用数据包结构，蓝牙 HCI 帧通过它传递
`struct hci_cb`	hci_core.h	HCI 命令回调函数表，用于注册命令完成/状态事件处理

  关键路径：当用户空间通过 HCI 套接字发送一个 HCI 命令时，数据流为：

  用户空间 → HCI 套接字 → hci_send_cmd() → hci_dev->ops->send() → 传输驱动 → 硬件控制器

2.3 用户空间工具：bluetoothd、bluetoothctl、hciconfig

用户空间工具是调试蓝牙驱动和协议栈的第一道防线。三个核心工具各有侧重：bluetoothd 是后台守护进程，bluetoothctl 是交互式 CLI，hciconfig 是传统配置工具。

2.3.1 bluetoothd：核心守护进程

bluetoothd 是 BlueZ 的用户空间核心，负责管理适配器、设备、配对、连接以及所有 Profile 的注册与调度。它通过 D-Bus 对外暴露服务接口。

启动与调试常用命令：

# 启动 bluetoothd（前台调试模式，输出详细日志）
sudo bluetoothd -n -d

# 查看 bluetoothd 进程状态
ps aux | grep bluetoothd

# 查看 bluetoothd 日志（systemd 环境）
journalctl -u bluetooth -f

# 指定配置文件启动
sudo bluetoothd -C /etc/bluetooth/main.conf

调试注意：使用 -d 选项会启用所有调试类别（包括 HCI 数据包、L2CAP、RFCOMM 等），日志量极大。建议先使用 -d 确认问题范围，再针对性启用特定类别，如 -d HCI 或 -d L2CAP。

2.3.2 bluetoothctl：交互式调试利器

bluetoothctl 是当前首选的蓝牙调试 CLI 工具，支持交互式命令和脚本模式。它直接与 bluetoothd 的 D-Bus 接口通信。

常用调试命令序列：

# 进入交互模式
bluetoothctl

# 显示控制器信息
[bluetooth]# show

# 扫描设备
[bluetooth]# scan on

# 配对设备
[bluetooth]# pair XX:XX:XX:XX:XX:XX

# 连接设备
[bluetooth]# connect XX:XX:XX:XX:XX:XX

# 查看已配对设备列表
[bluetooth]# devices Paired

# 查看连接状态
[bluetooth]# info XX:XX:XX:XX:XX:XX

# 启用 HCI 日志跟踪（需要 bluetoothd 支持）
[bluetooth]# list-attributes
[bluetooth]# select-attribute /org/bluez/hci0
[bluetooth]# attribute-info

2.3.3 hciconfig：传统配置工具

hciconfig 是 BlueZ 早期版本的核心配置工具，在 5.x 版本中已被标记为“传统”，但在驱动调试中仍然非常有用，尤其是查看 HCI 设备原始状态和重置控制器。

命令	作用	调试场景
`hciconfig -a`	显示所有 HCI 设备详细信息	确认控制器是否被内核识别、驱动是否加载
`hciconfig hci0 up`	激活 HCI 设备	控制器被 down 掉后重新启用
`hciconfig hci0 down`	关闭 HCI 设备	模拟控制器断开或重置
`hciconfig hci0 reset`	发送 HCI_Reset 命令到控制器	控制器卡死或状态异常时恢复
`hciconfig hci0 name "MyDevice"`	设置本地设备名称	验证 HCI 命令通路是否正常
`hciconfig hci0 class 0x000100`	设置设备类别	测试 Class of Device 写入

实战建议：在调试新硬件驱动时，先用 hciconfig -a 确认控制器是否出现在 HCI 设备列表中。如果看不到 hci0，说明内核驱动加载或探测阶段已经失败，需要检查 dmesg 和驱动 probe 函数。

2.3.4 三工具对比总结

工具	通信方式	适用场景	调试优势	局限性
bluetoothd	D-Bus + HCI 套接字	后台服务、Profile 管理	完整的协议栈支持，可扩展	调试日志需重启进程
bluetoothctl	D-Bus	交互式调试、配对连接测试	实时反馈，命令补全，脚本支持	依赖 bluetoothd 运行
hciconfig	HCI 套接字 (直接)	底层 HCI 操作、控制器重置	不依赖 bluetoothd，可直接操作 HCI	功能有限，不支持 BLE 高级特性

2.4 本章小结

Linux 蓝牙子系统采用清晰的分层架构：

BlueZ 协议栈 是完整的开源实现，覆盖从控制器到应用的全部层次。
内核蓝牙子系统 位于 net/bluetooth/，以模块化方式实现 HCI 核心、L2CAP、RFCOMM 等协议，通过 struct hci_dev 管理控制器实例。
用户空间工具 三剑客各司其职：bluetoothd 负责后台管理，bluetoothctl 提供交互式调试，hciconfig 用于底层 HCI 操作。