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

2.1 状态属性

状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
属性 选项 说明
线路1
power1
1
0
线路2
power2
1
0
线路3
power3
1
0
线路4
power4
1
0
线路5
power5
1
0
线路6
power6
1
0
线路7
power7
1
0
线路8
power8
1
0
线路9
power9
1
0
线路10
power10
1
0
线路11
power11
1
0
线路12
power12
1
0
线路13
power13
1
0
线路14
power14
1
0
线路15
power15
1
0
线路16
power16
1
0
线路17
power17
1
0
线路18
power18
1
0
线路19
power19
1
0
线路20
power20
1
0
线路21
power21
1
0
线路22
power22
1
0
线路23
power23
1
0
线路24
power24
1
0

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息:网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备,并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备,放弃当前状态
本产品的命令
命令 名称 内容 说明
批量控制
batch
全开 {"batch":"{"power":1}"}
全关 {"batch":"{"power":0}"}
线路1|3|5|7开 {"batch":"{"relay":[1,3,5,7],"power":1}"}
线路1|3|5|7关 {"batch":"{"relay":[1,3,5,7],"power":0}"}
线路2|4|6|8开 {"batch":"{"relay":[2,4,6,8],"power":1}"}
线路2|4|6|8关 {"batch":"{"relay":[2,4,6,8],"power":0}"}
先通后断
point
500毫秒,全部线路 {"point":"{"interval":500}"}
1秒,线路1|3|5|7 {"point":"{"relay":[1,3,5,7],"interval":1000}"}
2秒,线路2|4|6|8 {"point":"{"relay":[2,4,6,8],"interval":2000}"}
先断后通
reset
500毫秒,全部线路 {"reset":"{"interval":500}"}
1秒,线路1|3|5|7 {"reset":"{"relay":[1,3,5,7],"interval":1000}"}
2秒,线路2|4|6|8 {"reset":"{"relay":[2,4,6,8],"interval":2000}"}

2.2 触发事件

当设备属性状态值因为下面两个原因发生改变时触发:
1. 自身状态变化(如传感器的数值发生变化);
2. 人为操作(按下了设备按钮)
事件被触发后,平台会携带设备当前状态参数,实时上报消息,
具体机制在“第5节:消息推送”有详细描述
公共事件(所有产品均支持)
名称 内容 说明
开机 {"name":"boot","state":{当前属性值}} 设备加电、云端登记后触发,上报时携带当前状态(各功能属性的值)
本产品的事件
事件 名称 说明
按下按钮 btn1
线路1输入 line1
线路2输入 line2
线路3输入 line3
线路4输入 line4
线路5输入 line5
线路6输入 line6
线路7输入 line7
线路8输入 line8
线路9输入 line9
线路10输入 line10
线路11输入 line11
线路12输入 line12
线路13输入 line13
线路14输入 line14
线路15输入 line15
线路16输入 line16
线路17输入 line17
线路18输入 line18
线路19输入 line19
线路20输入 line20
线路21输入 line21
线路22输入 line22
线路23输入 line23
线路24输入 line24
状态保持 keep

2.3 配置项

所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
配置项 名称 内容 说明
按钮动作
btn1
全断 0 默认
全通 1
禁用 disable
1路开机状态
relay1
1
0 默认
2路开机状态
relay2
1
0 默认
3路开机状态
relay3
1
0 默认
4路开机状态
relay4
1
0
5路开机状态
relay5
1
0
6路开机状态
relay6
1
0
7路开机状态
relay7
1
0
8路开机状态
relay8
1
0
9路开机状态
relay9
1
0
10路开机状态
relay10
1
0
11路开机状态
relay11
1
0
12路开机状态
relay12
1
0
13路开机状态
relay13
1
0
14路开机状态
relay14
1
0
15路开机状态
relay15
1
0
16路开机状态
relay16
1
0
17路开机状态
relay17
1
0
18路开机状态
relay18
1
0
19路开机状态
relay19
1
0
20路开机状态
relay20
1
0
21路开机状态
relay21
1
0
22路开机状态
relay22
1
0
23路开机状态
relay23
1
0
24路开机状态
relay24
1
0
1路离线状态
offline1
1
0
不理会 n
2路离线状态
offline2
1
0
不理会 n
3路离线状态
offline3
1
0
不理会 n
4路离线状态
offline4
1
0
不理会 n
5路离线状态
offline5
1
0
不理会 n
6路离线状态
offline6
1
0
不理会 n
7路离线状态
offline7
1
0
不理会 n
8路离线状态
offline8
1
0
不理会 n
9路离线状态
offline9
1
0
不理会 n
10路离线状态
offline10
1
0
不理会 n
11路离线状态
offline11
1
0
不理会 n
12路离线状态
offline12
1
0
不理会 n
13路离线状态
offline13
1
0
不理会 n
14路离线状态
offline14
1
0
不理会 n
15路离线状态
offline15
1
0
不理会 n
16路离线状态
offline16
1
0
不理会 n
17路离线状态
offline17
1
0
不理会 n
18路离线状态
offline18
1
0
不理会 n
19路离线状态
offline19
1
0
不理会 n
20路离线状态
offline20
1
0
不理会 n
21路离线状态
offline21
1
0
不理会 n
22路离线状态
offline22
1
0
不理会 n
23路离线状态
offline23
1
0
不理会 n
24路离线状态
offline24
1
0
不理会 n
1路输入模式
mode1
轻触 0
长按 1
1路输入动作
action1
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
1路输入延时
time1
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
2路输入模式
mode2
轻触 0
长按 1
2路输入动作
action2
状态反转 reverse 默认
先断后通 reset
先通后断 point
禁用 disable
2路输入延时
time2
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
3路输入模式
mode3
轻触 0
长按 1
3路输入动作
action3
状态反转 reverse 默认
先断后通 reset
先通后断 point
禁用 disable
3路输入延时
time3
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
4路输入模式
mode4
轻触 0
长按 1
4路输入动作
action4
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
4路输入延时
time4
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
5路输入模式
mode5
轻触 0
长按 1
5路输入动作
action5
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
5路输入延时
time5
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
6路输入模式
mode6
轻触 0
长按 1
6路输入动作
action6
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
6路输入延时
time6
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
7路输入模式
mode7
轻触 0
长按 1
7路输入动作
action7
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
7路输入延时
time7
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
8路输入模式
mode8
轻触 0
长按 1
8路输入动作
action8
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
8路输入延时
time8
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
9路输入模式
mode9
轻触 0
长按 1
9路输入动作
action9
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
9路输入延时
time9
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
10路输入模式
mode10
轻触 0
长按 1
10路输入动作
action10
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
10路输入延时
time10
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
11路输入模式
mode11
轻触 0
长按 1
11路输入动作
action11
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
11路输入延时
time11
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
12路输入模式
mode12
轻触 0
长按 1
12路输入动作
action12
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
12路输入延时
12
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
13路输入模式
mode13
轻触 0
长按 1
13路输入动作
action13
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
13路输入延时
time13
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
14路输入模式
mode14
轻触 0
长按 1
14路输入动作
action14
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
14路输入延时
time14
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
15路输入模式
mode15
轻触 0
长按 1
15路输入动作
action15
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
15路输入延时
time15
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
16路输入模式
mode16
轻触 0
长按 1
16路输入动作
action16
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
16路输入延时
time16
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
17路输入模式
mode17
轻触 0
长按 1
17路输入动作
action17
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
17路输入延时
time17
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
18路输入模式
mode18
轻触 0
长按 1
18路输入动作
action18
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
18路输入延时
time18
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
19路输入模式
mode19
轻触 0
长按 1
19路输入动作
action19
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
19路输入延时
time19
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
20路输入模式
mode20
轻触 0
长按 1
20路输入动作
action20
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
20路输入延时
time20
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
21路输入模式
mode21
轻触 0
长按 1
21路输入动作
action21
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
21路输入延时
time21
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
22路输入模式
mode22
轻触 0
长按 1
22路输入动作
action22
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
22路输入延时
time22
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
23路输入模式
mode23
轻触 0
长按 1
23路输入动作
action23
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
23路输入延时
time23
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
24路输入模式
mode24
轻触 0
长按 1
24路输入动作
action24
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
24路输入延时
time24
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
负载时序
gap
无保护 0
间隔1秒 1
间隔2秒 2
间隔3秒 3
消抖
filter
150
200
250
300

附. 固件列表

固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V11
p116.20251215.v11
id.1431 1.13 MB 2025-12-15 11:33:07
V10
p116.20250929.v10
id.1304 608.39 KB 2025-09-29 17:13:14
V9
p116.20250923.v9
id.1286 608.32 KB 2025-09-23 16:39:07
消息上报优化
p116.20250903.v8
id.1247 607.47 KB 2025-09-03 21:40:52
LAN优化
p116.20250806.v7
id.1199 632.68 KB 2025-08-06 22:30:43
V6
p116.20250714.v6
id.1177 635.17 KB 2025-07-14 09:55:14
V5
p116.20250710.v5
id.1172 646.98 KB 2025-07-10 18:23:23
V4
p116.20250630.v4
id.1148 647.29 KB 2025-06-30 11:46:57
V3
p116.20250606.v3
id.1073 618.24 KB 2025-06-06 19:37:09
V2
p116.20250525.v2
id.1057 617.88 KB 2025-05-25 12:32:08