Thursday, 13 August 2020 08:30

传统蓝牙HCI Command(蓝牙HCI命令)详细介绍 Featured

一. 声明

本专栏文章我们会以连载的方式持续更新,本专栏计划更新内容如下:

第一篇:蓝牙综合介绍 ,主要介绍蓝牙的一些概念,产生背景,发展轨迹,市面蓝牙介绍,以及蓝牙开发板介绍。

第二篇:Transport层介绍,主要介绍蓝牙协议栈跟蓝牙芯片之前的硬件传输协议,比如基于UART的H4,H5,BCSP,基于USB的H2等

第三篇:传统蓝牙controller介绍,主要介绍传统蓝牙芯片的介绍,包括射频层(RF),基带层(baseband),链路管理层(LMP)等

第四篇:传统蓝牙host介绍,主要介绍传统蓝牙的协议栈,比如HCI,L2CAP,SDP,RFCOMM,HFP,SPP,HID,AVDTP,AVCTP,A2DP,AVRCP,OBEX,PBAP,MAP等等一系列的协议吧。

第五篇:低功耗蓝牙controller介绍,主要介绍低功耗蓝牙芯片,包括物理层(PHY),链路层(LL)

第六篇:低功耗蓝牙host介绍,低功耗蓝牙协议栈的介绍,包括HCI,L2CAP,ATT,GATT,SM等

第七篇:蓝牙芯片介绍,主要介绍一些蓝牙芯片的初始化流程,基于HCI vendor command的扩展

第八篇:附录,主要介绍以上常用名词的介绍以及一些特殊流程的介绍等。

另外,开发板如下所示,对于想学习蓝牙协议栈的最好人手一套。以便更好的学习蓝牙协议栈,相信我,学完这一套视频你将拥有修改任何协议栈的能力(比如Linux下的bluez,Android下的bluedroid)。

------------------------------------------------------------------------------------------------------------------------------------------

CSDN学院链接(进入选择你想要学习的课程):https://edu.csdn.net/lecturer/5352?spm=1002.2001.3001.4144

蓝牙交流扣扣群:970324688

Github代码:https://github.com/sj15712795029/bluetooth_stack

入手开发板:https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4004-22329603896.18.5aeb41f973iStr&id=622836061708

------------------------------------------------------------------------------------------------------------------------------------------

二. 蓝牙HCI command汇总(部分)

在介绍蓝牙command之前我还是要啰嗦点,尽管前面的文章已经写了,但是不排除有人直接看到这份文档

HCI命令包用于从协议栈发送给芯片的命令。HCI命令包的格式如下图所示:

Opcode:每个命令被分配一个2字节的操作码(opcode),用来唯一地识别不同类型的命令,操作码(opcode)参数分为两个字段,称为操作码组字段(Opcode Group Field, OGF)和操作码命令字段(Opcode Command Field, OCF)。其中OGF占用高6bit字节,OCF占用低10bit字节。

一共有以下几组OGF:

1)Link Control commands, the OGF is defined as 0x01.链路控制OGF,也就是控制蓝牙芯片跟remote沟通的命令

2)Link Policy commands, the OGF is defined as 0x02,链路策略OGF,也就是写一些Policy,比如转换角色等

3)HCI Control and Baseband commands, the OGF is defined as 0x03,控制本地芯片跟基带的OGF。比如reset本地芯片等。

4)Informational Parameters commands, the OGF is defined as 0x04。读取信息的OGF,比如读取本地芯片的LMP版本呢,支持的command,蓝牙地址等,

5)status parameters commands, the OGF is defined as 0x05,状态参数OGF,比如读取RSSI等。

6)Testing commands, the OGF is defined as 0x06,测试命令的OGF,比如让芯片进入测试模式(DUT,device under test)

7)LE Controller commands, the OGF code is defined as 0x08,BLE 的comand

8)vendor-specific debug commands,the OGF code is defined as 0x3F,此部分是vendor定义的,也就是芯片厂商为了扩展core文档的HCI command定义

OCF众多,在每个OGF下都有一堆的OCF定义

Parameter Total Length后续参数的长度

Parameter:每个command的para不同,下个小节做说明

注意:HCI Command Packet的长度不能超过255(包括HCI Command包头)

下面我们就列下常用的一堆HCI command,待后续补充

传统蓝牙HCI 命令(部分)
列1 列2 列3 列4
OGF OCF 命令 命令描述
Link Control command(0x01) 0x0001 Inquiry command 让BR/EDR芯片进行搜索模式,搜索周边的BR/EDR设备
  0x0002 Inquiry Cancel command 如果BR/EDR芯片在搜索状态,那么停止BR/EDR芯片的搜索
  0x0003 Periodic Inquiry Mode command 让BR/EDR芯片进入周期搜索状态,但是此命令不常用,并且有的芯片会返回错误,所以不在此处扩展讲解
  0x0004 Exit Periodic Inquiry Mode command 让进入周期搜索状态的BR/EDR蓝牙芯片退出周期搜索状态
  0x0005 Create Connection command 根据参数跟特定的蓝牙地址创建连线
  0x0006 Disconnect command 根据参数跟特定的连接句柄断开连接,可以用来断开ACL,也可以用来断开SCO,eSCO等等
  0x0008 Create Connection Cancel command “连接中”的取消指令,此功能感觉比较鸡肋,同样我也没用过
  0x0009 Accept Connection Request command 接受连接请求
  0x000A Reject Connection Request command 拒绝连接请求
  0x000B Link Key Request Reply command 对方请求linkkey的时候,而我们有此link key,我们回复link key
  0x000C Link Key RequestNegative Reply command 对方请求linkkey的时候,而我们没有次link key的情形下回复
  0x000D PIN Code Request Reply command 用于应答芯片发送的pincode申请,并把pincode用于连线
  0x000E PIN Code RequestNegative Reply command 不能用于pincode连线
  0x000F Change Connection Packet Type command 改变正在连接的交互封包类型
  0x0011 Authentication Requested command 用于指令连接句柄的两个蓝牙地址进行身份认证
  0x0013 Set Connection Encryption command 建立或者取消连接层次的加密
  0x0015 Change Connection Link Key command 用于指定额链接句柄,生成一组新的link key
  0x0017 Master Link Key command 用于强制主设备使用主设备的临时或半永久link key
  0x0019 Remote Name Request command 获取远端设备名称
  0x001A Remote Name Request Cancel command 取消获取远端设备名称
  0x001B Read Remote Supported Features command 获取remote端支持的feature
  0x001C Read Remote Extended Features command 获取remote端支持的扩展feature
  0x001D Read Remote Version Information command 获取remote端版本信息,注意此部分是LMP或者LL的版本
  0x001F Read Clock Offset command 获取时钟偏移
  0x0020 Read LMP Handle command 获取LMP句柄
  0x0028 Setup Synchronous Connection command 建立SCO
  0x0029 Accept Synchronous Connection Request command 接受对方SCO建立请求
  0x002A Reject SynchronousConnection Request command 拒绝对方SCO建立请求
  0x002B IO Capability Request Reply command 当在SSP配对模式下,响应芯片IO capability的请求
  0x002C User Confirmation Request Reply command 当在SSP配对模式下,响应芯片IO User Confirmation的请求
  0x002D User Confirmation Request Negative Reply command 当在SSP配对模式下,拒绝芯片IO User Confirmation的请求
  0x0034 IO Capability RequestNegative Reply command 当在SSP配对模式下,拒绝芯片IO capability的请求
Link Policy commands (0x02) 0x0001 Hold Mode command 用于更改链接的行为,并让它将指定的Connection_Handle关联的ACL基带连接放置到Holdmode中
  0x0003 Sniff Mode command 用于改变该链接的行为管理并让它将与指定Connection_Handle关联的ACL基带连接置于嗅探模式
  0x0004 Exit Sniff Mode command 离开嗅探模式
  0x0007 QoS Setup command 用于为Connection_Handle指定服务质量参数
  0x0009 Role Discovery command 查询当前的连线芯片处于什么角色
  0x000B Switch Role command 进行角色切换
  0x000C Read Link Policy Settings command 读取当前connection_handle的连接策略
  0x000D Write Link Policy Settings command 改变当前连线的连接策略
  0x000E Read Default Link Policy Settings command  读取默认的连接策略
  0x000F Write Default Link Policy Settings command 改变当前默认的连接策略
  0x0010 Flow Specification command 用于指定通过Connection_Handle标识的ACL Connection_Handle传输的流量的流参数
  0x0011 Sniff Subrating command 为给定链接指定用于嗅探子例程的参数
Control and Baseband commands(0x03) 0x0001 Set Event Mask command 用于控制HCI为主机生成哪些事件
  0x0003 Reset command reset蓝牙芯片(软复位)
  0x0005 Set Event Filter command 设置事件过滤
  0x0008 Flush command 丢弃芯片中正在等待传输的数据
  0x0009 Read PIN Type command 读取PIN 类型
  0x000A Write PIN Type command 写PIN类型
  0x000D Read Stored Link Key command 读取芯片中存储的Link key
  0x0011 Write Stored Link Key command 把link key写入到芯片中
  0x0012 Delete Stored Link Key command 删除芯片中的Link key
  0x0013 Write Local Name command 写入本地名称到芯片中
  0x0014 Read Local Name command 读取芯片的蓝牙名称
  0x0015 Read Connection Accept Timeout command 读取蓝牙连接接收的超时时间
  0x0016 Write Connection Accept Timeout command 写入蓝牙连接接收的超时时间
  0x0017 Read Page Timeout command 读取page的超时时间
  0x0018 Write Page Timeout command 写page的超时时间
  0x0019 Read Scan Enable command 读取scan enable
  0x001A Write Scan Enable command 写scan enable
  0x001B Read Page Scan Activity command 读取Page Scan Activity
  0x0023 Read Class of Device command 读取芯片的cod
  0x0024 Write Class of Device command 把cod写入cod
  0x0025 Read Voice Setting command 读取voice setting
  0x0026 Write Voice Setting command 把voice setting写入到芯片
  0x0031 Set Controller To Host Flow Control command 启动HCI 流控
  0x0033 Host Buffer Size command 把buffer size写入到芯片中
  0x0036 Read Link Supervision Timeout command 读取Link Supervision timeout时间(也就是Link lost时间)
  0x0037 Write Link Supervision Timeout command 把Link Supervision timeout写入到芯片(也就是Link lost时间)
  0x0044 Read Inquiry Mode command 读取芯片的搜索模式
  0x0045 Write Inquiry Mode command 把搜索模式写入到芯片中
  0x0051 Read Extended Inquiry Response command 读取芯片的Extended inquiry response
  0x0052 Write Extended Inquiry Response command 把Extended inquiry response写入到芯片
  0x0055 Read Simple Pairing Mode command 读取芯片是否支持SSP
  0x0056 Write Simple Pairing Mode command 把是否支持SSP写入到蓝牙芯片
Informational Parameters commands
(0x04)
0x0001 Read Local Version Information command 读取本地芯片的LMP version
  0x0002 Read Local Supported Commands command 读取本地芯片支持的command
  0x0003 Read Local Supported Features command 读取本地芯片支持的feature
  0x0004 Read Local Extended Features command 读取本地芯片支持的扩展feature
  0x0005 Read Buffer Size command 读取本地芯片的buffer size
  0x0009 Read BD_ADDR command 读取本地芯片的蓝牙地址
  0x000A Read Data Block Size command 读取本地芯片的block size
  0x000B/D Read Local Supported Codecs command 读取本地芯片支持的编码格式
  0x000C Read Local Simple Pairing Options command 读取本地SSP选项
  0x000E Read Local Supported Codec Capabilities command 读取本地芯片支持的codec capabilities
status parameters commands
(0x05)
0x0003 Read Link Quality command 读取连接质量
  0x0005 Read RSSI command 读取接收信号强度
  0x0007 Read Clock command 读取clock
Testing commands
(0x06)
0x0001 Read Loopback Mode command 去读loopback模式
  0x0002 Write Loopback Mode command 写loopback模式
  0x0003 Enable Device Under Test Mode command 使设备进去测试模式
Read 10430 times