Первая лампа в XIOT
В этой статье
- Что получится
- Что нужно до начала
- 1. Проверьте физическое реле
- 2. Создайте комнату
- 3. Добавьте светильник
- 4. Подключите Wiren Board и получите адреса
- 5. Назначьте адрес управления и адрес состояния
- Пример канала WB-MR6CU
- 6. Загрузите конфигурацию
- 7. Проверьте лампу в XIOT-APP
- Если лампа не работает
- Что вы настроили
- См. также
Каталог устройств → Светильник → Лампа через реле
Общие характеристики, параметры и другие варианты подключения: Светильник. Эта инструкция показывает минимальный сквозной пример: одно физическое реле Wiren Board управляет одной лампой, а её состояние видно в XIOT-APP. Пример намеренно не включает диммирование, сценарии и другие драйверы.
Что получится
В проекте будет комната и устройство Светильник. Его характеристика Включение будет связана с каналом реле Wiren Board через адрес управления и адрес состояния. После загрузки конфигурации лампой можно будет управлять из XIOT-APP с проверкой фактического состояния.
Что нужно до начала
- У вас есть проект и доступ интегратора к XIOT-EDITOR. Если проекта ещё нет, начните со статьи С чего начать интегратору.
- XIOT-PLC установлен, запущен и привязан к этому проекту. Подробный порядок: Установка XIOT-PLC на контроллер и Привязка XIOT-PLC к проекту.
- Wiren Board и релейный модуль настроены. Нужный канал реле виден в веб-интерфейсе Wiren Board и переключает тестовую нагрузку. См. Базовая настройка Wiren Board.
- Учётная запись имеет доступ к этому проекту в XIOT-APP.
Безопасность: не подключайте и не перекоммутируйте цепи сетевого напряжения под напряжением. Физическое подключение реле и лампы должен выполнять квалифицированный специалист. Для первой проверки используйте заранее проверенную безопасную нагрузку.
1. Проверьте физическое реле
- Откройте веб-интерфейс Wiren Board.
- Найдите канал реле, к которому подключена тестовая лампа.
- Один раз включите и выключите реле из веб-интерфейса.
- Запомните название устройства и канала. По ним вы найдёте нужный адрес в XIOT-EDITOR.
Результат: реле и лампа уже работают без XIOT. Если эта проверка не прошла, сначала исправьте монтаж или настройку Wiren Board.
2. Создайте комнату
- Откройте проект в XIOT-EDITOR.
- Нажмите F2 или Fn + F2, чтобы включить редактирование.
- Откройте раздел Устройства и сценарии.
- Если в проекте ещё нет этажа, создайте его и задайте понятное имя.
- Выберите этаж, нажмите Создать комнату и назовите её, например Тестовая комната.
Результат: в структуре проекта видна комната. Подробнее: Создание устройств XIOT.
3. Добавьте светильник
- Выберите созданную комнату.
- Нажмите Создать устройство и выберите свет.
- Задайте имя, например Первая лампа.
- Для этого примера настройте характеристику Включение. Яркость, цветовую температуру и RGB настраивают отдельно после успешной проверки включения.
Результат: в комнате виден светильник с характеристикой Включение. См. Светильник.
4. Подключите Wiren Board и получите адреса
- Откройте Драйверы → Wiren Board и активируйте подключение.
- Если XIOT-PLC работает на этом же Wiren Board, обычно используются
localhostи порт1883. В остальных случаях укажите адрес нужного Wiren Board в доверенной локальной или защищённой частной сети. Не публикуйте MQTT-порт в интернет. - Укажите логин и пароль MQTT-брокера, если они настроены.
- Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на PLC. Не изменяйте проект до завершения операций; проверьте запись в истории сохранений, сообщение о загрузке и восстановление связи с XIOT-PLC.
- Вернитесь в Драйверы → Wiren Board, убедитесь, что отображается статус ПОДКЛЮЧЕН, и нажмите Получить топики.
- Найдите в списке ранее проверенные устройство и канал реле.
Результат: драйвер XIOT подключён к Wiren Board, а нужный канал реле доступен для выбора. Подробнее: Настройка драйвера Wiren Board в XIOT.
5. Назначьте адрес управления и адрес состояния
- Вернитесь в Устройства и сценарии и откройте настройки светильника Первая лампа.
- В характеристике Включение нажмите поле адрес управления и выберите адрес нужного канала реле.
- В поле адрес состояния выберите адрес, из которого приходит фактическое состояние. Оба поля могут указывать на один канал Wiren Board, если он действительно принимает команды и публикует состояние; проверьте это для выбранного реле.
- Включите ожидание обратной связи, если выбранный адрес состояния действительно возвращает состояние реле.
В старых материалах эти поля могут называться «тег управления», «тег статуса» или «тег состояния». В текущем XIOT-EDITOR и в этой инструкции используются названия адрес управления и адрес состояния.
Результат: характеристика Включение отправляет команду реле и получает его состояние. Подробнее: Привязка оборудования к устройствам XIOT и Адреса управления и состояния в XIOT.
Пример канала WB-MR6CU
В релейном модуле WB-MR6CU выберите K1–K6 по фактическому подключению лампы. Один и тот же выбранный канал WB используется для команды и обратного состояния характеристики Включение. Галочка слева от адреса состояния включает ожидание ответа реле; не путайте её с активацией характеристики.
Параметр Включение через изменение яркости оставьте нет. Яркость, температуру цвета и RGB для обычной лампы через реле не активируйте. Отдельное устройство «Реле» для этой схемы не требуется: канал физического релейного модуля назначается непосредственно включению светильника.

На снимках показан пример «Бра WB-MR6CU» из комнаты «Примеры освещения». Имя светильника можно выбрать своё. В адресах выбирайте свой экземпляр модуля и выход, к которому подключена лампа.

6. Загрузите конфигурацию
- Проверьте, что выбраны нужные комната, светильник и канал реле.
- Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на PLC. Отдельное Сохранить проект используйте, если нужна самостоятельная контрольная точка.
- Не изменяйте проект до завершения операций. Проверьте новую запись в истории сохранений, сообщение о завершении загрузки и восстановление связи с XIOT-PLC.
- В XIOT-EDITOR включите и выключите Первую лампу. Убедитесь, что физическая лампа переключается, а отображаемое состояние совпадает с фактическим.
Результат: загрузка завершилась без ошибки, реле управляет физической лампой, а отображаемое состояние совпадает с фактическим. Различие между сохранением и загрузкой описано в статье Сохранение резервной копии проекта.
7. Проверьте лампу в XIOT-APP
- Дождитесь подтверждения облачного сохранения и публикации приложения в меню облака редактора. Откройте XIOT-APP и войдите под своей учётной записью XIOT.
- Выберите нужный проект, откройте Тестовую комнату и найдите Первую лампу.
- Включите лампу из приложения. Проверьте три результата: изменилась иконка, сработало реле, загорелась физическая лампа.
- Выключите лампу там же и убедитесь, что обратная связь показала фактическое состояние.
Успешный результат: команда из XIOT-APP доходит до физического реле, а состояние в приложении совпадает с фактическим. Подробнее об установке и входе: Приложение для телефона и планшета XIOT-APP.
Нажмите и удерживайте карточку светильника, чтобы открыть подробное управление.

Если лампа не работает
- Реле не работает из Wiren Board: это не ошибка XIOT. Проверьте монтаж, питание, настройку модуля и канала.
- Wiren Board не показывает «ПОДКЛЮЧЕН»: проверьте адрес, порт, учётные данные MQTT-брокера, сетевую связь и статус XIOT-PLC.
- Нет нужного канала: нажмите Получить топики после установления связи и сверьте имя устройства и канала с веб-интерфейсом Wiren Board.
- Иконка меняется, а реле нет: проверьте адрес управления и убедитесь, что после изменений вы снова загрузили конфигурацию.
- Реле срабатывает, но иконка показывает неверное состояние: проверьте адрес состояния и наличие обратной связи.
- В XIOT-APP нет комнаты или лампы: проверьте выбранный проект, доступ учётной записи, наличие комнаты и лампы в сохранённом проекте, облачную синхронизацию и публикацию приложения. Загрузка на PLC сама по себе не подтверждает обновление приложения.
Если проблема осталась, соберите название проекта, модель Wiren Board и релейного модуля, выбранные адреса, время ошибки и скриншоты, затем обратитесь в поддержку XIOT.
Что вы настроили
Вы прошли весь минимальный маршрут: проект → комната → светильник → драйвер Wiren Board → физическое реле → адреса управления и состояния → загрузка → проверка в XIOT-APP.
Следующий шаг — добавить остальные устройства по тому же принципу, а затем перейти к сценариям и пусконаладке.
См. также
- С чего начать интегратору
- Создание устройств XIOT
- Подключение Wiren Board — полный порядок от питания до проверки.
- Настройка драйвера Wiren Board в XIOT — параметры MQTT-подключения.
- Привязка оборудования к устройствам XIOT
- Сохранение резервной копии проекта
- Приложение для телефона и планшета XIOT-APP