Настройка лампочки
Устройство Лампочка (Lightbulb, в справочнике — Светильник) объединяет включение, яркость, цветовую температуру и цвет одного источника света. Включайте характеристики по возможностям оборудования: у обычной лампы через реле достаточно включения, у диммера нужна яркость, у регулируемого белого света — цветовая температура, у цветной ленты — цвет.
Отдельный топик включения есть не у каждого физического устройства. Например, в схеме Arlight DALI через Wiren Board свет включается и выключается значением яркости. Для такой схемы в XIOT предусмотрен параметр Включение через изменение яркости.
Подготовьте оборудование и драйвер
- Проверьте управление нужным каналом средствами самого оборудования. Для Wiren Board светильник должен управляться из его веб-интерфейса; для KNX сначала подготовьте групповые адреса и типы данных в ETS.
- Подключите соответствующий драйвер XIOT: Wiren Board или KNX. Получите список каналов оборудования.
- Выберите комнату, нажмите Добавить устройство → свет и задайте понятное имя, например «Люстра», «Трек кухни» или «Подсветка рабочей поверхности».
- Откройте характеристики и включите только необходимые. Затем назначьте им адреса управления и состояния.
Эта инструкция описывает настройку управления. Схему подключения, допустимую нагрузку и совместимость светильника с диммером выбирают по документации оборудования.
Какие характеристики включать
| Характеристика | Значение в XIOT | Когда нужна | Что связывать с оборудованием |
|---|---|---|---|
| Включение | 0 — выключено, 1 — включено | Основная характеристика, присутствует всегда | Канал включения и его состояние, если такие каналы есть. В схеме включения через яркость оба адреса здесь оставляют пустыми. |
| Яркость | 0–100 % | Диммируемая лампа, лента или группа DALI | Абсолютная яркость и её обратное значение. Если диапазон оборудования другой, настройте преобразование. |
| Диммирование | Меньше, больше, меньше-больше, остановить | Связанная характеристика яркости; нужна для пошагового изменения, например при удержании кнопки | Для диммирования средствами XIOT отдельный физический адрес не требуется: контроллер изменяет характеристику яркости. Это не адрес абсолютной яркости. |
| Температура цвета | 0 % — тёплый край, 100 % — холодный край | Белый свет с регулируемой цветовой температурой, CCT | Канал цветовой температуры. Проценты XIOT необходимо согласовать с диапазоном и направлением шкалы оборудования. |
| Цвет (RGB) | Три компонента 0–255, например 255,0,0 — красный |
Цветная лампа или 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-топик /devices/…/controls/…/on, а значение принимает из /devices/…/controls/…. Не добавляйте окончание /on к внутреннему адресу XIOT вручную.
Если устройство предоставляет обратное состояние, поставьте галочку слева от адреса состояния. Она включает ожидание подтверждения. При таком режиме отправка команды сама по себе ещё не меняет подтверждённое значение: XIOT ожидает ответ оборудования. Для характеристик без физических адресов галочку рядом с адресом состояния не ставьте. Не путайте эту настройку с галочкой активации самой характеристики.
Подробности: Привязка адресов к характеристикам и Механизм работы тегов XIOT. Отсутствующий адрес состояния не заменяется галочкой. Ответ драйвера также не доказывает, что лампа светится: для такой проверки требуется соответствующий датчик или осмотр.
Пример 1. Обычная лампа через реле Wiren Board
- Добавьте лампочку, например «Бра».
- Оставьте только Включение. Яркость, температуру цвета и цвет не активируйте.
- Выберите канал релейного модуля, например K1 у WB-MR6CU, в адресах управления и состояния включения. Используйте канал своего устройства из списка драйвера.
- Поставьте галочку возле адреса состояния: релейный модуль возвращает состояние своего канала.
- Параметр Включение через изменение яркости оставьте нет.
- Примените конфигурацию и проверьте включение, выключение и изменение состояния со стороны оборудования.
Номер канала не универсален: он должен соответствовать подключению вашей лампы. Пошаговый начальный пример: Первая лампа в 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-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-драйверов. Адрес состояния и ожидание подтверждения температуры цвета используйте только при наличии действительного чтения/ответа этого канала; возвращённую копию команды не считайте измерением.
Как работает включение через яркость
- При выключении 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 используйте следующую проверенную схему:
| Характеристика XIOT | Канал WB-MRGBW-D | Диапазон |
|---|---|---|
| Включение | RGB Strip | 0/1 |
| Яркость | RGB Strip Brightness | 0–100 % |
| Оттенок | RGB Strip Hue | 0–360° |
| Насыщенность | RGB Strip Saturation | 0–100 % |
У этих четырёх характеристик назначьте адреса управления и состояния, включите ожидание ответа. Цвет RGB и отдельные Красный/Зелёный/Синий оставьте без физических адресов и без галочки ожидания. Значение «Включение через изменение яркости» здесь — «нет».
Проверьте оттенки 0° (красный), 120° (зелёный), 240° (синий) при насыщенности 100 %. Затем уменьшите насыщенность до 0 % — получится белый; проверьте изменение общей яркости.
Почему здесь не выбран RGB Palette. В проверенной версии XIOT 14.10~beta24 общий цвет передаётся строкой вида 255,0,0, а MQTT-канал RGB Wiren Board использует 255;0;0, как описано в соглашении Wiren Board MQTT. Прямая привязка без согласования формата не обеспечивает правильную работу. Поэтому в этом примере используются совместимые числовые каналы H/S и яркости.
Для другого оборудования, которое принимает совместимую RGB-строку, можно использовать общий канал цвета. Назначайте физические адреса только выбранному способу представления цвета.
Если устройство принимает H/S или отдельные R/G/B вместо общей RGB-строки, привязка будет другой. Учитывайте диапазоны из таблицы характеристик и проверьте все способы управления, включая ползунок яркости и оттенок. Наличие связанных характеристик в редакторе само по себе не подтверждает работу любой комбинации каналов.
У RGBW-ленты отдельный белый канал не равен характеристике «Температура цвета». Настройте его как отдельный управляемый белый свет либо используйте предусмотренный оборудованием режим смешивания.
Пример 6. Светильник KNX
Добавление лампочки и выбор её характеристик остаются теми же. Вместо каналов Wiren Board назначьте групповые адреса из ETS через драйвер KNX. Для включения используйте переключение, для ползунка яркости — абсолютный уровень с соответствующим DPT. Адрес команды и адрес обратного состояния часто различаются.
Штатное пошаговое диммирование XIOT изменяет абсолютную яркость. Не назначайте ему адрес относительного диммирования KNX только по совпадению слова «диммирование». Согласуйте формат, направление и назначение каждой характеристики с проектом ETS.
Параметры лампочки
| Параметр | Как работает | Пример настройки |
|---|---|---|
| Включение через изменение яркости | При «да» выключение посылает нулевую яркость, включение восстанавливает уровень. При «нет» основным физическим каналом включения служит отдельный адрес характеристики «Включение». | «Да» для приведённой схемы Arlight DALI; «нет» для реле и диммера с отдельным включением. Значение по умолчанию — «нет». |
| Минимальный уровень яркости при включении | Поднимает слишком низкий уровень при включении; для режима через яркость применяется при восстановлении уровня из нуля. Это не постоянный нижний предел ползунка и не предел каждого шага диммирования. | Задайте явно 1–100 %. Например, при минимуме 10 % сохранённые 3 % будут подняты до 10 % при восстановлении. Подберите значение по реальной лампе. |
| Шаг диммирования | Изменяет яркость порциями. На границах и при округлении к шагу приращение может отличаться. | По умолчанию 5 процентных пунктов; диапазон настройки 1–50. При текущих 50 % следующий обычный шаг вверх даст 55 %. |
| Задержка между шагами диммирования | Интервал между последующими командами пошагового диммирования. Единица — 0,1 секунды. Первый шаг выполняется сразу. | По умолчанию 5, то есть 0,5 с; диапазон 1–20, то есть 0,1–2 с. Более мелкий шаг и короткий интервал увеличивают число команд. |
| Дополнительная логика | Подключает существующие дополнительные функции к устройству. Их настройки выполняются отдельно и могут влиять на яркость и состояние. | Сначала проверьте базовое управление, затем подключайте нужную логику и проверяйте взаимодействие с ручными командами. |
В проверенном редакторе 14.10~beta24 новое устройство получает минимум 0, хотя диапазон настройки начинается с 1, а резервное значение контроллера — 1. Поэтому при настройке диммируемого света задавайте минимум явно. Это обнаруженное расхождение значений по умолчанию, а не особый режим светильника.
Пошаговое уменьшение останавливается на 1 %, а не выключает свет. Для выключения используйте команду выключения. Команда «меньше-больше» меняет направление между запусками; это не бесконечное автоматическое движение от минимума к максимуму. Команда «остановить» прекращает дальнейшие шаги.
Не путайте три настройки: шаг и задержку XIOT, плавность самого диммера и частоту ШИМ оборудования. Они относятся к разным процессам. Параметры XIOT не меняют электрический режим выхода диммера.
Примените конфигурацию и проверьте
- Сохраните проект и штатно загрузите конфигурацию в привязанный контроллер. Дождитесь окончания операции и восстановления связи. Резервная копия и сохранение проекта описаны отдельно.
- Включите и выключите каждый светильник из редактора. Сравните интерфейс, обратное значение и реальную реакцию оборудования.
- У диммируемых устройств проверьте минимум, среднюю и максимальную яркость, затем выключение и восстановление уровня.
- У DALI без отдельного включения убедитесь, что команда выключения даёт ноль именно в канале яркости, а включение возвращает ненулевой уровень.
- Для CCT и RGB проверьте крайние и промежуточные значения, а также обратное состояние после изменения на оборудовании.
- Проверьте управление из XIOT-APP после обновления конфигурации приложения. Если используете панель, повторите проверку на ней.
- Проверьте взаимодействие со сценариями и физическими кнопками. Изменение иконки сразу после команды не заменяет проверку обратной связи.
Что проверено и ограничения версии
Проверка выполнена 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 показывает старое состояние: проверьте публикацию состояния, адрес чтения и обработку обратной яркости. Не скрывайте проблему включением мгновенного локального отображения.
- Подтверждение не приходит: убедитесь, что оборудование возвращает состояние и его диапазон совпадает с преобразованием команды. У каналов только для записи нельзя обещать подтверждение выполнения.