蓝牙配网接口

本文介绍了综合 SDK 的蓝牙配网接口。

结构体定义

ty_bt_param_t

typedef struct {
    CHAR_T name[DEVICE_NAME_LEN];
    ty_bt_mode_t mode;
    UCHAR_T link_num;
    TY_BT_MSG_CB cb;
    tuya_ble_data_buf_t adv;
    tuya_ble_data_buf_t scan_rsp;
}ty_bt_param_t;

功能说明(Summary)

蓝牙初始化参数结构体。

成员说明

成员名称	说明
name	蓝牙名称
mode	蓝牙工作模式，支持以下几种模式 TY_BT_MODE_PERIPHERAL TY_BT_MODE_CENTRAL TY_BT_MODE_MESH_PROVISIONER TY_BT_MODE_MESH_DEVICE
link_num	最大支持客户端连接数，默认是 1
cb	事件和数据回调
adv	广播数据
scan_rsp	客户端(APP)扫描响应数据

接口说明

tuya_adapter_bt_port_init

OPERATE_RET tuya_adapter_bt_port_init(ty_bt_param_t *p);

功能说明

开发者实现蓝牙HOST初始化，该接口需要支持多次调用，即在调用 tuya_adapter_bt_port_deinit 关闭蓝牙后，可以再次调用该接口来重新初始化蓝牙。

参数说明

参数名称	说明
p	参见 ty_bt_param_t

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_port_deinit

OPERATE_RET tuya_adapter_bt_port_deinit(VOID);

功能说明

开发者实现关闭蓝牙初始化，蓝牙网关无需关心该接口。

参数说明

无

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_gap_disconnect

OPERATE_RET tuya_adapter_bt_gap_disconnect(VOID);

功能说明

开发者实现蓝牙作为 Slave 主动断开连接，蓝牙网关无需关心该接口。

参数说明

无

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_send

OPERATE_RET tuya_adapter_bt_send(BYTE_T *data, UINT8_T len);

功能说明

开发者实现蓝牙发送数据。

参数说明

参数名称	说明
data	数据
len	数据长度

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_adv_reset

OPERATE_RET tuya_adapter_bt_adv_reset(tuya_ble_data_buf_t *adv, tuya_ble_data_buf_t *scan_resp);

功能说明

开发者实现重新设置蓝牙广播内容和扫描响应内容。

参数说明

参数名称	说明
adv	蓝牙广播数据
scan_resp	蓝牙扫描响应数据

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_adv_start

OPERATE_RET tuya_adapter_bt_adv_start(VOID);

功能说明

开发者实现开启蓝牙广播。

参数说明

无

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_adv_stop

OPERATE_RET tuya_adapter_bt_adv_stop(VOID);

功能说明

开发者实现停止蓝牙广播。

参数说明

无

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_get_rssi

OPERATE_RET tuya_adapter_bt_get_rssi(SCHAR_T *rssi);

功能说明

开发者实现获取蓝牙信号强度。

参数说明

参数名称	说明
rssi	信号强度指针

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_scan_assign

OPERATE_RET tuya_adapter_bt_scan_assign(INOUT ty_bt_scan_info_t *info);

功能说明

开发者实现扫描指定蓝牙名称，获取蓝牙信息，蓝牙网关无需关心该接口。

参数说明

参数名称	说明
info	蓝牙信息

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_scan_init

OPERATE_RET tuya_adapter_bt_scan_init(IN TY_BT_SCAN_ADV_CB scan_adv_cb);

功能说明

开发者实现蓝牙扫描初始化，蓝牙网关无需关心该接口。

参数说明

参数名称	说明
scan_adv_cb	蓝牙广播回调

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_scan_start

OPERATE_RET tuya_adapter_bt_scan_start(VOID_T);

功能说明

开发者实现开启蓝牙扫描，蓝牙网关无需关心该接口。

参数说明

无

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码

tuya_adapter_bt_scan_stop

OPERATE_RET tuya_adapter_bt_scan_stop(VOID_T);

功能说明

开发者实现停止蓝牙扫描，蓝牙网关无需关心该接口。

参数说明

无

返回值

返回值	说明
OPRT_OK	成功
错误码	失败返回错误码