Светильник
Главная страница → Каталог устройств → Светильник
Светильник — устройство XIOT для управления люстрой, бра, треком, белой или цветной лентой. При добавлении устройства в редакторе выберите свет. Набор включённых характеристик определяет, какие команды доступны и какие элементы управления появятся в приложении.
В этой статье описаны общие шаги: добавление светильника, выбор характеристик, привязка адресов и параметры. Для подключения конкретного оборудования выберите отдельную инструкцию ниже.
Примеры настройки
- Лампа через реле Wiren Board — Один канал включения и его обратное состояние; пример WB-MR6CU.
- Диммируемый светильник — Отдельные каналы включения и яркости; пример WB-MDM3.
- Arlight DALI: включение через яркость — Нет отдельного канала включения; яркость группы и, при наличии, температура цвета.
- Белый свет с регулировкой температуры, CCT — Яркость и переход от тёплого к холодному белому свету.
- Цветной светильник или RGB-лента — Выбор каналов цвета; пример WB-MRGBW-D через оттенок, насыщенность и яркость.
- Светильник KNX — Командные адреса и адреса состояния из проекта ETS.
Начните с возможностей физического устройства. Наличие ползунка или характеристики в XIOT не добавляет эту возможность оборудованию. Например, у релейной лампы нужна только команда включения, а у Arlight DALI в описанной схеме отдельного канала включения нет — используется яркость.
Подготовьте оборудование и драйвер
- Проверьте управление нужным каналом средствами самого оборудования. Для 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 % | Связанные характеристики цвета | Отдельные каналы оттенка и насыщенности, если оборудование принимает именно их. При использовании общего RGB-канала их можно оставить без адресов. |
| Красный, Зелёный, Синий | Каждый 0–100 % | Связанные характеристики цвета для раздельных компонентов | Отдельные каналы красного, зелёного и синего с согласованными диапазонами. Это проценты, а не компоненты RGB 0–255. |
Активация характеристики добавляет возможность устройству и его интерфейсу. Она не назначает физический топик автоматически. Обязательная характеристика также не обязана иметь адрес: в схеме DALI «Включение» остаётся логическим переключателем, а физическая команда уходит через яркость.
Не связывайте все представления цвета с оборудованием одновременно без проверки. Общий цвет RGB, оттенок с насыщенностью и отдельные красный, зелёный и синий каналы — разные способы задать один цвет. Начните с одного поддерживаемого оборудованием способа и проверьте команды и обратную связь.
Адреса управления, состояния и подтверждение
Адрес управления принимает команду, адрес состояния возвращает значение оборудования. Их выбирают у конкретной характеристики: адрес яркости относится к яркости, адрес температуры цвета — к температуре цвета.
У драйвера Wiren Board XIOT один выбранный канал может использоваться в обоих полях. Драйвер сам отправляет команду в MQTT-топик /devices/…/controls/…/on, а значение принимает из /devices/…/controls/…. Не добавляйте окончание /on к внутреннему адресу XIOT вручную.
Если устройство предоставляет обратное состояние, поставьте галочку слева от адреса состояния. Она включает ожидание подтверждения. При таком режиме отправка команды сама по себе ещё не меняет подтверждённое значение: XIOT ожидает ответ оборудования. Для характеристик без физических адресов галочку рядом с адресом состояния не ставьте. Не путайте эту настройку с галочкой активации самой характеристики.
Подробности: Привязка адресов к характеристикам и Механизм работы тегов XIOT. Отсутствующий адрес состояния не заменяется галочкой. Ответ драйвера также не доказывает, что лампа светится: для такой проверки требуется соответствующий датчик или осмотр.
Параметры светильника
| Параметр | Как работает | Пример настройки |
|---|---|---|
| Включение через изменение яркости | При «да» выключение посылает нулевую яркость, включение восстанавливает уровень. При «нет» основным физическим каналом включения служит отдельный адрес характеристики «Включение». | «Да» для приведённой схемы 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 до 100 %, при котором ваш светильник устойчиво включается.
Пошаговое уменьшение останавливается на 1 %, а не выключает свет. Для выключения используйте команду выключения. Команда «меньше-больше» меняет направление между запусками; это не бесконечное автоматическое движение от минимума к максимуму. Команда «остановить» прекращает дальнейшие шаги.
Не путайте три настройки: шаг и задержку XIOT, плавность самого диммера и частоту ШИМ оборудования. Они относятся к разным процессам. Параметры XIOT не меняют электрический режим выхода диммера.
Как работает включение через яркость
- При выключении XIOT отправляет в яркость 0.
- При следующем включении из нулевой яркости контроллер восстанавливает запомненный уровень, повышая его до заданного минимума, если требуется.
- Если запомненного уровня ещё нет, свет включается на 100 %. Поэтому первое включение также включите в приёмку.
- Если при выключенном светильнике сценарий задаёт только яркость выше нуля, этот уровень запоминается для следующего включения. Чтобы зажечь свет, нужна команда Включение. Так можно заранее подготовить нужную яркость сценарием.
- При получении нулевой яркости от оборудования XIOT снимает включение.
Проверяйте управление из приложения отдельно от прямой команды яркости: интерфейс может посылать несколько команд. Обязательно проверьте и внешнее управление DALI — свет, включённый настенной кнопкой или другим контроллером, должен корректно отображаться в XIOT.
Настройка адресов и масштабирования для такой схемы приведена в примере Arlight DALI. В версии 14.10~beta24 обнаружено ограничение обработки внешнего включения через яркость: подробности и проверка описаны в этой инструкции.
Примените конфигурацию и проверьте
- Сохраните проект и штатно загрузите конфигурацию в привязанный контроллер. Дождитесь окончания операции и восстановления связи. Резервная копия и сохранение проекта описаны отдельно.
- Включите и выключите каждый светильник из редактора. Сравните интерфейс, обратное значение и реальную реакцию оборудования.
- У диммируемых устройств проверьте минимум, среднюю и максимальную яркость, затем выключение и восстановление уровня.
- У DALI без отдельного включения убедитесь, что команда выключения даёт ноль именно в канале яркости, а включение возвращает ненулевой уровень.
- Для CCT и RGB проверьте крайние и промежуточные значения, а также обратное состояние после изменения на оборудовании.
- Проверьте управление из XIOT-APP после обновления конфигурации приложения. Если используете панель, повторите проверку на ней.
- Проверьте взаимодействие со сценариями и физическими кнопками. Изменение иконки сразу после команды не заменяет проверку обратной связи.
Для изменения масштаба на главном экране приложения нажмите название дома и выберите «Масштаб интерфейса». В показанном предпросмотре уменьшение до 80 % позволило разместить три карточки в ряд без обрезания названий. Число колонок зависит также от ширины экрана.
Иконка управляет включением. При активации яркости появляется её регулировка, при активации температуры цвета или RGB — соответствующие органы управления. Проверяйте также команды от сценариев и кнопок: набор команд интерфейса и прямое изменение одной характеристики могут отличаться.
Что проверено и ограничения версии
Описание соответствует XIOT 14.10~beta24 на 3 октября 2026 года. Примеры были добавлены через редактор; команды и обратные значения проверены на MQTT-каналах по настоящим шаблонам WB-MR6CU, WB-MDM3 и WB-MRGBW-D. Силовая нагрузка не подключалась. Снимки показывают редактор и его предпросмотр приложения.
В инструкциях по реле, диммеру и RGB отдельно указаны выполненные проверки. Для Arlight DALI изучен опубликованный шаблон и проверены преобразования значений; физическая DALI-шина не испытывалась. CCT и KNX требуют проверки на оборудовании конкретного проекта.
Известные ограничения, важные для выбора привязки: после включения внешней кнопкой светильник может по-прежнему отображаться выключенным в XIOT; при раздельном подключении красного, зелёного и синего каналов изменение оттенка или общей яркости может не передаться оборудованию; формат общего значения RGB в XIOT и WB различается. Условия и подходящие варианты подключения описаны в инструкциях DALI и RGB. Настройка минимальной яркости разобрана выше в параметрах.
Если результат отличается от ожидаемого
- Иконка переключается, а света нет: проверьте адрес управления, загрузку конфигурации и канал оборудования. Для DALI без канала включения проверьте параметр включения через яркость и привязку самой яркости.
- Яркость работает только на части шкалы: сверьте единицы и преобразование. Например, 100 XIOT и 254 шлюза DALI — разные диапазоны.
- Тёплый и холодный свет перепутаны: проверьте направление шкалы температуры цвета и крайние значения преобразования.
- После включения получается 100 %: в режиме через яркость это возможно, когда контроллер ещё не запомнил предыдущий уровень. Проверьте сценарий первого включения.
- Физическая кнопка меняет свет, а XIOT показывает старое состояние: проверьте публикацию состояния, адрес чтения и обработку обратной яркости. Не скрывайте проблему включением мгновенного локального отображения.
- Подтверждение не приходит: убедитесь, что оборудование возвращает состояние и его диапазон совпадает с преобразованием команды. У каналов только для записи нельзя обещать подтверждение выполнения.