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

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