通用服务

更新时间:2023-07-26 08:57:44下载pdf

本文介绍 TuyaOS 开发框架支持的通用 Zigbee 设备能力,包括时间、设备心跳、日志等。

时间服务

Zigbee 子设备会向网关请求时间信息,并转换成 年、月、日、时、分、秒。

TuyaOS 开发框架提供接口函数获取当前 UTC(Coordinated Universal Time)时间,2000 年基准。

int tal_current_time_get(VOID_T);/*return utc time*/

心跳服务

ZRD(Zigbee Router Device)和 ZED(Zigbee End Device)设备都可以开启设备心跳,用于保持云端在线状态。TuyaOS 是通过主动上报设备版本号或电池电量属性来维持心跳的。

涂鸦网关对于 Router 设备定期进行属性查询,来判断设备是否在线,因此 Router 设备无需自己主动上报。

以下为低功耗设备开启心跳服务的 Tuyaos 代码示例:

tal_heartbeat_type_set(HEARTBEAT_BATTERY_VOLTAGE);/*set heart type*/
tal_heartbeat_period_set(5 * 60 * 1000);/*set heart period*/
tal_heartbeat_start();/*start heartbeat service*/

异常日志

异常日志用于记录设备的重启,本地重置等特殊操作,以及异常故障。日志中包含特殊操作及异常发生的时间点。这些日志信息会在设备上电或者配网成功后,上报给网关,用于分析一些历史行为。

异常日志一旦上报成功后,本地则会清除此条记录。

异常日志通过 Basic Cluster 中的 FFDF 私有属性进行上报,抓包内容如下图所示

通用服务

支持与帮助

在开发过程遇到问题,您可以登录 TuyaOS 开发者论坛 子设备开发版块 进行沟通咨询。