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

2.1 状态属性

状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
属性 选项 说明
开关
power
打开 1
关闭 0
计量
metering
打开 1
关闭 0
能耗
energy
电压
voltage
电流
current
视在功率
apparent_power
有功功率
active_power
功率因数
power_factor

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(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节:消息推送”有详细描述
公共事件(所有产品均支持)
名称 内容 说明
开机 {"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 大小 发布日期 说明
V13
p44.20251105.v13
id.1369 293.19 KB 2025-11-05 14:27:27
id.1370 284.83 KB 2025-11-05 14:28:55
id.1371 284.8 KB 2025-11-05 14:28:56
id.1372 284.8 KB 2025-11-05 14:28:58
V12
p44.20250926.v12
id.1293 288.25 KB 2025-09-26 18:27:09
id.1294 288.25 KB 2025-09-26 18:27:36
V11
p44.20250823.v11
id.1227 305.11 KB 2025-08-23 10:02:40
id.1235 305.11 KB 2025-08-23 10:09:14
id.1236 305.08 KB 2025-08-23 10:09:15
id.1237 305.08 KB 2025-08-23 10:09:52
V10
p44.20250624.v10
id.1116 309.14 KB 2025-06-24 18:18:34
id.1125 309.14 KB 2025-06-24 18:50:13
id.1126 309.06 KB 2025-06-24 18:50:26
id.1127 309.06 KB 2025-06-24 18:50:27
V9
p44.20250429.v9
id.1015 290.85 KB 2025-04-29 15:37:07
V8
p44.20241107.v8
id.783 289.89 KB 2024-11-07 17:19:59
id.866 289.89 KB 2024-12-05 16:17:04
V7
p44.20240726.v7
id.594 284.87 KB 2024-07-26 09:56:06
id.787 285.95 KB 2024-11-08 19:13:18
计量功能增强
p44.20240625.v6
id.511 284.29 KB 2024-06-25 09:41:36
增加运行模式
p44.20240618.v5
id.491 276.02 KB 2024-06-18 16:39:28
优化网络
p44.20240416.v3
id.412 348.03 KB 2024-04-16 20:53:07