Просмотр кода страницы Tunable-white-light-setup

{{DISPLAYTITLE:Настройка белого света с регулировкой температуры}}
[[Xiot-devices|Каталог устройств]] → [[Light-fixture|Светильник]] → '''Белый свет CCT'''

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

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

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

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

Не вводите Кельвины непосредственно в характеристику XIOT со шкалой 0–100. Также не выбирайте два произвольных канала W вместо предусмотренного устройством режима CCT: смешивание белых каналов должно выполняться согласованным механизмом оборудования.

Для WB сначала выберите режим CCT в конфигурации диммера, проверьте его управление и получите актуальные каналы через [[Wiren-board-driver-setup|драйвер XIOT]]. Выбирайте каналы одной и той же ленты. Названия каналов сверяйте со своей версией шаблона.

== Выберите схему включения ==

{| class="wikitable"
! Что предоставляет оборудование !! Что настроить в XIOT
|-
| Отдельные включение, яркость и температура цвета || Привяжите каждую характеристику к её каналу. '''Включение через изменение яркости — нет'''.
|-
| Только яркость и температура цвета || У '''Включения''' оба адреса пустые, ожидание состояния выключено. Привяжите яркость и температуру цвета; '''Включение через изменение яркости — да'''. Точный пример и диапазоны: [[Arlight-dali-logic-lite-wiren-board-integration#10. 🏠 Добавление в XIOT|Arlight DALI]].
|}

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

== Диапазон и параметры ==

В характеристике XIOT 0 % означает тёплый край, 100 % — холодный. Сначала найдите эти два края в документации и интерфейсе оборудования, затем задайте соответствие. Преобразование команды и обратного значения должно согласовываться. Шкала в Кельвинах и обратная шкала оборудования не взаимозаменяемы.

Для примера Arlight крайним значениям XIOT соответствуют '''0 % → 1000''' и '''100 % → 80'''; это числа конкретного шлюза, а не универсальная настройка всех CCT-диммеров.

Минимум яркости при включении задайте явно по светильнику. Шаг и задержка диммирования относятся к яркости, а не к диапазону температуры цвета. Общие параметры разобраны в [[Light-fixture#Параметры светильника|статье «Светильник»]].

== Пример CCT-группы Arlight в редакторе ==

В примере «Лента CCT» используется группа 1 шлюза Arlight с шаблоном XIOT из [[Arlight-dali-logic-lite-wiren-board-integration|инструкции подключения Arlight]]. Яркость и температура цвета относятся к одной группе.

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


[[Файл:Cct-brightness-bindings-20261003.png|thumb|center|820px|alt=«Лента CCT»: яркость и её состояние привязаны к Group 1 Brightness.|«Лента CCT»: яркость и её состояние привязаны к Group 1 Brightness.]]

[[Файл:Cct-temperature-bindings-20261003.png|thumb|center|820px|alt=Температура белого света связана с Group 1 Color Temperature. Адрес состояния пустой, ожидание выключено.|Температура белого света связана с Group 1 Color Temperature. Адрес состояния пустой, ожидание выключено.]]

[[Файл:Cct-parameters-20261003.png|thumb|center|820px|alt=Параметры CCT-примера Arlight: включение через яркость и начальные значения регулировки.|Параметры CCT-примера Arlight: включение через яркость и начальные значения регулировки.]]

[[Файл:Cct-temperature-scale-warm-20261003.png|thumb|center|820px|alt=Тёплый край: значение характеристики 0 соответствует 1000 в канале шлюза.|Тёплый край: значение характеристики 0 соответствует 1000 в канале шлюза.]]

[[Файл:Cct-temperature-scale-cold-20261003.png|thumb|center|820px|alt=Холодный край: значение характеристики 100 соответствует 80 в канале шлюза.|Холодный край: значение характеристики 100 соответствует 80 в канале шлюза.]]

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


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

[[Файл:Cct-application-20261003.png|thumb|center|400px|alt=«Лента CCT» в предпросмотре приложения: отдельно регулируются яркость и температура белого света.|«Лента CCT» в предпросмотре приложения: отдельно регулируются яркость и температура белого света.]]

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

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

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

* [https://wiki.wirenboard.com/wiki/WB-LED_v.1_Modbus_LED_Dimmer WB-LED].
* [https://wiki.wirenboard.com/wiki/WB-MRGBW-D_Modbus_LED_Dimmer WB-MRGBW-D].

'''Другие варианты подключения и общие параметры: [[Light-fixture|Светильник]].'''

[[Категория:Документация XIOT]]
{{DEFAULTSORT:Настройка белого света с регулировкой температуры}}