前言

概述

BS2X发布版本中蓝牙和星闪SDK接口变化说明。

产品版本

与本文档对应的产品版本如下。

产品名称

产品版本

BS2X

V100

读者对象

本文档主要适用以下工程师：

  • 技术支持工程师

  • 软件开发工程师

符号约定

在本文中可能出现下列标志，它们所代表的含义如下。

符号

说明

表示如不避免则将会导致死亡或严重伤害的具有高等级风险的危害。

表示如不避免则可能导致死亡或严重伤害的具有中等级风险的危害。

表示如不避免则可能导致轻微或中度伤害的具有低等级风险的危害。

用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。

“须知”不涉及人身伤害。

对正文中重点信息的补充说明。

“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。

修改记录

文档版本

发布日期

修改说明

01

2025-05-30

更新“BLE SDK接口变更说明”章节的表1。

00B01

2024-06-18

第一次临时版本发布。

BLE SDK接口变更说明

表 1 BLE接口变更说明

SDK版本

头文件

修改内容

1.0.11

bts_device_manager.h
  1. 添加power_on回调，表明双核中B核是否上电
  2. 将enable/disable ble接口和回调移动至此文件

1.0.11

bts_le_gap.h
  1. 添加设置扩展广播参数接口
  2. 添加获取bond设备接口
  3. 添加设置NV接口（暂未开放）
  4. 添加设置rssi接口

1.0.12

bts_le_gap.h

将ble广播参数的结构体gap_ble_adv_params_t的tx_power参数类型从uint32_t 变更为int8_t

1.0.12

bts_le_gap.h
  1. 修改设置NV接口（添加index入参）
  2. 添加errcode_t gap_ble_set_save_smp_keys_mode(uint8_t is_available)接口，设置是否支持用户设置NV
  3. 添加gap_ble_save_pair_keys_mode_switch_t枚举

1.0.12

bts_le_gap.h
  1. 添加errcode_t gap_ble_add_white_list(const bd_addr_t *addr)

    errcode_t gap_ble_remove_white_list(const bd_addr_t *addr)

    errcode_t gap_ble_get_white_list(void)接口

  2. 添加typedef void (*gap_ble_get_white_list_callback)(uint8_t count, bd_addr_t *addr_list)回调

1.0.12

bts_le_gap.h

pair_complete_cb中添加keymissing错误码

1.0.12

bts_le_gap.h
  1. 首次配对先上报认证完成回调，后上报配对完成回调
  2. 回连只上报配对完成回调

1.0.12

bts_low_latency.h

新增set em data方法和回调

1.0.16

bts_le_gap.h

新增gap_ble_set_scan_extern_parameters接口

表 2 SLE接口变更说明

SDK版本

头文件

修改内容

1.0.11

sle_transmition_manager.h

添加QOS队列

1.0.11

sle_ssap_client.h

ssapc_find_structure方法的ssapc_find_structure_param_t中type成员变量参考枚举从ssap_find_type_t改为ssap_property_type_t

1.0.11

sle_ota.h

新增sle ota头文件

1.0.11

sle_low_latency.h
  1. tx和rx回调函数参数len由uint16_t改为uint8_t
  2. 添加sle_low_latency_rx_get_data获取rx数据

1.0.11

sle_device_manager.h
  1. 添加power_on回调，表明双核中B核是否上电
  2. 将enable/disable sle接口和回调移动至此文件

1.0.11

sle_device_discovery.h

添加删除广播接口和回调

1.0.11

sle_connection_manager.h
  1. 添加获取连接为G/T节点接口
  2. 添加获取bond设备接口
  3. 添加设置NV接口（暂未开放）
  4. 添加白名单逻辑
  5. 添加取消连接接口
  6. 添加设置rssi接口
  7. 添加断开所有连接接口

1.0.12

sle_ssap_server.h

添加收到来自客户端的cfm响应接口：indicate_cfm_cb

1.0.12

sle_connection_manager.h

新增set channel map接口

1.0.12

sle_connection_manager.h
  1. 修改设置NV接口（添加index入参）
  2. 添加errcode_t sle_set_save_pair_keys_mode(uint8_t is_available)接口，设置是否支持用户设置NV
  3. 添加sle_save_smp_keys_mode_switch_t枚举

1.0.12

sle_connection_manager.h

pair_complete_cb中添加keymissing错误码

1.0.12

sle_low_latency.h
  1. 新增set em data方法和回调
  2. 修改原有low latency回调