Connection#

Connection 提供 SLE(Star Flash Low Energy)连接管理、设备发现与传输管理能力,覆盖连接/断开、配对、连接参数更新、PHY/MCS 设置、设备公开(announce)、扫描(seek)以及传输繁忙回调等接口。

模块公共头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"
#include "include/middleware/services/bts/sle/sle_device_discovery.h"
#include "include/middleware/services/bts/sle/sle_transmition_manager.h"

接口清单#

接口名称

功能简述

sle_connect_remote_device

向对端设备发起连接请求

sle_create_connection_cancel

取消正在进行的连接创建过程

sle_set_connect_rssi

设置连接使用的 RSSI 门限值

sle_disconnect_remote_device

向对端设备发起断开连接请求

sle_disconnect_all_remote_device

断开所有已建立的连接

sle_update_connect_param

发送连接参数更新请求

sle_pair_remote_device

向对端设备发起配对请求

sle_remove_paired_remote_device

删除指定地址设备的配对信息

sle_remove_all_pairs

删除所有配对信息

sle_get_paired_devices_num

获取已配对设备数量

sle_get_connect_role

获取指定连接的链路角色

sle_get_paired_devices

获取已配对设备地址列表

sle_get_bonded_devices

获取已绑定设备地址列表

sle_set_nv_smp_keys

设置 NV 中保存的 SMP 密钥

sle_get_pair_state

获取指定设备的配对状态

sle_read_remote_device_rssi

读取对端设备 RSSI 值

sle_set_acb_evt_param

设置 ACB 链路重传参数

sle_read_access_filter_list_size

查询访问过滤器列表剩余大小

sle_clear_access_filter_list

清空访问过滤器列表

sle_add_device_to_access_filter_list

将地址加入访问过滤器列表

sle_remove_device_from_access_filter_list

将地址从访问过滤器列表移除

sle_set_phy_param

设置指定连接的 PHY 参数

sle_set_save_pair_keys_mode

设置配对密钥保存模式

sle_set_mcs

设置指定连接的调制与编码策略

sle_set_data_len

设置连接链路偏好最大传输 payload 字节数

sle_default_connection_param_set

设置默认连接参数

sle_connection_register_callbacks

注册连接管理回调函数

sle_customize_max_pwr

配置 BLE 与 SLE 最大功率定制化信息

sle_set_local_addr

设置本地设备地址

sle_get_local_addr

获取本地设备地址

sle_set_local_name

设置本地设备名称

sle_get_local_name

获取本地设备名称

sle_set_announce_data

设置设备公开数据

sle_remove_announce

删除指定设备公开实例

sle_set_announce_param

设置设备公开参数

sle_start_announce

启动指定设备公开实例

sle_stop_announce

停止指定设备公开实例

sle_set_seek_param

设置设备发现扫描参数

sle_start_seek

启动设备发现扫描

sle_stop_seek

停止设备发现扫描

sle_announce_seek_register_callbacks

注册设备公开与扫描回调函数

sle_transmission_signal_capability_req

发送连接管理能力查询请求

sle_transmission_register_callbacks

注册传输管理回调函数

Functions#

sle_connect_remote_device #

errcode_t sle_connect_remote_device(const sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 向指定地址的对端设备发送 SLE 连接请求。

  • 连接状态改变结果通过已注册的 sle_connect_state_changed_callback 回调返回。

  • 调用结果以错误码形式同步返回。

前置条件

  • 调用时序约束:调用前需先调用 sle_connection_register_callbacks 注册连接状态回调。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

对端设备地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

连接请求成功发起

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

sle_create_connection_cancel #

errcode_t sle_create_connection_cancel(void)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 取消当前正在进行的连接创建过程。

  • 终止由 sle_connect_remote_device 发起的连接流程。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:需在 sle_connect_remote_device 已发起连接但尚未完成时调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

取消连接创建成功

Other

其他错误码,参考errcode_t

执行失败

sle_set_connect_rssi #

errcode_t sle_set_connect_rssi(int8_t rssi)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置连接过程使用的 RSSI 门限值。

  • 用于在连接建立阶段对信号强度进行过滤。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

rssi

int8_t

连接 RSSI 门限值,单位 dBm

-127 ~ 20

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

sle_disconnect_remote_device #

errcode_t sle_disconnect_remote_device(const sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 向指定地址的对端设备发送断开连接请求。

  • 断链结果通过已注册的 sle_connect_state_changed_callback 回调返回。

  • 调用结果以错误码形式同步返回。

前置条件

  • 调用时序约束:目标设备需已建立连接。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

对端设备地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

断开连接请求成功发起

Other

其他错误码,参考errcode_t

执行失败

sle_disconnect_all_remote_device #

errcode_t sle_disconnect_all_remote_device(void)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 断开所有已建立的 SLE 连接。

  • 各连接的断链结果通过已注册的 sle_connect_state_changed_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:需在存在已建立连接时调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

断开所有连接成功

Other

其他错误码,参考errcode_t

执行失败

sle_update_connect_param #

errcode_t sle_update_connect_param(sle_connection_param_update_t *params)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 向对端设备发送连接参数更新请求。

  • 更新结果通过已注册的 sle_connect_param_update_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:目标连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

params

sle_connection_param_update_t *

连接参数更新请求

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

更新请求成功发起

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_pair_remote_device #

errcode_t sle_pair_remote_device(const sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 向指定地址的对端设备发送配对请求。

  • 配对完成结果通过已注册的 sle_pair_complete_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:目标设备需已建立连接。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

对端设备地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

配对请求成功发起

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

sle_remove_paired_remote_device #

errcode_t sle_remove_paired_remote_device(const sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 删除指定地址设备的配对信息。

  • 删除结果通过已注册的 sle_pair_remove_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:目标设备需已完成配对。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

对端设备地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

删除配对成功

Other

其他错误码,参考errcode_t

执行失败

sle_remove_all_pairs #

errcode_t sle_remove_all_pairs(void)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 删除所有已配对设备的配对信息。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

删除所有配对成功

Other

其他错误码,参考errcode_t

执行失败

sle_get_paired_devices_num #

errcode_t sle_get_paired_devices_num(uint16_t *number)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 获取当前已配对设备的数量。

  • 数量通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

出参

名称

数据类型

输出说明

number

uint16_t *

已配对设备数量,由调用方分配内存、函数填充

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_get_connect_role #

errcode_t sle_get_connect_role(uint16_t conn_id, uint8_t *role)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 获取指定连接的链路角色(G 节点或 T 节点)。

  • 角色结果通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

出参

名称

数据类型

输出说明

role

uint8_t *

链路角色,取值参考 sle_link_role_t,由调用方分配内存、函数填充

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_get_paired_devices #

errcode_t sle_get_paired_devices(sle_addr_t *addr, uint16_t *number)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 获取已配对设备的地址列表。

  • 地址列表与设备数量通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

出参

名称

数据类型

输出说明

addr

sle_addr_t *

已配对设备地址链表,由调用方分配内存、函数填充

number

uint16_t *

入参为调用方分配的地址容量,出参为实际填充的设备数量

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_get_bonded_devices #

errcode_t sle_get_bonded_devices(sle_addr_t *addr, uint16_t *number)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 获取已绑定设备的地址列表。

  • 地址列表与设备数量通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

出参

名称

数据类型

输出说明

addr

sle_addr_t *

已绑定设备地址链表,由调用方分配内存、函数填充

number

uint16_t *

入参为调用方分配的地址容量,出参为实际填充的设备数量

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_set_nv_smp_keys #

errcode_t sle_set_nv_smp_keys(sle_auth_info_evt_t *keys, sle_addr_t *own_addr, sle_addr_t *peer_addr, uint8_t index)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置 NV 中保存的 SMP 密钥信息。

  • 同时记录本端地址、对端地址与索引下标。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:需在配对/认证流程获得密钥后调用。

  • 依赖关系:依赖 SLE 协议栈与 NV 存储已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

keys

sle_auth_info_evt_t *

链路密钥与算法信息

不为 NULL

own_addr

sle_addr_t *

本端设备地址

不为 NULL

peer_addr

sle_addr_t *

对端设备地址

不为 NULL

index

uint8_t

密钥索引下标

0 ~ 255

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

sle_get_pair_state #

errcode_t sle_get_pair_state(const sle_addr_t *addr, uint8_t *state)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 获取指定地址设备的配对状态。

  • 配对状态通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

设备地址

不为 NULL

出参

名称

数据类型

输出说明

state

uint8_t *

配对状态,取值参考 sle_pair_state_t,由调用方分配内存、函数填充

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_read_remote_device_rssi #

errcode_t sle_read_remote_device_rssi(uint16_t conn_id)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 读取指定连接对端设备的 RSSI 值。

  • RSSI 读取结果通过已注册的 sle_read_rssi_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

读取请求成功发起

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

sle_set_acb_evt_param #

errcode_t sle_set_acb_evt_param(uint16_t conn_id, uint16_t evt_intv, uint8_t evt_num)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置指定连接的 ACB 链路重传间隔与重传次数。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

evt_intv

uint16_t

重传间隔

0 ~ 65535

evt_num

uint8_t

重传次数

0 ~ 255

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

sle_read_access_filter_list_size #

errcode_t sle_read_access_filter_list_size(uint8_t *size)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 查询访问过滤器列表的剩余可容纳大小。

  • 剩余大小通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

出参

名称

数据类型

输出说明

size

uint8_t *

访问过滤器列表剩余大小,由调用方分配内存、函数填充

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

查询成功

Other

其他错误码,参考errcode_t

执行失败

sle_clear_access_filter_list #

errcode_t sle_clear_access_filter_list(void)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 清空访问过滤器列表中的所有地址。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

清空成功

Other

其他错误码,参考errcode_t

执行失败

sle_add_device_to_access_filter_list #

errcode_t sle_add_device_to_access_filter_list(sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 将指定地址加入访问过滤器列表。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成、访问过滤器列表有剩余空间。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

待加入地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

添加成功

Other

其他错误码,参考errcode_t

执行失败

sle_remove_device_from_access_filter_list #

errcode_t sle_remove_device_from_access_filter_list(sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 将指定地址从访问过滤器列表中移除。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

待移除地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

移除成功

Other

其他错误码,参考errcode_t

执行失败

sle_set_phy_param #

errcode_t sle_set_phy_param(uint16_t conn_id, sle_set_phy_t *param)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置指定连接的 PHY 参数,包括无线帧类型、PHY、导频密度与反馈类型等。

  • 设置结果通过已注册的 sle_set_phy_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

param

sle_set_phy_t *

PHY 参数

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

设置请求成功发起

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_set_save_pair_keys_mode #

errcode_t sle_set_save_pair_keys_mode(uint8_t is_available)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置配对密钥的保存模式(自动保存或手动保存)。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

is_available

uint8_t

配对密钥保存模式

SLE_SAVE_SMP_KEYS_AUTO:0;
SLE_SAVE_SMP_KEYS_MANU:1。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

sle_set_mcs #

errcode_t sle_set_mcs(uint16_t conn_id, uint8_t mcs)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置指定连接的调制与编码策略(MCS)索引值。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

mcs

uint8_t

调制与编码策略索引值

0 ~ 255

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_set_data_len #

errcode_t sle_set_data_len(uint16_t conn_id, uint16_t tx_octets)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置指定连接链路上所偏好的最大传输 payload 字节数。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

tx_octets

uint16_t

偏好的最大传输 payload 字节数

0 ~ 65535

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_default_connection_param_set #

errcode_t sle_default_connection_param_set(sle_default_connect_param_t *set_param)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 设置 SLE 默认连接参数,包括过滤策略、扫描窗口、调度间隔与超时等。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:建议在发起连接之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

set_param

sle_default_connect_param_t *

默认连接参数

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_connection_register_callbacks #

errcode_t sle_connection_register_callbacks(sle_connection_callbacks_t *func)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 注册 SLE 连接管理回调函数集合。

  • 涵盖连接状态改变、参数更新、认证、配对、RSSI 读取、低时延、PHY 设置与取消配对等事件。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在发起连接/配对等相关操作之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

func

sle_connection_callbacks_t *

连接管理回调函数集合

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功注册

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_customize_max_pwr #

errcode_t sle_customize_max_pwr(int8_t ble_pwr, int8_t sle_pwr)

声明头文件

#include "include/middleware/services/bts/sle/sle_connection_manager.h"

功能说明

  • 配置 BLE 与 SLE 的最大功率定制化信息。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 NV 定制化配置模块已就绪。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

ble_pwr

int8_t

BLE 最大功率,单位 dBm

-127 ~ 20

sle_pwr

int8_t

SLE 最大功率,单位 dBm

-127 ~ 20

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功配置

Other

其他错误码,参考errcode_t

执行失败

sle_set_local_addr #

errcode_t sle_set_local_addr(sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 设置本地 SLE 设备地址。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在发起设备公开或扫描之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

addr

sle_addr_t *

本地设备地址

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

sle_get_local_addr #

errcode_t sle_get_local_addr(sle_addr_t *addr)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 获取本地 SLE 设备地址。

  • 地址通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

出参

名称

数据类型

输出说明

addr

sle_addr_t *

本地设备地址,由调用方分配内存、函数填充

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_set_local_name #

errcode_t sle_set_local_name(const uint8_t *name, uint8_t len)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 设置本地 SLE 设备名称。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在发起设备公开之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

name

const uint8_t *

本地设备名称

不为 NULL

len

uint8_t

设备名称长度,包括结束符 \0

0 ~ 255

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

sle_get_local_name #

errcode_t sle_get_local_name(uint8_t *name, uint8_t *len)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 获取本地 SLE 设备名称。

  • 名称与长度通过出参返回。

  • 调用结果以错误码形式返回。

前置条件

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

出参

名称

数据类型

输出说明

name

uint8_t *

本地设备名称,由调用方分配内存、函数填充

len

uint8_t *

入参为用户分配的缓冲区大小,出参为本地设备名称长度

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功获取

Other

其他错误码,参考errcode_t

执行失败

sle_set_announce_data #

errcode_t sle_set_announce_data(uint8_t announce_id, const sle_announce_data_t *data)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 设置指定设备公开实例的公开数据与扫描响应数据。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在 sle_start_announce 之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

announce_id

uint8_t

设备公开 ID

0 ~ SLE_ANNOUNCE_ID_MAX:16

data

sle_announce_data_t *

设备公开数据

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server_adv.c

sle_remove_announce #

errcode_t sle_remove_announce(uint8_t announce_id)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 删除指定的设备公开实例。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:目标设备公开实例需已停止。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

announce_id

uint8_t

设备公开 ID

0 ~ SLE_ANNOUNCE_ID_MAX:16

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功删除

Other

其他错误码,参考errcode_t

执行失败

sle_set_announce_param #

errcode_t sle_set_announce_param(uint8_t announce_id, const sle_announce_param_t *param)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 设置指定设备公开实例的参数,包括公开类型、G/T 角色、等级、间隔、信道与连接参数等。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在 sle_start_announce 之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

announce_id

uint8_t

设备公开 ID

0 ~ SLE_ANNOUNCE_ID_MAX:16

param

sle_announce_param_t *

设备公开参数

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server_adv.c

sle_start_announce #

errcode_t sle_start_announce(uint8_t announce_id)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 启动指定的设备公开实例。

  • 启动结果通过已注册的 sle_announce_enable_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:需先调用 sle_set_announce_param 与 sle_set_announce_data 完成参数与数据设置。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

announce_id

uint8_t

设备公开 ID

0 ~ SLE_ANNOUNCE_ID_MAX:16

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

启动请求成功发起

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server.c

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server_adv.c

sle_stop_announce #

errcode_t sle_stop_announce(uint8_t announce_id)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 停止指定的设备公开实例。

  • 停止结果通过已注册的 sle_announce_disable_callback 回调返回。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:目标设备公开实例需已启动。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

announce_id

uint8_t

设备公开 ID

0 ~ SLE_ANNOUNCE_ID_MAX:16

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

停止请求成功发起

Other

其他错误码,参考errcode_t

执行失败

sle_set_seek_param #

errcode_t sle_set_seek_param(sle_seek_param_t *param)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 设置设备发现扫描参数,包括地址类型、过滤策略、PHY、扫描类型、间隔与窗口等。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在 sle_start_seek 之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

param

sle_seek_param_t *

设备发现扫描参数

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功设置

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

sle_start_seek #

errcode_t sle_start_seek(void)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

前置条件

  • 调用时序约束:需先调用 sle_set_seek_param 完成扫描参数设置。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

启动扫描成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

sle_stop_seek #

errcode_t sle_stop_seek(void)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

前置条件

  • 调用时序约束:扫描需已启动。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

停止扫描成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

sle_announce_seek_register_callbacks #

errcode_t sle_announce_seek_register_callbacks(sle_announce_seek_callbacks_t *func)

声明头文件

#include "include/middleware/services/bts/sle/sle_device_discovery.h"

功能说明

  • 注册 SLE 设备公开与扫描的回调函数集合。

  • 涵盖设备公开使能/关闭/停止/删除、扫描使能/关闭、扫描结果上报与 dfr 等事件。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在发起设备公开或扫描之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

func

sle_announce_seek_callbacks_t *

设备公开与扫描回调函数集合

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功注册

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/bt/sle/sle_speed_client/src/sle_speed_client.c

  • src/application/samples/bt/sle/sle_speed_server/src/sle_speed_server_adv.c

sle_transmission_signal_capability_req #

errcode_t sle_transmission_signal_capability_req(uint16_t conn_id, sle_transmission_signal_capability_bit_t* param)

声明头文件

#include "include/middleware/services/bts/sle/sle_transmition_manager.h"

功能说明

  • 向对端发送连接管理能力查询请求。

  • 查询的能力信息通过入参指定。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:conn_id 对应的连接需已建立。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

conn_id

uint16_t

连接 ID

有效连接 ID

param

sle_transmission_signal_capability_bit_t *

查询的能力信息

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

查询请求成功发起

Other

其他错误码,参考errcode_t

执行失败

sle_transmission_register_callbacks #

errcode_t sle_transmission_register_callbacks(sle_transmission_callbacks_t *func)

声明头文件

#include "include/middleware/services/bts/sle/sle_transmition_manager.h"

功能说明

  • 注册 SLE 传输管理回调函数集合。

  • 涵盖传输数据繁忙状态事件。

  • 调用结果以错误码形式返回。

前置条件

  • 调用时序约束:应在进行传输数据收发之前调用。

  • 依赖关系:依赖 SLE 协议栈已初始化完成。

  • 上下文限制:需在主线程调用,禁止在中断上下文调用。

入参

名称

参数类型

说明

约束取值范围

func

sle_transmission_callbacks_t *

传输管理回调函数集合

不为 NULL

返回值

返回类型:errcode_t

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功执行

成功注册

Other

其他错误码,参考errcode_t

执行失败

Type definitions#

sle_connect_state_changed_callback #

typedef void (*sle_connect_state_changed_callback)(uint16_t conn_id, const sle_addr_t *addr,
    sle_acb_state_t conn_state, sle_pair_state_t pair_state, sle_disc_reason_t disc_reason);

使用说明

SLE 连接状态改变时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:连接建立/断开等状态改变时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,addr 为对端地址,conn_state 为连接状态,pair_state 为配对状态,disc_reason 为断链原因;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_connect_param_update_callback #

typedef void (*sle_connect_param_update_callback)(uint16_t conn_id, errcode_t status,
    const sle_connection_param_update_evt_t *param);

使用说明

连接参数更新完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:连接参数更新完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,status 为执行结果错误码,param 为更新后的连接参数;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_connect_param_update_req_callback #

typedef void (*sle_connect_param_update_req_callback)(uint16_t conn_id, errcode_t status,
    const sle_connection_param_update_req_t *param);

使用说明

连接参数更新请求完成前由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:连接参数更新请求完成前,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,status 为执行结果错误码,param 为连接参数更新请求;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_auth_complete_callback #

typedef void (*sle_auth_complete_callback)(uint16_t conn_id, const sle_addr_t *addr, errcode_t status,
    const sle_auth_info_evt_t* evt);

使用说明

认证完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:认证流程完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,addr 为对端地址,status 为执行结果错误码,evt 为认证事件信息;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_pair_complete_callback #

typedef void (*sle_pair_complete_callback)(uint16_t conn_id, const sle_addr_t *addr, errcode_t status);

使用说明

配对完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:配对流程完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,addr 为对端地址,status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_read_rssi_callback #

typedef void (*sle_read_rssi_callback)(uint16_t conn_id, int8_t rssi, errcode_t status);

使用说明

读取 RSSI 完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:调用 sle_read_remote_device_rssi 后读取完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,rssi 为读取到的 RSSI 值,status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值。

sle_low_latency_callback #

typedef void (*sle_low_latency_callback)(uint8_t status, sle_addr_t *addr, uint8_t rate);

使用说明

设置低时延完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:设置 low latency 完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:status 为设置结果,addr 为对端设备地址,rate 为鼠标回报率;

  • 返回值处理:返回类型为 void,无返回值。

sle_set_phy_callback #

typedef void (*sle_set_phy_callback)(uint16_t conn_id, errcode_t status, const sle_set_phy_t *param);

使用说明

设置 PHY 完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:调用 sle_set_phy_param 后设置完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:conn_id 为连接 ID,status 为设置结果,param 为当前 PHY 参数;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_pair_remove_callback #

typedef void (*sle_pair_remove_callback)(const sle_addr_t *addr, errcode_t status);

使用说明

取消单个设备配对完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:取消配对完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:addr 为地址,status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_announce_enable_callback #

typedef void (*sle_announce_enable_callback)(uint32_t announce_id, errcode_t status);

使用说明

设备公开使能完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:设备公开使能完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:announce_id 为公开 ID,status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值。

sle_announce_disable_callback #

typedef void (*sle_announce_disable_callback)(uint32_t announce_id, errcode_t status);

使用说明

设备公开关闭完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:设备公开关闭完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:announce_id 为公开 ID,status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值。

sle_announce_terminal_callback #

typedef void (*sle_announce_terminal_callback)(uint32_t announce_id);

使用说明

设备公开停止时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:设备公开停止时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:announce_id 为公开 ID;

  • 返回值处理:返回类型为 void,无返回值。

sle_announce_remove_callback #

typedef void (*sle_announce_remove_callback)(uint32_t announce_id, errcode_t status);

使用说明

删除广播完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:删除广播完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:announce_id 为公开 ID,status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值。

sle_start_seek_callback #

typedef void (*sle_start_seek_callback)(errcode_t status);

使用说明

扫描使能完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:扫描使能完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值。

sle_seek_disable_callback #

typedef void (*sle_seek_disable_callback)(errcode_t status);

使用说明

扫描关闭完成时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:扫描关闭完成时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:status 为执行结果错误码;

  • 返回值处理:返回类型为 void,无返回值。

sle_seek_result_callback #

typedef void (*sle_seek_result_callback)(sle_seek_result_info_t *seek_result_data);

使用说明

扫描结果上报时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:扫描到设备结果上报时,运行于 SLE service 线程,不能阻塞或长时间等待;

  • 参数语义:seek_result_data 为扫描结果数据;

  • 返回值处理:返回类型为 void,无返回值;指针由 SLE service 申请内存并由其释放,回调中不应释放。

sle_dfr_callback #

typedef void (*sle_dfr_callback)(void);

使用说明

SLE 协议栈 dfr 流程的通用回调函数类型。

回调说明:

  • 调用时机:SLE 协议栈 dfr 流程触发时;

  • 参数语义:无参数;

  • 返回值处理:返回类型为 void,无返回值。

sle_trans_data_busy_callback #

typedef void (*sle_trans_data_busy_callback)(uint16_t conn_id, sle_link_qos_state_t link_state);

使用说明

发送数据繁忙时由 SLE service 调用的事件回调函数类型。

回调说明:

  • 调用时机:发送数据繁忙状态变化时;

  • 参数语义:conn_id 为连接 ID,link_state 为链路状态;

  • 返回值处理:返回类型为 void,无返回值。

errcode_t #

typedef uint32_t errcode_t;

使用说明

本模块对外接口的返回值类型,表示接口执行结果错误码。

Enumerations#

sle_pair_state_t #

typedef enum {
    SLE_PAIR_NONE    = 0x01,
    SLE_PAIR_PAIRING = 0x02,
    SLE_PAIR_PAIRED  = 0x03
} sle_pair_state_t;

枚举成员

取值

描述

SLE_PAIR_NONE

0x01

未配对状态

SLE_PAIR_PAIRING

0x02

正在配对

SLE_PAIR_PAIRED

0x03

已完成配对

sle_disc_reason_t #

typedef enum {
    SLE_DISCONNECT_BY_REMOTE = 0x10,
    SLE_DISCONNECT_BY_LOCAL  = 0x11,
} sle_disc_reason_t;

枚举成员

取值

描述

SLE_DISCONNECT_BY_REMOTE

0x10

远端断链

SLE_DISCONNECT_BY_LOCAL

0x11

本端断链

sle_acb_state_t #

typedef enum {
    SLE_ACB_STATE_NONE          = 0x00,
    SLE_ACB_STATE_CONNECTED     = 0x01,
    SLE_ACB_STATE_DISCONNECTED  = 0x02,
} sle_acb_state_t;

枚举成员

取值

描述

SLE_ACB_STATE_NONE

0x00

SLE ACB 未连接状态

SLE_ACB_STATE_CONNECTED

0x01

SLE ACB 已连接

SLE_ACB_STATE_DISCONNECTED

0x02

SLE ACB 已断接

sle_crypto_algo_t #

typedef enum {
    SLE_CRYTO_ALGO_AC1     = 0x01,
    SLE_CRYTO_ALGO_AC2     = 0x02,
    SLE_CRYTO_ALGO_EA1     = 0x03,
    SLE_CRYTO_ALGO_EA2     = 0x04,
} sle_crypto_algo_t;

枚举成员

取值

描述

SLE_CRYTO_ALGO_AC1

0x01

AC1 加密算法类型

SLE_CRYTO_ALGO_AC2

0x02

AC2 加密算法类型

SLE_CRYTO_ALGO_EA1

0x03

EA1 加密算法类型

SLE_CRYTO_ALGO_EA2

0x04

EA2 加密算法类型

sle_key_deriv_algo_t #

typedef enum {
    SLE_KEY_DERIV_ALGO_HA1     = 0x01,
    SLE_KEY_DERIV_ALGO_HA2     = 0x02,
} sle_key_deriv_algo_t;

枚举成员

取值

描述

SLE_KEY_DERIV_ALGO_HA1

0x01

HA1 秘钥分发算法类型

SLE_KEY_DERIV_ALGO_HA2

0x02

HA2 秘钥分发算法类型

sle_integr_chk_ind_t #

typedef enum {
    SLE_ENCRYPTION_ENABLE_INTEGRITY_CHK_ENABLE      = 0x00,
    SLE_ENCRYPTION_DISABLE_INTEGRITY_CHK_ENABLE     = 0x01,
    SLE_ENCRYPTION_ENABLE_INTEGRITY_CHK_DISABLE     = 0x02,
    SLE_ENCRYPTION_DISABLE_INTEGRITY_CHK_DISABLE    = 0x03,
} sle_integr_chk_ind_t;

枚举成员

取值

描述

SLE_ENCRYPTION_ENABLE_INTEGRITY_CHK_ENABLE

0x00

加密和完整性保护同时启动

SLE_ENCRYPTION_DISABLE_INTEGRITY_CHK_ENABLE

0x01

不启动加密,启动完整性保护

SLE_ENCRYPTION_ENABLE_INTEGRITY_CHK_DISABLE

0x02

启动加密,不启动完整性保护

SLE_ENCRYPTION_DISABLE_INTEGRITY_CHK_DISABLE

0x03

不启动加密,不启动完整性保护

sle_bond_ind_t #

typedef enum {
    SLE_PAIR_NO_BOND      = 0x00,
    SLE_PAIR_NEED_BOND    = 0x01,
} sle_bond_ind_t;

枚举成员

取值

描述

SLE_PAIR_NO_BOND

0x00

星闪配对不需要绑定

SLE_PAIR_NEED_BOND

0x01

星闪配对需要绑定

sle_radio_frame_t #

typedef enum {
    SLE_RADIO_FRAME_1    = 0,
    SLE_RADIO_FRAME_2    = 1,
    SLE_RADIO_FRAME_3_M0 = 2,
    SLE_RADIO_FRAME_3_M1 = 3,
    SLE_RADIO_FRAME_3_M2 = 4,
    SLE_RADIO_FRAME_3_M3 = 5,
    SLE_RADIO_FRAME_3_M4 = 6,
    SLE_RADIO_FRAME_3_M5 = 7,
    SLE_RADIO_FRAME_4_M0 = 8,
    SLE_RADIO_FRAME_4_M1 = 9,
    SLE_RADIO_FRAME_4_M2 = 10,
    SLE_RADIO_FRAME_4_M3 = 11,
    SLE_RADIO_FRAME_4_M4 = 12,
    SLE_RADIO_FRAME_4_M5 = 13,
    SLE_RADIO_FRAME_END
} sle_radio_frame_t;

枚举成员

取值

描述

SLE_RADIO_FRAME_1

0

无线帧类型 1

SLE_RADIO_FRAME_2

1

无线帧类型 2

SLE_RADIO_FRAME_3_M0

2

无线帧类型 3,m 序列 0

SLE_RADIO_FRAME_3_M1

3

无线帧类型 3,m 序列 1

SLE_RADIO_FRAME_3_M2

4

无线帧类型 3,m 序列 2

SLE_RADIO_FRAME_3_M3

5

无线帧类型 3,m 序列 3

SLE_RADIO_FRAME_3_M4

6

无线帧类型 3,m 序列 4

SLE_RADIO_FRAME_3_M5

7

无线帧类型 3,m 序列 5

SLE_RADIO_FRAME_4_M0

8

无线帧类型 4,m 序列 0

SLE_RADIO_FRAME_4_M1

9

无线帧类型 4,m 序列 1

SLE_RADIO_FRAME_4_M2

10

无线帧类型 4,m 序列 2

SLE_RADIO_FRAME_4_M3

11

无线帧类型 4,m 序列 3

SLE_RADIO_FRAME_4_M4

12

无线帧类型 4,m 序列 4

SLE_RADIO_FRAME_4_M5

13

无线帧类型 4,m 序列 5

SLE_RADIO_FRAME_END

14

无线帧类型结束标志

sle_phy_tx_rx_t #

typedef enum {
    SLE_PHY_1M = 0x0,
    SLE_PHY_2M = 0x1,
    SLE_PHY_4M = 0x2,
    SLE_PHY_SUPPORT_NUM,
} sle_phy_tx_rx_t;

枚举成员

取值

描述

SLE_PHY_1M

0x0

1M PHY

SLE_PHY_2M

0x1

2M PHY

SLE_PHY_4M

0x2

4M PHY

SLE_PHY_SUPPORT_NUM

0x3

PHY 支持数量

sle_phy_tx_rx_pilot_density_t #

typedef enum {
    SLE_PHY_PILOT_DENSITY_4_TO_1  = 0x0,
    SLE_PHY_PILOT_DENSITY_8_TO_1  = 0x1,
    SLE_PHY_PILOT_DENSITY_16_TO_1 = 0x2,
    SLE_PHY_PILOT_DENSITY_NO = 0x3,
    SLE_PHY_PILOT_DENSITY_NUM,
} sle_phy_tx_rx_pilot_density_t;

枚举成员

取值

描述

SLE_PHY_PILOT_DENSITY_4_TO_1

0x0

导频密度为 4:1

SLE_PHY_PILOT_DENSITY_8_TO_1

0x1

导频密度为 8:1

SLE_PHY_PILOT_DENSITY_16_TO_1

0x2

导频密度为 16:1

SLE_PHY_PILOT_DENSITY_NO

0x3

无导频

SLE_PHY_PILOT_DENSITY_NUM

0x4

导频密度数量

sle_save_smp_keys_mode_switch_t #

typedef enum {
    SLE_SAVE_SMP_KEYS_AUTO = 0x00,
    SLE_SAVE_SMP_KEYS_MANU = 0x01,
} sle_save_smp_keys_mode_switch_t;

枚举成员

取值

描述

SLE_SAVE_SMP_KEYS_AUTO

0x00

秘钥自动保存

SLE_SAVE_SMP_KEYS_MANU

0x01

秘钥用户手动保存

sle_announce_level_t #

typedef enum {
    SLE_ANNOUNCE_LEVEL_NONE,
    SLE_ANNOUNCE_LEVEL_NORMAL,
    SLE_ANNOUNCE_LEVEL_PRIORITY,
    SLE_ANNOUNCE_LEVEL_PAIRED,
    SLE_ANNOUNCE_LEVEL_SPECIAL,
} sle_announce_level_t;

枚举成员

取值

描述

SLE_ANNOUNCE_LEVEL_NONE

0

不可见发现,预留

SLE_ANNOUNCE_LEVEL_NORMAL

1

一般可发现

SLE_ANNOUNCE_LEVEL_PRIORITY

2

优先可发现,预留

SLE_ANNOUNCE_LEVEL_PAIRED

3

被曾配对过的设备发现,预留

SLE_ANNOUNCE_LEVEL_SPECIAL

4

被指定设备发现

sle_announce_gt_role_t #

typedef enum {
    SLE_ANNOUNCE_ROLE_T_CAN_NEGO = 0,
    SLE_ANNOUNCE_ROLE_G_CAN_NEGO,
    SLE_ANNOUNCE_ROLE_T_NO_NEGO,
    SLE_ANNOUNCE_ROLE_G_NO_NEGO
} sle_announce_gt_role_t;

枚举成员

取值

描述

SLE_ANNOUNCE_ROLE_T_CAN_NEGO

0

期望做 T 可协商

SLE_ANNOUNCE_ROLE_G_CAN_NEGO

1

期望做 G 可协商

SLE_ANNOUNCE_ROLE_T_NO_NEGO

2

期望做 T 不可协商

SLE_ANNOUNCE_ROLE_G_NO_NEGO

3

期望做 G 不可协商

sle_announce_mode_t #

typedef enum {
    SLE_ANNOUNCE_MODE_NONCONN_NONSCAN      = 0x00,
    SLE_ANNOUNCE_MODE_CONNECTABLE_NONSCAN  = 0x01,
    SLE_ANNOUNCE_MODE_NONCONN_SCANABLE     = 0x02,
    SLE_ANNOUNCE_MODE_CONNECTABLE_SCANABLE = 0x03,
    SLE_ANNOUNCE_MODE_CONNECTABLE_DIRECTED = 0x07,
} sle_announce_mode_t;

枚举成员

取值

描述

SLE_ANNOUNCE_MODE_NONCONN_NONSCAN

0x00

不可连接不可扫描

SLE_ANNOUNCE_MODE_CONNECTABLE_NONSCAN

0x01

可连接不可扫描

SLE_ANNOUNCE_MODE_NONCONN_SCANABLE

0x02

不可连接可扫描

SLE_ANNOUNCE_MODE_CONNECTABLE_SCANABLE

0x03

可连接可扫描

SLE_ANNOUNCE_MODE_CONNECTABLE_DIRECTED

0x07

可连接可扫描定向

sle_seek_phy_t #

typedef enum {
    SLE_SEEK_PHY_1M = 0x1,
    SLE_SEEK_PHY_2M = 0x2,
    SLE_SEEK_PHY_4M = 0x4,
} sle_seek_phy_t;

枚举成员

取值

描述

SLE_SEEK_PHY_1M

0x1

1M PHY

SLE_SEEK_PHY_2M

0x2

2M PHY

SLE_SEEK_PHY_4M

0x4

4M PHY

sle_seek_type_t #

typedef enum {
    SLE_SEEK_PASSIVE = 0x00,
    SLE_SEEK_ACTIVE  = 0x01,
} sle_seek_type_t;

枚举成员

取值

描述

SLE_SEEK_PASSIVE

0x00

被动扫描

SLE_SEEK_ACTIVE

0x01

主动扫描

sle_seek_filter_t #

typedef enum {
    SLE_SEEK_FILTER_ALLOW_ALL   = 0x00,
    SLE_SEEK_FILTER_ALLOW_WLST  = 0x01,
} sle_seek_filter_t;

枚举成员

取值

描述

SLE_SEEK_FILTER_ALLOW_ALL

0x00

允许来自任何人的设备发现数据包

SLE_SEEK_FILTER_ALLOW_WLST

0x01

允许来自白名单设备的设备发现数据包,预留

sle_addr_type_t #

typedef enum {
    SLE_ADDRESS_TYPE_PUBLIC = 0,
    SLE_ADDRESS_TYPE_RANDOM = 6,
} sle_addr_type_t;

枚举成员

取值

描述

SLE_ADDRESS_TYPE_PUBLIC

0

公有地址

SLE_ADDRESS_TYPE_RANDOM

6

随机地址

使用说明

SLE 设备地址类型,作为 sle_addr_t 成员 type 的取值。

Structures#

sle_connection_param_update_req_t #

typedef struct {
    uint16_t interval_min;
    uint16_t interval_max;
    uint16_t max_latency;
    uint16_t supervision_timeout;
} sle_connection_param_update_req_t;

成员说明

成员名称

数据类型

描述

interval_min

uint16_t

链路调度最小间隔,单位 slot

interval_max

uint16_t

链路调度最大间隔,单位 slot

max_latency

uint16_t

延迟周期,单位 slot

supervision_timeout

uint16_t

超时时间,单位 10ms

sle_connection_param_update_t #

typedef struct {
    uint16_t conn_id;
    uint16_t interval_min;
    uint16_t interval_max;
    uint16_t max_latency;
    uint16_t supervision_timeout;
} sle_connection_param_update_t;

成员说明

成员名称

数据类型

描述

conn_id

uint16_t

连接 ID

interval_min

uint16_t

链路调度最小间隔,单位 slot

interval_max

uint16_t

链路调度最大间隔,单位 slot

max_latency

uint16_t

延迟周期,单位 slot

supervision_timeout

uint16_t

超时时间,单位 10ms

sle_connection_param_update_evt_t #

typedef struct {
    uint16_t interval;
    uint16_t latency;
    uint16_t supervision;
} sle_connection_param_update_evt_t;

成员说明

成员名称

数据类型

描述

interval

uint16_t

链路调度间隔,单位 slot

latency

uint16_t

延迟周期,单位 slot

supervision

uint16_t

超时时间,单位 10ms

sle_auth_info_evt_t #

typedef struct {
    uint8_t link_key[SLE_LINK_KEY_LEN];
    uint8_t crypto_algo;
    uint8_t key_deriv_algo;
    uint8_t integr_chk_ind;
    uint8_t is_bond;
} sle_auth_info_evt_t;

成员说明

成员名称

数据类型

描述

link_key

uint8_t[]

链路密钥,长度为 SLE_LINK_KEY_LEN:16

crypto_algo

uint8_t

加密算法类型,参考 sle_crypto_algo_t

key_deriv_algo

uint8_t

秘钥分发算法类型,参考 sle_key_deriv_algo_t

integr_chk_ind

uint8_t

完整性校验指示,参考 sle_integr_chk_ind_t

is_bond

uint8_t

配对绑定指示,参考 sle_bond_ind_t

sle_set_phy_t #

typedef struct {
    uint8_t tx_format;
    uint8_t rx_format;
    uint8_t tx_phy;
    uint8_t rx_phy;
    uint8_t tx_pilot_density;
    uint8_t rx_pilot_density;
    uint8_t g_feedback;
    uint8_t t_feedback;
} sle_set_phy_t;

成员说明

成员名称

数据类型

描述

tx_format

uint8_t

发送无线帧类型,参考 sle_radio_frame_t

rx_format

uint8_t

接收无线帧类型,参考 sle_radio_frame_t

tx_phy

uint8_t

发送 PHY,参考 sle_phy_tx_rx_t

rx_phy

uint8_t

接收 PHY,参考 sle_phy_tx_rx_t

tx_pilot_density

uint8_t

发送导频密度指示,参考 sle_phy_tx_rx_pilot_density_t

rx_pilot_density

uint8_t

接收导频密度指示,参考 sle_phy_tx_rx_pilot_density_t

g_feedback

uint8_t

先发链路反馈类型指示,取值范围 0-63

t_feedback

uint8_t

后发链路反馈类型指示,取值范围 0-7

sle_default_connect_param_t #

typedef struct {
    uint8_t  enable_filter_policy;
    uint8_t  initiate_phys;
    uint8_t  gt_negotiate;
    uint16_t scan_interval;
    uint16_t scan_window;
    uint16_t min_interval;
    uint16_t max_interval;
    uint16_t timeout;
} sle_default_connect_param_t;

成员说明

成员名称

数据类型

描述

enable_filter_policy

uint8_t

链路是否打开过滤功能

initiate_phys

uint8_t

链路扫描通信带宽:1 表示 1M,2 表示 2M

gt_negotiate

uint8_t

链路建立时是否进行 G 和 T 交互

scan_interval

uint16_t

链路建立时扫描对端设备的 interval

scan_window

uint16_t

链路建立时扫描对端设备的 windows

min_interval

uint16_t

链路调度最小 interval

max_interval

uint16_t

链路调度最大 interval

timeout

uint16_t

链路超时时间

sle_connection_callbacks_t #

typedef struct {
    sle_connect_state_changed_callback connect_state_changed_cb;
    sle_connect_param_update_req_callback connect_param_update_req_cb;
    sle_connect_param_update_callback connect_param_update_cb;
    sle_auth_complete_callback auth_complete_cb;
    sle_pair_complete_callback pair_complete_cb;
    sle_read_rssi_callback read_rssi_cb;
    sle_low_latency_callback low_latency_cb;
    sle_set_phy_callback set_phy_cb;
    sle_pair_remove_callback pair_remove_cb;
} sle_connection_callbacks_t;

成员说明

成员名称

数据类型

描述

connect_state_changed_cb

sle_connect_state_changed_callback

连接状态改变回调函数

connect_param_update_req_cb

sle_connect_param_update_req_callback

连接参数更新请求回调函数

connect_param_update_cb

sle_connect_param_update_callback

连接参数更新回调函数

auth_complete_cb

sle_auth_complete_callback

认证完成回调函数

pair_complete_cb

sle_pair_complete_callback

配对完成回调函数

read_rssi_cb

sle_read_rssi_callback

读取 RSSI 回调函数

low_latency_cb

sle_low_latency_callback

设置 low latency 回调函数

set_phy_cb

sle_set_phy_callback

设置 PHY 回调函数

pair_remove_cb

sle_pair_remove_callback

取消配对完成回调函数

sle_announce_param_t #

typedef struct sle_announce_param {
    uint8_t  announce_handle;
    uint8_t  announce_mode;
    uint8_t  announce_gt_role;
    uint8_t  announce_level;
    uint32_t announce_interval_min;
    uint32_t announce_interval_max;
    uint8_t  announce_channel_map;
    int8_t   announce_tx_power;
    sle_addr_t own_addr;
    sle_addr_t peer_addr;
    uint16_t conn_interval_min;
    uint16_t conn_interval_max;
    uint16_t conn_max_latency;
    uint16_t conn_supervision_timeout;
    void *ext_param;
} sle_announce_param_t;

成员说明

成员名称

数据类型

描述

announce_handle

uint8_t

设备公开句柄,取值范围 [0, 0xFF]

announce_mode

uint8_t

设备公开类型,参考 sle_announce_mode_t

announce_gt_role

uint8_t

G/T 角色协商指示,参考 sle_announce_gt_role_t

announce_level

uint8_t

发现等级,参考 sle_announce_level_t

announce_interval_min

uint32_t

最小设备公开周期,取值范围 0x000020~0xFFFFFF,单位 125us

announce_interval_max

uint32_t

最大设备公开周期,取值范围 0x000020~0xFFFFFF,单位 125us

announce_channel_map

uint8_t

设备公开信道,0:76,1:77,2:78

announce_tx_power

int8_t

广播发射功率,单位 dbm,取值范围 [-127, 20],0x7F 表示不设置特定发送功率

own_addr

sle_addr_t

本端地址

peer_addr

sle_addr_t

对端地址

conn_interval_min

uint16_t

连接间隔最小取值,取值范围 [0x001E,0x3E80],announce_gt_role 为 SLE_ANNOUNCE_ROLE_T_NO_NEGO 时无需配置

conn_interval_max

uint16_t

连接间隔最大取值,取值范围 [0x001E,0x3E80],announce_gt_role 为 SLE_ANNOUNCE_ROLE_T_NO_NEGO 时无需配置

conn_max_latency

uint16_t

最大休眠连接间隔,取值范围 [0,0x01F3],announce_gt_role 为 SLE_ANNOUNCE_ROLE_T_NO_NEGO 时无需配置

conn_supervision_timeout

uint16_t

最大超时时间,取值范围 [0x000A,0x0C80],announce_gt_role 为 SLE_ANNOUNCE_ROLE_T_NO_NEGO 时无需配置

ext_param

void *

扩展设备公开参数,缺省时置空

sle_announce_data_t #

typedef struct sle_announce_data {
    uint16_t announce_data_len;
    uint16_t seek_rsp_data_len;
    uint8_t  *announce_data;
    uint8_t  *seek_rsp_data;
} sle_announce_data_t;

成员说明

成员名称

数据类型

描述

announce_data_len

uint16_t

设备公开数据长度

seek_rsp_data_len

uint16_t

扫描响应数据长度

announce_data

uint8_t *

设备公开数据

seek_rsp_data

uint8_t *

扫描响应数据

sle_seek_param_t #

typedef struct sle_seek_params {
    uint8_t own_addr_type;
    uint8_t filter_duplicates;
    uint8_t seek_filter_policy;
    uint8_t seek_phys;
    uint8_t seek_type[SLE_SEEK_PHY_NUM_MAX];
    uint16_t seek_interval[SLE_SEEK_PHY_NUM_MAX];
    uint16_t seek_window[SLE_SEEK_PHY_NUM_MAX];
} sle_seek_param_t;

成员说明

成员名称

数据类型

描述

own_addr_type

uint8_t

本端地址类型

filter_duplicates

uint8_t

重复过滤开关,0 表示关闭,1 表示开启

seek_filter_policy

uint8_t

扫描设备使用的过滤类型,参考 sle_seek_filter_t

seek_phys

uint8_t

扫描设备所使用的 PHY,参考 sle_seek_phy_t

seek_type

uint8_t[]

扫描类型,参考 sle_seek_type_t,数组大小 SLE_SEEK_PHY_NUM_MAX:3

seek_interval

uint16_t[]

扫描间隔,取值范围 [0x0014, 0xFFFF],时间 = N * 0.125ms,数组大小 SLE_SEEK_PHY_NUM_MAX:3

seek_window

uint16_t[]

扫描窗口,取值范围 [0x0014, 0xFFFF],时间 = N * 0.125ms,数组大小 SLE_SEEK_PHY_NUM_MAX:3

sle_seek_result_info_t #

typedef struct sle_seek_result_info {
    uint8_t event_type;
    sle_addr_t addr;
    sle_addr_t direct_addr;
    int8_t rssi;
    uint8_t data_status;
    uint8_t data_length;
    uint8_t *data;
} sle_seek_result_info_t;

成员说明

成员名称

数据类型

描述

event_type

uint8_t

上报事件类型

addr

sle_addr_t

地址

direct_addr

sle_addr_t

定向发现地址

rssi

int8_t

信号强度指示,取值范围 [-127dBm, 20dBm],0x7F 表示不提供信号强度指示

data_status

uint8_t

数据状态

data_length

uint8_t

数据长度

data

uint8_t *

数据

sle_announce_seek_callbacks_t #

typedef struct {
    sle_announce_enable_callback announce_enable_cb;
    sle_announce_disable_callback announce_disable_cb;
    sle_announce_terminal_callback announce_terminal_cb;
    sle_announce_remove_callback announce_remove_cb;
    sle_start_seek_callback seek_enable_cb;
    sle_seek_disable_callback seek_disable_cb;
    sle_seek_result_callback seek_result_cb;
    sle_dfr_callback sle_dfr_cb;
} sle_announce_seek_callbacks_t;

成员说明

成员名称

数据类型

描述

announce_enable_cb

sle_announce_enable_callback

设备公开使能回调函数

announce_disable_cb

sle_announce_disable_callback

设备公开关闭回调函数

announce_terminal_cb

sle_announce_terminal_callback

设备公开停止回调函数

announce_remove_cb

sle_announce_remove_callback

设备公开停止回调函数

seek_enable_cb

sle_start_seek_callback

扫描使能回调函数

seek_disable_cb

sle_seek_disable_callback

扫描关闭回调函数

seek_result_cb

sle_seek_result_callback

扫描结果回调函数

sle_dfr_cb

sle_dfr_callback

dfr 回调函数

sle_transmission_signal_capability_bit_t #

typedef struct {
    uint32_t relay_capability : 1;
    uint32_t trans_mode : 1;
    uint32_t measurement_capability : 1;
    uint32_t access_slb : 1;
    uint32_t access_sle : 1;
    uint32_t mtu : 1;
    uint32_t mps : 1;
    uint32_t reverse : 25;
} sle_transmission_signal_capability_bit_t;

成员说明

成员名称

数据类型

描述

relay_capability

uint32_t:1

中继能力

trans_mode

uint32_t:1

传输模式

measurement_capability

uint32_t:1

测量能力

access_slb

uint32_t:1

slb 接入

access_sle

uint32_t:1

sle 接入

mtu

uint32_t:1

最大支持 MTU

mps

uint32_t:1

最大支持 mps

reverse

uint32_t:25

保留比特位

sle_transmission_callbacks_t #

typedef struct {
    sle_trans_data_busy_callback send_data_cb;
} sle_transmission_callbacks_t;

成员说明

成员名称

数据类型

描述

send_data_cb

sle_trans_data_busy_callback

传输数据繁忙回调函数

sle_addr_t #

typedef struct {
    uint8_t type;
    unsigned char addr[SLE_ADDR_LEN];
} sle_addr_t;

成员说明

成员名称

数据类型

描述

type

uint8_t

SLE 设备地址类型,参考 sle_addr_type_t

addr

unsigned char[]

SLE 设备地址,长度为 SLE_ADDR_LEN:6

使用说明

SLE 设备地址结构,作为本模块多个对外接口的入参/出参载体。

Macros#

SLE_ANNOUNCE_ID_MAX #

#define SLE_ANNOUNCE_ID_MAX 16

SLE_SEEK_PHY_NUM_MAX #

#define SLE_SEEK_PHY_NUM_MAX 3

SLE_ADDR_LEN #

#define SLE_ADDR_LEN        6