Xiot-plc-installation

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

Стабильная версия на 14 октября 2026 года — XIOT-PLC v14.19. Работайте с проектом в актуальном XIOT-EDITOR. Установка пакета XIOT-PLC не обновляет операционную систему устройства и не активирует лицензию проекта.

До установки проверьте номер редактора в открытом проекте и изучите порядок перехода и проверки совместимости. Проект может быть закреплён за определённой версией; открытие editor.xiot.pro само по себе её не переключает.

Скачать XIOT-PLC v14.19 (.deb)

В v14.19 исправлен вход по коду из письма при небольшом отставании часов контроллера. Синхронизация времени по NTP по-прежнему необходима.

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

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

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

Поддерживаемые архитектуры: armhf, arm64 и amd64. Для конкретной модели и ревизии отдельно проверьте совместимость версии ОС, Python и используемых драйверов. Этот список не означает, что любая прошивка перечисленных устройств подходит без проверки. Универсальные минимальные версии 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 А·ч. Окончательную схему должен проверить специалист, отвечающий за электропитание объекта.

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

• Обеспечьте стабильное питание, доверенную сеть и доступ устройства к интернету. Дата и время должны быть правильными для проверки HTTPS-сертификатов.
• На устройстве должна быть совместимая Debian-подобная Linux-система с systemd и Python 3. Для команды ниже нужны wget, sha256sum и dpkg.
• Установщик проверяет наличие не менее 100 МБ свободного места в /opt. Дополнительно нужен запас для файла пакета, данных проекта и резервной копии; 100 МБ — не рекомендация по общему объёму накопителя.
• Подготовьте административный SSH-доступ. Используйте реквизиты и способ получения прав root, предусмотренные документацией вашей модели. Если пароль заводской, смените его.
• Подключиться можно встроенным SSH-клиентом macOS/Linux, PuTTY или другим доверенным SSH-клиентом. IP-адрес устройства можно узнать в роутере.

Если это обновление работающего объекта

Во время обновления служба XIOT-PLC останавливается и запускается заново. Связь и управление могут временно прерваться. Выберите безопасное окно обслуживания и согласуйте его с ответственным за объект.

До установки сохраните проект, зафиксируйте текущие версии и подготовьте резервную копию контроллера штатным способом выбранной платформы. Убедитесь, что знаете порядок восстановления. Сохранение проекта не заменяет резервную копию ОС, драйверов и локальных данных контроллера. Копии с данными доступа храните закрыто.

Не отвязывайте контроллер, не удаляйте его настройки и не загружайте другую конфигурацию как обязательную часть обновления. Для обновления уже привязанного устройства повторный вход на странице привязки не требуется.

Установка

1. Подключитесь к устройству

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

Войдите под административной учётной записью. Если она не root, получите права root штатным способом вашей платформы. Следующий блок выполняется целиком в оболочке root на контроллере, а не на компьютере интегратора.

2. Скачайте, проверьте и установите пакет

cd /root &&
wget -O xiot-14.19.deb https://xiot.pro/system/plcversions/v14.19/xiot.deb &&
printf '%s\n' '2f9f1842bf53a87d19b30a90b05815caef1810a09cb79e3d359bb26b2094498d  xiot-14.19.deb' | sha256sum -c - &&
dpkg -i xiot-14.19.deb

Блок скачивает именно v14.19, проверяет SHA-256 и только затем устанавливает пакет. Операторы && не позволяют перейти к установке при ошибке скачивания или проверки. Не отключайте проверку TLS-сертификата и не заменяйте контрольную сумму произвольным значением.

Ожидаемый результат: проверка контрольной суммы успешна, а dpkg завершает установку без ошибки. Само сообщение установщика о запуске службы ещё не подтверждает её работоспособность — выполните следующие проверки.

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

Проверьте установленный пакет:

dpkg-query -W -f='${Status} ${Version}\n' xiot

Ожидаемый ответ: install ok installed 14.19.

Проверьте основную службу:

systemctl status xiot.service --no-pager

Ожидаемое состояние — active (running). Повторите проверку и убедитесь, что служба не завершается и не запускается по кругу. Плановая перезагрузка всей ОС в эти шаги не входит.

После обновления работающего объекта дождитесь восстановления связи в редакторе, сверьте выбранный проект и версию PLC, проверьте основные устройства и сценарии. Успешный запуск службы не заменяет эту проверку. После первой установки нового контроллера переходите к привязке ниже.

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

• При ошибке скачивания или несовпадении SHA-256 не устанавливайте файл. Проверьте сеть, дату устройства и TLS-сертификаты. Не используйте ранее оставшийся пакет без проверки.
• Если dpkg завершился с ошибкой, сохраните её текст. Не выполняйте универсальное apt upgrade, удаление системных пакетов или очистку данных XIOT как способ исправления.
• Если служба не запустилась либо постоянно перезапускается, соберите диагностику командами ниже. До выяснения причины не выполняйте новую привязку и не загружайте конфигурацию.

systemctl status xiot.service --no-pager
journalctl -u xiot.service -n 100 --no-pager

Перед передачей диагностики проверьте, что в ней нет паролей, кодов и токенов. Если обновлялся работающий объект, сохраните его данные и обратитесь в техническую поддержку; не отвязывайте контроллер и не повторяйте установку вслепую.

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

Новый, ещё не привязанный контроллер: перейдите к статье «Связываем XIOT-PLC с редактором XIOT». Страница настройки на порту 5551 должна быть доступна только из доверенной сети или через ограниченный защищённый канал, не из открытого интернета.

Обновлённый контроллер с действующей привязкой: продолжайте работать с прежним проектом после проверки результата. Установка новой версии сама по себе не требует повторной привязки или повторной активации лицензии.

Ранний видеобзор

Установка XIOT-PLC на контроллер — видеобзор прежнего интерфейса. Для установки v14.19 используйте актуальные команды и порядок проверки из этой статьи, а не показанные в ранней записи.

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