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> запускается. Привязка к проекту выполняется отдельно на следующем шаге.
-<b>Внимание!</b> Перед установкой XIOT-PLC на контроллер необходимо подключить устройство к интернету. Доступ в интернет должен сохраняться на всём протяжении установки XIOT-PLC на WirenBoard.<br><br>
+'''Проверено: 22 августа 2026 года.''' Проверены текущий пакет по официальной прямой ссылке и команда его установки. Сквозной аппаратный тест на каждой поддерживаемой модели этой проверкой не заявляется.
-) Скачайте и установите программу Putty с сайта: https://putty.org.ru/download<br>
+== Поддерживаемые платформы и архитектуры ==
-[[File:Xiot 42.png|405x405px]]<br>
-) Скачайте программу Advanced IP Scanner: https://www.advanced-ip-scanner.com/ru/<br>
+Официально поддерживаются:
-) Подключите контроллер WirenBoard к локальной сети через Ethernet-кабель.<br>
+* '''Wiren Board 6, 7, 8 и 9''';
+* '''JetHome''';
+* '''Raspberry Pi''', '''Orange Pi''' и '''NanoPi''';
+* '''x86-ПК''', включая '''Intel NUC''';
+* '''VDS/VPS''' с Debian-совместимой Linux-системой.
-) Просканируйте сеть с помощью Advanced IP Scanner и найдите IP-адрес вашего контроллера. В примере ниже контроллер найден с адресом 192.168.31.106:<br>
+Поддерживаемые архитектуры: <code>armhf</code>, <code>arm64</code> и <code>amd64</code>. Минимальные версии Debian и Python здесь не фиксируются; перед монтажом сверьте окружение с актуальной документацией выбранной платформы.
-[[File:Xiot_43.png|635x635px]]<br>
-) Подключитесь к контроллеру через Putty. Введите IP-адрес контроллера в формате <b>root@192.168.31.92</b> и нажмите кнопку <b>Open</b>.<br>
+== Текущая архитектура проекта ==
-[[File:Xiot 44.png|408x408px]]<br>
-) В появившемся окне введите пароль <b>wirenboard</b>. При вводе символы не отображаются — это нормально.<br>
+* К одному проекту XIOT сейчас привязывается '''один XIOT-PLC''' (<code>plc1</code>).
-[[File:Xiot 45.png|406x406px]]<br>
+* Один XIOT-PLC может использовать до '''шести''' отдельных MQTT-подключений Wiren Board. Это не шесть XIOT-PLC, а шесть подключений к оборудованию Wiren Board.
+* Поддержка нескольких XIOT-PLC в одном проекте, в том числе для гостиничных объектов, планируется, но в текущей версии ещё не доступна.
-) После ввода пароля нажмите <b>Enter</b>. Если пароль введён верно, вы получите доступ к консоли контроллера.<br>
+== Питание контроллера ==
-[[File:Xiot_46.png|545x545px]]<br>
-<h2>Часть 2. Установка XIOT-PLC на контроллер WirenBoard</h2>
+Схему питания, диапазон напряжения и точки подключения выбирают по документации конкретной модели и ревизии. В проектах XIOT контроллеры обычно не питаются по PoE: PoE используется для сенсорных панелей. Для контроллера обычно применяется ИБП (UPS) '''Tantos 5 А''' с аккумулятором (АКБ) '''12 В, 7 А·ч'''. Окончательную схему должен проверить специалист, отвечающий за электропитание объекта.
-<b>Важно!</b> Если в системе используется от 2 до 5 контроллеров, ПО "Сервер XIOT-PLC" устанавливается только на один из них — именно он будет управлять всей системой.<br><br>
+----
+== 🎥 Видеобзор ==
+➡️ ''[https://dzen.ru/video/watch/69f7d42078b10057d443de9c Установка XIOT-PLC на контроллер: пошаговая инструкция]''
-) После входа в систему вставьте в консоль следующую команду и нажмите Enter:<br>
+== Перед началом работы ==
-<b>wget https://xiot.pro/system/public/xiot.deb -O xiot.deb && dpkg -i xiot.deb</b><br>
-) Дождитесь завершения установки.<br>
+* Обеспечьте стабильное питание, доверенную локальную сеть и доступ устройства-хоста к интернету.
-[[File:Xiot 47.png|602x602px]]<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|608x608px]]<br>
-) Для проверки статуса работы сервиса выполните команду:<br>
+== Установка ==
-<b>service xiot status</b><br>
-[[File:Xiot 49.png|607x607px]]<br>
-Установка завершена!<br><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 (обсуждение | вклад)