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: @@
-__NOTOC__
+{{DISPLAYTITLE:С чего начать интегратору}}
+Этот чек-лист ведёт интегратора от регистрации до проверки готового проекта и его передачи владельцу. Выполняйте шаги по порядку: каждый шаг заканчивается проверяемым результатом.
-''Краткая пошаговая инструкция для Интегратора''
+== 1. Зарегистрируйтесь в XIOT-EDITOR ==
-== '''📝''' 1. Регистрация и ввод лицензионного ключа ==
+# Откройте [https://xiot.pro xiot.pro] в актуальной версии Google Chrome или Safari на компьютере или ноутбуке.
+# Зарегистрируйте учётную запись по email и паролю.
-* Перейдите на сайт [https://xiot.pro https://xiot.pro] и зарегистрируйтесь, указав email и пароль.
+'''Результат:''' вы входите в XIOT-EDITOR под учётной записью интегратора.
-* После регистрации откроется окно '''ввода лицензионного ключа'''.
+'''Подробнее:''' [[Editor-registration|Регистрация в редакторе]], [[Xiot-editor-access|Доступ к XIOT-EDITOR]].
-* Запросите ключ у представителей XIOT, указав email, под которым зарегистрировались.
+'''Далее:''' получите лицензионный ключ и создайте проект.
-* '''Введите ключ''' — после этого будет создан первый проект, привязанный к вашему аккаунту.
-[[Регистрация_в_редакторе|Подробно про регистрацию в редакторе]]
+== 2. Получите лицензию и создайте проект ==
-== '''🛠️'''2. Работа в редакторе XIOT ==
+# Рассчитайте состав в [https://xiot.ru/xiot_calc_license.html калькуляторе лицензии XIOT] и приобретите лицензию.
+# Получите ключ на email, войдите в XIOT-EDITOR и активируйте ключ. Для каждого следующего проекта нужны отдельная лицензия и новый ключ.
-* Редактор работает в облаке: [https://xiot.pro https://xiot.pro].
+'''Результат:''' в XIOT-EDITOR создан новый проект; интегратор получил в нём роли '''Владелец''' и '''Интегратор'''.
-* Доступ возможен '''только с компьютера или ноутбука''' через браузер на базе '''Chromium''' (например, Google Chrome или Яндекс.Браузер).
+'''Подробнее:''' [[First-project-in-xiot-editor|Создание первого проекта в XIOT-EDITOR]], [[Getting-a-license-key|Получение лицензионного ключа]], [[Xiot-licensing|Лицензирование XIOT]].
-* Для входа в режим редактирования нажмите клавишу '''F2''' (или '''Fn + F2''').
+'''Далее:''' установите XIOT-PLC.
-* '''Переключение между версиями Lite и Pro''' — кнопка '''LITE–PRO''' в верхнем меню редактора.
-=== '''⚡'''Lite (основная версия) ===
+== 3. Установите XIOT-PLC ==
-* Интерфейс создаётся автоматически по структуре: этажи, комнаты, устройства.
-* Подходит не только для типовых, но и для '''всех задач'''.
-* Постоянно совершенствуется на основе отзывов пользователей и опыта Интеграторов.
-==='''⚙️''' Pro (дополнительная версия) ===
+# Выберите поддерживаемое устройство-хост с Debian-совместимой Linux-системой и архитектурой <code>armhf</code>, <code>arm64</code> или <code>amd64</code>.
-* Позволяет вручную создавать страницы интерфейса.
+# Скачайте актуальный DEB-пакет XIOT-PLC по официальной ссылке и установите его с правами администратора. Не отключайте проверку TLS-сертификата.
-* Добавление кнопок, индикаторов, вкладок и пр.
-* Используется вместе с Lite — для '''технических''' и '''кастомных страниц'''.
-== 3. Установка XIOT-PLC на контроллер и привязка к проекту ==
+'''Результат:''' служба XIOT-PLC установлена и запущена на устройстве-хосте.
+'''Подробнее:''' [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]].
+'''Далее:''' привяжите XIOT-PLC к проекту.
-'''📦 Установка XIOT-PLC на контроллер'''
+== 4. Привяжите XIOT-PLC к проекту ==
-. Подключитесь по SSH к контроллеру (через программу Putty).
+# Из доверенной локальной сети откройте <code>http://&lt;IP_устройства&gt;:5551</code>; не публикуйте этот порт в интернете.
+# Введите те же email и пароль, что и в XIOT-EDITOR, выберите проект и выполните привязку.
-. Установите пакет XIOT-PLC командой:
+'''Результат:''' в слоте <code>plc1</code> проекта отображается привязанный XIOT-PLC. Сейчас к одному проекту привязывается один XIOT-PLC.
-<pre>
+'''Подробнее:''' [[Connect-xiot-plc-to-editor|Привязка XIOT-PLC к проекту]].
-wget https://xiot.pro/system/public/xiot.deb --no-check-certificate
+'''Далее:''' создайте структуру объекта.
-dpkg -i xiot.deb
-</pre>
-. В браузере откройте: <code>http://&lt;IP_контроллера&gt;:5551</code>
+== 5. Создайте структуру и виртуальные устройства ==
-. Авторизуйтесь под тем же email, с которым вы зарегистрированы в редакторе XIOT.
+# Нажмите '''F2''' или '''Fn + F2''', чтобы включить редактирование. F2 не переключает Lite и Pro.
+# Создайте этажи, комнаты и виртуальные устройства. Lite автоматически формирует стандартный интерфейс, Pro позволяет добавлять свои страницы и элементы. Это два режима одного проекта.
-. Выберите проект из списка, к которому вы хотите привязать контроллер.
+'''Результат:''' структура объекта и нужные виртуальные устройства видны в редакторе.
+'''Подробнее:''' [[Creating-devices|Создание виртуальных устройств]], [[Editor-lite-and-pro|Lite и Pro версии редактора]], [[Editor-pro-capabilities|Назначение и возможности Pro версии редактора]].
+'''Далее:''' настройте связь с физическим оборудованием.
+== 6. Настройте драйверы и адреса ==
- [[Установка_XIOT-PLC_на_контроллер|Установка XIOT-PLC на контроллер]]
+# Добавьте нужные драйверы XIOT, например Wiren Board или KNX. Драйвер XIOT — интеграционный модуль XIOT-PLC, а не системная служба производителя.
- [[Связываем_XIOT-PLC_с_редактором_XIOT|Связываем XIOT-PLC с проектом в редакторе]]
+# Назначьте характеристикам виртуальных устройств '''адрес управления''' для исходящей команды и '''адрес состояния''' для фактического состояния или обратной связи.
-== 4. Настройка структуры проекта ==
+'''Результат:''' физические сигналы связаны с характеристиками виртуальных устройств.
+'''Подробнее:''' [[Driver-setup|Настройка драйверов]], [[Device-bindings|Привязка реальных устройств к виртуальным]], [[Terms-and-abbreviations|Основные термины и сокращения]].
+'''Далее:''' создайте и проверьте сценарии.
-'''🏗️ Настройка проекта'''
+== 7. Добавьте и проверьте сценарии ==
-. Создайте этажи, комнаты и виртуальные устройства (освещение, розетки, датчики и т.д.).
+# Добавьте готовые или пользовательские сценарии.
+# Проверьте условия запуска, действия и переходы между состояниями.
-. В разделе "Драйверы" настройте связь с оборудованием (например, Wirenboard, KNX) для формирования списка тэгов.
+'''Результат:''' поведение устройств и сценариев соответствует проектной логике в редакторе.
+'''Подробнее:''' [[Scenarios|Сценарии]], [[Editor-pro-tools-and-menus|Обзор инструментов и меню PRO версии редактора]].
+'''Далее:''' проверьте ручное сохранение.
-. Привяжите виртуальные устройства к физическим через теги.
+== 8. Создайте самостоятельную контрольную точку ==
-. Вся настройка осуществляется через визуальный интерфейс, без необходимости знания системных переменных.
+# Во время настройки, например после отдельного этапа вёрстки в Pro, нажмите '''Сохранить проект'''.
+# Убедитесь, что появилась новая версия. Если нужна облачная копия, дождитесь статуса '''В облаке'''.
-== 5. Добавление сценариев ==
+'''Результат:''' создана отдельная версия-контрольная точка. Это действие не изменяет XIOT-PLC и не является техническим условием загрузки.
+'''Подробнее:''' [[Project-backup|Сохранение резервной копии проекта]].
+'''Далее:''' завершите настройку, а затем загрузите готовую конфигурацию.
-'''⏱️'''
+== 9. Загрузите конфигурацию на XIOT-PLC ==
-* Используйте готовые сценарии из библиотеки:
+# Нажмите '''Загрузить конфигурацию на контроллер''' и дождитесь завершения без ошибок.
-** биодинамическое освещение;
-** имитация рассвета и заката;
-** рабочий ритм;
-** отключение света;
-** управление поливом и др.
-* Либо создайте '''кастомный сценарий''' визуально, без программирования.
-* Сценарии можно запускать:
-** по времени;
-** по изменению статусов;
-** по действиям пользователя;
-** по логическим условиям.
-== '''🔁'''6. Передача проекта Пользователю ==
+Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает. Отдельно нажимать «Сохранить проект» перед загрузкой не обязательно. Не изменяйте проект до завершения операции; проверьте связь с XIOT-PLC, а физическую работу — на следующем шаге.
+'''Результат:''' проект сохранён локально, редактор сообщил о завершении загрузки и XIOT-PLC снова на связи. Облачная синхронизация и публикация приложения имеют отдельные статусы.
+'''Подробнее:''' [[Terms-and-abbreviations|Основные термины и сокращения]], [[Driver-setup|Настройка драйверов]].
+'''Далее:''' проверьте проект через XIOT-APP.
+== 10. Проверьте проект в XIOT-APP ==
-* При создании проекта Интегратор автоматически получает роли: '''Интегратор''', '''Владелец''', '''Пользователь'''.
+# Дождитесь подтверждения облачного сохранения и публикации приложения в меню облака редактора. Установите XIOT-APP на телефон или планшет, войдите под своей учётной записью и откройте нужный проект.
-* После завершения настройки:
+# Измените состояние одного безопасного тестового устройства. Убедитесь, что команда выполнена, а адрес состояния показал фактическую обратную связь.
-# Назначьте нового Владельца (собственника системы).
+# Проверьте основные экраны, сценарии и критичные состояния.
-# Передайте проект через редактор.
-'''После передачи:'''
+'''Результат:''' проект открывается в XIOT-APP, команды доходят до оборудования, а обратная связь показывает фактическое состояние.
-* Интегратор остаётся привязан только как '''Интегратор'''.
+'''Подробнее:''' [[Xiot-app|Приложение для телефона и планшета XIOT-APP]].
-* Новый Владелец получает полный контроль.
+'''Далее:''' подготовьте проект к передаче владельцу.
-* '''Список Пользователей очищается''' — они относятся к предыдущему Владельцу.
-== '''👥'''Роли в системе XIOT (кратко) ==
+== 11. Передайте проект владельцу ==
+# Пройдите [[Project-completion-and-handover|чек-лист пусконаладки и сдачи]] вместе с владельцем.
+# Проверьте сохранённую версию по дате и содержимому, дождитесь её статуса '''В облаке''' и подготовьте резервную копию по инструкции [[Project-backup|Сохранение резервной копии проекта]]. Работу конфигурации на XIOT-PLC подтвердите отдельно; передайте документацию и результаты проверки.
+# Убедитесь, что владелец входит под собственной учётной записью и выполнил согласованное безопасное действие в XIOT-APP.
+# Если собственник проекта меняется, подготовьте данные нового владельца и выполните административную передачу после подтверждения сторон. Если собственник остаётся прежним, передача владельца не нужна.
-* '''Интегратор''' — настраивает проект, редактирует структуру, интерфейс, устанавливает PLC и передаёт проект.
+'''Результат:''' владелец принял проверенную систему, резервную копию и документацию; стороны подтвердили доступ, роли и порядок дальнейшего обслуживания.
-* '''Владелец''' — управляет пользователями, может отключить Интегратора или передать проект.
+'''Подробнее:''' [[Project-completion-and-handover|Завершение и передача проекта]], [[Transfer-project-to-new-owner|Передача проекта новому владельцу]], [[Changing-your-xiot-integrator|Как сменить интегратора в XIOT]], [[Xiot-user-roles|Роли пользователей в XIOT]].
-* '''Пользователь''' — работает только с интерфейсом, не имеет доступа к настройкам.
+'''Далее:''' передайте владельцу ссылки на [[FAQ]], [[Support|чек-лист обращения в поддержку]] и [[Certified-xiot-integrators|реестр сертифицированных интеграторов XIOT]], затем зафиксируйте итоговую документацию по объекту.
-* '''Разработчик''' — сотрудник XIOT, развивает платформу, не участвует в пользовательских проектах.
-[[Роли_пользователей_в_XIOT | Подробно про роли пользователей в XIOT]]

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