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

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.
Property Options Value Description
lamp 1
0

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.
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
颜色
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"
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.
Configuration item
Configuration item Name Content Description
btn 静音/恢复 volume
禁用 disable
lamp 1
0
lamp_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.
Last 10
Version ID Size Release date Description
V3
p105.20260115.v3
id.1672 268.44 KB 2026-01-15 10:04:08
id.1674 268.44 KB 2026-01-15 10:15:35
V2
p105.20241201.v2
id.862 276.33 KB 2024-12-01 11:49:33
id.864 276.33 KB 2024-12-02 11:36:27
V1
p105.20241120.v1
id.841 274.13 KB 2024-11-20 18:12:27
id.846 274.13 KB 2024-11-22 11:43:57