准备工具
-
协议解析工具Wireshark,下载地址https://www.wireshark.org/download.html。
-
hci_dump.pklg文件,该文件由btstack示例程序运行时产生,此处可直接下载hci_dump.pklg。
说明
(以下内容摘抄自韦东山的《BLE协议.docx》)
运行BTStack程序时,会生成hci_dump.pklg文件,可以使用WireShark打开此文件。截图如下:
BTStack中涉及的数据有2类:
1.从硬件上获得的数据、发给硬件的数据
2.为更新系统状态而虚构的数据
1. 跟硬件相关的数据有4类:
① 发送给蓝牙控制器的Command
② 从蓝牙控制器获得的Event,蓝牙控制器收到Command后会回复Event
③ ACL数据,这涉及收、发两个方向
④ SCO数据,这涉及收、发两个方向
这4种数据类型,用一个头部信息来表示,参考bluetooth.h:
#define HCI_COMMAND_DATA_PACKET 0x01
#define HCI_ACL_DATA_PACKET 0x02
#define HCI_SCO_DATA_PACKET 0x03
#define HCI_EVENT_PACKET 0x04
但是在程序中,单凭这4个数值无法分辨数据的流高,比如ACL数据的类型是0x03,我们单凭0x03无法知道这数据是发给硬件、还是从硬件读到。为了便于调试,BTStack在打印Log信息时,把这些硬件数据类型转换为新数值:
参考函数: hci_dump_packetlogger_setup_header
1. Command : 0x00
2. Event: 0x01
3. ACL out 0x02
4. ACL in 0x03
5. SCO out 0x08
6. SCO in 0x09
7. Log Message 0xfc
2. 为更新系统状态而虚构的数据:
有很多种虚构的数据,下面举几个例子:
① 提示状态发生了变化:
在BTStack中,可能有很多层对hci_stack->state感兴趣,所以当hci_stack->state发生变化时,可以使用hci_emit_state发送一个虚拟的Event数据包,这会导致这些层的处理函数被调用。
在WireShark中看到的原始数据为:01 60 01 xx,第1个01表示Event,60表示BTSTACK_EVENT_STATE,第2个01表示数据长度为1, xx表示数据即state值。
② 当一个数据包已经成功发给硬件之后,我们要通知上层:你可以继续发送数据给硬件了。这通过hci_emit_transport_packet_sent函数来实现:
在WireShark中看到的原始数据为:01 6e 00,第1个01表示Event,6e表示HCI_EVENT_TRANSPORT_PACKET_SENT,00表示后续数据长度为0。