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

Training-editor-plc-connection: различия между версиями

Материал из XIOT Wiki
← Предыдущая правка

Admin (обсуждение | вклад)

3 группы участника
3638 правок
ВизуальныйВики-текст
Адрес-шаблон IP_контроллера оставлен обычным текстом для подстановки своего IP, без автоматической неработающей ссылки.
Уточнено описание блока установки v14.15: убрано лишнее обещание команд других версий.
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE:Установка XIOT-PLC и привязка контроллера к проекту}}
{{DISPLAYTITLE:Установка XIOT-PLC и привязка контроллера к проекту}}
В третьем уроке установим XIOT-PLC на подготовленный контроллер Wiren Board, свяжем его с уже существующим проектом и проверим зелёный индикатор связи в редакторе. Ниже описан весь путь, включая установку PuTTY на Windows и первый вход в консоль.
В третьем уроке установим XIOT-PLC на контроллер Wiren Board, свяжем его с проектом и проверим зелёный индикатор связи в редакторе. Пройдём весь путь: от установки PuTTY на Windows до подключения контроллера к XIOT-EDITOR.


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


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


Подготовьте:
Понадобятся:


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


== Видеоинструкция ==
== Видеоинструкция ==
Строка 22: Строка 18:


Музыка: «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 с; изменены громкость и частотный баланс, добавлены плавные вход и затухание, приглушение под речь.
Музыка: «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 ==
== 1. Откройте консоль контроллера через PuTTY ==
Строка 29: Строка 23:
=== Что такое консоль ===
=== Что такое консоль ===


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


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


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


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


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


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


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


{| class="wikitable"
{| class="wikitable"
! Поле !! Что указать
! Поле !! Что указать
|-
|-
| Host Name (or IP address) || IP-адрес своего контроллера, без <code>http://</code> и без <code>:5551</code>.
| Host Name (or IP address) || IP-адрес контроллера, без <code>http://</code> и <code>:5551</code>.
|-
|-
| Port || <code>22</code> — стандартный SSH-порт Wiren Board. Если администратор изменил его, используйте сообщённый им порт.
| Port || <code>22</code>.
|-
|-
| Connection type || <code>SSH</code>.
| 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 о проверке ключа].
Нажмите '''Open'''. При первом соединении PuTTY покажет ключ хоста — идентификатор контроллера. Сверьте тип ключа и весь отпечаток '''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.
# В строке <code>login as:</code> введите <code>root</code> — стандартное имя пользователя Wiren Board — и нажмите '''Enter'''. Для установки ниже используется этот пользователь.
# Введите текущий пароль пользователя <code>root</code> на контроллере и нажмите '''Enter'''. При вводе '''символы и звёздочки не отображаются''', курсор может оставаться на месте — PuTTY всё равно принимает пароль. Пароль можно узнать у того, кто настраивал устройство.
# После входа появятся приветствие и строка вида <code>root@имя-контроллера:~#</code>. Теперь можно вводить команды.


=== Как вводить, вставлять команды и завершить сеанс ===
Для проверки введите <code>whoami</code> и нажмите Enter. Ответ <code>root</code> подтверждает, что вы вошли под нужным пользователем. Подробнее о входе — [https://wiki.wirenboard.com/wiki/SSH в документации Wiren Board].


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


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


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


Когда установка и проверки завершены, введите <code>exit</code> и нажмите Enter. Это завершает SSH-сеанс, а не выключает контроллер. Не закрывайте окно во время установки пакета. Если связь оборвалась, сначала подключитесь снова и проверьте пакет и службу командами ниже, чтобы установить фактический результат.
Дождитесь ответа и возвращения приглашения командной строки. Чтобы скопировать ответ из PuTTY, выделите его мышью. '''Ctrl+C''' прерывает команду, поэтому для копирования в PuTTY он не подходит. Подробнее — [https://the.earth.li/~sgtatham/putty/latest/htmldoc/Chapter3.html#using-selection работа с текстом в PuTTY].


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


В Wiki откройте [[Getting-started|«Начало работы»]] → раздел «Первый проект» → [[Xiot-plc-installation|«Установка XIOT-PLC на контроллер»]]. В ролике используется пакет v14.15. Для другой версии берите совместимые пакет, ссылку и контрольную сумму из актуальной инструкции вместе, не смешивая выпуски.
В Wiki откройте [[Getting-started|«Начало работы»]] → «Первый проект» → [[Xiot-plc-installation|«Установка XIOT-PLC на контроллер»]]. Ниже приведён блок установки 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">
<syntaxhighlight lang="bash">
Строка 108: Строка 87:
</syntaxhighlight>
</syntaxhighlight>


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


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


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


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


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Строка 121: Строка 100:
</syntaxhighlight>
</syntaxhighlight>


Для показанной версии ожидаются ответы <code>install ok installed 14.15</code> и <code>active</code>. Дополнительно проверьте подробное состояние:
Ответ <code>install ok installed 14.15</code> подтверждает установку пакета. Ответ <code>active</code> означает, что служба XIOT-PLC запущена.
 
Чтобы увидеть подробное состояние службы, выполните:


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Строка 127: Строка 108:
</syntaxhighlight>
</syntaxhighlight>


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


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


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


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


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


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


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


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


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


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


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


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


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


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


== Дальше ==
== Дальше ==

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

В третьем уроке установим 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

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

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

  1. Подключите компьютер к сети контроллера.
  2. В интерфейсе роутера откройте список подключённых устройств или клиентов DHCP. Найдите Wiren Board по имени и серийному номеру и запишите его IP-адрес. Адрес также можно узнать у того, кто настраивал контроллер.
  3. Если веб-интерфейс 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.

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

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

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

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

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

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

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

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

В Wiki откройте «Начало работы» → «Первый проект» → «Установка XIOT-PLC на контроллер». Ниже приведён блок установки 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.

  1. Откроется страница «XIOT контроллер» с шагом «Вход по email».
  2. Введите ту же почту, под которой входите в XIOT-EDITOR, и нажмите «Получить код».
  3. Откройте письмо, введите шестизначный код в поле «Код» и нажмите «Подтвердить код».
  4. Если появится шаг двухфакторной проверки, введите код из приложения аутентификации и нажмите «Подтвердить вход».
Страница XIOT контроллер с полем Email и кнопкой «Получить код», адрес скрыт
Вход с той же почтой, что используется в редакторе. Кадр из видео — 01:23.
Шаг подтверждения email с закрытыми адресом и кодом и кнопкой «Подтвердить код»
Подтверждение входа кодом из письма. Кадр из видео — 01:29.

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

  1. На шаге «Выбор проекта» откройте список «Проект» и выберите проект из урока 2. В примере он называется «Новый проект».
  2. Установите флажок «Подтверждаю привязку контроллера к выбранному проекту» и нажмите «Привязать».
  3. Дождитесь сообщения «Привязка завершена». Контроллер связан с выбранным проектом.
Выбор проекта «Новый проект», флажок подтверждения и кнопка «Привязать»
Проверьте существующий проект перед установкой флажка и привязкой. Кадр из видео — 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 с той же почтой и проверьте, что проект есть в списке.
  • Нет зелёного индикатора. Проверьте, что в редакторе открыт выбранный при привязке проект, а контроллер подключён к интернету. Дополнительные действия — в инструкции привязки.

Дальше

Источник — https://wiki.xiot.ru/index.php?title=Training-editor-plc-connection&oldid=6042