应用开发说明

本文介绍了 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。