了解产品定义（物模型），可以帮助您更加准确、灵活的调用接口，接入设备。
产品定义
2.1 状态属性
2.2 触发事件
2.3 配置项

2.1 状态属性

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

2.2 设备指令

设备支持以下命令，可通过接口向设备下发这些命令。
在私有化（Broker、网关等任何方式）时，发送命令方式不同，但内容完全相同。
系统命令（所有产品均支持）
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息：网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备，并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备，放弃当前状态
本产品的命令
命令 名称 内容 说明
设置密码
pwd 		设置一个临时密码123123 {"pwd":"{"temp":"123123","limit":60}"} 60秒内有效，超期后，设备将删除此密码。
设置一个临时密码8888 {"pwd":"{"temp":"8888"}"} 默认有效期，自下发起3600秒
设置一个永久密码123456789 {"pwd":"{"persist":"123456789"}"}
密码列表
list 		临时密码列表 {"list":"temp"}
永久密码列表 {"list":"persist"}
删除密码
delete 		删除一个临时密码 {"delete":"{"temp":"123123"}"}
删除一个或永久密码 {"delete":"{"persist":"123456789"}"}
清空密码
clear 		清空临时密码 {"clear":"temp"}
清空永久密码 {"clear":"persist"}
先断后通
reset 		2秒 {"reset":"2000"}
3秒 {"reset":"3000"}
5秒 {"reset":"5000"}
先通后断
point 		2秒 {"point":"2000"}
3秒 {"point":"3000"}
5秒 {"point":"5000"}

2.2 触发事件

当设备属性状态值因为下面两个原因发生改变时触发：
1. 自身状态变化（如传感器的数值发生变化）；
2. 人为操作（按下了设备按钮）
事件被触发后，平台会携带设备当前状态参数，实时上报消息，
具体机制在“第5节：消息推送”有详细描述
公共事件（所有产品均支持）
名称 内容 说明
开机 {"name":"boot","state":{当前属性值}} 设备加电、云端登记后触发，上报时携带当前状态（各功能属性的值）
本产品的事件
事件 名称 说明
密码正确[放行] pass
密码错误[拒绝] deny
线路 relay1
按下出门开关 btn1

2.3 配置项

所有的配置项均保存在设备的Flash中，因为Flash有擦写次数限制，
所以平台未开放批量修改设备配置的接口，您可以在控制台来修改设备的配置项。
所有配置项均有默认值，如不了解配置项目意义，请勿随意修改；
修改配置项只有在设备在线时，才能成功下发并保存，并且不需要重启设备。
配置项
配置项 名称 内容 说明
开机状态
relay1 		通 1 默认
断 0
通行动作
pass_action 		先断后通 reset 默认
先通后断 point
通 1
断 0
无动作 dis
延时时间（毫秒）
pass_time 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000 默认
8秒 8000
10秒 10000
出门开关动作
action1 		先断后通 reset
先通后断 point
通 1
断 0
无动作 dis
出门开关延时
time1 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
按钮灵敏度
sensitivity 		1 1
2 2
3 3
4 4
5 5
6 6
7 7
8 8
threshold_1
threshold_1 		4 4
6 6
8 8
10 10
20 20
50 50
threshold_2
threshold_2 		2 2
3 3
4 4
5 5
8 8
threshold_3
threshold_3 		2 2
3 3
4 4
5 5
8 8
20 20
threshold_4
threshold_4 		2 2
3 3
4 4
5 5
8 8
threshold_5
threshold_5 		2 2
3 3
4 4
5 5
8 8
threshold_6
threshold_6 		2 2
3 3
4 4
5 5
8 8
20 20
threshold_7
threshold_7 		2 2
3 3
4 4
5 5
8 8
threshold_8
threshold_8 		2 2
3 3
4 4
5 5
8 8
threshold_9
threshold_9 		2 2
3 3
4 4
5 5
8 8
threshold_10
threshold_10 		2 2
3 3
4 4
5 5
8 8
threshold_11
threshold_11 		2 2
3 3
4 4
5 5
8 8
threshold_12
threshold_12 		5 5
2 2
3 3
4 4
8 8
20 20
10 10

附. 固件列表

固件更新的原则是兼容性升级，即：新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求，则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V1
p168.20260129.v1 		id.1690 281.29 KB 2026-01-29 16:50:52 无
id.1692 281.77 KB 2026-01-29 18:27:59 无
id.1702 281.59 KB 2026-03-18 22:07:04 无