led_strip
LED strip.
Device functions available
The device may have all the following functions or just some of them. For example, if a smart strip cannot change the color temperature, you do not need to include the light_colour_temp
function in the model description.
Some functions are mandatory for all strips.
Function | Mandatory? | Description |
light_brightness | Brightness shown by the device | |
light_colour | Color shown by the device | |
light_colour_temp | Color temperature shown by the device | |
light_mode | Device mode: color or white | |
on_off | ✔︎ | Switching the device on and off remotely |
online | ✔︎ | Device availability: offline or online |
Sample description of the strip model
The model is described in accordance with the model structure. The sample describes a strip that can be turned on and off remotely, supports white and color modes, can change brightness, color and color temperature. The strip has an off timer.
In addition, the model describes the dependency of the light_colour
function from the light_mode
function: you can only change the color of the strip if it is switched to color mode.
{
"id": "QWERTY123",
"manufacturer": "Xiaqara",
"model": "SM0123456789",
"hw_version": "3.2",
"sw_version": "5.7",
"description": "Xiaqara LED strip",
"category": "light",
"features": [
"online",
"on_off",
"light_mode",
"light_brightness",
"light_colour",
"light_colour_temp",
"sleep_timer"
],
"dependencies": {
"light_colour": {
"key": "light_mode",
"values": [
{
"type": "ENUM",
"enum_value": "colour"
}
]
}
}
}
Sample description of a user strip
The model is described in accordance with the device structure. In the sample there is no description of the strip model, therefore we believe that the models are described in a separate file and it is sufficient to specify only the model ID (in this case, QWERTY123).
{
"id": "ABCD_003",
"name": "My strip",
"default_name": "Smart strip",
"nicknames": [
"LED strip",
"Intelligent strip"
],
"home": "My home",
"room": "Living room",
"groups": [
"Night lighting",
"Windows",
],
"model_id": "QWERTY123",
"hw_version": "3.2",
"sw_version": "5.7"
}