led_strip

Обновлено 30 августа 2023

Светодиодная лента.

Доступные функции устройства

У устройства могут быть все нижеперечисленные функции или только часть из них. Например, если умная лента не умеет менять температуру цвета, включать функцию light_colour_temp в описание ее модели не нужно.

Некоторые функции обязательные: они должны быть у всех лент.

Функция	Обязательная?	Описание
light_brightness		Яркость устройства
light_colour		Цвет устройства
light_colour_temp		Температура цвета устройства
light_mode		Режим работы устройства: цветной или белый цвет
on_off	✔︎	Удаленное включение и выключение устройства
online	✔︎	Доступность устройства: офлайн или онлайн

Пример описания модели ленты

Модель описывается в соответствии со структурой model. В примере описана лента, которая может включаться и выключаться удаленно, поддерживает белый и цветной режим работы, умеет менять яркость, цвет и цветовую температуру. У ленты есть таймер выключения.

Кроме того, для модели описана зависимость функции light_colour (цвет освещения) от функции light_mode (режим работы): менять цвет ленты можно, только если она переключена в цветной режим работы.

Также изменены доступные значения для функции light_brightness (яркость): указано, что устройства этой модели умеют менять яркость в диапазоне от 10 до 900 с шагом в 1.

{
    "id": "QWERTY123",
    "manufacturer": "Xiaqara",
    "model": "SM0123456789",
    "hw_version": "3.2",
    "sw_version": "5.7",
    "description": "Умная лента Xiaqara",
    "category": "led_strip",
    "features": [
        "online",
        "on_off",
        "light_mode",
        "light_brightness",
        "light_colour",
        "light_colour_temp",
        "sleep_timer"
    ],
    "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"
            }
        }
    }  
}

Пример описания ленты пользователя

Устройство описывается в соответствии со структурой device. В примере нет описания модели ленты — считаем, что модели описаны отдельно, поэтому достаточно указать только ID модели (здесь — QWERTY123).

{
    "id": "ABCD_003",
    "name": "Моя лента",
    "default_name": "Умная лента",
    "nicknames": ["Светодиодная лента", "Смарт-лента"],
    "home": "Мой дом",
    "room": "Гостиная",
    "groups": ["Ночная подсветка", "Окна"],
    "model_id": "QWERTY123",
    "hw_version": "3.2",
    "sw_version": "5.7",
    "partner_meta": {
        "internal-id": 1234,
        "specificity": "microchip 2A"
    },
}