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

2.1 状态属性

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

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息:网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备,并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备,放弃当前状态
本产品的命令
命令 名称 内容 说明
1路状态保持
power1
1路保持关(用户开3秒后自动关闭) {"power1":"{"keep":"0","revert":"3"}"}
1路保持开(用户关3秒后自动打开) {"power1":"{"keep":"1","revert":"3"}"}
1路先通后断
point1
1s {"point1":"1000"}
2s {"point1":"2000"}
3s {"point1":"3000"}
1路先断后通
reset1
1s {"reset1":"1000"}
2s {"reset1":"2000"}
3s {"reset1":"3000"}

2.3 触发事件

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

按钮1被按下

状态保持 keep

2.4 配置项

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

附. 固件列表

固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V24
p10.20250624.v24
id.1102 297.77 KB 2025-06-24 16:40:59
id.1105 297.77 KB 2025-06-24 16:45:10
V23
p10.20250103.v23
id.938 282.72 KB 2025-01-03 17:11:05
id.939 282.72 KB 2025-01-03 17:11:10
V22
p10.20241212.v22
id.895 280.15 KB 2024-12-12 10:53:06
id.897 280.15 KB 2024-12-12 11:56:33
V21
p10.20240927.v21
id.716 276.41 KB 2024-09-27 10:24:40
id.779 276.44 KB 2024-11-01 14:59:41
V20
p10.20240904.v20
id.682 270.8 KB 2024-09-04 18:21:20
优化内存
p10.20240715.v19
id.537 271.05 KB 2024-07-15 17:11:49
增加运行模式
p10.20240615.v18
id.482 280.53 KB 2024-06-15 17:15:53
私有化支持
p10.20240516.v16
id.462 341.94 KB 2024-05-16 20:41:49
优化网络
p10.20240416.v15
id.401 341.14 KB 2024-04-16 14:37:47
合并
p10.20240306.v14
id.365 340.06 KB 2024-03-06 16:52:40