2.1 状态属性
状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
| 属性 | 选项 | 值 | 说明 |
|---|---|---|---|
|
线路 power |
打开 | 1 | |
| 关闭 | 0 | ||
|
计量 metering |
开始 | 1 | |
| 停止 | 0 | ||
|
能耗 energy |
无 | ||
|
电压 voltage |
无 | ||
|
电流 current |
无 | ||
|
视在功率 apparent_power |
无 | ||
|
有功功率 active_power |
无 | ||
|
功率因数 power_factor |
无 | ||
2.2 设备指令
设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
在私有化(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"} | ||
|
查询 query |
今日用电量 | {"query":"today"} | 从今天0时0分开始到现在的总的用电量 |
| 统计电量 | {"query":"amount"} | 从上次清除统计电量到现在的总的用电量 | |
| 总用电量 | {"query":"total"} | 从开机到现在的总的用电量 | |
| 过去3天用电量 | {"query":"days"} | 过去3天的每天的用电量 | |
| 过去6小时用电量 | {"query":"hours"} | 过去6个小时的每天的用电量 | |
|
清除 clear |
全部 | {"clear":"all"} | |
| 今日用电量 | {"clear":"today"} | ||
| 统计电量 | {"clear":"amount"} | ||
| 过去3天用电量 | {"clear":"days"} | ||
| 过去6小时用电量 | {"clear":"hours"} |
2.2 触发事件
当设备属性状态值因为下面两个原因发生改变时触发:
1. 自身状态变化(如传感器的数值发生变化);
2. 人为操作(按下了设备按钮)
事件被触发后,平台会携带设备当前状态参数,实时上报消息,
具体机制在“第5节:消息推送”有详细描述
1. 自身状态变化(如传感器的数值发生变化);
2. 人为操作(按下了设备按钮)
事件被触发后,平台会携带设备当前状态参数,实时上报消息,
具体机制在“第5节:消息推送”有详细描述
公共事件(所有产品均支持)
| 名称 | 内容 | 说明 | |
|---|---|---|---|
| 开机 | {"name":"boot","state":{当前属性值}} | 设备加电、云端登记后触发,上报时携带当前状态(各功能属性的值) | |
本产品的事件
| 事件 | 名称 | 说明 |
|---|---|---|
| 按钮被按下 | btn1 |
2.3 配置项
所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
| 配置项 | 名称 | 内容 | 说明 |
|---|---|---|---|
|
开机状态 relay1 |
通 | 1 | |
| 断 | 0 | ||
|
按钮动作 action1 |
状态反转 | reverse | |
| 先断后通 | reset | ||
| 先通后断 | point | ||
| 禁用 | disable | ||
|
按钮延时 time1 |
1秒 | 1000 | |
| 2秒 | 2000 | ||
| 3秒 | 3000 | ||
| 4秒 | 4000 | ||
| 5秒 | 5000 | ||
|
计量间隔 metering_interval |
5秒 | 5 | |
| 10秒 | 10 | ||
| 20秒 | 20 | ||
| 30秒 | 30 | ||
| 60秒 | 60 | ||
|
开机计量 metering_boot |
开机后马上开始 | 1 | |
| 通过命令开始 | 0 | ||
|
大功率触发持续时间 high_power_time |
不触发 | 0 | |
| 1秒 | 1 | ||
| 2秒 | 2 | ||
| 3秒 | 3 | ||
|
大功率触发值 high_power_value |
3kW | 3000 | |
| 2.5kW | 2500 | ||
| 2kW | 2000 | ||
| 1.5kW | 1500 | ||
| 1kW | 1000 | ||
|
大功率触发动作 high_power_action |
无 | none | |
| 断开 | 0 | ||
|
小功率触发持续时间 low_power_time |
不触发 | 0 | |
| 1秒 | 1 | ||
| 10秒 | 10 | ||
| 30秒 | 30 | ||
| 1m | 60 | ||
| 2m | 120 | ||
| 3m | 180 | ||
| 5m | 300 | ||
|
小功率触发值 low_power_value |
1w | 1 | |
| 2w | 2 | ||
| 3w | 3 | ||
| 4w | 4 | ||
| 5w | 5 | ||
| 10w | 10 | ||
| 15w | 15 | ||
| 20w | 20 | ||
|
小功率触发动作 low_power_action |
无 | none | |
| 断开 | 0 |
附. 固件列表
固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
| 版本 | ID | 大小 | 发布日期 | 说明 |
|---|---|---|---|---|
|
V12 p46.20250823.v12 |
id.1225 | 284.83 KB | 2025-08-23 10:02:35 | 无 |
| id.1228 | 288.27 KB | 2025-08-23 10:04:34 | 无 | |
| id.1229 | 284.8 KB | 2025-08-23 10:07:15 | 无 | |
| id.1230 | 284.8 KB | 2025-08-23 10:07:16 | 无 | |
|
V11 p46.20250813.v11 |
id.1204 | 302.89 KB | 2025-08-13 10:08:21 | 无 |
| id.1205 | 302.89 KB | 2025-08-13 10:10:26 | 无 | |
| id.1206 | 302.83 KB | 2025-08-13 10:10:27 | 无 | |
| id.1207 | 302.83 KB | 2025-08-13 10:10:28 | 无 | |
|
V10 p46.20250624.v10 |
id.1118 | 309.14 KB | 2025-06-24 18:19:00 | 无 |
| id.1128 | 309.14 KB | 2025-06-24 18:50:55 | 无 | |
| id.1130 | 309.06 KB | 2025-06-24 18:50:57 | 无 | |
| id.1131 | 309.06 KB | 2025-06-24 18:51:40 | 无 | |
|
V9 p46.20241211.v9 |
id.890 | 288.48 KB | 2024-12-11 15:26:17 | 无 |
| id.891 | 288.48 KB | 2024-12-11 15:27:11 | 无 | |
| id.892 | 288.48 KB | 2024-12-11 15:27:12 | 无 | |
| id.893 | 288.47 KB | 2024-12-11 15:27:13 | 无 | |
| id.894 | 288.48 KB | 2024-12-11 15:28:52 | 无 | |
|
V8 p46.20240904.v8 |
id.687 | 283.92 KB | 2024-09-04 18:35:10 | 无 |
| id.695 | 283.91 KB | 2024-09-04 18:51:39 | 无 | |
| id.696 | 283.92 KB | 2024-09-04 18:52:00 | 无 | |
| id.697 | 283.87 KB | 2024-09-04 18:52:46 | 无 | |
| id.698 | 283.87 KB | 2024-09-04 18:52:49 | 无 | |
|
V7 p46.20240728.v7 |
id.611 | 283.53 KB | 2024-07-28 15:44:16 | 无 |
| id.619 | 283.47 KB | 2024-07-28 15:53:40 | 无 | |
|
优化内存 p46.20240715.v6 |
id.552 | 282.85 KB | 2024-07-15 17:47:36 | 无 |
| id.553 | 283.23 KB | 2024-07-15 17:48:21 | 无 | |
|
增加运行模式 p46.20240702.v5 |
id.519 | 284.62 KB | 2024-07-02 17:01:13 | 无 |
| id.520 | 284.53 KB | 2024-07-02 17:01:26 | 无 | |
|
网关支持 p46.20240613.v4 |
id.471 | 284.53 KB | 2024-06-13 16:35:00 | 无 |
| id.516 | 284.62 KB | 2024-07-02 16:57:28 | 无 | |
|
私有化支持 p46.20240428.v3 |
id.429 | 346.27 KB | 2024-04-28 17:30:48 | 无 |
| id.433 | 346.2 KB | 2024-04-28 18:03:28 | 无 |