BES IBRT SDK API详解:从编译到主副耳交互

需积分: 0 53 下载量 153 浏览量 更新于2024-08-04 1 收藏 1.62MB PDF 举报
"本文档详细介绍了BES官方的IBRT SDK相关API接口,适用于基于BES2300P系列芯片的蓝牙设备开发,涵盖了SDK编译、默认UI配置、search UI、盒子动作处理接口、主副耳命令传输、回连配置、入盒出盒判断以及主从切换接口等多个方面。" 1. **SDK编译** BES SDK的编译过程可以通过特定的make命令来完成。例如,对于best1400或best2300p平台,可以使用`make T=best1400_ibrt INTERSYS_DEBUG=1`或`make T=best2300p_ibrt INTERSYS_DEBUG=1`。`INTERSYS_DEBUG`开关用于开启内部调试功能。 2. **默认UI配置** 默认UI需要在代码中设置双方设备的地址。开发者需要将自身设备的地址添加到预设数组中,并在烧录时使用这些地址。开机后,长按左右耳键可进入配对模式,手机搜索并连接耳机播放音乐。 3. **Search UI** 当`IBRT_SEARCH_UI`被设置为1时,启用自定义配对界面。配对要求设备的高位三字节地址相同且名称一致。用户可以修改代码中的参数以满足具体需求。配对过程中,长按主耳键启动配对,双击主耳键进行搜索连接,听到“connected”提示音即表示已配对成功。 4. **盒子动作处理接口** 这些接口控制蓝牙设备的盒动作,如开盖、出盒、入盒和关盖。必须按照特定顺序调用接口以确保动作有效。如果在出盒状态下需要重新启动回连,可以使用`app_ibrt_ui_reconnect_event_test`接口。 5. **主副耳命令传输** 主副耳之间的命令传输基于BES私有协议。开发者需要提供所需的命令和发送处理函数,系统会自动处理传输。 6. **回连配置** 回连机制使用经典蓝牙,替代了之前的BLE回连方式。底层已实现回连流程,用户仅需调用指定动作,可以配置回连尝试次数。 7. **入盒出盒判断** 入盒和出盒事件由充电口的中断触发。`chargerin`中断对应入盒动作,`chargerout`中断对应出盒动作。相关处理代码需要与这些中断事件关联。 8. **蓝牙连接状态接口** 开发者可以根据蓝牙连接状态添加必要的接口以应对不同场景。 9. **OTA配置** 目前仅支持单boot升级,通过设置`OTA_BASIC?=1`启用。升级文件如`ota.bin`需要按照指定格式放置。 10. **主从切换接口** 提供了接口支持主从设备的角色切换,这对于TWS(True Wireless Stereo)耳机等应用尤为重要。 11. **超距回连** 在设备超出正常连接范围后,提供了回连机制,确保设备能重新找回连接。 以上是BES官方IBRT SDK提供的关键API接口,它们为开发者提供了完整的工具集,以实现蓝牙设备的高效开发和自定义功能。