First-light-in-xiot: различия между версиями
Admin (обсуждение | вклад) Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца |
Admin (обсуждение | вклад) Иллюстрированные примеры: привязки адресов, параметры и управление светильником в приложении |
||
| (не показано 5 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Первая лампа в XIOT}} | {{DISPLAYTITLE:Первая лампа в XIOT}} | ||
[[Xiot-devices|Каталог устройств]] → [[Light-fixture|Светильник]] → '''Лампа через реле''' | |||
Общие характеристики, параметры и другие варианты подключения: [[Light-fixture|Светильник]]. | |||
Эта инструкция показывает минимальный сквозной пример: одно физическое реле Wiren Board управляет одной лампой, а её состояние видно в XIOT-APP. Пример намеренно не включает диммирование, сценарии и другие драйверы. | Эта инструкция показывает минимальный сквозной пример: одно физическое реле Wiren Board управляет одной лампой, а её состояние видно в XIOT-APP. Пример намеренно не включает диммирование, сценарии и другие драйверы. | ||
== Что получится == | == Что получится == | ||
В проекте будет комната и | В проекте будет комната и устройство '''Светильник'''. Его характеристика '''Включение''' будет связана с каналом реле Wiren Board через '''адрес управления''' и '''адрес состояния'''. После загрузки конфигурации лампой можно будет управлять из XIOT-APP с проверкой фактического состояния. | ||
== Что нужно до начала == | == Что нужно до начала == | ||
* У вас есть проект и доступ интегратора к XIOT-EDITOR. Если проекта ещё нет, начните со статьи [[С чего начать интегратору]]. | * У вас есть проект и доступ интегратора к XIOT-EDITOR. Если проекта ещё нет, начните со статьи [[Getting-started-for-integrators|С чего начать интегратору]]. | ||
* XIOT-PLC установлен, запущен и привязан к этому проекту. Подробный порядок: [[Установка XIOT-PLC на контроллер]] и [[ | * XIOT-PLC установлен, запущен и привязан к этому проекту. Подробный порядок: [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]] и [[Connect-xiot-plc-to-editor|Привязка XIOT-PLC к проекту]]. | ||
* Wiren Board и релейный модуль настроены. Нужный канал реле виден в веб-интерфейсе Wiren Board и переключает тестовую нагрузку. См. [[Базовая настройка Wiren Board]]. | * Wiren Board и релейный модуль настроены. Нужный канал реле виден в веб-интерфейсе Wiren Board и переключает тестовую нагрузку. См. [[Wiren-board-basic-setup|Базовая настройка Wiren Board]]. | ||
* Учётная запись имеет доступ к этому проекту в XIOT-APP. | * Учётная запись имеет доступ к этому проекту в XIOT-APP. | ||
| Строка 32: | Строка 35: | ||
# Выберите этаж, нажмите '''Создать комнату''' и назовите её, например '''Тестовая комната'''. | # Выберите этаж, нажмите '''Создать комнату''' и назовите её, например '''Тестовая комната'''. | ||
'''Результат:''' в структуре проекта видна комната. Подробнее: [[Создание | '''Результат:''' в структуре проекта видна комната. Подробнее: [[Creating-devices|Создание устройств XIOT]]. | ||
== 3. Добавьте | == 3. Добавьте светильник == | ||
# Выберите созданную комнату. | # Выберите созданную комнату. | ||
# Нажмите '''Создать устройство''' и выберите | # Нажмите '''Создать устройство''' и выберите '''свет'''. | ||
# Задайте имя, например '''Первая лампа'''. | # Задайте имя, например '''Первая лампа'''. | ||
# Для этого примера настройте характеристику '''Включение'''. Яркость, цветовую температуру и RGB настраивают отдельно после успешной проверки включения. | # Для этого примера настройте характеристику '''Включение'''. Яркость, цветовую температуру и RGB настраивают отдельно после успешной проверки включения. | ||
'''Результат:''' в комнате виден светильник с характеристикой '''Включение'''. См. [[ | '''Результат:''' в комнате виден светильник с характеристикой '''Включение'''. См. [[Light-fixture|Светильник]]. | ||
== 4. Подключите Wiren Board и получите адреса == | == 4. Подключите Wiren Board и получите адреса == | ||
| Строка 52: | Строка 55: | ||
# Найдите в списке ранее проверенные устройство и канал реле. | # Найдите в списке ранее проверенные устройство и канал реле. | ||
'''Результат:''' драйвер XIOT подключён к Wiren Board, а нужный канал реле доступен для выбора. Подробнее: [[Настройка драйвера Wiren Board в XIOT]]. | '''Результат:''' драйвер XIOT подключён к Wiren Board, а нужный канал реле доступен для выбора. Подробнее: [[Wiren-board-driver-setup|Настройка драйвера Wiren Board в XIOT]]. | ||
== 5. Назначьте адрес управления и адрес состояния == | == 5. Назначьте адрес управления и адрес состояния == | ||
| Строка 63: | Строка 66: | ||
В старых материалах эти поля могут называться «тег управления», «тег статуса» или «тег состояния». В текущем XIOT-EDITOR и в этой инструкции используются названия '''адрес управления''' и '''адрес состояния'''. | В старых материалах эти поля могут называться «тег управления», «тег статуса» или «тег состояния». В текущем XIOT-EDITOR и в этой инструкции используются названия '''адрес управления''' и '''адрес состояния'''. | ||
'''Результат:''' характеристика '''Включение''' | '''Результат:''' характеристика '''Включение''' отправляет команду реле и получает его состояние. Подробнее: [[Device-bindings|Привязка оборудования к устройствам XIOT]] и [[Xiot-tags|Адреса управления и состояния в XIOT]]. | ||
=== Пример канала WB-MR6CU === | |||
В релейном модуле WB-MR6CU выберите K1–K6 по фактическому подключению лампы. Один и тот же выбранный канал WB используется для команды и обратного состояния характеристики '''Включение'''. Галочка слева от адреса состояния включает ожидание ответа реле; не путайте её с активацией характеристики. | |||
Параметр '''Включение через изменение яркости''' оставьте '''нет'''. Яркость, температуру цвета и RGB для обычной лампы через реле не активируйте. Отдельное устройство «Реле» для этой схемы не требуется: канал физического релейного модуля назначается непосредственно включению светильника. | |||
[[Файл:Relay-topic-bindings-20261003.png|thumb|center|820px|alt=Включение светильника «Бра WB-MR6CU»: команда и состояние канала K5, ожидание ответа включено.|Включение светильника «Бра WB-MR6CU»: команда и состояние канала K5, ожидание ответа включено.]] | |||
На снимках показан пример «Бра WB-MR6CU» из комнаты «Примеры освещения». Имя светильника можно выбрать своё. В адресах выбирайте свой экземпляр модуля и выход, к которому подключена лампа. | |||
[[Файл:Relay-parameters-20261003.png|thumb|center|820px|alt=Для релейного светильника включение через изменение яркости выключено. Параметры яркости и диммирования при неактивной яркости не используются.|Для релейного светильника включение через изменение яркости выключено. Параметры яркости и диммирования при неактивной яркости не используются.]] | |||
== 6. Загрузите конфигурацию == | == 6. Загрузите конфигурацию == | ||
| Строка 72: | Строка 87: | ||
# В XIOT-EDITOR включите и выключите '''Первую лампу'''. Убедитесь, что физическая лампа переключается, а отображаемое состояние совпадает с фактическим. | # В XIOT-EDITOR включите и выключите '''Первую лампу'''. Убедитесь, что физическая лампа переключается, а отображаемое состояние совпадает с фактическим. | ||
'''Результат:''' загрузка завершилась без ошибки, реле управляет физической лампой, а отображаемое состояние совпадает с фактическим. Различие между сохранением и загрузкой описано в статье [[Сохранение резервной копии проекта]]. | '''Результат:''' загрузка завершилась без ошибки, реле управляет физической лампой, а отображаемое состояние совпадает с фактическим. Различие между сохранением и загрузкой описано в статье [[Project-backup|Сохранение резервной копии проекта]]. | ||
== 7. Проверьте лампу в XIOT-APP == | == 7. Проверьте лампу в XIOT-APP == | ||
| Строка 81: | Строка 96: | ||
# Выключите лампу там же и убедитесь, что обратная связь показала фактическое состояние. | # Выключите лампу там же и убедитесь, что обратная связь показала фактическое состояние. | ||
'''Успешный результат:''' команда из XIOT-APP доходит до физического реле, а состояние в приложении совпадает с фактическим. Подробнее об установке и входе: [[Приложение для телефона и планшета XIOT-APP]]. | '''Успешный результат:''' команда из XIOT-APP доходит до физического реле, а состояние в приложении совпадает с фактическим. Подробнее об установке и входе: [[Xiot-app|Приложение для телефона и планшета XIOT-APP]]. | ||
Нажмите и удерживайте карточку светильника, чтобы открыть подробное управление. | |||
[[Файл:Relay-application-20261003.png|thumb|center|400px|alt=«Бра WB-MR6CU» в предпросмотре приложения XIOT: управление включением без ползунков яркости и цвета.|«Бра WB-MR6CU» в предпросмотре приложения XIOT: управление включением без ползунков яркости и цвета.]] | |||
== Если лампа не работает == | == Если лампа не работает == | ||
| Строка 92: | Строка 112: | ||
* '''В XIOT-APP нет комнаты или лампы:''' проверьте выбранный проект, доступ учётной записи, наличие комнаты и лампы в сохранённом проекте, облачную синхронизацию и публикацию приложения. Загрузка на PLC сама по себе не подтверждает обновление приложения. | * '''В XIOT-APP нет комнаты или лампы:''' проверьте выбранный проект, доступ учётной записи, наличие комнаты и лампы в сохранённом проекте, облачную синхронизацию и публикацию приложения. Загрузка на PLC сама по себе не подтверждает обновление приложения. | ||
Если проблема осталась, соберите название проекта, модель Wiren Board и релейного модуля, выбранные адреса, время ошибки и скриншоты, затем [[ | Если проблема осталась, соберите название проекта, модель Wiren Board и релейного модуля, выбранные адреса, время ошибки и скриншоты, затем [[Support|обратитесь в поддержку XIOT]]. | ||
== Что вы настроили == | == Что вы настроили == | ||
Вы прошли весь минимальный маршрут: '''проект → комната → | Вы прошли весь минимальный маршрут: '''проект → комната → светильник → драйвер Wiren Board → физическое реле → адреса управления и состояния → загрузка → проверка в XIOT-APP'''. | ||
Следующий шаг — добавить остальные устройства по тому же принципу, а затем перейти к сценариям и пусконаладке. | Следующий шаг — добавить остальные устройства по тому же принципу, а затем перейти к сценариям и пусконаладке. | ||
| Строка 102: | Строка 122: | ||
== См. также == | == См. также == | ||
* [[С чего начать интегратору]] | * [[Light-fixture|Светильник: общая настройка и выбор другого варианта подключения]]. | ||
* [[Создание | |||
* [[Подключение Wiren Board]] — полный порядок от питания до проверки. | * [[Getting-started-for-integrators|С чего начать интегратору]] | ||
* [[Настройка драйвера Wiren Board в XIOT]] — параметры MQTT-подключения. | * [[Creating-devices|Создание устройств XIOT]] | ||
* [[Привязка | * [[Wiren-board-connection|Подключение Wiren Board]] — полный порядок от питания до проверки. | ||
* [[Сохранение резервной копии проекта]] | * [[Wiren-board-driver-setup|Настройка драйвера Wiren Board в XIOT]] — параметры MQTT-подключения. | ||
* [[Приложение для телефона и планшета XIOT-APP]] | * [[Device-bindings|Привязка оборудования к устройствам XIOT]] | ||
* [[Project-backup|Сохранение резервной копии проекта]] | |||
* [[Xiot-app|Приложение для телефона и планшета XIOT-APP]] | |||
[[Категория:Документация XIOT]] | [[Категория:Документация XIOT]] | ||
[[Категория:Быстрый старт]] | [[Категория:Быстрый старт]] | ||
{{DEFAULTSORT:Первая лампа в XIOT}} | |||
Текущая версия от 18:21, 3 октября 2026
Каталог устройств → Светильник → Лампа через реле
Общие характеристики, параметры и другие варианты подключения: Светильник. Эта инструкция показывает минимальный сквозной пример: одно физическое реле 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