Перейти к содержанию

First-light-in-xiot: различия между версиями

Материал из XIOT Wiki
Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца
Иллюстрированные примеры: привязки адресов, параметры и управление светильником в приложении
 
(не показано 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 с проверкой фактического состояния.
В проекте будет комната и устройство '''Светильник'''. Его характеристика '''Включение''' будет связана с каналом реле Wiren Board через '''адрес управления''' и '''адрес состояния'''. После загрузки конфигурации лампой можно будет управлять из XIOT-APP с проверкой фактического состояния.


== Что нужно до начала ==
== Что нужно до начала ==


* У вас есть проект и доступ интегратора к XIOT-EDITOR. Если проекта ещё нет, начните со статьи [[С чего начать интегратору]].
* У вас есть проект и доступ интегратора к XIOT-EDITOR. Если проекта ещё нет, начните со статьи [[Getting-started-for-integrators|С чего начать интегратору]].
* XIOT-PLC установлен, запущен и привязан к этому проекту. Подробный порядок: [[Установка XIOT-PLC на контроллер]] и [[Связываем XIOT-PLC с редактором XIOT|Привязка 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. Добавьте светильник ==


# Выберите созданную комнату.
# Выберите созданную комнату.
# Нажмите '''Создать устройство''' и выберите виртуальный светильник типа <code>Lightbulb</code>.
# Нажмите '''Создать устройство''' и выберите '''свет'''.
# Задайте имя, например '''Первая лампа'''.
# Задайте имя, например '''Первая лампа'''.
# Для этого примера настройте характеристику '''Включение'''. Яркость, цветовую температуру и 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 и в этой инструкции используются названия '''адрес управления''' и '''адрес состояния'''.


'''Результат:''' характеристика '''Включение''' может отправить команду реле и получить его состояние. Подробнее: [[Привязка реальных устройств к виртуальным]] и [[Механизм работы тегов в XIOT|Адреса управления и состояния в XIOT]].
'''Результат:''' характеристика '''Включение''' отправляет команду реле и получает его состояние. Подробнее: [[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 и релейного модуля, выбранные адреса, время ошибки и скриншоты, затем [[Связь с поддержкой|обратитесь в поддержку XIOT]].
Если проблема осталась, соберите название проекта, модель Wiren Board и релейного модуля, выбранные адреса, время ошибки и скриншоты, затем [[Support|обратитесь в поддержку XIOT]].


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


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

Что нужно до начала

Безопасность: не подключайте и не перекоммутируйте цепи сетевого напряжения под напряжением. Физическое подключение реле и лампы должен выполнять квалифицированный специалист. Для первой проверки используйте заранее проверенную безопасную нагрузку.

1. Проверьте физическое реле

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

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

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

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

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

3. Добавьте светильник

  1. Выберите созданную комнату.
  2. Нажмите Создать устройство и выберите свет.
  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 и Адреса управления и состояния в XIOT.

Пример канала WB-MR6CU

В релейном модуле WB-MR6CU выберите K1–K6 по фактическому подключению лампы. Один и тот же выбранный канал WB используется для команды и обратного состояния характеристики Включение. Галочка слева от адреса состояния включает ожидание ответа реле; не путайте её с активацией характеристики.

Параметр Включение через изменение яркости оставьте нет. Яркость, температуру цвета и RGB для обычной лампы через реле не активируйте. Отдельное устройство «Реле» для этой схемы не требуется: канал физического релейного модуля назначается непосредственно включению светильника.

Включение светильника «Бра WB-MR6CU»: команда и состояние канала K5, ожидание ответа включено.
Включение светильника «Бра WB-MR6CU»: команда и состояние канала K5, ожидание ответа включено.

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

Для релейного светильника включение через изменение яркости выключено. Параметры яркости и диммирования при неактивной яркости не используются.
Для релейного светильника включение через изменение яркости выключено. Параметры яркости и диммирования при неактивной яркости не используются.

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

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

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

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

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

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


Нажмите и удерживайте карточку светильника, чтобы открыть подробное управление.

«Бра WB-MR6CU» в предпросмотре приложения XIOT: управление включением без ползунков яркости и цвета.
«Бра WB-MR6CU» в предпросмотре приложения XIOT: управление включением без ползунков яркости и цвета.

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

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

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

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

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

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

См. также