2.1 状态属性
状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
| 属性 | 选项 | 值 | 说明 |
|---|---|---|---|
|
传感模块 sht_enable |
打开 | 1 | |
| 关闭 | 0 | ||
|
摄氏温度 temp_c |
无 | ||
|
华氏温度 temp_f |
无 | ||
|
湿度 humi |
无 | ||
2.2 设备指令
设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
| 名称 | 内容 | 说明 |
|---|---|---|
| 网络信息 | {"system":"network"} | 查看设备当前的网络信息:网络类型、信号强度、IP地址等 |
| 软重启 | {"system":"restart"} | 重启设备,并尽可能的保持当前状态 |
| 硬重启 | {"system":"reboot"} | 重启设备,放弃当前状态 |
本产品的命令
| 命令 | 名称 | 内容 | 说明 |
|---|---|---|---|
|
LED灯 led |
快闪 | {"led":"100"} | |
| 慢闪 | {"led":"500"} | ||
| 停止 | {"led":"0"} |
2.2 触发事件
当设备属性状态值因为下面两个原因发生改变时触发:
1. 自身状态变化(如传感器的数值发生变化);
2. 人为操作(按下了设备按钮)
事件被触发后,平台会携带设备当前状态参数,实时上报消息,
具体机制在“第5节:消息推送”有详细描述
1. 自身状态变化(如传感器的数值发生变化);
2. 人为操作(按下了设备按钮)
事件被触发后,平台会携带设备当前状态参数,实时上报消息,
具体机制在“第5节:消息推送”有详细描述
公共事件(所有产品均支持)
| 名称 | 内容 | 说明 | |
|---|---|---|---|
| 开机 | {"name":"boot","state":{当前属性值}} | 设备加电、云端登记后触发,上报时携带当前状态(各功能属性的值) | |
本产品的事件
| 事件 | 名称 | 说明 |
|---|---|---|
| 按钮按下 | btn | |
| 温湿度变化 | sht_detect |
2.3 配置项
所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
| 配置项 | 名称 | 内容 | 说明 |
|---|---|---|---|
|
按钮1动作 action1 |
传感器 | reverse | |
| 禁用 | disable | ||
|
LED灯 led |
长亮 | 1 | |
| 长灭 | 0 | ||
| 闪烁 | blink | 每10秒,闪一次 | |
|
传感器开机状态 sht |
打开 | 1 | |
| 关闭 | 0 | ||
|
校正系数 correction |
0.8 | 0.8 | |
| 0.85 | 0.85 | ||
| 0.9 | 0.9 | ||
| 0.91 | 0.91 | ||
| 0.92 | 0.92 | ||
| 0.93 | 0.93 | ||
| 0.94 | 0.94 | ||
| 0.95 | 0.95 | ||
| 0.96 | 0.96 | ||
| 0.97 | 0.97 | ||
| 0.98 | 0.98 | ||
| 0.99 | 0.99 | ||
| 1 | 1 | ||
| 1.01 | 1.01 | ||
| 1.02 | 1.02 | ||
|
灵敏度 sensitivity |
0.1 | 0.1 | |
| 0.2 | 0.2 | ||
| 0.3 | 0.3 | ||
| 0.4 | 0.4 | ||
| 0.5 | 0.5 |
附. 固件列表
固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
| 版本 | ID | 大小 | 发布日期 | 说明 |
|---|---|---|---|---|
|
V8 p20.20250928.v8 |
id.1302 | 277.14 KB | 2025-09-28 21:05:44 | 无 |
|
V7 p20.20250811.v7 |
id.1202 | 291.58 KB | 2025-08-11 18:28:31 | 无 |
|
V6 p20.20250602.v6 |
id.1066 | 299.5 KB | 2025-06-02 18:01:25 | 无 |
|
V5 p20.20240808.v5 |
id.638 | 273.6 KB | 2024-08-08 18:13:23 | 无 |
|
V4 p20.20240726.v4 |
id.604 | 273.48 KB | 2024-07-26 21:06:17 | 无 |
|
V3 p20.20240722.v3 |
id.567 | 272.9 KB | 2024-07-22 14:14:53 | 无 |
|
V2 p20.20240531.v2 |
id.466 | 344.5 KB | 2024-05-31 20:59:52 | 无 |
|
固件p20.20231013.v1 p20.20231013.v1 |
id.180 | 343.78 KB | 2023-10-13 17:44:07 | 无 |