Xiot-plc-installation: различия между версиями

Текущая версия от 22:26, 2 октября 2026

Инструкция предназначена для интегратора, который имеет административный SSH-доступ к поддерживаемому устройству-хосту. Результат: пакет XIOT-PLC установлен, а служба xiot.service запускается. Привязка к проекту выполняется отдельно на следующем шаге.

Проверено: 22 августа 2026 года. Проверены текущий пакет по официальной прямой ссылке и команда его установки. Сквозной аппаратный тест на каждой поддерживаемой модели этой проверкой не заявляется.

Поддерживаемые платформы и архитектуры

Официально поддерживаются:

Wiren Board 6, 7, 8 и 9;
JetHome;
Raspberry Pi, Orange Pi и NanoPi;
x86-ПК, включая Intel NUC;
VDS/VPS с Debian-совместимой Linux-системой.

Поддерживаемые архитектуры: armhf, arm64 и amd64. Минимальные версии Debian и Python здесь не фиксируются; перед монтажом сверьте окружение с актуальной документацией выбранной платформы.

Текущая архитектура проекта

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

Питание контроллера

Схему питания, диапазон напряжения и точки подключения выбирают по документации конкретной модели и ревизии. В проектах XIOT контроллеры обычно не питаются по PoE: PoE используется для сенсорных панелей. Для контроллера обычно применяется ИБП (UPS) Tantos 5 А с аккумулятором (АКБ) 12 В, 7 А·ч. Окончательную схему должен проверить специалист, отвечающий за электропитание объекта.

🎥 Видеобзор

➡️ Установка XIOT-PLC на контроллер: пошаговая инструкция

Перед началом работы

Обеспечьте стабильное питание, доверенную локальную сеть и доступ устройства-хоста к интернету.
Проверьте, что на устройстве установлена Debian-совместимая Linux-система с systemd, а в /opt свободно не менее 100 МБ.
Подготовьте административный SSH-доступ и штатные реквизиты выбранной платформы.
Для Wiren Board установите PuTTY или другой SSH-клиент. IP-адрес можно определить в роутере либо сетевым сканером.
На этом этапе проект в XIOT-EDITOR не изменяется, поэтому отдельное сохранение проекта не требуется.

Установка

Подключите устройство-хост к доверенной локальной сети и определите его IP-адрес. В примере на скриншоте используется 192.168.31.106; у вашего устройства адрес будет другим.

Ожидаемый результат: устройство отображается в локальной сети и отвечает по своему IP-адресу.
Откройте PuTTY. В поле Host Name введите IP-адрес устройства, выберите SSH и нажмите Open. При первом подключении сверьте отпечаток SSH-ключа с данными вашего устройства по доверенному каналу.
Если заводские реквизиты Wiren Board ещё не изменены, для первого входа используйте имя пользователя root и начальный пароль wirenboard. Проверьте их по документации своей модели и смените заводской пароль после первого входа.

Ожидаемый результат: открыта командная оболочка устройства-хоста.
Выполните команду в оболочке пользователя root:
```
wget https://xiot.pro/system/public/xiot.deb -O xiot.deb && dpkg -i xiot.deb
```
Оператор && не запускает установку, если скачивание завершилось ошибкой. Если вы вошли не как root, после успешного скачивания выполните sudo dpkg -i xiot.deb. Не отключайте проверку TLS-сертификата.

Ожидаемый результат: команда dpkg завершается без сообщения об ошибке установки.
Проверьте службу XIOT-PLC:
```
systemctl status xiot.service
```
Ожидаемый результат: служба имеет состояние active (running).

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

Повторно выполните systemctl status xiot.service и убедитесь, что служба остаётся в состоянии active (running). Эта проверка подтверждает запуск XIOT-PLC, но не заменяет последующую привязку к проекту и проверку физических устройств.

Если установка не завершилась

Если wget сообщил об ошибке, не устанавливайте ранее оставшийся файл xiot.deb. Проверьте сеть, дату устройства и TLS-сертификаты, затем повторите скачивание.
Если dpkg завершился с ошибкой, сохраните полный текст сообщения. Не выполняйте универсальные apt upgrade, удаление системных пакетов или ручное редактирование /opt/xiot как способ исправления.
Если служба не запустилась, соберите безопасную диагностику командами systemctl status xiot.service и journalctl -u xiot.service -n 100 --no-pager. До выяснения причины не привязывайте устройство к проекту.
Если обновлялась уже работающая установка, не удаляйте её данные вручную. Используйте сохранённую версию проекта и передайте диагностические сообщения в техническую поддержку.

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

Перейдите к статье «Связываем XIOT-PLC с редактором XIOT». Локальный интерфейс на порту 5551 используйте только из доверенной локальной сети и не публикуйте этот порт в интернет.

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

@@ Строка 1: / Строка 1: @@
-<h2>Часть 1. Подключение к контроллеру WirenBoard по локальной сети.</h2>
+{{DISPLAYTITLE:Установка XIOT-PLC на контроллер}}
+Инструкция предназначена для '''интегратора''', который имеет административный SSH-доступ к поддерживаемому устройству-хосту. Результат: пакет XIOT-PLC установлен, а служба <code>xiot.service</code> запускается. Привязка к проекту выполняется отдельно на следующем шаге.
-Внимание! Перед началом установки XIOT-PLC на контроллер, необходимо подключиться к сети интернет, сеть интернет должна быть доступна на протяжении всего процесса установки XIOT-PLC на контроллер Wirenboard.</br>
+'''Проверено: 22 августа 2026 года.''' Проверены текущий пакет по официальной прямой ссылке и команда его установки. Сквозной аппаратный тест на каждой поддерживаемой модели этой проверкой не заявляется.
-) Скачиваем и устанавливаем на ПК программу Putty на компьютер по ссылке https://putty.org.ru/download</br>
+== Поддерживаемые платформы и архитектуры ==
-[[File:Xiot 42.png|600px]]</br>
-) Скачиваем на ПК программу Advanced IP Scanner по ссылке https://www.advanced-ip-scanner.com/ru/</br>
+Официально поддерживаются:
-) Подключаем контроллер к локальной сети по кабелю Ethernet</br>
+* '''Wiren Board 6, 7, 8 и 9''';
+* '''JetHome''';
+* '''Raspberry Pi''', '''Orange Pi''' и '''NanoPi''';
+* '''x86-ПК''', включая '''Intel NUC''';
+* '''VDS/VPS''' с Debian-совместимой Linux-системой.
-) Сканируем сеть с помощью Advanced IP Scanner и находим свой контроллер. В примере на скриншоте контроллер определился с адресом 192.168.31.106</br>
+Поддерживаемые архитектуры: <code>armhf</code>, <code>arm64</code> и <code>amd64</code>. Минимальные версии Debian и Python здесь не фиксируются; перед монтажом сверьте окружение с актуальной документацией выбранной платформы.
-[[File:Xiot_43.png|800px]]</br>
-) Подключаемся к контроллеру через программу Putty, для этого Вводим ip адрес контроллера с указанием пользователя <b>root@192.168.31.92</b> и нажимаем кнопку <b>Open</b></br>
+== Текущая архитектура проекта ==
-[[File:Xiot 44.png|800px]]</br>
-) В открывшемся окне вводим пароль <b>wirenboard</b>, при вводе в консоль пароль не отображается, так и должно быть.</br>
+* К одному проекту XIOT сейчас привязывается '''один XIOT-PLC''' (<code>plc1</code>).
-[[File:Xiot 45.png|600px]]</br>
+* Один XIOT-PLC может использовать до '''шести''' отдельных MQTT-подключений Wiren Board. Это не шесть XIOT-PLC, а шесть подключений к оборудованию Wiren Board.
+* Поддержка нескольких XIOT-PLC в одном проекте, в том числе для гостиничных объектов, планируется, но в текущей версии ещё не доступна.
-) После того, как вы ввели, нажимаем <b>enter</b> на клавиатуре. Если вы верно ввели пароль, вы подключитесь к контроллеру.</br>
+== Питание контроллера ==
-[[File:Xiot_46.png|800px]]</br>
-<h2>Часть 2. Установка ПО "XIOT-PLC" на контроллер WirenBoard.</h2>
+Схему питания, диапазон напряжения и точки подключения выбирают по документации конкретной модели и ревизии. В проектах XIOT контроллеры обычно не питаются по PoE: PoE используется для сенсорных панелей. Для контроллера обычно применяется ИБП (UPS) '''Tantos 5 А''' с аккумулятором (АКБ) '''12 В, 7 А·ч'''. Окончательную схему должен проверить специалист, отвечающий за электропитание объекта.
-Важно! Если в системе от 2 до 5 контроллеров WirenBoard, то ПО "Сервер XIOT-PLC" устанавливается только на 1 контроллер для управления всей системой.</br>
+----
+== 🎥 Видеобзор ==
+➡️ ''[https://dzen.ru/video/watch/69f7d42078b10057d443de9c Установка XIOT-PLC на контроллер: пошаговая инструкция]''
-) После того, как вы вошли на контроллер, копируем и вставляем в Putty команду:</br>
+== Перед началом работы ==
-<b>wget https://xiot.pro/system/public/xiot.deb -O xiot.deb && dpkg -i xiot.deb</b></br>
-) После того, как вы вставили команду, нажимаем Enter на клавиатуре.</br>
+* Обеспечьте стабильное питание, доверенную локальную сеть и доступ устройства-хоста к интернету.
-[[File:Xiot_47.png|800px]]</br>
+* Проверьте, что на устройстве установлена Debian-совместимая Linux-система с <code>systemd</code>, а в <code>/opt</code> свободно не менее 100 МБ.
+* Подготовьте административный SSH-доступ и штатные реквизиты выбранной платформы.
+* Для Wiren Board установите [https://www.putty.org/ PuTTY] или другой SSH-клиент. IP-адрес можно определить в роутере либо сетевым сканером.
+* На этом этапе проект в XIOT-EDITOR не изменяется, поэтому отдельное сохранение проекта не требуется.
-) Ждем окончания установки программы. Установка программы занимает примерно 2 минуты. Вы увидите на экране информационные сообщения от программы.</br>
+[[File:Xiot 42.png|405x405px]]
-[[File:Xiot_48.png|800px]]</br>
-) Статус работы программы Сервера XIOT-PLC на контроллере можно проверить через Putty командой <b>service xiot status</b></br>
+== Установка ==
-[[File:Xiot_49.png|800px]]</br>
-Установка программы Сервера XIOT-PLC на контроллер WirenBoard завершена!</br>
+# Подключите устройство-хост к доверенной локальной сети и определите его IP-адрес. В примере на скриншоте используется <code>192.168.31.106</code>; у вашего устройства адрес будет другим.
+#: [[File:Xiot_43.png|635x635px]]
+#: '''Ожидаемый результат:''' устройство отображается в локальной сети и отвечает по своему IP-адресу.
+# Откройте PuTTY. В поле '''Host Name''' введите IP-адрес устройства, выберите '''SSH''' и нажмите '''Open'''. При первом подключении сверьте отпечаток SSH-ключа с данными вашего устройства по доверенному каналу.
+#: [[File:Xiot 44.png|408x408px]]
+# Если заводские реквизиты Wiren Board ещё не изменены, для первого входа используйте имя пользователя <code>root</code> и начальный пароль <code>wirenboard</code>. Проверьте их по документации своей модели и смените заводской пароль после первого входа.
+#: [[File:Xiot 45.png|406x406px]]
+#: '''Ожидаемый результат:''' открыта командная оболочка устройства-хоста.
+#: [[File:Xiot_46.png|545x545px]]
+# Выполните команду в оболочке пользователя <code>root</code>:
+#: <pre>wget https://xiot.pro/system/public/xiot.deb -O xiot.deb && dpkg -i xiot.deb</pre>
+#: Оператор <code>&amp;&amp;</code> не запускает установку, если скачивание завершилось ошибкой. Если вы вошли не как <code>root</code>, после успешного скачивания выполните <code>sudo dpkg -i xiot.deb</code>. Не отключайте проверку TLS-сертификата.
+#: [[File:Xiot 47.png|602x602px]]
+#: [[File:Xiot 48.png|608x608px]]
+#: '''Ожидаемый результат:''' команда <code>dpkg</code> завершается без сообщения об ошибке установки.
+# Проверьте службу XIOT-PLC:
+#: <pre>systemctl status xiot.service</pre>
+#: [[File:Xiot 49.png|607x607px]]
+#: '''Ожидаемый результат:''' служба имеет состояние <code>active (running)</code>.
-Следующий шаг - это подключение ПО "Сервера XIOT-PLC" к редактору XIOT [[Связываем XIOT-PLC с редактором XIOT]].
+== Проверка результата ==
+Повторно выполните <code>systemctl status xiot.service</code> и убедитесь, что служба остаётся в состоянии <code>active (running)</code>. Эта проверка подтверждает запуск XIOT-PLC, но не заменяет последующую привязку к проекту и проверку физических устройств.
+== Если установка не завершилась ==
+* Если <code>wget</code> сообщил об ошибке, не устанавливайте ранее оставшийся файл <code>xiot.deb</code>. Проверьте сеть, дату устройства и TLS-сертификаты, затем повторите скачивание.
+* Если <code>dpkg</code> завершился с ошибкой, сохраните полный текст сообщения. Не выполняйте универсальные <code>apt upgrade</code>, удаление системных пакетов или ручное редактирование <code>/opt/xiot</code> как способ исправления.
+* Если служба не запустилась, соберите безопасную диагностику командами <code>systemctl status xiot.service</code> и <code>journalctl -u xiot.service -n 100 --no-pager</code>. До выяснения причины не привязывайте устройство к проекту.
+* Если обновлялась уже работающая установка, не удаляйте её данные вручную. Используйте сохранённую версию проекта и передайте диагностические сообщения в техническую поддержку.
+== Следующий шаг ==
+Перейдите к статье [[Connect-xiot-plc-to-editor|«Связываем XIOT-PLC с редактором XIOT»]]. Локальный интерфейс на порту <code>5551</code> используйте только из доверенной локальной сети и не публикуйте этот порт в интернет.
+Связанные статьи: [[Wiren-board-connection|полный маршрут Wiren Board]], [[Wiren-board-basic-setup|Базовая настройка Wiren Board]], [[Wiren-board-8-first-start|Первое включение контроллера Wiren Board 8]], [[Wiren-board-driver-setup|Настройка драйвера Wiren Board в XIOT]], [[Editor-and-controller-updates|Обновление редактора и контроллера]].

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