文章目录经典蓝牙 HCI 层详解一、HCI 概述二、HCI 的核心作用三、HCI 传输层Transport Layer1. HCI UARTH4 / H5 / BCSP2. HCI USB3. HCI SDIO / SPI四、HCI 数据包类型1. HCI Command Packet命令包2. HCI Event Packet事件包3. HCI ACL Data Packet异步数据包4. HCI SCO Data Packet同步数据包五、HCI 通信流程示例设备发现Inquiry流程ACL 连接建立流程六、HCI 配置与初始化七、HCI 与上层L2CAP的关系八、HCI 的流控机制1. Host → Controller 流控命令流控2. Host → Controller 数据流控ACL 流控3. Controller → Host 流控九、HCI 日志分析常用工具十、总结经典蓝牙 HCI 层详解一、HCI 概述HCIHost Controller Interface主机控制器接口是蓝牙协议栈中连接Host主机和Controller控制器的标准化接口层。┌─────────────────────────────────────────┐ │ Application │ ├─────────────────────────────────────────┤ │ Profiles (GAP/GATT等) │ ├─────────────────────────────────────────┤ │ Host Layer │ │ ┌─────────┐ ┌─────────┐ ┌──────────┐ │ │ │ L2CAP │ │ ATT │ │ SMP │ │ │ └────┬────┘ └─────────┘ └──────────┘ │ │ │ │ │ ┌────┴────────────────────────────────┐│ │ │ HCI 层 ││ ←── 本文重点 │ └────┬────────────────────────────────┘│ ├───────┼─────────────────────────────────┤ │ │ Controller Layer │ │ ┌────┴────┐ ┌─────────┐ ┌──────────┐ │ │ │ LL │ │ PHY │ │ Baseband │ │ │ └─────────┘ └─────────┘ └──────────┘ │ └─────────────────────────────────────────┘二、HCI 的核心作用功能说明命令下发Host 通过 HCI 向 Controller 发送控制命令如查询设备、建立连接等事件上报Controller 通过 HCI 向 Host 上报异步事件如连接完成、数据到达等数据传输承载 ACL异步和 SCO同步数据包的双向传输状态同步维护 Host 与 Controller 之间的状态一致性三、HCI 传输层Transport LayerHCI 定义了多种物理传输方式最常见的是1. HCI UARTH4 / H5 / BCSPH4最常用简单字节流无流控H5带软件流控和错误恢复BCSP博通私有协议带重传机制UART 帧格式H4 ┌────────┬────────────────────────────┐ │ 类型(1B)│ 数据载荷 │ │ 0x01Cmd│ │ │ 0x02ACL│ │ │ 0x03SCO│ │ │ 0x04Evt│ │ └────────┴────────────────────────────┘2. HCI USB使用 USB 的 Interrupt、Bulk、Isoc 端点适合高带宽场景如蓝牙适配器3. HCI SDIO / SPI用于嵌入式系统集成在 SoC 内部四、HCI 数据包类型HCI 定义了4 种基本数据包类型1. HCI Command Packet命令包方向Host → Controller用途Host 发送控制指令格式┌──────────┬──────────┬────────────────┐ │ OCF(10b) │ OGF(6b) │ Parameter(s) │ │ 命令字段 │ 命令组 │ 参数 │ └──────────┴──────────┴────────────────┘ ↓ 组合成 16-bit Opcode常见命令组OGFOGF命令组示例命令0x01Link ControlInquiry、Create Connection0x02Link PolicyWrite Link Policy Settings0x03Host Controller BasebandReset、Set Event Mask0x04Informational ParametersRead Local Version0x05Status ParametersRead RSSI0x06Testing CommandsEnable Device Under Test Mode2. HCI Event Packet事件包方向Controller → Host用途Controller 异步通知 Host格式┌──────────┬──────────┬────────────────┐ │ Event Code(1B) │ Param Len(1B) │ Parameters │ └──────────┴──────────┴────────────────┘常见事件Event Code事件名称触发场景0x01Inquiry Complete设备搜索完成0x03Connection Complete连接建立完成0x05Disconnection Complete连接断开0x0ECommand Complete命令执行完成0x0FCommand Status命令状态返回0x13Number Of Completed Packets数据包发送完成确认3. HCI ACL Data Packet异步数据包方向双向Host ↔ Controller用途传输 L2CAP 层数据如文件传输、网络数据格式┌────────────┬──────────┬────────────┬──────────────┐ │ Handle(12b)│ PB(2b) │ BC(2b) │ Data Length │ │ 连接句柄 │ 包边界 │ 广播标志 │ (2B) │ └────────────┴──────────┴────────────┴──────────────┘PBPacket Boundary标志00首包Start of L2CAP PDU01续包Continuation10首包自动刷新可启用4. HCI SCO Data Packet同步数据包方向双向用途传输语音等实时同步数据如蓝牙耳机通话特点固定速率、低延迟、不重传┌────────────┬──────────┬──────────────┐ │ Handle(12b)│ Status │ Data Length │ │ 连接句柄 │ (4b) │ (1B) │ └────────────┴──────────┴──────────────┘五、HCI 通信流程示例设备发现Inquiry流程Host Controller │ │ │ ─── HCI_Inquiry ─────────────── │ │ [OGF0x01, OCF0x0001] │ │ │ │ ── HCI_Command_Status_Event ─── │ │ [StatusPending] │ │ │ │ ── HCI_Inquiry_Result_Event ─── │ │ [BD_ADDR, Class of Device] │ │ │ │ ── HCI_Inquiry_Result_Event ─── │ │ [BD_ADDR, Class of Device] │ │ │ │ ── HCI_Inquiry_Complete_Event ─ │ │ [StatusSuccess] │ │ │ACL 连接建立流程Host Controller │ │ │ ─── HCI_Create_Connection ──── │ │ [BD_ADDR, Packet_Type, etc] │ │ │ │ ── HCI_Command_Status_Event ─── │ │ │ │ ── HCI_Connection_Complete ─── │ │ [Status, Connection_Handle] │ │ │ │ ─── HCI_Accept_Connection_Request │ (如果是被动连接) │六、HCI 配置与初始化典型的蓝牙 Host 初始化序列1. HCI_Reset → 复位 Controller 2. HCI_Read_Local_Version_Information → 读取版本信息 3. HCI_Read_Local_Supported_Commands → 读取支持的命令 4. HCI_Read_Local_Supported_Features → 读取支持的功能特性 5. HCI_Set_Event_Mask → 设置感兴趣的事件掩码 6. HCI_Write_Class_Of_Device → 设置设备类型 7. HCI_Write_Local_Name → 设置蓝牙名称 8. HCI_Write_Scan_Enable → 设置可发现/可连接模式七、HCI 与上层L2CAP的关系┌─────────────────────────────────┐ │ L2CAP │ │ ┌─────────┐ ┌──────────────┐ │ │ │ Channel │ │ SDU/PDU │ │ │ │ 管理 │ │ 重组/分片 │ │ │ └────┬────┘ └──────┬───────┘ │ │ │ │ │ │ └──────┬───────┘ │ │ ▼ │ │ ┌─────────────────────────────┐ │ │ │ L2CAP → HCI 数据映射 │ │ │ │ (CID → Connection Handle) │ │ │ └─────────────┬───────────────┘ │ └────────────────┼──────────────────┘ ▼ ┌──────────────┐ │ HCI │ │ ACL Data │ └──────────────┘关键点L2CAP 使用CIDChannel ID标识逻辑通道HCI 使用Connection Handle标识物理/逻辑链路L2CAP 的 PDU 可能分片为多个 HCI ACL 包传输八、HCI 的流控机制1. Host → Controller 流控命令流控通过HCI_Command_Status_Event和HCI_Command_Complete_Event确认Controller 有命令缓冲区Host 需等待确认再发2. Host → Controller 数据流控ACL 流控Packet-based基于包数量的流控Host 查询HCI_Read_Buffer_Size获取 Controller 缓冲区大小Controller 通过HCI_Number_Of_Completed_Packets_Event报告释放的缓冲区Data-block-based基于数据块大小的流控可选3. Controller → Host 流控Host 通过HCI_Set_Host_Controller_To_Host_Flow_Control启用通过HCI_Host_Buffer_Size和HCI_Host_Number_Of_Completed_Packets实现九、HCI 日志分析常用工具工具用途btmonBlueZLinux 蓝牙监控实时抓取 HCI 日志Frontline BPA专业蓝牙协议分析仪Ellisys高端蓝牙抓包工具Wireshark可解析 HCI 日志需配合适配器btmon 示例输出$sudobtmonHCI Event: Command Complete(0x0e)plen4Read Local Supported Features(0x04|0x0003)ncmd1Status: Success(0x00)Features: 0xbf 0xfe 0xcf 0xfe 0xdb 0xff 0x7b 0x87十、总结特性说明标准化由蓝牙核心规范Core Specification严格定义松耦合Host 和 Controller 可独立开发、升级灵活性支持多种物理传输层UART/USB/SDIO可扩展通过 Vendor Specific 命令支持厂商扩展HCI 层是理解蓝牙协议栈的关键它将复杂的底层射频操作抽象为简单的命令/事件/数据接口使得上层应用开发无需关心基带和链路层的具体实现。
文章目录经典蓝牙 HCI 层详解一、HCI 概述二、HCI 的核心作用三、HCI 传输层Transport Layer1. HCI UARTH4 / H5 / BCSP2. HCI USB3. HCI SDIO / SPI四、HCI 数据包类型1. HCI Command Packet命令包2. HCI Event Packet事件包3. HCI ACL Data Packet异步数据包4. HCI SCO Data Packet同步数据包五、HCI 通信流程示例设备发现Inquiry流程ACL 连接建立流程六、HCI 配置与初始化七、HCI 与上层L2CAP的关系八、HCI 的流控机制1. Host → Controller 流控命令流控2. Host → Controller 数据流控ACL 流控3. Controller → Host 流控九、HCI 日志分析常用工具十、总结经典蓝牙 HCI 层详解一、HCI 概述HCIHost Controller Interface主机控制器接口是蓝牙协议栈中连接Host主机和Controller控制器的标准化接口层。┌─────────────────────────────────────────┐ │ Application │ ├─────────────────────────────────────────┤ │ Profiles (GAP/GATT等) │ ├─────────────────────────────────────────┤ │ Host Layer │ │ ┌─────────┐ ┌─────────┐ ┌──────────┐ │ │ │ L2CAP │ │ ATT │ │ SMP │ │ │ └────┬────┘ └─────────┘ └──────────┘ │ │ │ │ │ ┌────┴────────────────────────────────┐│ │ │ HCI 层 ││ ←── 本文重点 │ └────┬────────────────────────────────┘│ ├───────┼─────────────────────────────────┤ │ │ Controller Layer │ │ ┌────┴────┐ ┌─────────┐ ┌──────────┐ │ │ │ LL │ │ PHY │ │ Baseband │ │ │ └─────────┘ └─────────┘ └──────────┘ │ └─────────────────────────────────────────┘二、HCI 的核心作用功能说明命令下发Host 通过 HCI 向 Controller 发送控制命令如查询设备、建立连接等事件上报Controller 通过 HCI 向 Host 上报异步事件如连接完成、数据到达等数据传输承载 ACL异步和 SCO同步数据包的双向传输状态同步维护 Host 与 Controller 之间的状态一致性三、HCI 传输层Transport LayerHCI 定义了多种物理传输方式最常见的是1. HCI UARTH4 / H5 / BCSPH4最常用简单字节流无流控H5带软件流控和错误恢复BCSP博通私有协议带重传机制UART 帧格式H4 ┌────────┬────────────────────────────┐ │ 类型(1B)│ 数据载荷 │ │ 0x01Cmd│ │ │ 0x02ACL│ │ │ 0x03SCO│ │ │ 0x04Evt│ │ └────────┴────────────────────────────┘2. HCI USB使用 USB 的 Interrupt、Bulk、Isoc 端点适合高带宽场景如蓝牙适配器3. HCI SDIO / SPI用于嵌入式系统集成在 SoC 内部四、HCI 数据包类型HCI 定义了4 种基本数据包类型1. HCI Command Packet命令包方向Host → Controller用途Host 发送控制指令格式┌──────────┬──────────┬────────────────┐ │ OCF(10b) │ OGF(6b) │ Parameter(s) │ │ 命令字段 │ 命令组 │ 参数 │ └──────────┴──────────┴────────────────┘ ↓ 组合成 16-bit Opcode常见命令组OGFOGF命令组示例命令0x01Link ControlInquiry、Create Connection0x02Link PolicyWrite Link Policy Settings0x03Host Controller BasebandReset、Set Event Mask0x04Informational ParametersRead Local Version0x05Status ParametersRead RSSI0x06Testing CommandsEnable Device Under Test Mode2. HCI Event Packet事件包方向Controller → Host用途Controller 异步通知 Host格式┌──────────┬──────────┬────────────────┐ │ Event Code(1B) │ Param Len(1B) │ Parameters │ └──────────┴──────────┴────────────────┘常见事件Event Code事件名称触发场景0x01Inquiry Complete设备搜索完成0x03Connection Complete连接建立完成0x05Disconnection Complete连接断开0x0ECommand Complete命令执行完成0x0FCommand Status命令状态返回0x13Number Of Completed Packets数据包发送完成确认3. HCI ACL Data Packet异步数据包方向双向Host ↔ Controller用途传输 L2CAP 层数据如文件传输、网络数据格式┌────────────┬──────────┬────────────┬──────────────┐ │ Handle(12b)│ PB(2b) │ BC(2b) │ Data Length │ │ 连接句柄 │ 包边界 │ 广播标志 │ (2B) │ └────────────┴──────────┴────────────┴──────────────┘PBPacket Boundary标志00首包Start of L2CAP PDU01续包Continuation10首包自动刷新可启用4. HCI SCO Data Packet同步数据包方向双向用途传输语音等实时同步数据如蓝牙耳机通话特点固定速率、低延迟、不重传┌────────────┬──────────┬──────────────┐ │ Handle(12b)│ Status │ Data Length │ │ 连接句柄 │ (4b) │ (1B) │ └────────────┴──────────┴──────────────┘五、HCI 通信流程示例设备发现Inquiry流程Host Controller │ │ │ ─── HCI_Inquiry ─────────────── │ │ [OGF0x01, OCF0x0001] │ │ │ │ ── HCI_Command_Status_Event ─── │ │ [StatusPending] │ │ │ │ ── HCI_Inquiry_Result_Event ─── │ │ [BD_ADDR, Class of Device] │ │ │ │ ── HCI_Inquiry_Result_Event ─── │ │ [BD_ADDR, Class of Device] │ │ │ │ ── HCI_Inquiry_Complete_Event ─ │ │ [StatusSuccess] │ │ │ACL 连接建立流程Host Controller │ │ │ ─── HCI_Create_Connection ──── │ │ [BD_ADDR, Packet_Type, etc] │ │ │ │ ── HCI_Command_Status_Event ─── │ │ │ │ ── HCI_Connection_Complete ─── │ │ [Status, Connection_Handle] │ │ │ │ ─── HCI_Accept_Connection_Request │ (如果是被动连接) │六、HCI 配置与初始化典型的蓝牙 Host 初始化序列1. HCI_Reset → 复位 Controller 2. HCI_Read_Local_Version_Information → 读取版本信息 3. HCI_Read_Local_Supported_Commands → 读取支持的命令 4. HCI_Read_Local_Supported_Features → 读取支持的功能特性 5. HCI_Set_Event_Mask → 设置感兴趣的事件掩码 6. HCI_Write_Class_Of_Device → 设置设备类型 7. HCI_Write_Local_Name → 设置蓝牙名称 8. HCI_Write_Scan_Enable → 设置可发现/可连接模式七、HCI 与上层L2CAP的关系┌─────────────────────────────────┐ │ L2CAP │ │ ┌─────────┐ ┌──────────────┐ │ │ │ Channel │ │ SDU/PDU │ │ │ │ 管理 │ │ 重组/分片 │ │ │ └────┬────┘ └──────┬───────┘ │ │ │ │ │ │ └──────┬───────┘ │ │ ▼ │ │ ┌─────────────────────────────┐ │ │ │ L2CAP → HCI 数据映射 │ │ │ │ (CID → Connection Handle) │ │ │ └─────────────┬───────────────┘ │ └────────────────┼──────────────────┘ ▼ ┌──────────────┐ │ HCI │ │ ACL Data │ └──────────────┘关键点L2CAP 使用CIDChannel ID标识逻辑通道HCI 使用Connection Handle标识物理/逻辑链路L2CAP 的 PDU 可能分片为多个 HCI ACL 包传输八、HCI 的流控机制1. Host → Controller 流控命令流控通过HCI_Command_Status_Event和HCI_Command_Complete_Event确认Controller 有命令缓冲区Host 需等待确认再发2. Host → Controller 数据流控ACL 流控Packet-based基于包数量的流控Host 查询HCI_Read_Buffer_Size获取 Controller 缓冲区大小Controller 通过HCI_Number_Of_Completed_Packets_Event报告释放的缓冲区Data-block-based基于数据块大小的流控可选3. Controller → Host 流控Host 通过HCI_Set_Host_Controller_To_Host_Flow_Control启用通过HCI_Host_Buffer_Size和HCI_Host_Number_Of_Completed_Packets实现九、HCI 日志分析常用工具工具用途btmonBlueZLinux 蓝牙监控实时抓取 HCI 日志Frontline BPA专业蓝牙协议分析仪Ellisys高端蓝牙抓包工具Wireshark可解析 HCI 日志需配合适配器btmon 示例输出$sudobtmonHCI Event: Command Complete(0x0e)plen4Read Local Supported Features(0x04|0x0003)ncmd1Status: Success(0x00)Features: 0xbf 0xfe 0xcf 0xfe 0xdb 0xff 0x7b 0x87十、总结特性说明标准化由蓝牙核心规范Core Specification严格定义松耦合Host 和 Controller 可独立开发、升级灵活性支持多种物理传输层UART/USB/SDIO可扩展通过 Vendor Specific 命令支持厂商扩展HCI 层是理解蓝牙协议栈的关键它将复杂的底层射频操作抽象为简单的命令/事件/数据接口使得上层应用开发无需关心基带和链路层的具体实现。
