了解产品定义(物模型),可以帮助您更加准确、灵活的调用接口,接入设备。
产品定义

2.1 状态属性

状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
属性 选项 说明
线路
power
打开 1
关闭 0

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息:网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备,并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备,放弃当前状态
本产品的命令
命令 名称 内容 说明
先通后断
point
1秒 {"point":"1000"}
2秒 {"point":"2000"}
3秒 {"point":"3000"}
5秒 {"point":"5000"}
先断后通
reset
1秒 {"reset":"1000"}
2秒 {"reset":"2000"}
3秒 {"reset":"3000"}
5秒 {"reset":"5000"}
监听遥控键码
learn
开始 {"learn":"1"}
结束 {"learn":"0"}

2.2 触发事件

当设备属性状态值因为下面两个原因发生改变时触发:
1. 自身状态变化(如传感器的数值发生变化);
2. 人为操作(按下了设备按钮)
事件被触发后,平台会携带设备当前状态参数,实时上报消息,
具体机制在“第5节:消息推送”有详细描述
公共事件(所有产品均支持)
名称 内容 说明
开机 {"name":"boot","state":{当前属性值}} 设备加电、云端登记后触发,上报时携带当前状态(各功能属性的值)
本产品的事件
事件 名称 说明
按下按钮 btn1
遥控器 rf1
键码 rf_key

2.3 配置项

所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
配置项 名称 内容 说明
开机状态
relay1
1
0
按钮动作
action1
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
按钮延时
time1
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
遥控器动作
rfaction1
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
遥控器1延时
rftime1
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000

附. 固件列表

固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V16
p30.20260104.v16
id.1563 277 KB 2026-01-04 10:02:45
id.1564 277 KB 2026-01-04 10:18:16
id.1682 277.27 KB 2026-01-24 10:53:16
V15
p30.20251202.v15
id.1405 285.1 KB 2025-12-02 14:48:35
id.1406 285.9 KB 2025-12-02 14:52:04
V14
p30.20251014.v14
id.1342 273.6 KB 2025-10-14 11:07:08
id.1343 273.96 KB 2025-10-14 11:07:30
V13
p30.20250804.v13
id.1193 289.03 KB 2025-08-04 16:15:46
id.1194 289.4 KB 2025-08-04 16:17:18
V12
p30.20250102.v12
id.936 277.23 KB 2025-01-02 21:17:15
id.937 277.23 KB 2025-01-02 21:18:00
V11
p30.20241126.v11
id.851 274.02 KB 2024-11-26 21:53:13
id.854 274.01 KB 2024-11-26 21:57:07
V10
p30.20241013.v10
id.748 270.91 KB 2024-10-13 14:21:45
id.753 270.91 KB 2024-10-13 14:24:09
V9
p30.20241008.v9
id.734 270.9 KB 2024-10-08 16:13:45
id.735 270.9 KB 2024-10-08 16:14:37
V8
p30.20240904.v8
id.680 269.07 KB 2024-09-04 18:01:47
id.681 269.07 KB 2024-09-04 18:02:04
V7
p30.20240819.v7
id.658 270.09 KB 2024-08-19 11:30:32
id.659 270.09 KB 2024-08-19 11:32:41