传统蓝牙HCI Command（蓝牙HCI命令）详细介绍

一. 声明

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

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

第二篇: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	使设备进去测试模式