Установка XIOT-PLC и привязка контроллера к проекту

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

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

Урок посвящён первой установке XIOT-PLC. Для обновления используйте отдельную инструкцию.

Понадобятся:

компьютер с Windows;
контроллер Wiren Board с доступом в интернет;
имя пользователя и пароль для входа на контроллер по SSH;
учётная запись XIOT-EDITOR, доступ к её почте и проект из урока 2.

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

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

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

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

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

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

Консоль — окно, в котором вы вводите текстовые команды и получаете ответы контроллера. Через неё мы установим XIOT-PLC.

PuTTY — программа для подключения к консоли по протоколу SSH. Она работает на компьютере, а введённые после подключения команды выполняются на контроллере.

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

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

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

Подключите компьютер к сети контроллера.
В интерфейсе роутера откройте список подключённых устройств или клиентов DHCP. Найдите Wiren Board по имени и серийному номеру и запишите его IP-адрес. Адрес также можно узнать у того, кто настраивал контроллер.
Если веб-интерфейс Wiren Board уже открыт, IP-адрес можно посмотреть в разделе «Устройства» → Network. Используйте адрес подключения к сети компьютера.

Подробнее — как узнать IP-адрес Wiren Board.

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

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

Поле	Что указать
Host Name (or IP address)	IP-адрес контроллера, без `http://` и `:5551`.
Port	`22`.
Connection type	`SSH`.

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

Войдите на контроллер

В строке login as: введите root — стандартное имя пользователя Wiren Board — и нажмите Enter. Для установки ниже используется этот пользователь.
Введите текущий пароль пользователя root на контроллере и нажмите Enter. При вводе символы и звёздочки не отображаются, курсор может оставаться на месте — PuTTY всё равно принимает пароль. Пароль можно узнать у того, кто настраивал устройство.
После входа появятся приветствие и строка вида root@имя-контроллера:~#. Теперь можно вводить команды.

Для проверки введите whoami и нажмите Enter. Ответ root подтверждает, что вы вошли под нужным пользователем. Подробнее о входе — в документации Wiren Board.

Как вводить и вставлять команды

Наберите команду и нажмите Enter. Приглашение root@…# и строки ответа копировать не нужно.

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

Дождитесь ответа и возвращения приглашения командной строки. Чтобы скопировать ответ из PuTTY, выделите его мышью. Ctrl+C прерывает команду, поэтому для копирования в PuTTY он не подходит. Подробнее — работа с текстом в PuTTY.

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

В Wiki откройте «Начало работы» → «Первый проект» → «Установка XIOT-PLC на контроллер». Ниже приведён блок для версии v14.15; команды для других версий доступны в этой инструкции.

Скопируйте блок целиком и выполните его в консоли контроллера:

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

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

Блок скачивания, проверки SHA-256 и установки XIOT-PLC в документации — Копирование полного блока команд. Кадр из видео — 00:22.

3. Проверьте установку

Выполните команды по очереди:

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

Ответ install ok installed 14.15 подтверждает установку пакета. Ответ active означает, что служба XIOT-PLC запущена.

Чтобы увидеть подробное состояние службы, выполните:

systemctl status xiot.service --no-pager

В строке Active должно быть active (running).

Консоль с установленным пакетом XIOT-PLC версии 14.15 и ответом active для xiot.service — Пакет установлен, основная служба активна. Кадр из видео — 01:01.

После проверки введите exit и нажмите Enter. SSH-сеанс завершится, контроллер продолжит работать.

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

В браузере откройте http://IP_контроллера:5551, заменив IP_контроллера адресом, который использовали в PuTTY. Число :5551 оставьте после адреса — это порт страницы настройки XIOT-PLC.

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

Страница XIOT контроллер с полем Email и кнопкой «Получить код», адрес скрыт — Вход с той же почтой, что используется в редакторе. Кадр из видео — 01:23.

Шаг подтверждения email с закрытыми адресом и кодом и кнопкой «Подтвердить код» — Подтверждение входа кодом из письма. Кадр из видео — 01:29.

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

На шаге «Выбор проекта» откройте список «Проект» и выберите проект из урока 2. В примере он называется «Новый проект».
Установите флажок «Подтверждаю привязку контроллера к выбранному проекту» и нажмите «Привязать».
Дождитесь сообщения «Привязка завершена». Контроллер связан с выбранным проектом.

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

Сообщение «Привязка завершена» для контроллера XIOT-PLC v14.15 — Страница подтвердила завершение привязки. Кадр из видео — 01:39,3.

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

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

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

XIOT-PLC установлен, контроллер привязан к проекту, редактор видит его. Теперь можно переходить к настройке устройств.

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

PuTTY не соединяется. Проверьте IP-адрес контроллера, подключение компьютера к его сети и порт 22. Если для SSH настроен другой порт, укажите его.
Пароль не подходит. Проверьте имя пользователя, раскладку клавиатуры, Caps Lock и пароль контроллера.
Ошибка установки или служба не запускается. Найдите сообщение об ошибке в консоли и откройте инструкцию установки. С этим сообщением можно обратиться в поддержку XIOT.
Страница :5551 не открывается. Проверьте адрес контроллера и ответ active на команду systemctl is-active xiot.service.
Код не приходит. Проверьте адрес почты и папку «Спам». Если код отклонён, запросите новый кнопкой «Отправить код повторно», когда она станет доступна.
Проекта нет в списке. Откройте XIOT-EDITOR с той же почтой и проверьте, что проект есть в списке.
Нет зелёного индикатора. Проверьте, что в редакторе открыт выбранный при привязке проект, а контроллер подключён к интернету. Дополнительные действия — в инструкции привязки.

Дальше