Rgb-light-setup - История изменений

Admin: Иллюстрированные примеры: привязки адресов, параметры и управление светильником в приложении

2026-10-03T18:21:06Z

Иллюстрированные примеры: привязки адресов, параметры и управление светильником в приложении

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

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

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

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

			=== Пример «Лента RGB» в редакторе ===

			Все четыре канала относятся к одной RGB-ленте. У каждого заполнены оба адреса и включено ожидание состояния.

			[[Файл:Rgb-switch-bindings-20261003.png\|thumb\|center\|820px\|alt=Включение ленты — канал RGB Strip.\|Включение ленты — канал RGB Strip.]]

			[[Файл:Rgb-brightness-bindings-20261003.png\|thumb\|center\|820px\|alt=Общая яркость ленты — RGB Strip Brightness, диапазон 0–100 %.\|Общая яркость ленты — RGB Strip Brightness, диапазон 0–100 %.]]

			[[Файл:Rgb-hue-bindings-20261003.png\|thumb\|center\|820px\|alt=Оттенок — RGB Strip Hue, диапазон 0–360°.\|Оттенок — RGB Strip Hue, диапазон 0–360°.]]

			[[Файл:Rgb-saturation-bindings-20261003.png\|thumb\|center\|820px\|alt=Насыщенность — RGB Strip Saturation, диапазон 0–100 %.\|Насыщенность — RGB Strip Saturation, диапазон 0–100 %.]]

	== Параметры и применение ==		== Параметры и применение ==
Строка 37:		Строка 49:

	[[Project-backup\|Загрузите конфигурацию на контроллер]] и дождитесь окончания загрузки.		[[Project-backup\|Загрузите конфигурацию на контроллер]] и дождитесь окончания загрузки.


			[[Файл:Rgb-parameters-20261003.png\|thumb\|center\|820px\|alt=Параметры «Лента RGB»: отдельное включение, минимум яркости 10 %, шаг 5 % и задержка 0,5 с.\|Параметры «Лента RGB»: отдельное включение, минимум яркости 10 %, шаг 5 % и задержка 0,5 с.]]
			== Светильник в приложении ==


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

			[[Файл:Rgb-application-20261003.png\|thumb\|center\|400px\|alt=«Лента RGB» в предпросмотре приложения: включение, общая яркость и выбор цвета.\|«Лента RGB» в предпросмотре приложения: включение, общая яркость и выбор цвета.]]

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

Admin: Чистовая инструкция по настройке: функции и наладка без обозначений бета-версий и внутренних отчётов

2026-10-03T07:48:21Z

Чистовая инструкция по настройке: функции и наладка без обозначений бета-версий и внутренних отчётов

← Предыдущая версия		Версия от 07:48, 3 октября 2026
Строка 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\|Светильник]].'''

Admin: Инструкция для интегратора: названия полей редактора и поведение оборудования вместо системных имён и переменных

2026-10-03T06:39:31Z

Инструкция для интегратора: названия полей редактора и поведение оборудования вместо системных имён и переменных

← Предыдущая версия		Версия от 06:39, 3 октября 2026
Строка 30:		Строка 30:
	Проверьте оттенки 0° (красный), 120° (зелёный), 240° (синий) при насыщенности 100 %. Затем уменьшите насыщенность до 0 % — получится белый; проверьте изменение общей яркости.		Проверьте оттенки 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 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-строку, можно использовать общий канал цвета. Назначайте физические адреса только выбранному способу представления цвета.		Для другого оборудования, которое принимает совместимую RGB-строку, можно использовать общий канал цвета. Назначайте физические адреса только выбранному способу представления цвета.

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

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

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

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

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

Admin: Отдельный пример настройки из Lightbulb-setup; общие параметры — Light-fixture

2026-10-03T06:29:00Z

Отдельный пример настройки из Светильник; общие параметры — Светильник

Новая страница

{{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-ленты}}