Xiot-plc-installation

Инструкция предназначена для интегратора, который имеет административный 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 не изменяется, поэтому отдельное сохранение проекта не требуется.

Установка

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

   

   Ожидаемый результат: устройство отображается в локальной сети и отвечает по своему IP-адресу.

2. Откройте PuTTY. В поле Host Name введите IP-адрес устройства, выберите SSH и нажмите Open. При первом подключении сверьте отпечаток SSH-ключа с данными вашего устройства по доверенному каналу.

   

3. Если заводские реквизиты Wiren Board ещё не изменены, для первого входа используйте имя пользователя root и начальный пароль wirenboard. Проверьте их по документации своей модели и смените заводской пароль после первого входа.

   

   Ожидаемый результат: открыта командная оболочка устройства-хоста.

   

4. Выполните команду в оболочке пользователя root:

   wget https://xiot.pro/system/public/xiot.deb -O xiot.deb && dpkg -i xiot.deb

   Оператор && не запускает установку, если скачивание завершилось ошибкой. Если вы вошли не как root, после успешного скачивания выполните sudo dpkg -i xiot.deb. Не отключайте проверку TLS-сертификата.

   

   

   Ожидаемый результат: команда dpkg завершается без сообщения об ошибке установки.

5. Проверьте службу 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, Обновление редактора и контроллера.