BlueNRG-LP v3.x 协议栈主要事件列表与含义解析
📡本文总结了 BlueNRG-LP v3.x BLE 协议栈 中支持的主要事件，涵盖 GAP、L2CAP、GATT Server/Client 以及 Controller 层事件，可用于开发者在 hci_user_evt_proc() 回调中进行事件解析、状态机驱动和逻辑控制。
🔗 GAP（通用访问配置）模块事件
| 事件名称 | 事件含义 |
|---|---|
HCI_LE_CONNECTION_COMPLETE_EVENT | BLE 连接建立成功 |
HCI_DISCONNECTION_COMPLETE_EVENT | BLE 连接断开 |
HCI_LE_ADVERTISING_REPORT_EVENT | 接收到广播包（扫描模式下） |
ACI_GAP_PROC_COMPLETE_EVENT | 扫描/连接过程完成 |
ACI_GAP_PAIRING_COMPLETE_EVENT | 配对过程完成 |
ACI_GAP_PASS_KEY_REQ_EVENT | 请求用户输入配对 PIN |
ACI_GAP_BOND_LOST_EVENT | Bond 信息丢失，需重新配对 |
🔄 L2CAP（逻辑链路控制和适配协议）模块事件
| 事件名称 | 事件含义 |
|---|---|
ACI_L2CAP_CONNECTION_UPDATE_REQ_EVENT | 从设备请求连接参数更新 |
ACI_L2CAP_CONNECTION_UPDATE_RESP_EVENT | 主设备响应连接参数更新 |
ACI_L2CAP_PROC_TIMEOUT_EVENT | 连接参数更新超时 |
📡 GATT Server（服务端）事件
| 事件名称 | 事件含义 |
|---|---|
ACI_GATT_SRV_ATTRIBUTE_MODIFIED_EVENT | 客户端写入某个属性值（Notify 或 Write） |
ACI_GATT_SRV_READ_EVENT | 客户端请求读取属性（回调处理） |
ACI_GATT_SRV_WRITE_EVENT | 客户端写入属性（回调处理） |
ACI_GATT_SRV_CONFIRMATION_EVENT | 客户端确认收到 Indication |
📲 GATT Client（客户端）事件
| 事件名称 | 事件含义 |
|---|---|
ACI_GATT_CLT_NOTIFICATION_EVENT | 接收到服务端 Notify 数据 |
ACI_GATT_CLT_INDICATION_EVENT | 接收到服务端 Indication 数据 |
ACI_GATT_CLT_PROC_COMPLETE_EVENT | GATT 操作完成（如读、写、发现等） |
ACI_GATT_CLT_ERROR_RESP_EVENT | GATT 操作出错（如读写失败） |
🧩 Controller（控制器）事件
| 事件名称 | 事件含义 |
|---|---|
HCI_HARDWARE_ERROR_EVENT | 硬件异常，可能需复位 BLE 模块 |
HCI_AUTHENTICATED_PAYLOAD_TIMEOUT_EXPIRED_EVENT | 安全链路认证数据超时 |
ACI_HAL_FW_ERROR_EVENT | 协议栈内部错误（需根据参数进一步判断） |
✅ 应用建议
这些事件是构建 BLE 应用逻辑的重要基础，建议你在 hci_user_evt_proc() 回调函数中集中处理，并结合事件驱动的 有限状态机（FSM） 实现模块行为管理。例如：
-
接收
HCI_LE_CONNECTION_COMPLETE_EVENT后切换至已连接状态； -
接收到
ACI_GATT_SRV_ATTRIBUTE_MODIFIED_EVENT后解析属性数据； -
ACI_GAP_PAIRING_COMPLETE_EVENT可结合配对状态更新安全机制。
🧠 结语
掌握这些核心事件，有助于你快速开发稳定可靠的 BLE 应用系统。建议结合 AT 命令系统、URC 通知机制以及状态机进行事件响应处理，构建清晰、可控的架构。
如需进一步了解 FSM 架构设计、事件队列管理与 BLE API 调用，可参考以下推荐文章：
-
《BlueNRG-LP BLE 状态机设计思路》
-
《BLE 协议栈事件驱动机制详解》
-
《嵌入式系统中如何构建事件响应架构》