Просмотр кода страницы Training-editor-plc-connection

{{DISPLAYTITLE:Установка XIOT-PLC и привязка контроллера к проекту}}
В третьем уроке установим XIOT-PLC на подготовленный контроллер Wiren Board, свяжем его с уже существующим проектом и проверим зелёный индикатор связи в редакторе. Ниже описан весь путь, включая установку PuTTY на Windows и первый вход в консоль.

== Перед началом ==

Этот урок посвящён '''первой установке на контроллер, где XIOT-PLC ещё нет'''. Контроллер уже подключён к питанию и сети, его операционная система подготовлена. Если устройство управляет работающим объектом, сначала сохраните проект, подготовьте резервную копию контроллера и порядок восстановления. Для обновления действующей установки используйте [[Editor-and-controller-updates|отдельную инструкцию]]: удалять рабочую конфигурацию или повторять привязку для обычного обновления не требуется.

Подготовьте:

* компьютер с Windows и правом установить PuTTY;
* стабильное питание контроллера, доверенную локальную сеть и доступ контроллера к интернету; проверьте правильность его даты и времени;
* IP-адрес именно своего контроллера, административные реквизиты SSH и проверенный отпечаток его ключа — их можно получить у ответственного за настройку устройства;
* учётную запись XIOT-EDITOR, доступ к её почте и уже созданный проект из [[Training-editor-license-activation|урока 2]]; при включённой двухфакторной защите — приложение аутентификации.

Проверьте совместимость модели и ОС по статье [[Xiot-plc-installation|«Установка XIOT-PLC на контроллер»]]. Для показанной установки нужны Debian-совместимая система, systemd, Python 3, wget, sha256sum и dpkg. Установщик требует не менее 100 МБ свободного места в /opt; дополнительно нужен запас для пакета, данных и резервной копии.

Инструкция и кадры относятся к '''XIOT-PLC v14.15 и XIOT-EDITOR v14.15-1'''; ссылки сверены 11 октября 2026 года. Номер редактора виден в открытом проекте. Если проект закреплён за другой линией версии, сначала проверьте [[Editor-and-controller-updates|совместимость и порядок перехода]].

== Видеоинструкция ==

<xiot-video file="XIOT-EDITOR-plc-connection-20261011-music-r1.mp4" poster="XIOT-EDITOR-plc-poster-20261011.png" caption="Урок 3. Установка XIOT-PLC и привязка контроллера — 1 минута 51 секунда" />

Музыка: «Dream Culture» — Kevin MacLeod ([https://incompetech.com/ incompetech.com]). [https://incompetech.com/music/royalty-free/index.html?isrc=USUAN1300046 Официальный источник]. Лицензия [https://creativecommons.org/licenses/by/4.0/ CC BY 4.0]. Использован фрагмент 0–111,4 с; изменены громкость и частотный баланс, добавлены плавные вход и затухание, приглушение под речь.

Кадры ниже извлечены из этого ролика. Email и код закрыты при подготовке записи: это маски записи, а не обязательный вид полей программы. Вводите свои данные. В ролике работа начинается в уже открытой консоли; следующий раздел объясняет, как попасть в неё с Windows.

== 1. Откройте консоль контроллера через PuTTY ==

=== Что такое консоль ===

Консоль — текстовый интерфейс Linux на контроллере. Вы вводите команду и получаете ответ: например, версию установленного пакета или состояние службы. Здесь консоль нужна, чтобы скачать XIOT-PLC, проверить файл и установить его с правами администратора.

'''PuTTY''' — программа на вашем компьютере. Она соединяется с контроллером по защищённому протоколу '''SSH''' и показывает его консоль. После входа команды выполняются на контроллере. Обычная командная строка Windows, редактор XIOT и веб-страница привязки — другие окна; команды установки вводите именно в SSH-сеансе контроллера.

=== Установите PuTTY на Windows ===

# Откройте [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html официальную страницу последнего стабильного выпуска PuTTY]. На дату подготовки урока это версия 0.85. Используйте раздел '''Package files → MSI (Windows Installer)'''.
# Выберите установщик для своего компьютера: '''64-bit x86''' для обычной 64-разрядной Windows на Intel/AMD, '''64-bit Arm''' для Windows на ARM. Тип системы можно посмотреть в параметрах Windows, в сведениях о системе. Вариант 32-bit x86 нужен только для 32-разрядной Windows.
# Откройте скачанный файл <code>.msi</code> двойным щелчком. Пройдите мастер установки, оставив предложенные папку и компоненты. Если Windows запросит разрешение администратора, используйте разрешённую для этого компьютера учётную запись; при отсутствии прав обратитесь к администратору.
# После завершения найдите '''PuTTY''' в меню «Пуск» и запустите его. Откроется окно '''PuTTY Configuration'''.

Скачивайте установщик по ссылке с указанной официальной страницы. Сайт <code>putty.org</code>, встречающийся в старых инструкциях, не принадлежит разработчикам PuTTY; это разъяснено в [https://the.earth.li/~sgtatham/putty/latest/htmldoc/AppendixA.html#faq-putty-org официальном FAQ].

=== Узнайте адрес своего контроллера ===

# Подключите компьютер к той же доверенной локальной сети, что и контроллер.
# Откройте список клиентов DHCP или подключённых устройств в интерфейсе роутера. Найдите Wiren Board и сверьте устройство по имени и серийному номеру/маркировке, а при необходимости — по MAC-адресу соответствующего сетевого интерфейса. Если доступа к роутеру нет, попросите администратора сообщить адрес нужного контроллера.
# Если веб-интерфейс Wiren Board уже доступен, адреса его интерфейсов можно посмотреть в разделе '''Устройства''', карточке '''Network'''. Выберите адрес интерфейса, через который компьютер связан с контроллером.

Адрес зависит от подключения и настроек сети. У контроллера может быть несколько адресов; адрес роутера и адрес компьютера не подходят вместо адреса контроллера. При нескольких одинаковых устройствах не выбирайте первое найденное. Подробности: [https://wiki.wirenboard.com/wiki/How_to_find_IP_address «Как узнать IP-адрес контроллера» в документации Wiren Board].

=== Подключитесь по SSH и проверьте ключ ===

В разделе '''Session''' окна PuTTY заполните параметры:

{| class="wikitable"
! Поле !! Что указать
|-
| Host Name (or IP address) || IP-адрес своего контроллера, без <code>http://</code> и без <code>:5551</code>.
|-
| Port || <code>22</code> — стандартный SSH-порт Wiren Board. Если администратор изменил его, используйте сообщённый им порт.
|-
| Connection type || <code>SSH</code>.
|}

Нажмите '''Open'''. При первом соединении PuTTY покажет ключ хоста — идентификатор SSH-сервера. Сравните тип ключа и '''весь отпечаток SHA-256''' со значением, заранее полученным от администратора по доверенному каналу или с самого контроллера через доверенный локальный доступ. Только при совпадении нажмите '''Accept''': PuTTY сохранит ключ для следующих соединений. Если сверить ключ нельзя, нажмите '''Cancel''' и уточните его. Если ключ изменился при повторном входе, сначала выясните причину у администратора; не заменяйте сохранённый ключ автоматически. См. [https://the.earth.li/~sgtatham/putty/latest/htmldoc/Chapter2.html#gs-hostkey руководство PuTTY о проверке ключа].

=== Введите реквизиты и убедитесь, что вход выполнен ===

# В строке <code>login as:</code> введите имя пользователя и нажмите '''Enter'''. В стандартной конфигурации Wiren Board административный пользователь — <code>root</code>. Если доступ настроен иначе, используйте выданную вам учётную запись и предусмотренный администратором способ получения прав root.
# На запрос пароля введите '''текущий пароль этого пользователя контроллера''' и нажмите '''Enter'''. Это не пароль от Windows или почты XIOT. Пароль узнавайте у ответственного за устройство; заводские реквизиты сверяйте с документацией своей модели и после первого входа меняйте по инструкции производителя.
# При вводе пароля символы и звёздочки обычно '''не отображаются''', курсор может оставаться на месте. Это нормально: ввод принимается скрыто. При отказе проверьте раскладку клавиатуры, Caps Lock и реквизиты.
# После успешного входа появятся приветствие системы и приглашение командной строки. Оно обычно содержит имя пользователя, имя контроллера и заканчивается знаком <code>#</code> для root либо <code>$</code> для обычного пользователя.

Для проверки введите <code>whoami</code> и нажмите Enter. Перед установкой этой инструкцией ожидается ответ <code>root</code>. Команда <code>hostname</code> покажет имя устройства: сверьте его с ожидаемым контроллером. Эти команды не меняют настройки.

Параметры доступа сверены с официальными статьями Wiren Board [https://wiki.wirenboard.com/wiki/SSH «Подключение по SSH»] и [https://wiki.wirenboard.com/wiki/Консоль «Консоль»]. В XIOT Wiki есть также раздел о PuTTY в статье [[Wiren-board-8-first-start|«Первое включение контроллера Wiren Board 8»]]; он относится к WB8.

=== Как вводить, вставлять команды и завершить сеанс ===

Одну команду можно набрать с клавиатуры и выполнить клавишей Enter. Не перепечатывайте приглашение <code>root@…#</code>, сам знак <code>#</code> и строки результата: они не входят в команду.

Чтобы вставить блок из статьи, сначала прочитайте его, затем нажмите «Копировать» у блока или выделите только команды и скопируйте их в Windows. В окне PuTTY вставка по умолчанию выполняется '''правой кнопкой мыши''' либо '''Shift+Insert'''. Если команда ещё не запустилась, нажмите Enter. Многострочный текст с переводами строк может начать выполняться сразу после вставки, поэтому проверяйте его '''до''' вставки.

Для копирования ответа из PuTTY достаточно выделить текст левой кнопкой мыши. '''Ctrl+C''' в терминале может прервать выполняющуюся команду; не используйте его как обычное копирование во время установки. После каждой операции дождитесь результата и возвращения приглашения. Эти приёмы описаны в [https://the.earth.li/~sgtatham/putty/latest/htmldoc/Chapter3.html#using-selection руководстве PuTTY].

Когда установка и проверки завершены, введите <code>exit</code> и нажмите Enter. Это завершает SSH-сеанс, а не выключает контроллер. Не закрывайте окно во время установки пакета. Если связь оборвалась, сначала подключитесь снова и проверьте пакет и службу командами ниже, чтобы установить фактический результат.

== 2. Установите XIOT-PLC ==

В Wiki откройте [[Getting-started|«Начало работы»]] → раздел «Первый проект» → [[Xiot-plc-installation|«Установка XIOT-PLC на контроллер»]]. В ролике используется пакет v14.15. Для другой версии берите совместимые пакет, ссылку и контрольную сумму из актуальной инструкции вместе, не смешивая выпуски.

До установки можно проверить наличие пакета:

<syntaxhighlight lang="bash">
dpkg-query -W -f='${Status} ${Version}\n' xiot
</syntaxhighlight>

Если пакет не найден, это соответствует показанной первой установке. Если получен статус установленного пакета с номером версии, не удаляйте его ради повторения урока: сначала определите, требуется ли [[Editor-and-controller-updates|обновление действующей установки]].

Для первой установки v14.15 выполните следующий блок '''целиком в консоли контроллера с правами root''':

<syntaxhighlight lang="bash">
cd /root &&
wget -O xiot-14.15.deb https://xiot.pro/system/plcversions/v14.15/xiot.deb &&
printf '%s\n' 'c3b67332176759b590f966a494130331afc9cf0b0192d8760f1175abe68a21ee  xiot-14.15.deb' | sha256sum -c - &&
dpkg -i xiot-14.15.deb
</syntaxhighlight>

Блок скачивает пакет, сверяет SHA-256 и устанавливает его только после успешной проверки. Связки <code>&amp;&amp;</code> останавливают цепочку при ошибке. Ожидайте сообщения об успешной проверке суммы и завершения <code>dpkg</code> без ошибок. Не отключайте проверку HTTPS-сертификата и не пропускайте несовпадение контрольной суммы. Время установки зависит от устройства и соединения; в видео ожидание сокращено.

[[Файл:XIOT-EDITOR-plc-commands-20261011.png|thumb|center|960px|alt=Блок скачивания, проверки SHA-256 и установки XIOT-PLC в документации|Копирование полного блока команд. Кадр из видео — 00:22.]]

== 3. Проверьте пакет и работающую службу ==

После возвращения приглашения выполните по очереди:

<syntaxhighlight lang="bash">
dpkg-query -W -f='${Status} ${Version}\n' xiot
systemctl is-active xiot.service
</syntaxhighlight>

Для показанной версии ожидаются ответы <code>install ok installed 14.15</code> и <code>active</code>. Дополнительно проверьте подробное состояние:

<syntaxhighlight lang="bash">
systemctl status xiot.service --no-pager
</syntaxhighlight>

Ожидается <code>active (running)</code>. Повторите проверку через некоторое время: служба должна оставаться запущенной. Сообщение установщика само по себе не заменяет эту проверку.

[[Файл:XIOT-EDITOR-plc-console-20261011.png|thumb|center|960px|alt=Консоль с установленным пакетом XIOT-PLC версии 14.15 и ответом active для xiot.service|Пакет установлен, основная служба активна. Кадр из видео — 01:01.]]

== 4. Войдите на странице настройки XIOT-PLC ==

Откройте [[Connect-xiot-plc-to-editor|инструкцию привязки]], затем в браузере перейдите по адресу <code>http://IP_контроллера:5551</code>, заменив <code>IP_контроллера</code> адресом своего устройства. '''5551''' — порт веб-страницы настройки XIOT-PLC; '''22''' выше использовался для SSH.

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

# Убедитесь, что открылась страница '''«XIOT контроллер»''' с шагом '''«Вход по email»''' и ожидаемой версией. Если контроллер уже привязан, сначала проверьте его действующий проект.
# Введите '''ту же почту, под которой входите в XIOT-EDITOR''', и нажмите '''«Получить код»'''.
# Откройте пришедшее письмо, введите шестизначный код в поле '''«Код»''' и нажмите '''«Подтвердить код»'''. Код вводите самостоятельно и не передавайте другим людям.
# Если включена двухфакторная защита и появился соответствующий шаг, введите код из приложения аутентификации и нажмите '''«Подтвердить вход»'''.

[[Файл:XIOT-EDITOR-plc-email-20261011.png|thumb|center|960px|alt=Страница XIOT контроллер с полем Email и кнопкой «Получить код», адрес скрыт|Вход с той же почтой, что используется в редакторе. Кадр из видео — 01:23.]]

[[Файл:XIOT-EDITOR-plc-code-20261011.png|thumb|center|960px|alt=Шаг подтверждения email с закрытыми адресом и кодом и кнопкой «Подтвердить код»|Подтверждение входа кодом из письма. Кадр из видео — 01:29.]]

В записи перед подтверждением был запрошен свежий код. При обычном входе используйте действующий код из своего письма; повторный запрос не является обязательным шагом. Если код просрочен или отклонён, следуйте сообщению формы и доступности кнопки «Отправить код повторно».

== 5. Выберите существующий проект и завершите привязку ==

# На шаге '''«Выбор проекта»''' откройте список '''«Проект»''' и выберите тот проект, который подготовили в редакторе.
# Сверьте название. В ролике '''«Новый проект» — имя уже существующего проекта''', созданного на предыдущем уроке; создавать ещё один проект не нужно.
# Установите флажок '''«Подтверждаю привязку контроллера к выбранному проекту»''' и нажмите '''«Привязать»'''.
# Дождитесь сообщения '''«Привязка завершена»''' и подтверждения успешной привязки к выбранному проекту. Один только успешный вход по email ещё не завершает привязку.

[[Файл:XIOT-EDITOR-plc-project-20261011.png|thumb|center|960px|alt=Выбор проекта «Новый проект», флажок подтверждения и кнопка «Привязать»|Проверьте существующий проект перед установкой флажка и привязкой. Кадр из видео — 01:36.]]

[[Файл:XIOT-EDITOR-plc-bound-20261011.png|thumb|center|960px|alt=Сообщение «Привязка завершена» для контроллера XIOT-PLC v14.15|Страница подтвердила завершение привязки. Кадр из видео — 01:39,3.]]

== 6. Проверьте связь в редакторе ==

Вернитесь в [https://editor.xiot.pro/ XIOT-EDITOR] и откройте тот же проект. Дождитесь '''зелёного индикатора связи с контроллером''' в верхней панели. Сверьте название проекта и версию XIOT-PLC. В примере на кадре показаны PLC v14.15 и редактор v14.15-1.

[[Файл:XIOT-EDITOR-plc-green-20261011.png|thumb|center|960px|alt=Открытый проект в XIOT-EDITOR с зелёным индикатором связи с контроллером, выделенным оранжевой рамкой|Зелёный индикатор подтверждает связь с XIOT-PLC. Кадр из видео — 01:48.]]

Результат урока: пакет установлен, служба работает, привязка завершена и редактор видит контроллер. Это ещё не проверка физических устройств и сценариев. Привязка и команда '''«Загрузить конфигурацию на контроллер»''' — отдельные действия; загрузку выполняют после подготовки и проверки конфигурации с учётом безопасности оборудования.

== Если не получилось ==

* '''PuTTY не соединяется.''' Проверьте, что выбран адрес нужного контроллера, компьютер находится в доступной ему сети и указан правильный SSH-порт. Уточните у администратора, разрешён ли SSH-доступ; открывать порт в интернет для этой проверки не требуется.
* '''SSH отвергает пароль.''' Проверьте имя пользователя, раскладку, Caps Lock и текущие реквизиты контроллера. Если доступ разрешён только по ключу, используйте выданный администратором способ входа.
* '''Не совпала SHA-256 или установка завершилась ошибкой.''' Не устанавливайте неподтверждённый файл и не запускайте очистку данных или общее обновление ОС. Сохраните текст ошибки и разберите её по [[Xiot-plc-installation|инструкции установки]].
* '''Служба не активна или перезапускается.''' Проверьте её состояние и журнал командой <code>journalctl -u xiot.service -n 100 --no-pager</code>. До выяснения причины не переходите к привязке. Перед передачей журнала уберите из него секреты и данные доступа.
* '''Страница :5551 не открывается.''' Проверьте адрес контроллера, службу xiot.service и доступ из доверенной сети.
* '''Код не приходит или проект отсутствует в списке.''' Проверьте email, папку «Спам», доступность проекта этой учётной записи в редакторе и сообщения формы. Подробности — в [[Connect-xiot-plc-to-editor|инструкции привязки]].
* '''Сообщается о существующей привязке или нет зелёной связи.''' Проверьте выбранный проект, службу и интернет на контроллере. Не удаляйте настройки и не повторяйте привязку вслепую. Если причина неясна, [[Support|обратитесь в поддержку XIOT]] с текстом сообщения без кодов и паролей.

== Дальше ==

* [[Training|Содержание обучения XIOT]]
* [[Training-editor-license-activation|Урок 2. Активация лицензии и открытие проекта]]
* [[Wiren-board-driver-setup|Настройка драйвера Wiren Board в XIOT]]
* [[Device-bindings|Привязка реальных устройств к виртуальным]]
* [[Wiren-board-connection|Полный маршрут подключения Wiren Board]]

[[Категория:Документация XIOT]]
[[Категория:XIOT-EDITOR]]
{{DEFAULTSORT:Установка XIOT-PLC и привязка контроллера к проекту}}