Connect-xiot-plc-to-editor: различия между версиями

Текущая версия от 09:57, 11 октября 2026

Инструкция для первичной привязки XIOT-PLC v14.15 к проекту в актуальном XIOT-EDITOR. Нужны установленный контроллер, учётная запись интегратора и доступный ей проект. Результат: контроллер сообщает об успешной привязке, а в редакторе появляется связь с ним.

В этой версии вход на странице настройки выполняется по email и одноразовому коду, без пароля. Если для учётной записи включена двухфакторная защита, дополнительно потребуется код из приложения аутентификации.

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

Ограничения

Сейчас один XIOT-PLC (plc1) можно привязать к одному проекту. Этот XIOT-PLC может использовать до шести отдельных MQTT-подключений Wiren Board. Возможность нескольких XIOT-PLC в одном проекте, в том числе для гостиничных объектов, находится в разработке и пока недоступна.

Страница на порту 5551 должна быть доступна только из доверенной сети. Для удалённой настройки используйте ограниченный защищённый канал; не оставляйте порт общедоступным в интернете. Не вводите коды подтверждения через недоверенное соединение.

До начала работы

Проверьте, что установлен XIOT-PLC v14.15 и служба xiot.service работает; см. Установка XIOT-PLC на контроллер.
Подключите контроллер и компьютер интегратора к доверенной локальной сети. Контроллеру нужен доступ к интернету, а его дата и время должны быть правильными.
Подготовьте зарегистрированный в XIOT email и доступ к почте. Если включена двухфакторная защита, понадобится приложение аутентификации.
Убедитесь, что нужный проект уже создан и доступен вашей учётной записи интегратора в XIOT-EDITOR. Активация лицензии и создание проекта выполняются в редакторе отдельно: установка пакета на контроллер их не заменяет.
Если нужна самостоятельная контрольная точка проекта, выполните Сохранить проект. Сохранение, привязка и загрузка конфигурации на контроллер — разные действия.

Привязка

Откройте XIOT-EDITOR, войдите под своей учётной записью интегратора и убедитесь, что нужный проект доступен.
В новой вкладке откройте http://IP_контроллера:5551. Например, http://192.168.31.92:5551; замените адрес на адрес своего устройства.
Ожидаемый результат: открылась страница «XIOT контроллер» с шагом «Вход по email». На странице также указана версия контроллера. Если она сообщает, что контроллер уже привязан, не создавайте новую привязку.
В поле Email введите свою зарегистрированную почту XIOT и нажмите «Получить код».
Откроется шаг «Подтверждение email». Проверьте почту; код не нужно пересылать другим людям или помещать в скриншоты и журналы.
Введите полученный шестизначный код в поле «Код» и нажмите «Подтвердить код».
Если появился шаг «Двухфакторная защита», введите код из приложения аутентификации и нажмите «Подтвердить вход». Если этот шаг не запрашивается, переходите к выбору проекта.
На шаге «Выбор проекта» выберите нужное название в списке «Проект». Сверьте его, установите флажок «Подтверждаю привязку контроллера к выбранному проекту» и нажмите «Привязать».
Ожидаемый результат: показано «Привязка завершена» и сообщение об успешной привязке к выбранному проекту. Подтверждённый вход по email без этого шага ещё не означает привязку.
Вернитесь в нужный проект XIOT-EDITOR и дождитесь появления связи с контроллером. При необходимости обновите страницу редактора. Сверьте сведения об устройстве и его версию.

Проверка результата

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

Когда конфигурация подготовлена и проверена, выполните «Загрузить конфигурацию на контроллер». Это отдельное действие, которое может изменить работу оборудования: сначала убедитесь, что выбран верный проект и выполнение безопасно для объекта. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.

После загрузки проверьте основные устройства и сценарии на объекте.

Если привязка не завершилась

Страница :5551 не открывается. Проверьте IP-адрес, состояние xiot.service и доступ из доверенной сети. Не открывайте порт всему интернету для диагностики.
Код не пришёл или отклонён. Проверьте написание email, почтовую папку «Спам» и сообщения формы. Повторную отправку выполняйте после указанного ожидания кнопкой «Отправить код повторно». При истечении сессии начните вход заново. Пароль от старой формы здесь не используется.
Вход подтверждён, но список проектов временно недоступен. Нажмите «Получить проекты», когда сервис снова станет доступен. Если список пуст или нужного проекта нет, проверьте его наличие и свои права в актуальном редакторе.
Контроллер или проект уже привязан. Не удаляйте настройки и не пытайтесь обойти ограничение. Проверьте действующую привязку; для её изменения обратитесь в поддержку.
Ожидается завершение прежней привязки. Следуйте сообщению страницы: войдите тем же аккаунтом и выберите тот же проект. Не меняйте проект между повторными попытками незавершённой операции.
Новая привязка для проекта недоступна. Сохраните текст сообщения и обратитесь в поддержку. Не переходите к прежней парольной форме и не создавайте другой проект только для обхода ошибки.
Выбран неверный проект или после привязки нет связи. Не загружайте конфигурацию и не повторяйте привязку вслепую. Проверьте службу, доступ контроллера к интернету и сообщение страницы; передайте эти сведения в поддержку без кодов и данных доступа.

Следующий шаг

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

@@ Строка 1: / Строка 1: @@
 {{DISPLAYTITLE:Связываем XIOT-PLC с редактором XIOT}}
-Инструкция предназначена для '''интегратора''', который установил XIOT-PLC и имеет доступ к проекту. Результат: установленный XIOT-PLC привязан к выбранному проекту и отображается в XIOT-EDITOR.
+Инструкция для '''первичной привязки XIOT-PLC v14.15''' к проекту в [https://editor.xiot.pro/ актуальном XIOT-EDITOR]. Нужны установленный контроллер, учётная запись интегратора и доступный ей проект. Результат: контроллер сообщает об успешной привязке, а в редакторе появляется связь с ним.
-'''Проверено: 22 августа 2026 года.''' Описан текущий вход по email и паролю через локальный порт <code>5551</code>.
+В этой версии вход на странице настройки выполняется по '''email и одноразовому коду''', без пароля. Если для учётной записи включена двухфакторная защита, дополнительно потребуется код из приложения аутентификации.
+'''Если вы только обновили уже привязанный контроллер, эти шаги повторять не нужно.''' Сначала проверьте связь с прежним проектом. Не удаляйте данные привязки и не отвязывайте устройство ради повторного входа.
 == Ограничения ==
@@ Строка 8: / Строка 10: @@
 Сейчас один XIOT-PLC (<code>plc1</code>) можно привязать к одному проекту. Этот XIOT-PLC может использовать до шести отдельных MQTT-подключений Wiren Board. Возможность нескольких XIOT-PLC в одном проекте, в том числе для гостиничных объектов, находится в разработке и пока недоступна.
-Интерфейс на порту <code>5551</code> используйте только внутри доверенной локальной сети. Не публикуйте этот порт в интернет и не вводите пароль через недоверенную сеть.
+Страница на порту <code>5551</code> должна быть доступна только из доверенной сети. Для удалённой настройки используйте ограниченный защищённый канал; не оставляйте порт общедоступным в интернете. Не вводите коды подтверждения через недоверенное соединение.
 == До начала работы ==
-* Убедитесь, что <code>xiot.service</code> запущена; см. [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]].
+* Проверьте, что установлен XIOT-PLC v14.15 и служба <code>xiot.service</code> работает; см. [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]].
-* Подключите устройство-хост и компьютер интегратора к доверенной локальной сети.
+* Подключите контроллер и компьютер интегратора к доверенной локальной сети. Контроллеру нужен доступ к интернету, а его дата и время должны быть правильными.
-* Подготовьте текущие email и пароль XIOT, а также проект, к которому нужно привязать XIOT-PLC.
+* Подготовьте зарегистрированный в XIOT email и доступ к почте. Если включена двухфакторная защита, понадобится приложение аутентификации.
-* Если перед привязкой нужна самостоятельная контрольная точка или передача работы через облако, в XIOT-EDITOR нажмите '''Сохранить проект''' и при необходимости дождитесь статуса '''В облаке'''. Для последующей загрузки конфигурации отдельное сохранение не требуется.
+* Убедитесь, что нужный проект уже создан и доступен вашей учётной записи интегратора в [https://editor.xiot.pro/ XIOT-EDITOR]. Активация лицензии и создание проекта выполняются в редакторе отдельно: установка пакета на контроллер их не заменяет.
+* Если нужна самостоятельная контрольная точка проекта, выполните '''Сохранить проект'''. Сохранение, привязка и загрузка конфигурации на контроллер — разные действия.
 == Привязка ==
-# Откройте [https://xiot.pro XIOT-EDITOR], войдите под учётной записью интегратора и нажмите '''F2''' или '''Fn + F2'''.
+# Откройте [https://editor.xiot.pro/ XIOT-EDITOR], войдите под своей учётной записью интегратора и убедитесь, что нужный проект доступен.
-#: До привязки блок XIOT-PLC не содержит данных подключённого сервера и показывает отсутствие связи.
+# В новой вкладке откройте <code>http://IP_контроллера:5551</code>. Например, <code>http://192.168.31.92:5551</code>; замените адрес на адрес своего устройства.
-#: [[Файл:Plclinkno.png|без|мини|537x537пкс|отсутствие связи контроллера с редактором]]
+#: '''Ожидаемый результат:''' открылась страница '''«XIOT контроллер»''' с шагом '''«Вход по email»'''. На странице также указана версия контроллера. Если она сообщает, что контроллер уже привязан, не создавайте новую привязку.
-# В новой вкладке откройте <code>http://IP_устройства:5551</code>. Например: <code>http://192.168.31.92:5551</code>.
+# В поле '''Email''' введите свою зарегистрированную почту XIOT и нажмите '''«Получить код»'''.
-#: '''Ожидаемый результат:''' открылась локальная страница привязки XIOT-PLC.
+#: Откроется шаг '''«Подтверждение email»'''. Проверьте почту; код не нужно пересылать другим людям или помещать в скриншоты и журналы.
-#: [[Файл:Plc login xiot.png|без|мини|508x508пкс|страница привязки контроллера к проекту в редакторе]]
+# Введите полученный шестизначный код в поле '''«Код»''' и нажмите '''«Подтвердить код»'''.
-# Введите текущие '''email''' и '''пароль''', используемые для входа в XIOT-EDITOR. Выберите нужный проект из доступного списка и подтвердите привязку.
+# Если появился шаг '''«Двухфакторная защита»''', введите код из приложения аутентификации и нажмите '''«Подтвердить вход»'''. Если этот шаг не запрашивается, переходите к выбору проекта.
-#: '''Ожидаемый результат:''' локальный интерфейс сообщает об успешной привязке.
+# На шаге '''«Выбор проекта»''' выберите нужное название в списке '''«Проект»'''. Сверьте его, установите флажок '''«Подтверждаю привязку контроллера к выбранному проекту»''' и нажмите '''«Привязать»'''.
-#: [[Файл:Plc login ok.png|без|мини|609x609пкс|контроллер успешно привязан к проекту]]
+#: '''Ожидаемый результат:''' показано '''«Привязка завершена»''' и сообщение об успешной привязке к выбранному проекту. Подтверждённый вход по email без этого шага ещё не означает привязку.
-# Вернитесь в XIOT-EDITOR и обновите страницу.
+# Вернитесь в нужный проект XIOT-EDITOR и дождитесь появления связи с контроллером. При необходимости обновите страницу редактора. Сверьте сведения об устройстве и его версию.
-#: '''Ожидаемый результат:''' в блоке XIOT-PLC появились сведения о сервере и зелёный индикатор связи.
-#: [[Файл:Plc connect.png|без|мини|518x518пкс|индикация связи контроллера с редактором]]
 == Проверка результата ==
-Сверьте название выбранного проекта, сведения о XIOT-PLC и зелёный индикатор связи. Затем нажмите '''Загрузить конфигурацию на контроллер''': команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. Проверьте основные устройства и сценарии на объекте.
+Сверьте выбранный проект, сведения о XIOT-PLC и наличие связи. Успешная привязка подтверждает связь контроллера с проектом, но не проверяет работу всех физических устройств и сценариев.
+Когда конфигурация подготовлена и проверена, выполните '''«Загрузить конфигурацию на контроллер»'''. Это отдельное действие, которое может изменить работу оборудования: сначала убедитесь, что выбран верный проект и выполнение безопасно для объекта. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
+После загрузки проверьте основные устройства и сценарии на объекте.
 == Если привязка не завершилась ==
-* Если страница <code>:5551</code> не открывается, проверьте IP-адрес, состояние <code>xiot.service</code> и подключение к той же локальной сети. Не открывайте порт наружу как способ диагностики.
+* '''Страница <code>:5551</code> не открывается.''' Проверьте IP-адрес, состояние <code>xiot.service</code> и доступ из доверенной сети. Не открывайте порт всему интернету для диагностики.
-* Если email или пароль не принимаются, проверьте вход с этими текущими реквизитами в XIOT-EDITOR. Не используйте старые тестовые учётные записи.
+* '''Код не пришёл или отклонён.''' Проверьте написание email, почтовую папку «Спам» и сообщения формы. Повторную отправку выполняйте после указанного ожидания кнопкой '''«Отправить код повторно»'''. При истечении сессии начните вход заново. Пароль от старой формы здесь не используется.
-* Если нужного проекта нет в списке, проверьте, что вы вошли под учётной записью его интегратора и что проект создан.
+* '''Вход подтверждён, но список проектов временно недоступен.''' Нажмите '''«Получить проекты»''', когда сервис снова станет доступен. Если список пуст или нужного проекта нет, проверьте его наличие и свои права в актуальном редакторе.
-* Если выбран неверный проект, не загружайте конфигурацию на устройство. Зафиксируйте сведения о привязке и обратитесь к администратору XIOT для безопасного исправления.
+* '''Контроллер или проект уже привязан.''' Не удаляйте настройки и не пытайтесь обойти ограничение. Проверьте действующую привязку; для её изменения обратитесь в поддержку.
-* Если индикатор остаётся красным, не повторяйте привязку вслепую: проверьте службу, доступ устройства к интернету и сообщения локального интерфейса.
+* '''Ожидается завершение прежней привязки.''' Следуйте сообщению страницы: войдите тем же аккаунтом и выберите тот же проект. Не меняйте проект между повторными попытками незавершённой операции.
+* '''Новая привязка для проекта недоступна.''' Сохраните текст сообщения и обратитесь в поддержку. Не переходите к прежней парольной форме и не создавайте другой проект только для обхода ошибки.
+* '''Выбран неверный проект или после привязки нет связи.''' Не загружайте конфигурацию и не повторяйте привязку вслепую. Проверьте службу, доступ контроллера к интернету и сообщение страницы; передайте эти сведения в поддержку без кодов и данных доступа.
 == Следующий шаг ==
-Настройте нужный драйвер XIOT, например [[Wiren-board-driver-setup|Настройка драйвера Wiren Board в XIOT]], затем свяжите физические и виртуальные устройства: [[Device-bindings|Привязка реальных устройств к виртуальным]]. Полный маршрут для Wiren Board: [[Wiren-board-connection|Подключение Wiren Board]]. Отдельная команда '''Сохранить проект''' создаёт самостоятельную контрольную точку. Команда '''Загрузить конфигурацию на контроллер''' сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
+Настройте нужный драйвер, например [[Wiren-board-driver-setup|драйвер Wiren Board в XIOT]], затем [[Device-bindings|свяжите физические и виртуальные устройства]]. Полный маршрут: [[Wiren-board-connection|Подключение Wiren Board]].