能力地图

更新时间:2025-03-18 10:05:19下载pdf

TuyaOS PLC 开发框架基于业务包的概念设计,提供了产品级的能力,高度封装了 PLC 协议栈的能力。您无需关心具体的实现原理,使用业务接口即可快速开发 PLC 产品。

设备构建

能力 说明
功能 DP 表 根据平台创建的 DP 功能 List,构建设备的功能 DP 表
设备信息 设备版本号

网络管理

能力 说明
配网 普通配网一般是通过设备复位(复位 N 次),或者在设备上进行某种特殊操作后,让设备进入配网状态
本地重置 本地重置可把设备恢复到配网之前状态,也可以选择是否清除数据,如群组、场景、设备状态等
被动离网 收到网关发送的离网指令,可恢复到配网前状态
网络自恢复 用于防止本地误操作导致的设备主动离网。本地重置后进入配网状态,若配网超时或者设备重启,则恢复之前的网络信息,且所有数据都会保留,如群组、场景等

数据传输

能力 说明
DP 上报 PLC 设备通过主动上报 DP 状态至网关,用于同步自身的状态
DP 读 PLC 设备向网关请求 DP 状态的值,用于获取一些服务,如:时间等
DP 写 PLC 设备/网关通过写 DP 状态,改变 DP 的值
DP 执行 PLC 设备/网关执行控制,如:群组控制、场景控制等

设备关系

能力 说明
本地群组 当需要对群组设备进行控制时,只需要向群组发送一条命令即可,避免了向多个设备发送相同的命令。这样可以有效减少空中报文的数量,且群组设备的行为可以保持同步。多个 PLC 子设备可以加入到一个群组中,同一个 PLC 子设备也可以加入到多个群组中
本地场景 场景是指设备的多个状态的组合,这些状态可以如同快照一样存储在设备本地,并分配一个场景 ID 进行索引。用户可以在任意时间通过场景唤醒指令,让设备进入特定状态,而不需要发多条指令。例如给灯具添加一个场景,包含开关、亮度、色温等信息,当唤醒此场景时灯具会恢复此场景对应的开关、亮度、色温等状态
绑定和解绑 用于 PLC 设备之间直接控制。通过绑定和解绑流程,两个设备之间可以建立绑定关系,之后一个设备可以直接发送指令给另一个设备,即使此时网关已经断电

OTA 升级

能力 说明
单点 OTA OTA 包是完整的固件,OTA 固件的大小为 335KB,整个 OTA 过程大约 3 分钟
群升 OTA 当一个群组内有多个相同的设备时,给每个设备逐个进行 OTA 是非常耗时的。群升 OTA 可以同时对群组内相同设备进行 OTA,从而缩短总体所需时长。设备数量越大,群升 OTA 效果越明显

支持与帮助

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