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

2.1 状态属性

状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
属性 选项 说明
总体感应
target
有人 1
无人 0
雷达模块
radar_enable
打开 1
关闭 0
雷达感应
radar_target
有人 1
无人 0
红外模块
infrared_enable
打开 1
关闭 0
红外感应
infrared_target
有人 1
无人 0
线路
power
通/开 1
断/关 0

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息:网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备,并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备,放弃当前状态
本产品的命令
命令 名称 内容 说明

2.2 触发事件

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

2.3 配置项

所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
配置项 名称 内容 说明
按钮动作
action1
状态反转 reverse
禁用 disable
LED灯
led
与线路同步 rl_s 线路通时亮,线路断时灭
与线路相反 rl_r
与存在同步 ss_s
与存在相反 ss_r
长亮 1
长灭 0
闪烁 blink 每10秒,闪一次
雷达开机状态
radar
打开 1
关闭 0
雷达灵敏度
radar_target_detect
0 检测微动
1 只检测移动
雷达有人触发持续时间
radar_change_1
马上 0
1s 1
2s 2
3s 3
5s 5
雷达无人触发持续时间
radar_change_0
马上 0
30s 30
1m 60
2m 120
3m 180
5m 300
10m 600
红外开机状态
infrared
打开 1
关闭 0
红外有人触发持续时间
infrared_change_1
马上 0
1s 1
2s 2
3s 3
5s 5
红外无人触发持续时间
infrared_change_0
马上 0
30s 30
1m 60
2m 120
3m 180
5m 300
10m 600
线路开机状态
relay1
1
0
发现无人时线路动作
relay_change_0
打开 1
关闭 0
无动作 no
发现有人时线路动作
relay_change_1
打开 1
关闭 0
无动作 no

附. 固件列表

固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V8
p51.20251226.v8
id.1532 280.32 KB 2025-12-26 19:55:29
id.1541 270.18 KB 2025-12-26 20:01:44
id.1542 280.32 KB 2025-12-26 20:01:44
id.1643 282.24 KB 2026-01-06 16:01:25
id.1694 282.24 KB 2026-01-29 21:03:43
V7
p51.20250408.v7
id.1001 283.32 KB 2025-04-08 10:31:24
V6
p51.20250304.v6
id.975 280.63 KB 2025-03-04 10:03:21
V5
p51.20241030.v5
id.777 274.2 KB 2024-10-30 15:33:17
20241011后出厂产品
p51.20241011.v4
id.741 273.98 KB 2024-10-11 20:36:14
V3
p51.20241011.v3
id.740 276.97 KB 2024-10-11 10:21:37
V2
p51.20240806.v2
id.634 272.23 KB 2024-08-06 21:58:16
V1
p51.20240318.v1
id.381 342.36 KB 2024-03-18 16:02:02