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