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

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

У цветного света есть несколько способов передачи одного и того же цвета: общая RGB-строка, оттенок/насыщенность или отдельные компоненты. Выберите способ, совместимый с оборудованием и текущей версией драйвера. Ниже приведён пример WB-MRGBW-D с числовыми каналами оттенка, насыщенности и яркости.

== Характеристики и каналы WB-MRGBW-D ==

Перед настройкой подключите диммер через [[Wiren-board-driver-setup|драйвер Wiren Board]], выберите режим RGB в оборудовании и убедитесь, что нужная лента управляется из веб-интерфейса WB.

Активируйте '''Включение''', '''Яркость''' и '''Цвет'''. При включении характеристики цвета редактор добавляет связанные характеристики оттенка, насыщенности и отдельных компонентов.

Для '''WB-MRGBW-D''' с шаблоном fw3 в режиме RGB используйте следующую проверенную схему:

{| class="wikitable"
! Характеристика XIOT !! Канал WB-MRGBW-D !! Диапазон
|-
| Включение || RGB Strip || 0/1
|-
| Яркость || RGB Strip Brightness || 0–100 %
|-
| Оттенок || RGB Strip Hue || 0–360°
|-
| Насыщенность || RGB Strip Saturation || 0–100 %
|}

У этих четырёх характеристик назначьте адреса управления и состояния, включите ожидание ответа. '''Цвет RGB и отдельные Красный/Зелёный/Синий оставьте без физических адресов и без галочки ожидания'''. Значение «Включение через изменение яркости» здесь — «нет».

[[Файл:Lightbulb-rgb-hue-binding-20261003.png|thumb|center|780px|alt=Оттенок XIOT связан с каналом RGB Strip Hue|Пример привязки оттенка. Насыщенность и яркость выбираются из каналов той же ленты.]]

Проверьте оттенки 0° (красный), 120° (зелёный), 240° (синий) при насыщенности 100 %. Затем уменьшите насыщенность до 0 % — получится белый; проверьте изменение общей яркости.

'''Почему здесь не выбран RGB Palette.''' В проверенной версии XIOT 14.10~beta24 общий цвет передаётся строкой вида <code>255,0,0</code>, а MQTT-канал RGB Wiren Board использует <code>255;0;0</code>, как описано в [https://github.com/wirenboard/conventions#rgb-color-control соглашении Wiren Board MQTT]. Прямая привязка без согласования формата не обеспечивает правильную работу. Поэтому в этом примере используются совместимые числовые каналы H/S и яркости.

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

Если устройство принимает H/S или отдельные R/G/B вместо общей RGB-строки, привязка будет другой. Учитывайте диапазоны из таблицы характеристик и проверьте все способы управления, включая ползунок яркости и оттенок. Наличие связанных характеристик в редакторе само по себе не подтверждает работу любой комбинации каналов.

У RGBW-ленты отдельный белый канал не равен характеристике «Температура цвета». Настройте его как отдельный управляемый белый свет либо используйте предусмотренный оборудованием режим смешивания.

== Параметры и применение ==

Для указанной схемы '''Включение через изменение яркости — нет''', поскольку используется отдельный RGB Strip. Минимальную яркость при включении задайте явно по ленте; шаг и задержка относятся к общей яркости. Значения и поведение описаны в [[Light-fixture#Параметры светильника|общей статье]].

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

== Проверки и ограничения версии ==

На XIOT-EDITOR/PLC 14.10~beta24 03.10.2026 проверены MQTT-каналы по настоящему шаблону WB-MRGBW-D: например, оттенок 120°, насыщенность 80 % и яркость 50 % возвращались по соответствующим каналам. Силовая нагрузка не подключалась; снимок показывает реальные настройки редактора.

При использовании '''отдельных R/G/B''' обнаружено ограничение: изменение оттенка или общей яркости не во всех путях обновляет компоненты. Поэтому в приведённом примере они не привязаны к физическим каналам. Для устройства, принимающего только отдельные компоненты, проверьте все способы управления перед применением такой схемы.

Прямая привязка '''RGB Palette''' при несовпадении разделителей компонентов также не работает корректно. Снятие галочки ожидания состояния не исправляет формат команды. Исправления логики и преобразования драйвера в рамках этой инструкции не устанавливались.

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

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