Learn the product definition (object model), which can help you more accurately and flexibly call the interface to access the device.
Product definition
| 2.1 | State property | |
| 2.2 | Trigger event | |
| 2.3 | Configuration item |
2.1 State property
The status attribute is the basic material model of the product, which determines the function of the product.
By issuing commands, human operations can change these status attributes；
If it is a sensor class or a product with sampling function, the environment will also change the device status attribute.
By issuing commands, human operations can change these status attributes；
If it is a sensor class or a product with sampling function, the environment will also change the device status attribute.
| Property | Options | Value | Description |
|---|---|---|---|
| status | 空闲 | 0 | |
| 播放中 | 1 | ||
| led | 亮 | 1 | |
| 灭 | 0 | ||
| 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 Device command
The device supports the following commands, and can send these commands to the device through the interface.
When private (Broker, gateway, etc. in any way), the command sending method is different, but the content is the same.
When private (Broker, gateway, etc. in any way), the command sending method is different, but the content is the same.
System command（All products support）
| Name | Content | Description |
|---|---|---|
| 网络信息 | {"system":"network"} | View the current network information of the device: network type, signal strength, IP address, etc. |
| Soft reboot | {"system":"restart"} | Restart the device and try to maintain the current state as much as possible |
| Hard reboot | {"system":"reboot"} | Restart the device, abandon the current state |
Commands of this product
| Command | Name | Content | Description |
|---|---|---|---|
|
播报 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]好，你好"} | ||
|
重复 repeat |
重复播报3次 | {"repeat":"3"} | |
|
铃声 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"} | ||
|
灯带 led |
开 | {"led":"1"} | |
| 关 | {"led":"0"} | ||
| 恢复默认 | {"led":"default"} | ||
|
颜色 color |
红 | {"color":"[255,0,0]"} | |
| 绿 | {"color":"[0,255,0]"} | ||
| 蓝 | {"color":"[0,0,255]"} | ||
| 黄 | {"color":"[255,255,0]"} | ||
| 青 | {"color":"[0,255,255]"} | ||
| 紫 | {"color":"[255,0,255]"} | ||
| 白 | {"color":"[255,255,255]"} | ||
|
闪烁 twinkle |
快 | {"twinkle":"100"} | |
| 慢 | {"twinkle":"500"} | ||
| 停 | {"twinkle":"0"} | ||
|
呼吸 breath |
快 | {"breath":"1000"} | |
| 慢 | {"breath":"2000"} | ||
| 停 | {"breath":"0"} | ||
|
多彩 colorful |
红蓝切换 | {"colorful":"{"speed":1500,"colors":[[155,0,0],[0,0,155]]}"} | |
| 三色切换 | {"colorful":"{"speed":1500,"colors":[[155,0,0],[0,155,0],[0,0,155]]}"} | ||
| 停 | {"colorful":"{"speed":0}"} |
2.2 Trigger event
When the device property status value changes because of the following two reasons:
1. Self-state changes (such as the value of a sensor changes);
2. Human operation (pressed the device button)
After the event is triggered, the platform will carry the current status parameter of the device, and report the message in real time,
The specific mechanism is described in "Section 5: Message push"
1. Self-state changes (such as the value of a sensor changes);
2. Human operation (pressed the device button)
After the event is triggered, the platform will carry the current status parameter of the device, and report the message in real time,
The specific mechanism is described in "Section 5: Message push"
Public event（All products support）
| Name | Content | Description | |
|---|---|---|---|
| Power on | {"name":"boot","state":{Current attribute value}} | Device power on, cloud registration after trigger, report with the current status (the value of each function attribute) | |
This product event
| Event | Name | Description |
|---|---|---|
| Press the button | btn1 |
2.3 Configuration item
All configuration items are saved in the Flash of the device, because Flash has a write limit,
So the platform does not open the interface to modify the configuration of the device in batch, you can modify the configuration item in the console.
All configuration items have default values, such as do not understand the meaning of the configuration item, do not modify it randomly;
Modifying the configuration item can only be successfully sent and saved when the device is online, and does not require a restart of the device.
So the platform does not open the interface to modify the configuration of the device in batch, you can modify the configuration item in the console.
All configuration items have default values, such as do not understand the meaning of the configuration item, do not modify it randomly;
Modifying the configuration item can only be successfully sent and saved when the device is online, and does not require a restart of the device.
Configuration item
| Configuration item | Name | Content | Description |
|---|---|---|---|
| btn | 静音/恢复 | volume | |
| 禁用 | disable | ||
| 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 | ||
| led_color | 红 | [120,0,0] | |
| 绿 | [0,120,0] | ||
| 蓝 | [0,0,120] |
Attachment. Firmware list
The principle of firmware update is compatibility upgrade, that is, the new firmware version will retain the original functions and commands.
If the current firmware can meet the business requirements, you can not upgrade the latest version of the firmware.
If the current firmware can meet the business requirements, you can not upgrade the latest version of the firmware.
Last 10
| Version | ID | Size | Release date | Description |
|---|---|---|---|---|
|
V19 p35.20251222.v19 |
id.1580 | 282.65 KB | 2026-01-05 22:28:21 | 无 |
| id.1581 | 282.65 KB | 2026-01-05 22:31:40 | 无 | |
| id.1583 | 282.65 KB | 2026-01-05 22:35:04 | 无 | |
| id.1584 | 282.65 KB | 2026-01-05 22:37:47 | 无 | |
| id.1571 | 284.71 KB | 2026-01-05 14:38:01 | 无 | |
| id.1575 | 284.71 KB | 2026-01-05 21:31:25 | 无 | |
| id.1725 | 283.13 KB | 2026-06-04 10:14:57 | 无 | |
|
V18 p35.20251013.v18 |
id.1341 | 282.16 KB | 2025-10-13 16:27:46 | 无 |
| id.1340 | 282.16 KB | 2025-10-13 16:26:09 | 无 | |
| id.1338 | 283.17 KB | 2025-10-13 16:25:53 | 无 | |
| id.1339 | 289.49 KB | 2025-10-13 16:26:08 | 无 | |
|
V17 p35.20250624.v17 |
id.1111 | 282.28 KB | 2025-06-24 16:52:23 | 无 |
| id.1110 | 282.28 KB | 2025-06-24 16:51:24 | 无 | |
| id.1108 | 283.14 KB | 2025-06-24 16:48:14 | 无 | |
| id.1109 | 283.14 KB | 2025-06-24 16:51:23 | 无 | |
|
V16 p35.20250523.v16 |
id.1086 | 301.2 KB | 2025-06-14 14:25:39 | 无 |
| id.1047 | 301.71 KB | 2025-05-23 23:03:05 | 无 | |
| id.1046 | 305 KB | 2025-05-23 23:02:14 | 无 | |
|
V15 p35.20250517.v15 |
id.1031 | 300.88 KB | 2025-05-17 11:36:35 | 无 |
| id.1032 | 304.23 KB | 2025-05-17 11:40:10 | 无 | |
|
V14 p35.20250320.v14 |
id.993 | 286.68 KB | 2025-03-20 15:24:48 | 无 |
| id.994 | 286.68 KB | 2025-03-20 15:25:00 | 无 | |
|
V13 p35.20250102.v13 |
id.933 | 286.8 KB | 2025-01-02 17:36:50 | 无 |
| id.935 | 286.81 KB | 2025-01-02 17:40:17 | 无 | |
|
V12 p35.20241221.v12 |
id.904 | 285.48 KB | 2024-12-21 11:14:33 | 无 |
| id.905 | 285.48 KB | 2024-12-21 11:15:09 | 无 | |
|
V11 p35.20241120.v11 |
id.839 | 281.36 KB | 2024-11-20 18:01:34 | 无 |
| id.840 | 281.36 KB | 2024-11-20 18:01:48 | 无 |