应用开发说明

更新时间:2022-11-24 09:20:12

本文介绍了 Tuya Beacon SDK 开发过程中常使用的功能,以提高您设备应用程序开发的速度。

上报数据

应用层调用 app_dps_upload 设置要发送的 DP 数据。协议栈层将待发送数据进行组包和加密,送入 Beacon txbufff,之后一旦调用 bal_beacon_txrx(x,3) 就会将 buff 中的数据发出去。

代码示例

app_dps_upload (3, 1, 1, 0);

//设备主动上报 DP3,bool 类型,长度为 1,数据为 0

下发数据

系统通过循环调用 bal_beacon_txrx(x,3) ,持续搜索周围蓝牙广播包,将收到的数据送到 Beacon 协议栈进行合法性校验、数据包解析,并最终推到应用层。这些数据最后做为收到的 DP 数据。

SDK会主动调用 app_dps_download 函数,用户可在app_dps_download函数内改变设备状态并上报当前状态。

app_dps_download 函数的调用已经封装,当Beacon收到数据后,SDK会主动调用。

Beacon 状态获取

如果设备应用程序想要获得当前的Beacon网络状态,可调用 ty_beacon_get_state()

返回值示例

DEVICE_STATE_NOT_PAIRED; 未配对;
DEVICE_STATE_PAIRING; 配对中;
DEVICE_STATE_PAIRED; 已配对;

重置设备

通过调用 app_light_reset_run() 完成三次上下电设备重置操作,重置功能等同于移动端应用的 移除并清除云端数据 操作。

设备应用程序调用该函数来实现三次上下电设备重置操作,该函数会清除 Beacon SDK 绑定信息中的设备虚拟 ID。