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

Rgb-light-setup: различия между версиями

Материал из XIOT Wiki
← Предыдущая правкаСледующая правка →

Admin (обсуждение | вклад)

3 группы участника
3501 правка
ВизуальныйВики-текст
Инструкция для интегратора: названия полей редактора и поведение оборудования вместо системных имён и переменных
Чистовая инструкция по настройке: функции и наладка без обозначений бета-версий и внутренних отчётов
Строка 2: Строка 2:
[[Xiot-devices|Каталог устройств]] → [[Light-fixture|Светильник]] → '''Цветной свет и RGB'''
[[Xiot-devices|Каталог устройств]] → [[Light-fixture|Светильник]] → '''Цветной свет и RGB'''


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


== Характеристики и каналы WB-MRGBW-D ==
== Характеристики и каналы WB-MRGBW-D ==
Строка 10: Строка 10:
Активируйте '''Включение''', '''Яркость''' и '''Цвет'''. При включении характеристики цвета редактор добавляет связанные характеристики оттенка, насыщенности и отдельных компонентов.
Активируйте '''Включение''', '''Яркость''' и '''Цвет'''. При включении характеристики цвета редактор добавляет связанные характеристики оттенка, насыщенности и отдельных компонентов.


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


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


Проверьте оттенки 0° (красный), 120° (зелёный), 240° (синий) при насыщенности 100 %. Затем уменьшите насыщенность до 0 % — получится белый; проверьте изменение общей яркости.
В этой схеме цвет задаётся оттенком и насыщенностью, а световой поток — общей яркостью. Назначьте физические адреса четырём характеристикам из таблицы. Общий канал RGB Palette и отдельные красный, зелёный и синий каналы в этой схеме не используются.
 
'''Почему здесь не выбран 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]. Прямая привязка без согласования формата не обеспечивает правильную работу. Поэтому в этом примере используются отдельные числовые каналы оттенка, насыщенности и яркости.
 
Для другого оборудования, которое принимает совместимую RGB-строку, можно использовать общий канал цвета. Назначайте физические адреса только выбранному способу представления цвета.
 
Если устройство принимает отдельно оттенок и насыщенность либо отдельные красный, зелёный и синий компоненты, привязка будет другой. Учитывайте диапазоны из таблицы характеристик и проверьте все способы управления, включая ползунок яркости и оттенок. Наличие связанных характеристик в редакторе само по себе не подтверждает работу любой комбинации каналов.


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


[[Project-backup|Загрузите конфигурацию на контроллер]], дождитесь окончания загрузки. Проверьте включение/выключение, три основных оттенка, насыщенность 0/100 % и несколько значений яркости; сопоставьте интерфейс XIOT и MQTT-состояние выбранных каналов. Затем проверьте те же действия в приложении и изменение со стороны оборудования.
[[Project-backup|Загрузите конфигурацию на контроллер]] и дождитесь окончания загрузки.
 
== Проверки и ограничения версии ==
 
На XIOT-EDITOR/PLC 14.10~beta24 03.10.2026 проверены MQTT-каналы по настоящему шаблону WB-MRGBW-D: например, оттенок 120°, насыщенность 80 % и яркость 50 % возвращались по соответствующим каналам. Силовая нагрузка не подключалась; снимок показывает реальные настройки редактора.


При привязке характеристик '''Красный''', '''Зелёный''' и '''Синий''' к отдельным каналам изменение оттенка или общей яркости может не передаться оборудованию. Поэтому в приведённом примере эти характеристики оставлены без физических адресов. Если ваше устройство принимает только отдельные компоненты цвета, проверьте выбор оттенка и регулировку яркости перед применением такой схемы.
== Проверка результата ==


Прямая привязка '''RGB Palette''' при несовпадении разделителей компонентов также не работает корректно. Снятие галочки ожидания состояния не исправляет формат команды. Для данного примера используйте указанные выше каналы оттенка, насыщенности и яркости.
# Включите и выключите светильник из XIOT; сравните переключатель с состоянием канала включения диммера.
# При насыщенности 100 % задайте оттенки 0°, 120° и 240° — красный, зелёный и синий.
# Уменьшите насыщенность до 0 %: цвет станет белым. Верните насыщенность и проверьте выбранный оттенок.
# Задайте яркость 10, 50 и 100 %; убедитесь, что меняется яркость выбранной ленты.
# Измените цвет со стороны оборудования и сравните обратные значения оттенка, насыщенности и яркости с XIOT.
# Повторите управление из приложения и настроенных сценариев.


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

Версия от 07:48, 3 октября 2026

Каталог устройств → Светильник → Цветной свет и RGB

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

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

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

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

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

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

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

Оттенок XIOT связан с каналом RGB Strip Hue
Пример привязки оттенка. Насыщенность и яркость выбираются из каналов той же ленты.

В этой схеме цвет задаётся оттенком и насыщенностью, а световой поток — общей яркостью. Назначьте физические адреса четырём характеристикам из таблицы. Общий канал RGB Palette и отдельные красный, зелёный и синий каналы в этой схеме не используются.

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

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

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

Загрузите конфигурацию на контроллер и дождитесь окончания загрузки.

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

  1. Включите и выключите светильник из XIOT; сравните переключатель с состоянием канала включения диммера.
  2. При насыщенности 100 % задайте оттенки 0°, 120° и 240° — красный, зелёный и синий.
  3. Уменьшите насыщенность до 0 %: цвет станет белым. Верните насыщенность и проверьте выбранный оттенок.
  4. Задайте яркость 10, 50 и 100 %; убедитесь, что меняется яркость выбранной ленты.
  5. Измените цвет со стороны оборудования и сравните обратные значения оттенка, насыщенности и яркости с XIOT.
  6. Повторите управление из приложения и настроенных сценариев.

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

Источник — https://wiki.xiot.ru/index.php?title=Rgb-light-setup&oldid=5875