Getting-started-for-integrators: различия между версиями

Текущая версия от 22:20, 2 октября 2026

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ Строка 1: / Строка 1: @@
+{{DISPLAYTITLE:С чего начать интегратору}}
 Этот чек-лист ведёт интегратора от регистрации до проверки готового проекта и его передачи владельцу. Выполняйте шаги по порядку: каждый шаг заканчивается проверяемым результатом.
@@ Строка 7: / Строка 8: @@
 '''Результат:''' вы входите в XIOT-EDITOR под учётной записью интегратора.
-'''Подробнее:''' [[Регистрация в редакторе]], [[Доступ к XIOT-EDITOR]].
+'''Подробнее:''' [[Editor-registration|Регистрация в редакторе]], [[Xiot-editor-access|Доступ к XIOT-EDITOR]].
 '''Далее:''' получите лицензионный ключ и создайте проект.
@@ Строка 16: / Строка 17: @@
 '''Результат:''' в XIOT-EDITOR создан новый проект; интегратор получил в нём роли '''Владелец''' и '''Интегратор'''.
-'''Подробнее:''' [[Получение лицензионного ключа]], [[Лицензирование XIOT]].
+'''Подробнее:''' [[First-project-in-xiot-editor|Создание первого проекта в XIOT-EDITOR]], [[Getting-a-license-key|Получение лицензионного ключа]], [[Xiot-licensing|Лицензирование XIOT]].
 '''Далее:''' установите XIOT-PLC.
@@ Строка 25: / Строка 26: @@
 '''Результат:''' служба XIOT-PLC установлена и запущена на устройстве-хосте.
-'''Подробнее:''' [[Установка XIOT-PLC на контроллер]].
+'''Подробнее:''' [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]].
 '''Далее:''' привяжите XIOT-PLC к проекту.
@@ Строка 34: / Строка 35: @@
 '''Результат:''' в слоте <code>plc1</code> проекта отображается привязанный XIOT-PLC. Сейчас к одному проекту привязывается один XIOT-PLC.
-'''Подробнее:''' [[Связываем XIOT-PLC с редактором XIOT|Привязка XIOT-PLC к проекту]].
+'''Подробнее:''' [[Connect-xiot-plc-to-editor|Привязка XIOT-PLC к проекту]].
 '''Далее:''' создайте структуру объекта.
@@ Строка 43: / Строка 44: @@
 '''Результат:''' структура объекта и нужные виртуальные устройства видны в редакторе.
-'''Подробнее:''' [[Создание виртуальных устройств]], [[Lite и Pro версии редактора]], [[Назначение и возможности Pro версии редактора]].
+'''Подробнее:''' [[Creating-devices|Создание виртуальных устройств]], [[Editor-lite-and-pro|Lite и Pro версии редактора]], [[Editor-pro-capabilities|Назначение и возможности Pro версии редактора]].
 '''Далее:''' настройте связь с физическим оборудованием.
@@ Строка 52: / Строка 53: @@
 '''Результат:''' физические сигналы связаны с характеристиками виртуальных устройств.
-'''Подробнее:''' [[Настройка драйверов]], [[Привязка реальных устройств к виртуальным]], [[Основные термины и сокращения]].
+'''Подробнее:''' [[Driver-setup|Настройка драйверов]], [[Device-bindings|Привязка реальных устройств к виртуальным]], [[Terms-and-abbreviations|Основные термины и сокращения]].
 '''Далее:''' создайте и проверьте сценарии.
@@ Строка 61: / Строка 62: @@
 '''Результат:''' поведение устройств и сценариев соответствует проектной логике в редакторе.
-'''Подробнее:''' [[Сценарии]], [[Обзор инструментов и меню PRO версии редактора]].
+'''Подробнее:''' [[Scenarios|Сценарии]], [[Editor-pro-tools-and-menus|Обзор инструментов и меню PRO версии редактора]].
 '''Далее:''' проверьте ручное сохранение.
@@ Строка 70: / Строка 71: @@
 '''Результат:''' создана отдельная версия-контрольная точка. Это действие не изменяет XIOT-PLC и не является техническим условием загрузки.
-'''Подробнее:''' [[Сохранение резервной копии проекта]].
+'''Подробнее:''' [[Project-backup|Сохранение резервной копии проекта]].
 '''Далее:''' завершите настройку, а затем загрузите готовую конфигурацию.
@@ Строка 77: / Строка 78: @@
 # Нажмите '''Загрузить конфигурацию на контроллер''' и дождитесь завершения без ошибок.
-Команда сама сохраняет проект, создаёт одну новую версию и передаёт на привязанный XIOT-PLC точный снимок этой версии. Не сохраняйте проект ещё раз непосредственно перед загрузкой без специальной причины.
+Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. Отдельно нажимать «Сохранить проект» перед загрузкой не обязательно. Не изменяйте проект до завершения операции; проверьте связь с XIOT-PLC, а физическую работу — на следующем шаге.
-'''Результат:''' XIOT-PLC работает с точным снимком версии, созданной командой загрузки.
+'''Результат:''' проект сохранён локально, редактор сообщил о завершении загрузки и XIOT-PLC снова на связи. Облачная синхронизация и публикация приложения имеют отдельные статусы.
-'''Подробнее:''' [[Основные термины и сокращения]], [[Настройка драйверов]].
+'''Подробнее:''' [[Terms-and-abbreviations|Основные термины и сокращения]], [[Driver-setup|Настройка драйверов]].
 '''Далее:''' проверьте проект через XIOT-APP.
 == 10. Проверьте проект в XIOT-APP ==
-# Установите XIOT-APP на телефон или планшет, войдите по email и паролю и откройте нужный проект.
+# Дождитесь подтверждения облачного сохранения и публикации приложения в меню облака редактора. Установите XIOT-APP на телефон или планшет, войдите под своей учётной записью и откройте нужный проект.
 # Измените состояние одного безопасного тестового устройства. Убедитесь, что команда выполнена, а адрес состояния показал фактическую обратную связь.
 # Проверьте основные экраны, сценарии и критичные состояния.
 '''Результат:''' проект открывается в XIOT-APP, команды доходят до оборудования, а обратная связь показывает фактическое состояние.
-'''Подробнее:''' [[Приложение для телефона и планшета XIOT-APP]].
+'''Подробнее:''' [[Xiot-app|Приложение для телефона и планшета XIOT-APP]].
 '''Далее:''' подготовьте проект к передаче владельцу.
 == 11. Передайте проект владельцу ==
-# Убедитесь, что проект проверен на объекте и через XIOT-APP.
+# Пройдите [[Project-completion-and-handover|чек-лист пусконаладки и сдачи]] вместе с владельцем.
-# Нажмите '''Сохранить проект''' и дождитесь статуса '''В облаке'''. Эта контрольная точка нужна для административной передачи и не заменяет загрузку на XIOT-PLC.
+# Проверьте сохранённую версию по дате и содержимому, дождитесь её статуса '''В облаке''' и подготовьте резервную копию по инструкции [[Project-backup|Сохранение резервной копии проекта]]. Работу конфигурации на XIOT-PLC подтвердите отдельно; передайте документацию и результаты проверки.
-# Подготовьте данные нового владельца и выполните передачу после подтверждения сторон.
+# Убедитесь, что владелец входит под собственной учётной записью и выполнил согласованное безопасное действие в XIOT-APP.
+# Если собственник проекта меняется, подготовьте данные нового владельца и выполните административную передачу после подтверждения сторон. Если собственник остаётся прежним, передача владельца не нужна.
-'''Результат:''' владелец получил проект, а интегратор и владелец проверили доступ и роли.
+'''Результат:''' владелец принял проверенную систему, резервную копию и документацию; стороны подтвердили доступ, роли и порядок дальнейшего обслуживания.
-'''Подробнее:''' [[Передача проекта новому владельцу]], [[Как сменить интегратора в XIOT]], [[Роли пользователей в XIOT]].
+'''Подробнее:''' [[Project-completion-and-handover|Завершение и передача проекта]], [[Transfer-project-to-new-owner|Передача проекта новому владельцу]], [[Changing-your-xiot-integrator|Как сменить интегратора в XIOT]], [[Xiot-user-roles|Роли пользователей в XIOT]].
-'''Далее:''' передайте владельцу ссылку на [[Связь с поддержкой]] и зафиксируйте итоговую документацию по объекту.
+'''Далее:''' передайте владельцу ссылки на [[FAQ]], [[Support|чек-лист обращения в поддержку]] и [[Certified-xiot-integrators|реестр сертифицированных интеграторов XIOT]], затем зафиксируйте итоговую документацию по объекту.

Admin (обсуждение | вклад)