Device led_strip | Documentation for developers
Skip to main content


Last updated on August 26, 2022

LED strip.

Available device functions

The device can have all the functions listed below or some of them. E.g. if the smart strip cannot change the colour temperature, there is no need in including the light_colour_temp function in its model description.

Some functions are mandatory, and all strips must have them.

light_brightnessDevice brightness
light_colourDevice color
light_colour_tempDevice color temperature
light_modeDevice operation mode: color or white
on_off✔︎Turning the device on and off remotely
online✔︎Device availability: offline or online

Strip model description example

The model shall be described in accordance with the model structure. The example describes a strip that can be switched on/off remotely, supports both the white light mode and the colour mode, can change its light intensity, colour and colour temperature. The strip has a time-out timer.

Besides, a dependency between the light_colour and light_mode functions is described for the model: the strip light colour may only be changed if switched to the colour mode.

Allowed values for the light_brightness function have also been changed: it is indicated that devices of this model can change the brightness from 10 to 900 at an interval of 1.

"id": "QWERTY123",
"manufacturer": "Xiaqara",
"model": "SM0123456789",
"hw_version": "3.2",
"sw_version": "5.7",
"description": "Xiaqara led strip",
"category": "led_strip",
"features": [
"dependencies": {
"light_colour": {
"key": "light_mode",
"value": [
"type": "ENUM",
"enum_value": "colour"
"allowed_values": {
"light_brightness": {
"type": "INTEGER",
"integer_values": {
"min": "10",
"max": "900",
"step": "1"

User's strip description example

The device shall be describe in accordance with the device structure. The example contains no strip model description as we believe that models are described independently and the model ID will be enough (in this case, QWERTY124).

"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"