|
Метка: новое перенаправление |
| Строка 1: |
Строка 1: |
| {{DISPLAYTITLE:Настройка лампочки}}
| | #REDIRECT [[Light-fixture]] |
| Устройство '''Лампочка''' (<code>Lightbulb</code>, в справочнике — [[Light-fixture|Светильник]]) объединяет включение, яркость, цветовую температуру и цвет одного источника света. Включайте характеристики по возможностям оборудования: у обычной лампы через реле достаточно включения, у диммера нужна яркость, у регулируемого белого света — цветовая температура, у цветной ленты — цвет.
| |
| | |
| '''Отдельный топик включения есть не у каждого физического устройства.''' Например, в [[Arlight-dali-logic-lite-wiren-board-integration|схеме Arlight DALI через Wiren Board]] свет включается и выключается значением яркости. Для такой схемы в XIOT предусмотрен параметр '''Включение через изменение яркости'''.
| |
| | |
| == Подготовьте оборудование и драйвер ==
| |
| | |
| # Проверьте управление нужным каналом средствами самого оборудования. Для Wiren Board светильник должен управляться из его веб-интерфейса; для KNX сначала подготовьте групповые адреса и типы данных в ETS.
| |
| # Подключите соответствующий драйвер XIOT: [[Wiren-board-driver-setup|Wiren Board]] или [[Knx-connection|KNX]]. Получите список каналов оборудования.
| |
| # Выберите комнату, нажмите '''Добавить устройство → свет''' и задайте понятное имя, например «Люстра», «Трек кухни» или «Подсветка рабочей поверхности».
| |
| # Откройте характеристики и включите только необходимые. Затем назначьте им адреса управления и состояния.
| |
| | |
| Эта инструкция описывает настройку управления. Схему подключения, допустимую нагрузку и совместимость светильника с диммером выбирают по документации оборудования.
| |
| | |
| == Какие характеристики включать ==
| |
| | |
| {| class="wikitable"
| |
| ! Характеристика !! Значение в XIOT !! Когда нужна !! Что связывать с оборудованием
| |
| |-
| |
| | '''Включение''' || 0 — выключено, 1 — включено || Основная характеристика, присутствует всегда || Канал включения и его состояние, если такие каналы есть. В схеме включения через яркость оба адреса здесь оставляют пустыми.
| |
| |-
| |
| | '''Яркость''' || 0–100 % || Диммируемая лампа, лента или группа DALI || Абсолютная яркость и её обратное значение. Если диапазон оборудования другой, настройте преобразование.
| |
| |-
| |
| | '''Диммирование''' || Меньше, больше, меньше-больше, остановить || Связанная характеристика яркости; нужна для пошагового изменения, например при удержании кнопки || Для диммирования средствами XIOT отдельный физический адрес не требуется: контроллер изменяет характеристику яркости. Это не адрес абсолютной яркости.
| |
| |-
| |
| | '''Температура цвета''' || 0 % — тёплый край, 100 % — холодный край || Белый свет с регулируемой цветовой температурой, CCT || Канал цветовой температуры. Проценты XIOT необходимо согласовать с диапазоном и направлением шкалы оборудования.
| |
| |-
| |
| | '''Цвет''' (RGB) || Три компонента 0–255, например <code>255,0,0</code> — красный || Цветная лампа или RGB-лента || Совместимый общий канал RGB. Для другого представления цвета выбирайте подходящие связанные характеристики.
| |
| |-
| |
| | '''Оттенок''' и '''Насыщенность''' || 0–360° и 0–100 % || Связанные характеристики цвета || Каналы H/S, если оборудование принимает именно их. При использовании общего RGB-канала их можно оставить без адресов.
| |
| |-
| |
| | '''Красный''', '''Зелёный''', '''Синий''' || Каждый 0–100 % || Связанные характеристики цвета для раздельных компонентов || Только соответствующие каналы R/G/B с согласованными диапазонами. Это проценты, а не компоненты RGB 0–255.
| |
| |}
| |
| | |
| Активация характеристики добавляет возможность устройству и его интерфейсу. Она '''не назначает физический топик автоматически'''. Обязательная характеристика также не обязана иметь адрес: в схеме DALI «Включение» остаётся логическим переключателем, а физическая команда уходит через яркость.
| |
| | |
| Не связывайте все представления цвета с оборудованием одновременно без проверки. RGB, H/S и отдельные R/G/B описывают один цвет, а контроллер выполняет преобразования между ними. Начните с одного поддерживаемого оборудованием способа и проверьте команды и обратную связь.
| |
| | |
| == Адреса управления, состояния и подтверждение ==
| |
| | |
| '''Адрес управления''' принимает команду, '''адрес состояния''' возвращает значение оборудования. Их выбирают у конкретной характеристики: адрес яркости относится к яркости, адрес температуры цвета — к температуре цвета.
| |
| | |
| У драйвера Wiren Board XIOT один выбранный канал может использоваться в обоих полях. Драйвер сам отправляет команду в MQTT-топик <code>/devices/…/controls/…/on</code>, а значение принимает из <code>/devices/…/controls/…</code>. Не добавляйте окончание <code>/on</code> к внутреннему адресу XIOT вручную.
| |
| | |
| Если устройство предоставляет обратное состояние, '''поставьте галочку слева от адреса состояния'''. Она включает ожидание подтверждения. При таком режиме отправка команды сама по себе ещё не меняет подтверждённое значение: XIOT ожидает ответ оборудования. Для характеристик без физических адресов галочку рядом с адресом состояния не ставьте. Не путайте эту настройку с галочкой активации самой характеристики.
| |
| | |
| Подробности: [[Device-bindings|Привязка адресов к характеристикам]] и [[Xiot-tags|Механизм работы тегов XIOT]]. Отсутствующий адрес состояния не заменяется галочкой. Ответ драйвера также не доказывает, что лампа светится: для такой проверки требуется соответствующий датчик или осмотр.
| |
| | |
| == Пример 1. Обычная лампа через реле Wiren Board ==
| |
| | |
| # Добавьте лампочку, например «Бра».
| |
| # Оставьте только '''Включение'''. Яркость, температуру цвета и цвет не активируйте.
| |
| # Выберите канал релейного модуля, например '''K1''' у WB-MR6CU, в адресах управления и состояния включения. Используйте канал своего устройства из списка драйвера.
| |
| # Поставьте галочку возле адреса состояния: релейный модуль возвращает состояние своего канала.
| |
| # Параметр '''Включение через изменение яркости''' оставьте '''нет'''.
| |
| # Примените конфигурацию и проверьте включение, выключение и изменение состояния со стороны оборудования.
| |
| | |
| [[Файл:Lightbulb-relay-feedback-20261003.png|thumb|center|780px|alt=Адреса управления и состояния включения, галочка подтверждения отмечена|Релейный свет: один канал WB-MR6CU выбран для команды и состояния. Зелёная галочка включает ожидание ответа. На учебном стенде использован свободный K5.]]
| |
| | |
| Номер канала не универсален: он должен соответствовать подключению вашей лампы. Пошаговый начальный пример: [[First-light-in-xiot|Первая лампа в XIOT]].
| |
| | |
| == Пример 2. Диммер с отдельными включением и яркостью ==
| |
| | |
| Так работают устройства, у которых есть отдельный канал включения и отдельный канал уровня, например WB-MDM3 с подходящим диммируемым светильником.
| |
| | |
| # Активируйте '''Яркость'''.
| |
| # В '''Включении''' выберите канал включения нужного выхода.
| |
| # В '''Яркости''' выберите канал абсолютной яркости того же выхода. У каждого используемого значения назначьте соответствующий адрес состояния.
| |
| # Проверьте диапазон яркости в шаблоне устройства. Если он уже 0–100, дополнительное масштабирование не требуется.
| |
| # '''Включение через изменение яркости''' оставьте '''нет'''.
| |
| # Установите минимальную яркость при включении, при которой лампа уверенно зажигается. Проверьте 10, 50 и 100 %, выключение и повторное включение.
| |
| | |
| В шаблоне WB-MDM3 из примера '''K1''' — включение первого выхода, '''Channel 1''' — его яркость. Для второго выхода выбирайте K2 и Channel 2, для третьего — K3 и Channel 3.
| |
| | |
| | |
| Не подменяйте канал абсолютной яркости командами «увеличивать/уменьшать». Их поведение различается. Уставки плавного включения самого диммера также отличаются от пошагового диммирования XIOT.
| |
| | |
| == Пример 3. Arlight DALI без отдельного канала включения ==
| |
| | |
| Сначала выполните [[Arlight-dali-logic-lite-wiren-board-integration|подключение Arlight DALI-LOGIC-LITE-PS-x1 к Wiren Board]]. В опубликованном там шаблоне для каждой группы предусмотрены '''Group N Brightness''' и '''Group N Color Temperature'''; отдельного канала включения группы нет.
| |
| | |
| # Создайте лампочку для нужной группы, например «Трек кухни».
| |
| # У характеристики '''Включение''' оставьте пустыми адрес управления и адрес состояния, галочку ожидания состояния не ставьте. Не подставляйте сюда топик яркости: 0/1 и уровень яркости имеют разный смысл.
| |
| # Активируйте '''Яркость''' и назначьте ей канал '''Group N Brightness''' нужной группы в адресах управления и состояния.
| |
| # В преобразовании яркости задайте соответствие: '''0 % → 0''', '''100 % → 254'''. Например, 50 % соответствует значению 127. Промежуточные точки нужны только для специально подобранной кривой.
| |
| # В параметрах лампочки установите '''Включение через изменение яркости → да'''. Задайте минимальную яркость при включении явно.
| |
| # Если светильники группы поддерживают регулируемый белый свет, активируйте '''Температуру цвета''' и выберите '''Group N Color Temperature'''. Для фиксированного белого света этот шаг пропустите.
| |
| | |
| В шаблоне Arlight шкала температуры цвета направлена противоположно шкале XIOT: 1000 — тёплый край, 80 — холодный. Для полного диапазона шаблона соответствие задаётся как '''0 % → 1000''', '''100 % → 80'''. Это диапазон команд шлюза, а не обещание такого диапазона у любого светильника. Учитывайте пределы конкретных DALI-драйверов. Адрес состояния и ожидание подтверждения температуры цвета используйте только при наличии действительного чтения/ответа этого канала; возвращённую копию команды не считайте измерением.
| |
| | |
| [[Файл:Lightbulb-logical-on-20261003.png|thumb|center|780px|alt=Включение без физических адресов и без галочки ожидания|Для управления через яркость у «Включения» нет физических адресов. Яркость привязывается отдельно.]]
| |
| | |
| === Как работает включение через яркость ===
| |
| | |
| * При выключении XIOT отправляет в яркость '''0'''.
| |
| * При следующем включении из нулевой яркости контроллер восстанавливает запомненный уровень, повышая его до заданного минимума, если требуется.
| |
| * Если запомненного уровня ещё нет, текущая реализация начинает со '''100 %'''. Поэтому первое включение также включите в приёмку.
| |
| * Пока лампочка выключена, команда положительной яркости запоминается для следующего включения. Сама такая команда в текущей логике контроллера не должна зажигать свет. Это полезно, например, при подготовке уровня сценарием.
| |
| * При получении нулевой яркости от оборудования XIOT снимает включение.
| |
| | |
| Проверяйте управление из приложения отдельно от прямой команды яркости: интерфейс может посылать несколько команд. Обязательно проверьте и внешнее управление DALI — свет, включённый настенной кнопкой или другим контроллером, должен корректно отображаться в XIOT.
| |
| | |
| == Пример 4. Белая лента с регулировкой температуры цвета ==
| |
| | |
| Для CCT-ленты нужен диммер в соответствующем режиме. Например, WB-LED и WB-MRGBW-D поддерживают режимы CCT; набор видимых каналов зависит от выбранного режима и версии шаблона.
| |
| | |
| # Активируйте '''Включение''', '''Яркость''' и '''Температуру цвета'''. '''Цвет RGB''' для обычной CCT-ленты не нужен.
| |
| # Выберите три канала одной CCT-ленты: её включение, яркость и температуру цвета.
| |
| # Укажите адреса состояния там, где диммер их возвращает.
| |
| # Согласуйте шкалу температуры: 0 % XIOT должен соответствовать тёплому свету, 100 % — холодному. Если направление оборудования противоположное, поменяйте крайние значения в преобразовании.
| |
| # Проверьте тёплый, средний и холодный свет при одинаковой яркости, затем отдельно проверьте диммирование.
| |
| | |
| Не вводите Кельвины непосредственно в характеристику XIOT со шкалой 0–100. Также не выбирайте два произвольных канала W вместо предусмотренного устройством режима CCT: смешивание белых каналов должно выполняться согласованным механизмом оборудования.
| |
| | |
| == Пример 5. Цветная RGB-лента ==
| |
| | |
| Активируйте '''Включение''', '''Яркость''' и '''Цвет'''. При включении характеристики цвета редактор добавляет связанные характеристики оттенка, насыщенности и отдельных компонентов.
| |
| | |
| Для '''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-ленты отдельный белый канал не равен характеристике «Температура цвета». Настройте его как отдельный управляемый белый свет либо используйте предусмотренный оборудованием режим смешивания.
| |
| | |
| == Пример 6. Светильник KNX ==
| |
| | |
| Добавление лампочки и выбор её характеристик остаются теми же. Вместо каналов Wiren Board назначьте групповые адреса из ETS через [[Knx-connection|драйвер KNX]]. Для включения используйте переключение, для ползунка яркости — абсолютный уровень с соответствующим DPT. Адрес команды и адрес обратного состояния часто различаются.
| |
| | |
| Штатное пошаговое диммирование XIOT изменяет абсолютную яркость. Не назначайте ему адрес относительного диммирования KNX только по совпадению слова «диммирование». Согласуйте формат, направление и назначение каждой характеристики с проектом ETS.
| |
| | |
| == Параметры лампочки ==
| |
| | |
| {| class="wikitable"
| |
| ! Параметр !! Как работает !! Пример настройки
| |
| |-
| |
| | '''Включение через изменение яркости''' || При «да» выключение посылает нулевую яркость, включение восстанавливает уровень. При «нет» основным физическим каналом включения служит отдельный адрес характеристики «Включение». || «Да» для приведённой схемы Arlight DALI; «нет» для реле и диммера с отдельным включением. Значение по умолчанию — «нет».
| |
| |-
| |
| | '''Минимальный уровень яркости при включении''' || Поднимает слишком низкий уровень при включении; для режима через яркость применяется при восстановлении уровня из нуля. Это не постоянный нижний предел ползунка и не предел каждого шага диммирования. || Задайте явно 1–100 %. Например, при минимуме 10 % сохранённые 3 % будут подняты до 10 % при восстановлении. Подберите значение по реальной лампе.
| |
| |-
| |
| | '''Шаг диммирования''' || Изменяет яркость порциями. На границах и при округлении к шагу приращение может отличаться. || По умолчанию 5 процентных пунктов; диапазон настройки 1–50. При текущих 50 % следующий обычный шаг вверх даст 55 %.
| |
| |-
| |
| | '''Задержка между шагами диммирования''' || Интервал между последующими командами пошагового диммирования. Единица — 0,1 секунды. Первый шаг выполняется сразу. || По умолчанию 5, то есть 0,5 с; диапазон 1–20, то есть 0,1–2 с. Более мелкий шаг и короткий интервал увеличивают число команд.
| |
| |-
| |
| | '''Дополнительная логика''' || Подключает существующие дополнительные функции к устройству. Их настройки выполняются отдельно и могут влиять на яркость и состояние. || Сначала проверьте базовое управление, затем подключайте нужную логику и проверяйте взаимодействие с ручными командами.
| |
| |}
| |
| | |
| [[Файл:Lightbulb-parameters-20261003.png|thumb|center|800px|alt=Параметры включения через яркость, минимум 10 процентов, шаг 5 и задержка 5|Пример: включение через яркость, минимум 10 %, шаг 5 процентных пунктов и интервал 0,5 с.]]
| |
| | |
| В проверенном редакторе 14.10~beta24 новое устройство получает минимум 0, хотя диапазон настройки начинается с 1, а резервное значение контроллера — 1. Поэтому при настройке диммируемого света задавайте минимум явно. Это обнаруженное расхождение значений по умолчанию, а не особый режим светильника.
| |
| | |
| Пошаговое уменьшение останавливается на '''1 %''', а не выключает свет. Для выключения используйте команду выключения. Команда «меньше-больше» меняет направление между запусками; это не бесконечное автоматическое движение от минимума к максимуму. Команда «остановить» прекращает дальнейшие шаги.
| |
| | |
| Не путайте три настройки: '''шаг и задержку XIOT''', '''плавность самого диммера''' и '''частоту ШИМ оборудования'''. Они относятся к разным процессам. Параметры XIOT не меняют электрический режим выхода диммера.
| |
| | |
| == Примените конфигурацию и проверьте ==
| |
| | |
| # Сохраните проект и штатно загрузите конфигурацию в привязанный контроллер. Дождитесь окончания операции и восстановления связи. [[Project-backup|Резервная копия и сохранение проекта]] описаны отдельно. | |
| # Включите и выключите каждый светильник из редактора. Сравните интерфейс, обратное значение и реальную реакцию оборудования.
| |
| # У диммируемых устройств проверьте минимум, среднюю и максимальную яркость, затем выключение и восстановление уровня.
| |
| # У DALI без отдельного включения убедитесь, что команда выключения даёт ноль именно в канале яркости, а включение возвращает ненулевой уровень.
| |
| # Для CCT и RGB проверьте крайние и промежуточные значения, а также обратное состояние после изменения на оборудовании.
| |
| # Проверьте управление из XIOT-APP после обновления конфигурации приложения. Если используете панель, повторите проверку на ней.
| |
| # Проверьте взаимодействие со сценариями и физическими кнопками. Изменение иконки сразу после команды не заменяет проверку обратной связи.
| |
| | |
| [[Файл:Lightbulb-room-app-preview-20261003.png|thumb|center|370px|alt=Четыре примера света в пользовательском интерфейсе XIOT|Предпросмотр пользовательского интерфейса в редакторе: релейный свет, RGB-лента, диммер и свет с включением через яркость.]]
| |
| | |
| == Что проверено и ограничения версии ==
| |
| | |
| Проверка выполнена 3 октября 2026 года на XIOT-EDITOR и XIOT-PLC '''14.10~beta24'''. Учебные устройства добавлены через редактор. На контроллере использованы MQTT-каналы стенда, построенные по настоящим шаблонам WB-MR6CU, WB-MDM3 и WB-MRGBW-D. Силовые нагрузки не подключались. Снимки показывают действующий редактор и его предпросмотр приложения.
| |
| | |
| Проверены команды и обратные значения: включение/выключение, яркость 10/50/100 %, восстановление 40 % после выключения, повышение сохранённых 3 % до минимума 10 %, шаг 50 → 55 % и остановка диммирования, каналы оттенка/насыщенности/яркости. Для Arlight изучен опубликованный шаблон и отдельно проверены преобразования яркости и CCT в обе стороны; это не проверка физической DALI-шины. Примеры CCT и KNX следует дополнительно проверить на оборудовании своего проекта.
| |
| | |
| Обнаружены ограничения этой версии:
| |
| | |
| * '''Внешнее включение через яркость.''' После выключения XIOT может оставить «Включение = 0» и «Яркость = 0», даже если оборудование уже вернуло положительную яркость. На стенде это воспроизведено для внешних 45 %. Управление через XIOT и восстановление уровня проверены отдельно и работают; внешние кнопки и другие системы управления требуют отдельной приёмки.
| |
| * '''Раздельные R/G/B.''' Проверка логики контроллера обнаружила, что изменение оттенка или общей яркости не во всех путях обновляет отдельные компоненты. Не считайте такую привязку взаимозаменяемой с H/S или общей RGB-строкой без проверки всех органов управления. В примере WB выше отдельные R/G/B к оборудованию не привязаны.
| |
| * '''Формат общей RGB-строки и минимум по умолчанию.''' Ограничения и применённые настройки разобраны в разделах про RGB-ленту и параметры. Отключение ожидания состояния не устраняет несовместимость формата.
| |
| | |
| == Если результат отличается от ожидаемого ==
| |
| | |
| * '''Иконка переключается, а света нет:''' проверьте адрес управления, загрузку конфигурации и канал оборудования. Для DALI без канала включения проверьте параметр включения через яркость и привязку самой яркости.
| |
| * '''Яркость работает только на части шкалы:''' сверьте единицы и преобразование. Например, 100 XIOT и 254 шлюза DALI — разные диапазоны.
| |
| * '''Тёплый и холодный свет перепутаны:''' проверьте направление шкалы температуры цвета и крайние значения преобразования.
| |
| * '''После включения получается 100 %:''' в режиме через яркость это возможно, когда контроллер ещё не запомнил предыдущий уровень. Проверьте сценарий первого включения.
| |
| * '''Физическая кнопка меняет свет, а XIOT показывает старое состояние:''' проверьте публикацию состояния, адрес чтения и обработку обратной яркости. Не скрывайте проблему включением мгновенного локального отображения.
| |
| * '''Подтверждение не приходит:''' убедитесь, что оборудование возвращает состояние и его диапазон совпадает с преобразованием команды. У каналов только для записи нельзя обещать подтверждение выполнения.
| |
| | |
| == Связанные инструкции ==
| |
| | |
| * [[Light-fixture|Светильник: назначение устройства]].
| |
| * [[First-light-in-xiot|Первая лампа в XIOT]].
| |
| * [[Arlight-dali-logic-lite-wiren-board-integration|Arlight DALI через Wiren Board: шлюз, шаблон и группы]].
| |
| * [[Xiot-device-characteristics|Характеристики устройств XIOT]].
| |
| * [[Device-bindings|Привязка адресов к характеристикам]].
| |
| * [[Xiot-tags|Адреса управления и состояния]].
| |
| * [https://wiki.wirenboard.com/wiki/WB-MRGBW-D_Modbus_LED_Dimmer Документация WB-MRGBW-D].
| |
| * [https://wiki.wirenboard.com/wiki/WB-LED_v.1_Modbus_LED_Dimmer Документация WB-LED].
| |
| | |
| [[Категория:Документация XIOT]]
| |
| {{DEFAULTSORT:Настройка лампочки}}
| |
