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

2.1 状态属性

状态属性是产品的基础物模型,决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性;
如果是传感器类或具备采样功能的产品,环境变化也会设备状态属性变化。
属性 选项 说明
线路1
power1
1
0
线路2
power2
1
0
线路3
power3
1
0
线路4
power4
1
0
线路5
power5
1
0
线路6
power6
1
0
线路7
power7
1
0
喇叭状态
status
空闲 0
播放中 1
喇叭音量
volume
0 0
1 1
2 2
3 3
4 4
5 5
6 6
7 7
8 8
9 9
喇叭音色
voice
女声 0
男声 1
喇叭语速
speed
0 0
1 1
2 2
3 3
4 4
5 5
6 6
7 7
8 8
9 9
喇叭语调
tone
0 0
1 1
2 2
3 3
4 4
5 5
6 6
7 7
8 8
9 9

2.2 设备指令

设备支持以下命令,可通过接口向设备下发这些命令。
在私有化(Broker、网关等任何方式)时,发送命令方式不同,但内容完全相同。
系统命令(所有产品均支持)
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息:网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备,并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备,放弃当前状态
本产品的命令
命令 名称 内容 说明
批量控制
batch
全开 {"batch":"{"power":1}"}
全关 {"batch":"{"power":0}"}
线路1|3|5|7开 {"batch":"{"relay":[1,3,5,7],"power":1}"}
线路1|3|5|7关 {"batch":"{"relay":[1,3,5,7],"power":0}"}
线路2|4|6开 {"batch":"{"relay":[2,4,6],"power":1}"}
线路2|4|6关 {"batch":"{"relay":[2,4,6],"power":0}"}
先通后断
point
500毫秒,全部线路 {"point":"{"interval":500}"}
1秒,线路1|3 {"point":"{"relay":[1,3],"interval":1000}"}
2秒,线路2 {"point":"{"relay":[2],"interval":2000}"}
先断后通
reset
500毫秒,全部线路 {"reset":"{"interval":500}"}
1秒,线路1|3 {"reset":"{"relay":[1,3],"interval":1000}"}
2秒,线路2 {"reset":"{"relay":[2],"interval":2000}"}
5秒,线路7 {"reset":"{"relay":["7"],"interval":5000}"}
语音播报
play:gbk:16
到账提醒 {"play:gbk:16":"支付宝到账200元"}
业务提醒 {"play:gbk:16":"你好,小程序上有新的业务线索:河北的刘先生要定制一款小程序,请及时处理"}
工作通知(男声) {"play:gbk:16":"[m1]小王,请你到一下张总的办公室"}
长文本 {"play:gbk:16":"今天天气非常晴朗,暖暖的太阳照在人身上真舒服。我不禁的感叹:这真是美好的一天。最长不要超过50个字符,如果超过50个,可分多条连续下发命令。"}
提示音+文字 {"play:gbk:16":"[message_3]欢迎光临"}
数字 {"play:gbk:16":"ID为[n1]888,手机号码为[n3]18500860080的客户,共消费[n2]1888元,优惠100元。"}
多音字 {"play:gbk:16":"请把空调调[=diao4]转一下角度"}
停顿 {"play:gbk:16":"你[w0]好,你好"}
喇叭铃声
ring
1 {"ring":"1"}
2 {"ring":"2"}
3 {"ring":"3"}
4 {"ring":"4"}
5 {"ring":"5"}
喇叭提示音
message
1 {"message":"1"}
2 {"message":"2"}
3 {"message":"3"}
4 {"message":"4"}
5 {"message":"5"}
喇叭警示音
alert
1 {"alert":"1"}
2 {"alert":"2"}
3 {"alert":"3"}
4 {"alert":"4"}
5 {"alert":"5"}
停止播放
stop
停止当前 {"stop":"0"}
全部停止 {"stop":"1"}

2.2 触发事件

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

2.3 配置项

所有的配置项均保存在设备的Flash中,因为Flash有擦写次数限制,
所以平台未开放批量修改设备配置的接口,您可以在控制台来修改设备的配置项。
所有配置项均有默认值,如不了解配置项目意义,请勿随意修改;
修改配置项只有在设备在线时,才能成功下发并保存,并且不需要重启设备。
配置项
配置项 名称 内容 说明
按钮动作
btn1
全断 0 默认
全通 1
禁用 disable
1路开机状态
relay1
1
0 默认
2路开机状态
relay2
1
0 默认
3路开机状态
relay3
1
0 默认
4路开机状态
relay4
1
0
5路开机状态
relay5
1
0
6路开机状态
relay6
1
0
7路开机状态
relay7
1
0
7路离线状态
offline7
1
0
不理会 no
1路输入模式
mode1
轻触 0
长按 1
1路输入动作
action1
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
1路输入延时
time1
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
2路输入模式
mode2
轻触 0
长按 1
2路输入动作
action2
状态反转 reverse 默认
先断后通 reset
先通后断 point
禁用 disable
2路输入延时
time2
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
3路输入模式
mode3
轻触 0
长按 1
3路输入动作
action3
状态反转 reverse 默认
先断后通 reset
先通后断 point
禁用 disable
3路输入延时
time3
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
4路输入模式
mode4
轻触 0
长按 1
4路输入动作
action4
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
4路输入延时
time4
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
5路输入模式
mode5
轻触 0
长按 1
5路输入动作
action5
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
5路输入延时
time5
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
6路输入模式
mode6
轻触 0
长按 1
6路输入动作
action6
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
6路输入延时
time6
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
7路输入模式
mode7
轻触 0
长按 1
7路输入动作
action7
状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
7路输入延时
time7
1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
8路输入模式
mode8
轻触 0
长按 1
8路输入动作
action8
全断 0
全通 1
禁用 disable
led灯
led
长亮 open
长灭 close
长亮|静音时灭 volume
长灭|播放时亮 play
开机提示音
boot_message
0
提示音1 1
提示音2 2
提示音3 3
提示音4 4
提示音5 5
上线提示音
online_message
0
1 1
2 2
3 3
4 4
5 5
操作提示音
oper_message
关闭 0
提示音1 1
提示音2 2
提示音3 3
提示音4 4
提示音5 5
消抖
filter
150
200
250
300
负载时序
gap
无保护 0
间隔1秒 1
间隔2秒 2
间隔3秒 3

附. 固件列表

固件更新的原则是兼容性升级,即:新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求,则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V17
p36.20241222.v17
id.911 288.83 KB 2024-12-22 10:42:24
id.912 288.83 KB 2024-12-22 10:43:01
V16
p36.20241206.v16
id.878 285.04 KB 2024-12-06 14:39:12
id.879 285.04 KB 2024-12-06 14:39:23
V15
p36.20241120.v15
id.833 285.1 KB 2024-11-20 17:53:42
id.834 285.1 KB 2024-11-20 17:54:03
V14
p36.20241026.v14
id.767 281.07 KB 2024-10-26 18:02:44
id.768 281.07 KB 2024-10-26 18:21:34
V13
p36.20241013.v13
id.758 281.09 KB 2024-10-13 14:29:20
id.759 281.09 KB 2024-10-13 14:29:38
V12
p36.20240930.v12
id.725 281.05 KB 2024-09-30 18:36:34
id.726 281.05 KB 2024-09-30 18:44:02
V11
p36.20240904.v11
id.667 278.75 KB 2024-09-04 16:11:14
id.669 278.74 KB 2024-09-04 16:12:37
V10
p36.20240812.v10
id.640 279.75 KB 2024-08-12 09:54:24
id.642 279.74 KB 2024-08-12 09:59:57
V9
p36.20240725.v9
id.575 279.75 KB 2024-07-25 11:33:12
id.578 279.74 KB 2024-07-25 14:44:16
内存优化
p36.20240715.v8
id.528 278.95 KB 2024-07-15 10:45:55