Установка XIOT-PLC на контроллер

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

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

До установки проверьте номер редактора в открытом проекте: проект может быть закреплён за прежней версией. Для PLC v14.15 нужна совместимая линия XIOT-EDITOR v14.15, например v14.15-1. Если версия проекта другая, сначала изучите порядок перехода и проверки совместимости. Открытие editor.xiot.pro само по себе не переключает закреплённую версию проекта.

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

Для ручного скачивания используется публичное зеркало xiot.pro. Здесь размещён тот же пакет v14.15, что и в новом облаке: его контрольная сумма приведена в команде установки ниже. Домен зеркала не означает, что скачивается прежняя версия PLC.

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

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

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.15.deb https://xiot.pro/system/plcversions/v14.15/xiot.deb &&
printf '%s\n' 'c3b67332176759b590f966a494130331afc9cf0b0192d8760f1175abe68a21ee  xiot-14.15.deb' | sha256sum -c - &&
dpkg -i xiot-14.15.deb

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

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

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

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

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

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

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

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

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