N32WB03x蓝牙芯片API详解与功能指南

本篇文档详细介绍了国民技术N32WB03x系列蓝牙系统级芯片（System-on-Chip, SoC）的API函数指南，旨在帮助开发者更快地理解和运用这些API进行蓝牙低功耗（BLE）应用程序的开发。文档涵盖了蓝牙应用模块、蓝牙安全加密模块以及软件定时器的相关部分。 **蓝牙应用模块**： 1. **NS_BLE_STACK_INIT**：初始化蓝牙栈，为后续功能的使用奠定基础。 2. **NS_BLE_GAP_INIT**：设置通用属性 profile (GAP) 的参数，如设备地址、连接参数等。 3. **NS_BLE_ADD_PRF_FUNC_REGISTER**：注册自定义服务或特性函数，以便与蓝牙设备交互。 4. **NS_BLE_PRF_TASK_REGISTER**：注册任务处理函数，管理蓝牙任务的执行。 5. **PRF_GET_ITF_FUNC_REGISTER**：获取接口函数注册，用于访问特定功能。 6. **NS_BLE_ADV_INIT** 和相关函数（如NS_BLE_ADV_START, NS_BLE_ADV_STOP）：控制广播广告模式，包括设置广告数据和扫描响应数据。 7. **NS_BLE_SCAN_INIT** 和扫描相关操作，如NS_BLE_START_SCAN 和 NS_BLE_STOP_SCAN，用于设备搜索和连接。 8. **NS_BLE_MTU_SET**：设置最大传输单元（MTU），影响数据传输效率。 9. **NS_BLE_PHY_SET**：配置物理层参数，如数据率和编码方案。 10. **NS_BLE_ACTIVE_RSSI**：获取设备的实时接收信号强度指示（RSSI）。 11. **NS_BLE_DISCONNECT**：发起或处理蓝牙断开连接事件。 12. **NS_BLE_DLE_SET**：设置数据链路层特性，如数据包分割和确认机制。 13. **RF_TX_POWER_SET**：设置发送功率，控制通信范围。 **蓝牙安全加密模块**： 这部分API专注于蓝牙设备的安全性，如： - **NS_SEC_INIT**：初始化蓝牙安全功能，包括设置安全参数。 - **NS_SEC_GET_BOND_STATUS**：查询设备的绑定状态。 - **NS_SEC_GET_IOCAP**：获取设备支持的鉴权间隔（IO Capability）。 - **NS_SEC_BOND_DB_ERASE_ALL**：清除所有绑定数据库。 - **NS_SEC_SEND_SECURITY_REQ**：发送安全请求，如配对请求。 - **NS_SEC_BOND_STORE_EVT_HANDLER**：处理绑定事件的回调函数。 **软件定时器**： 1. **NS_TIMER_CREATE**：创建定时器，用于异步事件的调度。 2. **NS_TIMER_MODIFY**：修改定时器属性。 3. **NS_TIMER_CANCEL**：取消或停止定时器，释放系统资源。 通过这个详细的API指南，开发者可以迅速上手N32WB03x芯片，提高蓝牙应用的开发效率，确保产品的稳定性和安全性。同时，文档结构清晰，每个函数都有明确的功能说明，方便查阅和理解。在实际开发过程中，结合芯片的硬件特性和应用场景，合理调用这些API，将有助于实现高效、可靠的蓝牙通信。