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

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