cc2640r2f:hci
差别
这里会显示出您选择的修订版和当前版本之间的差别。
|
cc2640r2f:hci [2017/09/11 22:07] wuyl |
cc2640r2f:hci [2021/06/22 23:14] |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | < | ||
| - | # Host 控制接口（ HCI ） # | ||
| - | |||
| - | 主控制器接口（ HCI ）层是在蓝牙协议栈的主机( Host )和控制器( controller )之间传送命令和事件的薄层。在纯网络处理器应用程序（即 host_test 项目）中，HCI 层通过 SPI 或 UART 等传输协议实现数据处理。 | ||
| - | |||
| - | 类似 simple_peripheral 的嵌入式无线MCU项目中，HCI 层通过无线 MCU 内的函数调用和回调来实现通信。所有与 Controller 进行通信的命令和事件（如 ATT 、GAP 等）将最终称为 HCI API，从协议栈的 Host 通过 HCI 层传递到 Controller。同样，控制器通过 HCI 将接收到的数据和事件发送到 Host 上层。 | ||
| - | |||
| - | 除了标准的蓝牙 LE HCI 命令之外，还有许多 HCI 扩展供应商特定的命令可以扩展控制器的一些功能。有关在嵌入式应用程序中调用的可用 HCI 和 HCI 扩展命令的描述，请参阅 BLE Stack API。 | ||
| - | |||
| - | BLE5-Stack 支持纯网络处理器配置（ host_test ），即允许应用程序在外部 MCU 上运行以连接到 BLE5-Stack 。网络处理器可以通过外部传输协议（ UART、 SPI 等）接受所有 LE HCI 命令。由于 BLE Controller 和 Host 都驻留在无线 MCU 上，一些 HCI 命令会使对应的事件被 TI BLE 主机消耗。因此，不可能使用标准 HCI LE 命令将外部的蓝牙主机与 CC2640 无线 MCU 进行接口连接。网络处理器配置应使用 HCI 和 TI 供应商特定的 HCI 命令来实现外部蓝牙应用。 | ||
| - | |||
| - | 类似于网络处理器配置（ host_test ），BLE5-Stack 可以被配置为使用子集 HCI 命令，可用的 HCI 命令的子集是执行蓝牙 RF 认证的子集。HCI 命令通过 UASRT、SPI传递给控制器，从而能够切换到完整的嵌入式应用，此配置称为生产测试模式（ PTM ）。有关如何在嵌入式应用程序上启用 PTM 的信息，请参阅使用生产测试模式（ PTM ）。 | ||
| - | |||
| - | 当需要满足以下条件时，应考虑将 PTM 用于直接测试模式（ DTM ），以代替完整的网络处理器配置（ host_test ）: | ||
| - | |||
| - | - 在生产过程中设备只会烧写一次 FLASH ，并且固件镜像无法再更改 | ||
| - | |||
| - | - HCI 传输层 FLASH 可用，在应用程序中 PTM 需要 FLASH ，因此减少应用程序 FLASH | ||
| - | |||
| - | < 注意: BLE5-Stack 也支持直接测试模式（ DTM ）。DTM 在蓝牙核心规范版本 5.0 的直接测试模式部分（[第 6 卷，第 F 部分））中有详细描述。Host_test 支持所有 DTM 命令以及供应商特定的调制解调器测试命令。有关如何设置用于定制产品和芯片包类型的 host_test 应用程序二进制文件的信息，请参阅配置 CC2640 的蓝牙直接测试模式（ SWRA530 ）。 | ||
| - | |||
| - | ## 在应用程序中使用 HCI 和 HCI 供应商特定的命令 ## | ||
| - | |||
| - | 按照以下步骤使用这些命令并在应用程序中接收各自的事件： | ||
| - | |||
| - | 1. 包括 HCI 传输层头文件。 | ||
| - | |||
| - | ````C | ||
| - | `# | ||
| - | ```` | ||
| - | |||
| - | 2. 注册用于 HCI/Host 消息的 GAP，以便从控制器接收事件。这应该在应用程序初始化函数中完成。 | ||
| - | |||
| - | ````C | ||
| - | //注册 GAP 用于 HCI / | ||
| - | GAP_RegisterForMsgs （selfEntity ）; | ||
| - | ```` | ||
| - | |||
| - | 3. 应用程序能调用 HCI 或 HCI 特定于供应商的命令。请参阅 BLE Stack API Reference，HCI 部分具体介绍可以发送哪些命令。 | ||
| - | |||
| - | 4. 作为 HCI_GAP_EVENT_EVENT 的任务间消息返回 HCI 事件 。请参阅 simple_peripheral 项目。 | ||
| - | |||
| - | 以下部分讨论接收 HCI 事件和 HCI 供应商特定的事件。 | ||
| - | |||
| - | ## 标准 LE HCI 命令和事件 ## | ||
| - | |||
| - | 这些命令在“ 蓝牙核心规范版本 5.0 ”的“ HCI 命令和事件”一章（第 2 卷，第 E 部分，第 7 节）中有记录。使用这些命令的机制与蓝牙核心规范版本 5.0 中的任何命令相同，包括 HCI LE 命令。 | ||
| - | |||
| - | 下面的示例演示了如何使用蓝牙核心规范版本 5.0 在应用程序中实现 HCI 命令，使用的命令是读 RSSI 命令。 | ||
| - | |||
| - | ### 发送 HCI 命令 ### | ||
| - | |||
| - | 1. 如图 1 在蓝牙核心规范版本 5.0 中查找命令： | ||
| - | |||
| - | 。 | ||
| - | |||
| - | 3. 使用步骤 1 中的 API ，填写参数并从应用程序的某处调用命令。在形成连接后，应该调用此特定命令。这里只有一个参数：一个 2 字节的连接句柄。本例连接句柄是 0x0000： | ||
| - | |||
| - | ````C | ||
| - | `HCI_ReadRssiCmd （0x0000）; | ||
| - | ```` | ||
| - | |||
| - | ### 接收 HCI event ### | ||
| - | |||
| - | < 注意: | ||
| - | |||
| - | 1.如图 2 ，查看蓝牙核心规范版本 5.0 以查看返回事件的格式： | ||
| - | |||
| - |  | ||
| - | { | ||
| - | | ||
| - | | ||
| - | { | ||
| - | case HCI_GAP_EVENT_EVENT: | ||
| - | { | ||
| - | // Process HCI message | ||
| - | | ||
| - | { | ||
| - | // Process HCI Vendor Specific Command Complete Event | ||
| - | case HCI_VE_EVENT_CODE: | ||
| - | { | ||
| - | // Parse Command Complete Event for opcode and status | ||
| - | hciEvt_VSCmdComplete_t* command_complete = (hciEvt_VSCmdComplete_t*)pMsg; | ||
| - | |||
| - | // Find which command this command complete is for | ||
| - | switch(command_complete-> | ||
| - | { | ||
| - | case HCI_EXT_PER: | ||
| - | { | ||
| - | uint8_t status = command_complete-> | ||
| - | if (status == SUCCESS) | ||
| - | { | ||
| - | | ||
| - | |||
| - | if (cmdVal == 1) //if we were reading packet error rate | ||
| - | { | ||
| - | uint16_t numPkts = BUILD_UINT16(command_complete-> | ||
| - | uint16_t numCrcErr = BUILD_UINT16(command_complete-> | ||
| - | uint16_t numEvents = BUILD_UINT16(command_complete-> | ||
| - | uint16_t numMissedEvents = BUILD_UINT16(command_complete-> | ||
| - | |||
| - | ```` | ||
| - | |||
| - | 首先，检查堆栈消息的状态以查看它是什么类型的 HCI 事件，本例是一个 HCI_VE_EVENT_CODE。接下来，把它作为消息（ pMsg）从堆栈返回的事件转换为 hciEvt_VSCmdComplete_t ，其定义为： | ||
| - | |||
| - | ````C | ||
| - | typedef struct | ||
| - | { | ||
| - | | ||
| - | | ||
| - | } hciEvt_VSCmdComplete_t; | ||
| - | ```` | ||
| - | |||
| - | 通过读取 command_complete -> cmdOpcode 来检查操作码，并发现它与 HCI_EXT_PER 匹配。 | ||
| - | |||
| - | 接下来，解析* pEventParam 并提取事件 API 中定义的参数。前两个字节（图 6 中以红色显示）是事件操作码（ 0x1404 ），第三个字节是状态。所有供应商特定事件都是这种情况。 | ||
| - | |||
| - | 从 pEventParam 的第四个字节，第三个参数开始，使用“ TI BLE 供应商指南”中的事件 API 进行解析。所有供应商特定事件都是这种情况。对于此示例， pEventParam 的第四个字节对应于 cmdVal 参数。pEventParam 在存储器中的显示如下图 6 。 | ||
| - | |||
| - | ![](http:// | ||
| - | |||
| - | 图6. 存储器中的字节参数 | ||
| - | |||
| - | 通过读取事件参数的第三个字节（ command_complete -> pEventParam [2]）来检查状态。图 6 中以黄色显示。 | ||
| - | |||
| - | 从事件参数（ command_complete -> pEventParam [3]）的第四个字节开始，事件 API 指出下一个参数是一个字节的 cmdVal。cmdVal 用来验证该事件是否对应于 PER 计数器的读取，显示为粉色。 | ||
| - | |||
| - | 使用事件 API 继续解析，下一个参数是两个字节的 numPkts 。这是通过在事件参数的第五和第六个字节中构建一个 uint16_t 来找到的，显示为蓝色。以类似的方式，从第七和八个字节的事件参数（绿色显示）中找到 numCrcErr。 | ||
| - | |||
| - | 接下来，从事件参数的第九和第十个字节找到 numEvents（以橙色显示）。最后，从事件参数的第十一和第十二个字节找到 numMissedEvents（以紫色显示）。 | ||
| - | |||
| - | ## 加入我们 ## | ||
| - | |||
| - | 文章所有代码、工具、文档开源。加入我们[**QQ群 591679055**](http:// | ||
| - | <div> | ||
| - | <p align=" | ||
| - | <a target=" | ||
| - | © Copyright 2017, 成都乐控畅联科技有限公司. | ||
| - | </p> | ||
| - | </ | ||
| - | |||
| - | </ | ||
cc2640r2f/hci.txt · 最后更改: 2021/06/22 23:14 (外部编辑)
除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
