Getting-started-for-integrators
Краткая пошаговая инструкция для Интегратора
📝 1. Регистрация и создание проекта
- Перейдите на сайт https://xiot.pro и зарегистрируйтесь, указав email интегратора и пароль.
- Рассчитайте состав в калькуляторе лицензии ПО XIOT и приобретите лицензию для проекта.
- После покупки получите лицензионный ключ на email интегратора.
- Войдите в XIOT-EDITOR под этой учётной записью и активируйте ключ. При активации будет создан новый проект.
- Учётная запись интегратора получит в проекте роли Владелец и Интегратор.
Для каждого следующего проекта требуется отдельная лицензия и новый лицензионный ключ.
Подробно про регистрацию в редакторе Получение и активация лицензионного ключа
🛠️2. Работа в редакторе XIOT
- Редактор работает в браузере и не требует установки. Откройте https://xiot.pro на компьютере или ноутбуке; актуальный список поддерживаемых браузеров приведён в статье Доступ к XIOT-EDITOR.
- Клавиша F2 переключает просмотр и редактирование, а не режимы Lite и Pro. На некоторых ноутбуках используйте Fn + F2.
- Lite и Pro — два режима одного XIOT-EDITOR и одного проекта. Переключение выполняется кнопкой LITE / PRO и не создаёт второй проект.
Подробнее о режимах: Lite и Pro версии редактора. Основные действия и точные термины: Основные термины и сокращения.
⚡ Lite (основной режим)
- Интерфейс создаётся автоматически по структуре: этажи, комнаты, устройства.
- Используется как стандартный пользовательский интерфейс проекта.
⚙️ Pro (дополнительный режим)
- Позволяет вручную создавать дополнительные страницы, окна и элементы интерфейса.
- Используется вместе с Lite для технических и специализированных страниц.
3. Установка XIOT-PLC на устройство-хост и привязка к проекту
📦 Установка XIOT-PLC на поддерживаемое устройство-хост или контроллер
Поддерживаются Wiren Board 6/7/8/9, JetHome, Raspberry Pi, Orange Pi, NanoPi, x86-ПК/Intel NUC и VDS/VPS на архитектурах armhf, arm64 и amd64. Требуется Debian-совместимая Linux-система.
1. Подключитесь по SSH к устройству-хосту (например, через программу PuTTY).
2. Установите пакет XIOT-PLC командой:
wget https://xiot.pro/system/public/xiot.deb -O xiot.deb && dpkg -i xiot.deb
Не отключайте проверку TLS-сертификата при скачивании.
3. Из доверенной локальной сети откройте в браузере http://<IP_устройства>:5551. Не публикуйте этот порт в интернет.
4. Введите те же email и пароль, с которыми вы входите в текущий XIOT-EDITOR.
5. Выберите проект из списка и привяжите установленный XIOT-PLC к этому проекту.
В текущей версии к одному проекту привязывается один XIOT-PLC. Он может использовать до шести MQTT-подключений Wiren Board. Несколько XIOT-PLC в одном проекте, в том числе для гостиничных объектов, находятся в планах и пока не описываются как доступная функция.
Установка XIOT-PLC на устройство-хост или контроллер
Привязка XIOT-PLC к проекту
4. Настройка структуры проекта
🏗️ Настройка проекта
1. Создайте этажи, комнаты и виртуальные устройства (освещение, розетки, датчики и т.д.).
2. В разделе Драйверы настройте драйвер XIOT для связи с оборудованием, например Wiren Board или KNX. Драйвер XIOT — интеграционный модуль XIOT-PLC, а не системная служба производителя оборудования.
3. Назначьте характеристикам виртуальных устройств адреса управления и состояния, которые предоставляет драйвер XIOT.
4. Вся настройка осуществляется через визуальный интерфейс, без необходимости знания системных переменных.
5. Добавление сценариев
⏱️
- Используйте готовые сценарии из библиотеки:
- биодинамическое освещение;
- имитация рассвета и заката;
- рабочий ритм;
- отключение света;
- управление поливом и др.
- Либо создайте кастомный сценарий визуально, без программирования.
- Сценарии можно запускать:
- по времени;
- по изменению статусов;
- по действиям пользователя;
- по логическим условиям.
Чтобы применить проверенную конфигурацию, нажмите Загрузить конфигурацию на контроллер. Команда сама сохранит проект, создаст одну новую версию и передаст на привязанный XIOT-PLC точный снимок этой версии. Отдельное сохранение полезно как самостоятельная контрольная точка, особенно во время вёрстки в Pro, но не выполняйте его непосредственно перед загрузкой без специальной причины.
🔁6. Передача проекта владельцу
При создании проекта интегратор получает роли Владелец и Интегратор. После завершения работ:
- сохраните актуальную версию проекта и дождитесь статуса В облаке;
- подготовьте данные нового владельца;
- выполните передачу по административной процедуре после подтверждения сторон.
Подробный порядок: Передача проекта новому владельцу. Если требуется назначить другого интегратора, см. Как сменить интегратора в XIOT.
👥Роли в системе XIOT (кратко)
- Интегратор — настраивает проект и интерфейс, устанавливает XIOT-PLC на поддерживаемое устройство-хост, привязывает его к проекту и передаёт проект владельцу.
- Владелец — управляет пользователями, может отключить Интегратора или передать проект.
- Пользователь — работает только с интерфейсом, не имеет доступа к настройкам.
- Разработчик — сотрудник XIOT, развивает платформу, не участвует в пользовательских проектах.