Настройка белого света с регулировкой температуры
Каталог устройств → Светильник → Белый свет CCT
Белый свет CCT позволяет независимо менять яркость и оттенок белого — от тёплого до холодного. В XIOT для этого используется характеристика Температура цвета. Устройство и светильник должны поддерживать такую регулировку; обычная одноцветная лента не становится CCT после активации характеристики.
Подготовка и характеристики
Для CCT-ленты нужен диммер в соответствующем режиме. Например, WB-LED и WB-MRGBW-D поддерживают режимы CCT; набор видимых каналов зависит от выбранного режима и версии шаблона.
- Активируйте Включение, Яркость и Температуру цвета. Цвет RGB для обычной CCT-ленты не нужен.
- Для диммера с отдельным включением выберите три канала одной CCT-ленты: её включение, яркость и температуру цвета. Вариант без отдельного включения разобран ниже.
- Укажите адреса состояния там, где диммер их возвращает.
- Согласуйте шкалу температуры: 0 % XIOT должен соответствовать тёплому свету, 100 % — холодному. Если направление оборудования противоположное, поменяйте крайние значения в преобразовании.
- Проверьте тёплый, средний и холодный свет при одинаковой яркости, затем отдельно проверьте диммирование.
Не вводите Кельвины непосредственно в характеристику XIOT со шкалой 0–100. Также не выбирайте два произвольных канала W вместо предусмотренного устройством режима CCT: смешивание белых каналов должно выполняться согласованным механизмом оборудования.
Для WB сначала выберите режим CCT в конфигурации диммера, проверьте его управление и получите актуальные каналы через драйвер XIOT. Выбирайте каналы одной и той же ленты. Названия каналов сверяйте со своей версией шаблона.
Выберите схему включения
| Что предоставляет оборудование | Что настроить в XIOT |
|---|---|
| Отдельные включение, яркость и температура цвета | Привяжите каждую характеристику к её каналу. Включение через изменение яркости — нет. |
| Только яркость и температура цвета | У Включения оба адреса пустые, ожидание состояния выключено. Привяжите яркость и температуру цвета; Включение через изменение яркости — да. Точный пример и диапазоны: Arlight DALI. |
Галочку возле адреса состояния включайте только у привязанных характеристик, для которых оборудование действительно возвращает обратное значение. Наличие адреса команды само по себе не подтверждает наличие чтения.
Диапазон и параметры
В характеристике XIOT 0 % означает тёплый край, 100 % — холодный. Сначала найдите эти два края в документации и интерфейсе оборудования, затем задайте соответствие. Преобразование команды и обратного значения должно согласовываться. Шкала в Кельвинах и обратная шкала оборудования не взаимозаменяемы.
Для примера Arlight крайним значениям XIOT соответствуют 0 % → 1000 и 100 % → 80; это числа конкретного шлюза, а не универсальная настройка всех CCT-диммеров.
Минимум яркости при включении задайте явно по светильнику. Шаг и задержка диммирования относятся к яркости, а не к диапазону температуры цвета. Общие параметры разобраны в статье «Светильник».
Пример CCT-группы Arlight в редакторе
В примере «Лента CCT» используется группа 1 шлюза Arlight с шаблоном XIOT из инструкции подключения Arlight. Яркость и температура цвета относятся к одной группе.
- У Включения оставьте оба адреса пустыми и снимите галочку ожидания.
- У Яркости выберите Group 1 Brightness для управления и состояния. Включите ожидание ответа. В соответствиях задайте 0 % → 0 и 100 % → 254.
- У Температуры цвета выберите Group 1 Color Temperature как адрес управления. У этого канала в выбранном шаблоне есть только запись: адрес состояния оставьте пустым, галочку ожидания снимите.
- Для температуры цвета задайте 0 % → 1000 и 100 % → 80. Тёплый и холодный края не меняют общую яркость группы.
- В параметрах включите управление включением через яркость; задайте минимум 10 %, шаг 5 % и задержку 0,5 с для начальной настройки.





Регулировки в приложении
Нажмите и удерживайте карточку светильника, чтобы открыть подробное управление.

Проверка результата
- Загрузите конфигурацию и дождитесь восстановления связи.
- При одной и той же яркости задайте 0, 50 и 100 % температуры цвета: проверьте тёплый, промежуточный и холодный свет.
- На каждом краю отдельно проверьте регулировку яркости и включение/выключение.
- Если оборудование возвращает состояние, сравните значение в XIOT с ним, в том числе после внешней команды.
- Проверьте органы управления в приложении. Перепутанные тёплый и холодный края исправляйте в преобразовании, а не перестановкой смысла характеристики.
Документация оборудования
Другие варианты подключения и общие параметры: Светильник.