数据传输

TuyaOS 开发框架支持的数据传输方式有属性（上报，读，写）、命令、DP 透传。

属性（Attribute ）

Zigbee 设备的状态信息，配置信息等都保存在各 Cluster 下的 Attribute 中，设备端维护了一张属性表，对属性的操作有：

• 上报属性（Report）
• 读属性（Read）
• 写属性（Write）

设备可支持的标准属性由 CSA 联盟定义，具体可以参照 CSA 联盟 发布的《Cluster Library Specification》，通过 TuyaOS 您也可以定义私有属性。

• 上报属性：Zigbee 子设备主动上报属性，通过上报属性可以同步设备当前的状态。例如当一个温度传感器检测到温度变化时，通过上报温度属性来通知网关。
• 读属性：通过读设备的属性，可以获取设备的信息，例如设备厂商（Manufacturer name），固件版本号（Firmware version），设备型号（Model ID）等。也可以获取设备的当前状态，例如灯具的开关状态。
• 写属性：通过写设备属性，可以对设备进行一些配置。例如，对一个色温可调的灯，写入 ColorTempPhysicalMinMireds（0x400b）、ColorTempPhysicalMaxMireds（0x400c）属性，可以设置灯具的色温最小值和最大值。

TuyaOS 提供了属性上报的接口，同时提供了读写属性的通知回调函数。通过配置属性列表，可以将属性配置为保存在非易失性存储器中，以便断电属性值不丢失。

需要注意的是，并非所有属性都支持写，具体请参考《Cluster Library Specification》。

命令（Command）

当一个设备需要向另一个设备发送控制命令时，可以通过发送命令的方式。例如一个照明遥控器可以向一个照明设备发送开、关命令，从而控制照明设备的开关状态。通常网关都是通过发送命令的方式控制 Zigbee 设备的。

《Cluster Library Specification》同样定义了各 Cluster 支持的命令。命令可以发送给某个特定设备，也可以是发送给某个群组，也可以发送给全网。

TuyaOS 提供了命令发送接口，以及命令接收回调函数，命令发送和命令接收都能区分单播，组播，广播。

命令发送之后，如果需要知道对方是否收到，这时应用层可以通过函数参数，告知 TuyaOS 是否关心对方是否已成功收到命令。如果应用层关心对方是否收到命令，TuyaOS 会通过回调函数通知应用层，对方是否接收成功。

DP 透传

DP 是指在 涂鸦开发者平台 创建一个产品后，该产品支持的功能点集合。每一个功能点由一个 DPID 来标识。这是涂鸦支持的一种物模型机制。

Zigbee 网关和云端是通过 DP 的方式传递消息的，Zigbee 网关充当了涂鸦 DP 与 Zigbee 协议转换者的角色。

• 云端发送涂鸦 DP 给网关，网关将其转换成 Zigbee 指令发送给 Zigbee 子设备。

• Zigbee 子设备通过 Zigbee 指令上报给网关，网关将其转换成涂鸦 DP 上报给云端。

  下图介绍了网关充当涂鸦 DP 与 Zigbee 指令转换者的示意效果：

  

通常情况下如果涂鸦 DP 所表达的设备功能点，在 Zigbee 《Cluster Library Specification》中，那么网关与子设备之间则会使用此规范中的 Zigbee 指令。涂鸦开发者平台为每一款产品赋予了标准的 DP，您也可以增加自定义 DP。更多详情，请参考 产品功能。

• 标准 DP：网关与子设备之间通过普通属性或命令进行交互，这里的属性和命令可以是标准的也可以是私有的。
• 自定义 DP：网关与子设备之间通过涂鸦定义的透传命令进行交互，此时网关不做 DP 与 Zigbee 指令的转换，而是直接进行透明传输。具体请参考 TuyaOS 开发指导。

支持与帮助

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