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

2.1 状态属性

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

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息:网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备,并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备,放弃当前状态
本产品的命令
命令 名称 内容 说明
颜色
color
{"color":"[255,0,0]"}
绿 {"color":"[0,255,0]"}
{"color":"[0,0,255]"}
{"color":"[255,255,0]"}
{"color":"[0,255,255]"}
{"color":"[255,0,255]"}
{"color":"[255,255,255]"}
闪烁
twinkle
{"twinkle":"100"}
{"twinkle":"500"}
{"twinkle":"0"}
呼吸
breath
{"breath":"1000"}
{"breath":"2000"}
{"breath":"0"}
多彩
colorful
红蓝切换 {"colorful":"{"speed":1500,"colors":[[155,0,0],[0,0,155]]}"}
三色切换 {"colorful":"{"speed":1500,"colors":[[155,0,0],[0,155,0],[0,0,155]]}"}
{"colorful":"{"speed":0}"}
蜂鸣器
buzzer
急促 {"buzzer":"100"}
{"buzzer":"300"}
{"buzzer":"500"}
{"buzzer":"700"}
{"buzzer":"stop"}

2.2 触发事件

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

2.3 配置项

所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
配置项 名称 内容 说明
按钮
btn
静音/恢复 volume
禁用 disable
开机led状态
lamp
1
0
默认led灯色彩
lamp_color
[120,0,0]
绿 [0,120,0]
[0,0,120]
蜂鸣器音量
buz_volume
255
200
150
蜂鸣器声长
buz_length
极短 50
100
150
200

附. 固件列表

固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V5
p85.20260115.v5
id.1671 268.44 KB 2026-01-15 10:04:03
id.1673 268.44 KB 2026-01-15 10:12:29
V4
p85.20251201.v4
id.1403 287.74 KB 2025-12-01 09:30:08
id.1404 286.74 KB 2025-12-01 09:33:53
V3
p85.20241201.v3
id.863 276.68 KB 2024-12-01 11:49:38
id.888 276.68 KB 2024-12-10 19:35:28
V1
p85.20240820.v1
id.662 271.06 KB 2024-08-20 12:59:37