Getting-started-for-integrators

Этот чек-лист ведёт интегратора от регистрации до проверки готового проекта и его передачи владельцу. Выполняйте шаги по порядку: каждый шаг заканчивается проверяемым результатом.

1. Зарегистрируйтесь в XIOT-EDITOR

1. Откройте xiot.pro в актуальной версии Google Chrome или Safari на компьютере или ноутбуке.
2. Зарегистрируйте учётную запись по email и паролю.

Результат: вы входите в XIOT-EDITOR под учётной записью интегратора. Подробнее: Регистрация в редакторе, Доступ к XIOT-EDITOR. Далее: получите лицензионный ключ и создайте проект.

2. Получите лицензию и создайте проект

1. Рассчитайте состав в калькуляторе лицензии XIOT и приобретите лицензию.
2. Получите ключ на email, войдите в XIOT-EDITOR и активируйте ключ. Для каждого следующего проекта нужны отдельная лицензия и новый ключ.

Результат: в XIOT-EDITOR создан новый проект; интегратор получил в нём роли Владелец и Интегратор. Подробнее: Создание первого проекта в XIOT-EDITOR, Получение лицензионного ключа, Лицензирование XIOT. Далее: установите XIOT-PLC.

3. Установите XIOT-PLC

1. Выберите поддерживаемое устройство-хост с Debian-совместимой Linux-системой и архитектурой armhf, arm64 или amd64.
2. Скачайте актуальный DEB-пакет XIOT-PLC по официальной ссылке и установите его с правами администратора. Не отключайте проверку TLS-сертификата.

Результат: служба XIOT-PLC установлена и запущена на устройстве-хосте. Подробнее: Установка XIOT-PLC на контроллер. Далее: привяжите XIOT-PLC к проекту.

4. Привяжите XIOT-PLC к проекту

1. Из доверенной локальной сети откройте http://<IP_устройства>:5551; не публикуйте этот порт в интернете.
2. Введите те же email и пароль, что и в XIOT-EDITOR, выберите проект и выполните привязку.

Результат: в слоте plc1 проекта отображается привязанный XIOT-PLC. Сейчас к одному проекту привязывается один XIOT-PLC. Подробнее: Привязка XIOT-PLC к проекту. Далее: создайте структуру объекта.

5. Создайте структуру и виртуальные устройства

1. Нажмите F2 или Fn + F2, чтобы включить редактирование. F2 не переключает Lite и Pro.
2. Создайте этажи, комнаты и виртуальные устройства. Lite автоматически формирует стандартный интерфейс, Pro позволяет добавлять свои страницы и элементы. Это два режима одного проекта.

Результат: структура объекта и нужные виртуальные устройства видны в редакторе. Подробнее: Создание виртуальных устройств, Lite и Pro версии редактора, Назначение и возможности Pro версии редактора. Далее: настройте связь с физическим оборудованием.

6. Настройте драйверы и адреса

1. Добавьте нужные драйверы XIOT, например Wiren Board или KNX. Драйвер XIOT — интеграционный модуль XIOT-PLC, а не системная служба производителя.
2. Назначьте характеристикам виртуальных устройств адрес управления для исходящей команды и адрес состояния для фактического состояния или обратной связи.

Результат: физические сигналы связаны с характеристиками виртуальных устройств. Подробнее: Настройка драйверов, Привязка реальных устройств к виртуальным, Основные термины и сокращения. Далее: создайте и проверьте сценарии.

7. Добавьте и проверьте сценарии

1. Добавьте готовые или пользовательские сценарии.
2. Проверьте условия запуска, действия и переходы между состояниями.

Результат: поведение устройств и сценариев соответствует проектной логике в редакторе. Подробнее: Сценарии, Обзор инструментов и меню PRO версии редактора. Далее: проверьте ручное сохранение.

8. Создайте самостоятельную контрольную точку

1. Во время настройки, например после отдельного этапа вёрстки в Pro, нажмите Сохранить проект.
2. Убедитесь, что появилась новая версия. Если нужна облачная копия, дождитесь статуса В облаке.

Результат: создана отдельная версия-контрольная точка. Это действие не изменяет XIOT-PLC и не является техническим условием загрузки. Подробнее: Сохранение резервной копии проекта. Далее: завершите настройку, а затем загрузите готовую конфигурацию.

9. Загрузите конфигурацию на XIOT-PLC

1. Нажмите Загрузить конфигурацию на контроллер и дождитесь завершения без ошибок.

Команда сама сохраняет проект, создаёт одну новую версию и передаёт на привязанный XIOT-PLC точный снимок этой версии. Не сохраняйте проект ещё раз непосредственно перед загрузкой без специальной причины.

Результат: XIOT-PLC работает с точным снимком версии, созданной командой загрузки. Подробнее: Основные термины и сокращения, Настройка драйверов. Далее: проверьте проект через XIOT-APP.

10. Проверьте проект в XIOT-APP

1. Установите XIOT-APP на телефон или планшет, войдите по email и паролю и откройте нужный проект.
2. Измените состояние одного безопасного тестового устройства. Убедитесь, что команда выполнена, а адрес состояния показал фактическую обратную связь.
3. Проверьте основные экраны, сценарии и критичные состояния.

Результат: проект открывается в XIOT-APP, команды доходят до оборудования, а обратная связь показывает фактическое состояние. Подробнее: Приложение для телефона и планшета XIOT-APP. Далее: подготовьте проект к передаче владельцу.

11. Передайте проект владельцу

1. Убедитесь, что проект проверен на объекте и через XIOT-APP.
2. Нажмите Сохранить проект и дождитесь статуса В облаке. Эта контрольная точка нужна для административной передачи и не заменяет загрузку на XIOT-PLC.
3. Подготовьте данные нового владельца и выполните передачу после подтверждения сторон.

Результат: владелец получил проект, а интегратор и владелец проверили доступ и роли. Подробнее: Передача проекта новому владельцу, Как сменить интегратора в XIOT, Роли пользователей в XIOT. Далее: передайте владельцу ссылку на Связь с поддержкой и зафиксируйте итоговую документацию по объекту.