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