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. Передача проекта владельцу

При создании проекта интегратор получает роли Владелец и Интегратор. После завершения работ:

1. сохраните актуальную версию проекта и дождитесь статуса В облаке;
2. подготовьте данные нового владельца;
3. выполните передачу по административной процедуре после подтверждения сторон.

Подробный порядок: Передача проекта новому владельцу. Если требуется назначить другого интегратора, см. Как сменить интегратора в XIOT.

👥Роли в системе XIOT (кратко)

• Интегратор — настраивает проект и интерфейс, устанавливает XIOT-PLC на поддерживаемое устройство-хост, привязывает его к проекту и передаёт проект владельцу.
• Владелец — управляет пользователями, может отключить Интегратора или передать проект.
• Пользователь — работает только с интерфейсом, не имеет доступа к настройкам.
• Разработчик — сотрудник XIOT, развивает платформу, не участвует в пользовательских проектах.

Подробно про роли пользователей в XIOT