First-light-in-xiot

Эта инструкция показывает минимальный сквозной пример: одно физическое реле 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. Проверьте физическое реле

1. Откройте веб-интерфейс Wiren Board.
2. Найдите канал реле, к которому подключена тестовая лампа.
3. Один раз включите и выключите реле из веб-интерфейса.
4. Запомните название устройства и канала. По ним вы найдёте нужный адрес в XIOT-EDITOR.

Результат: реле и лампа уже работают без XIOT. Если эта проверка не прошла, сначала исправьте монтаж или настройку Wiren Board.

2. Создайте комнату

1. Откройте проект в XIOT-EDITOR.
2. Нажмите F2 или Fn + F2, чтобы включить редактирование.
3. Откройте раздел Устройства и сценарии.
4. Если в проекте ещё нет этажа, создайте его и задайте понятное имя.
5. Выберите этаж, нажмите Создать комнату и назовите её, например Тестовая комната.

Результат: в структуре проекта видна комната. Подробнее: Создание виртуальных устройств.

3. Добавьте виртуальный светильник

1. Выберите созданную комнату.
2. Нажмите Создать устройство и выберите виртуальный светильник типа Lightbulb.
3. Задайте имя, например Первая лампа.
4. Для этого примера настройте характеристику Включение. Яркость, цветовую температуру и RGB настраивают отдельно после успешной проверки включения.

Результат: в комнате виден светильник с характеристикой Включение. См. Виртуальное устройство "Светильник".

4. Подключите Wiren Board и получите адреса

1. Откройте Драйверы → Wiren Board и активируйте подключение.
2. Если XIOT-PLC работает на этом же Wiren Board, обычно используются localhost и порт 1883. В остальных случаях укажите адрес нужного Wiren Board в доверенной локальной или защищённой частной сети. Не публикуйте MQTT-порт в интернет.
3. Укажите логин и пароль MQTT-брокера, если они настроены.
4. Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на PLC. Не изменяйте проект до завершения операций; проверьте запись в истории сохранений, сообщение о загрузке и восстановление связи с XIOT-PLC.
5. Вернитесь в Драйверы → Wiren Board, убедитесь, что отображается статус ПОДКЛЮЧЕН, и нажмите Получить топики.
6. Найдите в списке ранее проверенные устройство и канал реле.

Результат: драйвер XIOT подключён к Wiren Board, а нужный канал реле доступен для выбора. Подробнее: Настройка драйвера Wiren Board в XIOT.

5. Назначьте адрес управления и адрес состояния

1. Вернитесь в Устройства и сценарии и откройте настройки светильника Первая лампа.
2. В характеристике Включение нажмите поле адрес управления и выберите адрес нужного канала реле.
3. В поле адрес состояния выберите адрес, из которого приходит фактическое состояние. Оба поля могут указывать на один канал Wiren Board, если он действительно принимает команды и публикует состояние; проверьте это для выбранного реле.
4. Включите ожидание обратной связи, если выбранный адрес состояния действительно возвращает состояние реле.

В старых материалах эти поля могут называться «тег управления», «тег статуса» или «тег состояния». В текущем XIOT-EDITOR и в этой инструкции используются названия адрес управления и адрес состояния.

Результат: характеристика Включение может отправить команду реле и получить его состояние. Подробнее: Привязка реальных устройств к виртуальным и Адреса управления и состояния в XIOT.

6. Загрузите конфигурацию

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

Результат: загрузка завершилась без ошибки, реле управляет физической лампой, а отображаемое состояние совпадает с фактическим. Различие между сохранением и загрузкой описано в статье Сохранение резервной копии проекта.

7. Проверьте лампу в XIOT-APP

1. Дождитесь подтверждения облачного сохранения и публикации приложения в меню облака редактора. Откройте XIOT-APP и войдите под своей учётной записью XIOT.
2. Выберите нужный проект, откройте Тестовую комнату и найдите Первую лампу.
3. Включите лампу из приложения. Проверьте три результата: изменилась иконка, сработало реле, загорелась физическая лампа.
4. Выключите лампу там же и убедитесь, что обратная связь показала фактическое состояние.

Успешный результат: команда из XIOT-APP доходит до физического реле, а состояние в приложении совпадает с фактическим. Подробнее об установке и входе: Приложение для телефона и планшета XIOT-APP.

Если лампа не работает

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

Если проблема осталась, соберите название проекта, модель Wiren Board и релейного модуля, выбранные адреса, время ошибки и скриншоты, затем обратитесь в поддержку XIOT.

Что вы настроили

Вы прошли весь минимальный маршрут: проект → комната → виртуальный светильник → драйвер Wiren Board → физическое реле → адреса управления и состояния → загрузка → проверка в XIOT-APP.

Следующий шаг — добавить остальные устройства по тому же принципу, а затем перейти к сценариям и пусконаладке.

См. также

• С чего начать интегратору
• Создание виртуальных устройств
• Подключение Wiren Board — полный порядок от питания до проверки.
• Настройка драйвера Wiren Board в XIOT — параметры MQTT-подключения.
• Привязка реальных устройств к виртуальным
• Сохранение резервной копии проекта
• Приложение для телефона и планшета XIOT-APP