Getting-started-for-integrators

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

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

1. Откройте editor.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. Проверьте версию редактора именно в открытом проекте: у проекта может быть закреплён прежний выпуск. Для PLC v14.15 используйте совместимую линию XIOT-EDITOR v14.15, например v14.15-1. При необходимости сначала выполните явный переход по инструкции Обновление редактора и контроллера. Сам адрес editor.xiot.pro не переключает версию проекта.
3. Установите стабильный XIOT-PLC v14.15 по инструкции ниже: скачайте DEB-пакет, проверьте контрольную сумму и выполните установку с правами администратора. Не отключайте проверку TLS-сертификата. Проверьте установленную версию и состояние службы.

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

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

1. Из доверенной локальной сети откройте http://<IP_устройства>:5551; не публикуйте этот порт в интернете.
2. Укажите email интегратора, нажмите Получить код, введите код из письма и нажмите Подтвердить код. При запросе пройдите двухфакторную проверку.
3. Выберите проект, установите флажок Подтверждаю привязку контроллера к выбранному проекту и нажмите Привязать. Дождитесь сообщения Привязка завершена.

Эти шаги предназначены для новой установки. Обновление уже работающего XIOT-PLC само по себе не требует повторной привязки.

Результат: в слоте 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. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. Отдельно нажимать «Сохранить проект» перед загрузкой не обязательно. Не изменяйте проект до завершения операции; проверьте связь с XIOT-PLC, а физическую работу — на следующем шаге.

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

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

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

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

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

1. Пройдите чек-лист пусконаладки и сдачи вместе с владельцем.
2. Проверьте сохранённую версию по дате и содержимому, дождитесь её статуса В облаке и подготовьте резервную копию по инструкции Сохранение резервной копии проекта. Работу конфигурации на XIOT-PLC подтвердите отдельно; передайте документацию и результаты проверки.
3. Убедитесь, что владелец входит под собственной учётной записью и выполнил согласованное безопасное действие в XIOT-APP.
4. Если собственник проекта меняется, подготовьте данные нового владельца и выполните административную передачу после подтверждения сторон. Если собственник остаётся прежним, передача владельца не нужна.

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