Training-editor-plc-connection

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

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

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

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

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

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

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

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

Урок 3. Установка XIOT-PLC и привязка контроллера — 1 минута 51 секунда

Открыть или скачать видео (MP4)

Музыка: «Dream Culture» — Kevin MacLeod (incompetech.com). Официальный источник. Лицензия CC BY 4.0. Использован фрагмент 0–111,4 с; изменены громкость и частотный баланс, добавлены плавные вход и затухание, приглушение под речь.

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

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

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

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

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

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

1. Откройте официальную страницу последнего стабильного выпуска PuTTY. На дату подготовки урока это версия 0.85. Используйте раздел Package files → MSI (Windows Installer).
2. Выберите установщик для своего компьютера: 64-bit x86 для обычной 64-разрядной Windows на Intel/AMD, 64-bit Arm для Windows на ARM. Тип системы можно посмотреть в параметрах Windows, в сведениях о системе. Вариант 32-bit x86 нужен только для 32-разрядной Windows.
3. Откройте скачанный файл .msi двойным щелчком. Пройдите мастер установки, оставив предложенные папку и компоненты. Если Windows запросит разрешение администратора, используйте разрешённую для этого компьютера учётную запись; при отсутствии прав обратитесь к администратору.
4. После завершения найдите PuTTY в меню «Пуск» и запустите его. Откроется окно PuTTY Configuration.

Скачивайте установщик по ссылке с указанной официальной страницы. Сайт putty.org, встречающийся в старых инструкциях, не принадлежит разработчикам PuTTY; это разъяснено в официальном FAQ.

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

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

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

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

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

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

Нажмите Open. При первом соединении PuTTY покажет ключ хоста — идентификатор SSH-сервера. Сравните тип ключа и весь отпечаток SHA-256 со значением, заранее полученным от администратора по доверенному каналу или с самого контроллера через доверенный локальный доступ. Только при совпадении нажмите Accept: PuTTY сохранит ключ для следующих соединений. Если сверить ключ нельзя, нажмите Cancel и уточните его. Если ключ изменился при повторном входе, сначала выясните причину у администратора; не заменяйте сохранённый ключ автоматически. См. руководство PuTTY о проверке ключа.

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

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

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

Параметры доступа сверены с официальными статьями Wiren Board «Подключение по SSH» и «Консоль». В XIOT Wiki есть также раздел о PuTTY в статье «Первое включение контроллера Wiren Board 8»; он относится к WB8.

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

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

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

Для копирования ответа из PuTTY достаточно выделить текст левой кнопкой мыши. Ctrl+C в терминале может прервать выполняющуюся команду; не используйте его как обычное копирование во время установки. После каждой операции дождитесь результата и возвращения приглашения. Эти приёмы описаны в руководстве PuTTY.

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

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

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

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

dpkg-query -W -f='${Status} ${Version}\n' xiot

Если пакет не найден, это соответствует показанной первой установке. Если получен статус установленного пакета с номером версии, не удаляйте его ради повторения урока: сначала определите, требуется ли обновление действующей установки.

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

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

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

Копирование полного блока команд. Кадр из видео — 00:22.

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

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

dpkg-query -W -f='${Status} ${Version}\n' xiot
systemctl is-active xiot.service

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

systemctl status xiot.service --no-pager

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

Пакет установлен, основная служба активна. Кадр из видео — 01:01.

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

Откройте инструкцию привязки, затем в браузере перейдите по адресу http://IP_контроллера:5551, заменив IP_контроллера адресом своего устройства. 5551 — порт веб-страницы настройки XIOT-PLC; 22 выше использовался для SSH.

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

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

Вход с той же почтой, что используется в редакторе. Кадр из видео — 01:23.

Подтверждение входа кодом из письма. Кадр из видео — 01:29.

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

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

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

Проверьте существующий проект перед установкой флажка и привязкой. Кадр из видео — 01:36.

Страница подтвердила завершение привязки. Кадр из видео — 01:39,3.

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

Вернитесь в XIOT-EDITOR и откройте тот же проект. Дождитесь зелёного индикатора связи с контроллером в верхней панели. Сверьте название проекта и версию XIOT-PLC. В примере на кадре показаны PLC v14.15 и редактор v14.15-1.

Зелёный индикатор подтверждает связь с XIOT-PLC. Кадр из видео — 01:48.

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

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

• PuTTY не соединяется. Проверьте, что выбран адрес нужного контроллера, компьютер находится в доступной ему сети и указан правильный SSH-порт. Уточните у администратора, разрешён ли SSH-доступ; открывать порт в интернет для этой проверки не требуется.
• SSH отвергает пароль. Проверьте имя пользователя, раскладку, Caps Lock и текущие реквизиты контроллера. Если доступ разрешён только по ключу, используйте выданный администратором способ входа.
• Не совпала SHA-256 или установка завершилась ошибкой. Не устанавливайте неподтверждённый файл и не запускайте очистку данных или общее обновление ОС. Сохраните текст ошибки и разберите её по инструкции установки.
• Служба не активна или перезапускается. Проверьте её состояние и журнал командой journalctl -u xiot.service -n 100 --no-pager. До выяснения причины не переходите к привязке. Перед передачей журнала уберите из него секреты и данные доступа.
• Страница :5551 не открывается. Проверьте адрес контроллера, службу xiot.service и доступ из доверенной сети.
• Код не приходит или проект отсутствует в списке. Проверьте email, папку «Спам», доступность проекта этой учётной записи в редакторе и сообщения формы. Подробности — в инструкции привязки.
• Сообщается о существующей привязке или нет зелёной связи. Проверьте выбранный проект, службу и интернет на контроллере. Не удаляйте настройки и не повторяйте привязку вслепую. Если причина неясна, обратитесь в поддержку XIOT с текстом сообщения без кодов и паролей.

Дальше

• Содержание обучения XIOT
• Урок 2. Активация лицензии и открытие проекта
• Настройка драйвера Wiren Board в XIOT
• Привязка реальных устройств к виртуальным
• Полный маршрут подключения Wiren Board