Перейти к содержанию

Настройка белого света с регулировкой температуры

Материал из XIOT Wiki
Версия от 18:20, 3 октября 2026; Admin (обсуждение | вклад) (Иллюстрированные примеры: привязки адресов, параметры и управление светильником в приложении)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Каталог устройств → Светильник → Белый свет CCT

Белый свет CCT позволяет независимо менять яркость и оттенок белого — от тёплого до холодного. В XIOT для этого используется характеристика Температура цвета. Устройство и светильник должны поддерживать такую регулировку; обычная одноцветная лента не становится CCT после активации характеристики.

Подготовка и характеристики

Для CCT-ленты нужен диммер в соответствующем режиме. Например, WB-LED и WB-MRGBW-D поддерживают режимы CCT; набор видимых каналов зависит от выбранного режима и версии шаблона.

  1. Активируйте Включение, Яркость и Температуру цвета. Цвет RGB для обычной CCT-ленты не нужен.
  2. Для диммера с отдельным включением выберите три канала одной CCT-ленты: её включение, яркость и температуру цвета. Вариант без отдельного включения разобран ниже.
  3. Укажите адреса состояния там, где диммер их возвращает.
  4. Согласуйте шкалу температуры: 0 % XIOT должен соответствовать тёплому свету, 100 % — холодному. Если направление оборудования противоположное, поменяйте крайние значения в преобразовании.
  5. Проверьте тёплый, средний и холодный свет при одинаковой яркости, затем отдельно проверьте диммирование.

Не вводите Кельвины непосредственно в характеристику 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. Яркость и температура цвета относятся к одной группе.

  1. У Включения оставьте оба адреса пустыми и снимите галочку ожидания.
  2. У Яркости выберите Group 1 Brightness для управления и состояния. Включите ожидание ответа. В соответствиях задайте 0 % → 0 и 100 % → 254.
  3. У Температуры цвета выберите Group 1 Color Temperature как адрес управления. У этого канала в выбранном шаблоне есть только запись: адрес состояния оставьте пустым, галочку ожидания снимите.
  4. Для температуры цвета задайте 0 % → 1000 и 100 % → 80. Тёплый и холодный края не меняют общую яркость группы.
  5. В параметрах включите управление включением через яркость; задайте минимум 10 %, шаг 5 % и задержку 0,5 с для начальной настройки.


«Лента CCT»: яркость и её состояние привязаны к Group 1 Brightness.
«Лента CCT»: яркость и её состояние привязаны к Group 1 Brightness.
Температура белого света связана с Group 1 Color Temperature. Адрес состояния пустой, ожидание выключено.
Температура белого света связана с Group 1 Color Temperature. Адрес состояния пустой, ожидание выключено.
Параметры CCT-примера Arlight: включение через яркость и начальные значения регулировки.
Параметры CCT-примера Arlight: включение через яркость и начальные значения регулировки.
Тёплый край: значение характеристики 0 соответствует 1000 в канале шлюза.
Тёплый край: значение характеристики 0 соответствует 1000 в канале шлюза.
Холодный край: значение характеристики 100 соответствует 80 в канале шлюза.
Холодный край: значение характеристики 100 соответствует 80 в канале шлюза.

Регулировки в приложении

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

«Лента CCT» в предпросмотре приложения: отдельно регулируются яркость и температура белого света.
«Лента CCT» в предпросмотре приложения: отдельно регулируются яркость и температура белого света.

Проверка результата

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

Документация оборудования

Другие варианты подключения и общие параметры: Светильник.