Terms-and-abbreviations: различия между версиями

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

XIOT — программно-аппаратная платформа для создания надёжных проводных систем автоматизации: «умный дом», «умное здание» и промышленные объекты.

Платформа объединяет устройства-хосты XIOT-PLC, облачный сервис и визуальный редактор — от настройки проекта до управления системой. Конфигурация создаётся в XIOT-EDITOR и загружается на XIOT-PLC. Загруженные локальные сценарии продолжают выполняться без связи с облаком; облачные функции в это время недоступны.

Основные действия

Эти действия не заменяют друг друга. Для поиска в старых материалах могут встречаться названия «тег управления», «тег статуса» и «тег состояния»; в актуальной документации используются термины адрес управления и адрес состояния.

Термин	Что означает	Важно
Сохранить проект	Явно зафиксировать локальную датированную копию проекта. Отдельное сохранение удобно как контрольная точка, особенно во время вёрстки интерфейса в Pro.	Сохранение не меняет конфигурацию XIOT-PLC. Статус В облаке отдельно подтверждает отправку версии в XIOT-CLOUD. Подробнее: Сохранение резервной копии проекта.
Создать версию	Получить результат сохранения проекта — новую датированную запись в списке версий.	Это результат команды Сохранить проект, а не отдельная кнопка или команда.
Загрузить конфигурацию на контроллер	Сначала сохранить проект локально и после успешной записи отправить сохранённую конфигурацию на привязанный XIOT-PLC.	Дождитесь завершения операций; отдельно проверьте запись в истории, связь контроллера, физические команды и обратную связь. Успешная загрузка сама по себе не подтверждает облачное сохранение или публикацию приложения. Загрузка не устанавливает XIOT-PLC и не привязывает его к проекту.
Установить XIOT-PLC на устройство-хост	Скачать и установить пакет XIOT-PLC на поддерживаемое устройство-хост или контроллер и проверить запуск службы.	Установка пакета не привязывает XIOT-PLC к проекту и не загружает конфигурацию. Подробнее: Установка XIOT-PLC на контроллер.
Привязать XIOT-PLC к проекту	Назначить установленный XIOT-PLC выбранному проекту через локальный интерфейс устройства-хоста.	Привязка не восстанавливает и не загружает конфигурацию проекта. Подробнее: Привязка XIOT-PLC к проекту.
Драйвер XIOT	Интеграционный модуль XIOT-PLC, который обменивается данными с оборудованием, шиной или внешним сервисом и предоставляет адреса для связи с виртуальными устройствами.	Это не системная служба или драйвер операционной системы производителя оборудования, например `wb-mqtt-serial`. Подробнее: Настройка драйверов.
Адрес управления	Адрес, в который XIOT отправляет команду или записывает значение для физического оборудования.	Если характеристика не управляет оборудованием, адрес управления может не требоваться.
Адрес состояния	Адрес, из которого XIOT получает фактическое состояние или обратную связь физического оборудования.	Наличие только адреса состояния само по себе не делает характеристику недоступной для ручного изменения: это дополнительно определяется типом и правами характеристики. Подробнее: Адреса управления и состояния в XIOT.

Обычная последовательность: установить XIOT-PLC → привязать XIOT-PLC к проекту → настроить драйвер XIOT → назначить адреса управления и состояния → выполнить Загрузить конфигурацию на контроллер → проверить оборудование и сценарии. Для самостоятельной контрольной точки используйте Сохранить проект. Во время сохранения и загрузки не редактируйте проект; результат каждой операции проверяйте отдельно.

💡 Особое внимание уделено:

надёжности проводных технологий (KNX, Modbus, DALI);
интуитивно понятному интерфейсу для пользователя и интегратора;
удобству проектирования и визуальной настройке без программирования.

🧩 Компоненты платформы XIOT

XIOT-PLC — программный модуль, устанавливаемый из Debian-пакета на поддерживаемую Linux-платформу. Выполняет загруженную конфигурацию, сценарии, обрабатывает данные устройств и управляет оборудованием. Поддерживаются Wiren Board 6/7/8/9, JetHome, Raspberry Pi, Orange Pi, NanoPi, x86-ПК/Intel NUC и VDS/VPS на архитектурах armhf, arm64 и amd64.

XIOT-EDITOR — веб-редактор с локальным хранением проектов и облачной синхронизацией. Позволяет создавать структуру проекта, добавлять устройства, сценарии и визуальные интерфейсы.

XIOT-CLOUD — облачный сервис хранения, синхронизации и маршрутизации данных. Обеспечивает связь между контроллером, редактором и приложением.

XIOT-APP — мобильное приложение для управления системой. Позволяет контролировать устройства, сценарии и состояние дома с телефона или планшета.

🧱 Структура проекта

Проект — конфигурация системы, включающая этажи, комнаты, устройства и сценарии.

Этаж — логическая группа комнат, используется для структурирования проекта и визуального отображения.

Комната — логическая единица проекта, содержащая устройства, сценарии и характеристики помещения (температура, освещённость, активность и др.).

Устройство — элемент системы, объединяющий физические и виртуальные компоненты.

Сценарий — логическая последовательность действий, определяющая автоматизацию поведения системы. Может срабатывать по времени, событию, состоянию устройства или внешнему сигналу.

⚙️ Типы устройств

Физическое устройство — реальное оборудование, подключённое по протоколам KNX, Modbus, MQTT и др. Обменивается данными с XIOT-PLC через драйвер XIOT, адрес управления и адрес состояния.

Виртуальное устройство — логическая модель оборудования, создаваемая интегратором в редакторе. Может быть связано с физическим устройством или работать автономно.

🔄 Компоненты логики

Адрес связи — идентификатор источника или приёмника значения в настроенном драйвере XIOT. Для исходящей команды используется адрес управления, для входящего фактического значения — адрес состояния.

Сценарий — логическая последовательность действий, определяющая поведение системы. Может выполняться по времени, событию или состоянию устройств.

Тип устройства — шаблон, определяющий функциональность и отображение (лампа, термостат, реле и др.).

Тип логики — шаблон сценария (по времени, событию, рассвету, циклу и т.д.).

👥 Роли пользователей

Интегратор — создаёт проект, настраивает устройства и сценарии, устанавливает XIOT-PLC на поддерживаемое устройство-хост и привязывает его к проекту. Может передавать проект владельцу.

Владелец — конечный собственник системы. Управляет пользователями, назначает или ограничивает интегратора.

Пользователь — управляет системой через XIOT-APP, без доступа к настройкам проекта.

🔁 Основные процессы

Передача проекта новому владельцу — административная смена владельца проекта после подтверждения сторон. Точный порядок и последствия для ролей и доступов приведены в статье Передача проекта новому владельцу.

Привязка XIOT-PLC к проекту — назначение установленного XIOT-PLC проекту через локальный интерфейс http://IP_контроллера:5551. В текущем интерфейсе интегратор вводит email и пароль XIOT и выбирает проект. Операцию выполняют только из доверенной локальной сети. Сейчас у проекта один PLC-слот (plc1); до шести Wiren Board подключаются к этому XIOT-PLC как отдельные MQTT-подключения.

@@ Строка 1: / Строка 1: @@
+{{DISPLAYTITLE:Основные термины и сокращения}}
+'''XIOT''' — программно-аппаратная платформа для создания надёжных проводных систем автоматизации:
+«умный дом», «умное здание» и промышленные объекты.
-__NOTOC__
+Платформа объединяет устройства-хосты XIOT-PLC, облачный сервис и визуальный редактор — от настройки проекта до управления системой.
+Конфигурация создаётся в '''XIOT-EDITOR''' и загружается на '''XIOT-PLC'''. Загруженные локальные сценарии продолжают выполняться без связи с облаком; облачные функции в это время недоступны.
+== '''Основные действия''' ==
-=== ▶ Общие понятия ===
+Эти действия не заменяют друг друга. Для поиска в старых материалах могут встречаться названия «тег управления», «тег статуса» и «тег состояния»; в актуальной документации используются термины '''адрес управления''' и '''адрес состояния'''.
-==== '''Платформа XIOT''' ====
+{| class="wikitable" style="width:100%"
-Платформа для создания проводных систем автоматизации: "умный дом", "умное здание", промышленная автоматизация. Поддерживает управление по расписаниям, логике, датчикам и через сценарии. Вся конфигурация создаётся в облачном редакторе и выполняется на локальном контроллере.
+! Термин !! Что означает !! Важно
-'''Примечание''': Основное внимание в XIOT уделяется проводным технологиям, на стандартизированных протоколах, например, KNX, Modbus, DALI, для максимальной надёжности и интеграции.
+|-
+| '''Сохранить проект''' || Явно зафиксировать локальную датированную копию проекта. Отдельное сохранение удобно как контрольная точка, особенно во время вёрстки интерфейса в Pro. || Сохранение не меняет конфигурацию XIOT-PLC. Статус '''В облаке''' отдельно подтверждает отправку версии в XIOT-CLOUD. Подробнее: [[Project-backup|Сохранение резервной копии проекта]].
+|-
+| '''Создать версию''' || Получить результат сохранения проекта — новую датированную запись в списке версий. || Это результат команды '''Сохранить проект''', а не отдельная кнопка или команда.
+|-
+| '''Загрузить конфигурацию на контроллер''' || Сначала сохранить проект локально и после успешной записи отправить сохранённую конфигурацию на привязанный XIOT-PLC. || Дождитесь завершения операций; отдельно проверьте запись в истории, связь контроллера, физические команды и обратную связь. Успешная загрузка сама по себе не подтверждает облачное сохранение или публикацию приложения. Загрузка не устанавливает XIOT-PLC и не привязывает его к проекту.
+|-
+| '''Установить XIOT-PLC на устройство-хост''' || Скачать и установить пакет XIOT-PLC на поддерживаемое устройство-хост или контроллер и проверить запуск службы. || Установка пакета не привязывает XIOT-PLC к проекту и не загружает конфигурацию. Подробнее: [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]].
+|-
+| '''Привязать XIOT-PLC к проекту''' || Назначить установленный XIOT-PLC выбранному проекту через локальный интерфейс устройства-хоста. || Привязка не восстанавливает и не загружает конфигурацию проекта. Подробнее: [[Connect-xiot-plc-to-editor|Привязка XIOT-PLC к проекту]].
+|-
+| '''Драйвер XIOT''' || Интеграционный модуль XIOT-PLC, который обменивается данными с оборудованием, шиной или внешним сервисом и предоставляет адреса для связи с виртуальными устройствами. || Это не системная служба или драйвер операционной системы производителя оборудования, например <code>wb-mqtt-serial</code>. Подробнее: [[Driver-setup|Настройка драйверов]].
+|-
+| '''Адрес управления''' || Адрес, в который XIOT отправляет команду или записывает значение для физического оборудования. || Если характеристика не управляет оборудованием, адрес управления может не требоваться.
+|-
+| '''Адрес состояния''' || Адрес, из которого XIOT получает фактическое состояние или обратную связь физического оборудования. || Наличие только адреса состояния само по себе не делает характеристику недоступной для ручного изменения: это дополнительно определяется типом и правами характеристики. Подробнее: [[Xiot-tags|Адреса управления и состояния в XIOT]].
+|}
-==== '''XIOT-PLC''' ====
+Обычная последовательность: установить XIOT-PLC → привязать XIOT-PLC к проекту → настроить драйвер XIOT → назначить адреса управления и состояния → выполнить '''Загрузить конфигурацию на контроллер''' → проверить оборудование и сценарии. Для самостоятельной контрольной точки используйте '''Сохранить проект'''. Во время сохранения и загрузки не редактируйте проект; результат каждой операции проверяйте отдельно.
-Программный модуль, устанавливаемый на контроллер Linux (например, Wiren Board, JetHome). Исполняет проект, созданный в редакторе XIOT: обрабатывает сценарии, события, данные с устройств, взаимодействует с интерфейсами управления.
-'''Примечание''': XIOT-PLC можно настраивать для работы с различными физическими интерфейсами, такими как Modbus, MQTT, KNX.
-==== '''Редактор XIOT''' ====
+💡 Особое внимание уделено:
-Облачный инструмент настройки проекта. Доступен в двух версиях: '''Lite''' (основной, подходит для всех задач) и '''Pro''' (расширенный, с доступом к коду и отладке). Запуск режима редактирования — клавиша '''F2'''.
+* надёжности проводных технологий (KNX, Modbus, DALI);
-'''Примечание''': Редактор предоставляет удобный визуальный интерфейс для интеграторов и владельцев, не требуя глубоких знаний программирования.
+* интуитивно понятному интерфейсу для пользователя и интегратора;
+* удобству проектирования и визуальной настройке без программирования.
-==== '''Облако XIOT''' ====
+----
-Сервис, обеспечивающий хранение проектов, загрузку обновлений, защищённую связку между контроллером и внешними интерфейсами.
-'''Примечание''': Облако XIOT также служит резервным хранилищем для проектов и обеспечивает доступ к проектам из любой точки мира, а также позволяет синхронизировать данные между различными устройствами.
-==== '''Приложение XIOT''' ====
+== 🧩 '''Компоненты платформы XIOT''' ==
-Мобильное приложение, которое предоставляет пользователям и владельцам удобный интерфейс для управления системой автоматизации. Приложение поддерживает доступ к проектам, позволяет управлять устройствами, запускать сценарии и получать уведомления.
-'''Примечание''': Приложение доступно для устройств на платформе iOS и Android и позволяет пользователям взаимодействовать с системой в любом месте, обеспечивая гибкость и удобство в управлении.
-=== 🧱 Структура проекта ===
+'''XIOT-PLC''' — программный модуль, устанавливаемый из Debian-пакета на поддерживаемую Linux-платформу. Выполняет загруженную конфигурацию, сценарии, обрабатывает данные устройств и управляет оборудованием. Поддерживаются 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>.
-==== '''Проект''' ====
+'''XIOT-EDITOR''' — веб-редактор с локальным хранением проектов и облачной синхронизацией.
-Конфигурация системы, включающая этажи, комнаты, устройства, сценарии и настройки.
+Позволяет создавать структуру проекта, добавлять устройства, сценарии и визуальные интерфейсы.
-'''Примечание''': Каждый проект может быть настроен индивидуально для различных помещений и типов устройств.
-==== '''Этаж''' ====
+'''XIOT-CLOUD''' — облачный сервис хранения, синхронизации и маршрутизации данных.
-Логическая единица, объединяющая комнаты. Используется для визуального отображения, группировки устройств и настройки прав доступа.
+Обеспечивает связь между контроллером, редактором и приложением.
-'''Примечание''': Этажи могут быть как физическими, так и виртуальными в зависимости от конфигурации.
-==== '''Комната''' ====
+'''XIOT-APP''' — мобильное приложение для управления системой.
-Привязана к этажу. Содержит устройства и сценарии. Может быть назначена отдельным пользователям.
+Позволяет контролировать устройства, сценарии и состояние дома с телефона или планшета.
-'''Примечание''': Комнаты могут иметь разные уровни доступа для различных пользователей системы.
-== 🏗️ Устройства в XIOT ==
+----
-==== '''Устройство''' ====
+== 🧱 '''Структура проекта''' ==
-Общее понятие, включающее как реальные (физические), так и программные (виртуальные) компоненты, отображаемые и используемые в проекте XIOT.
-'''Примечание''': Устройства могут быть подключены к системе через различные физические протоколы или работать виртуально.
-==== '''Физическое устройство''' ====
+'''Проект''' — конфигурация системы, включающая этажи, комнаты, устройства и сценарии.
-Реальное оборудование, подключённое к системе XIOT через один из протоколов (Modbus, KNX, MQTT, HTTP и т.д.).
-'''Примеры''':
-Датчик температуры;
+'''Этаж''' — логическая группа комнат, используется для структурирования проекта и визуального отображения.
-Релейный модуль;
+'''Комната''' — логическая единица проекта, содержащая устройства, сценарии и характеристики помещения (температура, освещённость, активность и др.).
-KNX-кнопка;
+'''Устройство''' — элемент системы, объединяющий физические и виртуальные компоненты.
-Modbus-регулятор.
+'''Сценарий''' — логическая последовательность действий, определяющая автоматизацию поведения системы.
-Физические устройства обмениваются данными с XIOT-PLC через '''теги''' и интерфейсы, но не отображаются напрямую в структуре проекта — они «привязаны» к виртуальным устройствам.
+Может срабатывать по времени, событию, состоянию устройства или внешнему сигналу.
-==== '''Виртуальное устройство''' ====
+== ⚙️ '''Типы устройств''' ==
-Добавляется интегратором в редакторе. Представляет собой логическое отображение устройства в пользовательском интерфейсе.
-'''Примечание''': Виртуальные устройства могут быть связаны с физическими устройствами или работать полностью виртуально.
-'''Может быть связано с''':
+'''Физическое устройство''' — реальное оборудование, подключённое по протоколам KNX, Modbus, MQTT и др.
+Обменивается данными с XIOT-PLC через драйвер XIOT, адрес управления и адрес состояния.
-Физическим устройством (например, лампа управляет реле);
+'''Виртуальное устройство''' — логическая модель оборудования, создаваемая интегратором в редакторе.
+Может быть связано с физическим устройством или работать автономно.
-Работать виртуально (например, как триггер для запуска сценария).
+----
-'''Имеет''':
+== 🔄 '''Компоненты логики''' ==
-Тип (например, лампа, термостат);
+'''Адрес связи''' — идентификатор источника или приёмника значения в настроенном драйвере XIOT. Для исходящей команды используется адрес управления, для входящего фактического значения — адрес состояния.
-Иконку и название;
+'''Сценарий''' — логическая последовательность действий, определяющая поведение системы.
+Может выполняться по времени, событию или состоянию устройств.
-Управляющие и статусные теги;
+'''Тип устройства''' — шаблон, определяющий функциональность и отображение (лампа, термостат, реле и др.).
-Параметры визуализации.
+'''Тип логики''' — шаблон сценария (по времени, событию, рассвету, циклу и т.д.).
-=== ⚙️ Компоненты и логика ===
+----
-==== '''Тег''' ====
+== 👥 '''Роли пользователей''' ==
-Цифровая переменная, отображающая значение (температура, состояние реле, команда включения и т.п.). Связывает физические устройства, виртуальные устройства и сценарии.
-'''Примечание''': Теги являются основой взаимодействия между физическими и виртуальными устройствами, а также между устройствами и сценариями.
-==== '''Сценарий''' ====
+'''Интегратор''' — создаёт проект, настраивает устройства и сценарии, устанавливает XIOT-PLC на поддерживаемое устройство-хост и привязывает его к проекту.
-Логический блок, описывающий поведение системы: по времени, по событию, по кнопке, а также в ответ на изменения состояния системы или внешние факторы. Может содержать шаги, условия, задержки, циклы и логические операторы.
+Может передавать проект владельцу.
-'''Примечание''': Сценарии позволяют гибко настроить логику системы, будь то автоматическое включение света по времени, управление климатом в зависимости от датчиков, или реагирование на внешние события (например, открытие окна или движение в комнате). Сценарии могут быть настроены для работы в различных режимах, таких как дневной/ночной, рабочий/выходной день.
-==== '''Тип устройства''' ====
+'''Владелец''' — конечный собственник системы.
-Шаблон, определяющий функциональность и внешний вид устройства: например, лампа, термостат, розетка.
+Управляет пользователями, назначает или ограничивает интегратора.
-'''Примечание''': Каждый тип устройства может иметь свои уникальные параметры и особенности настройки.
-==== '''Тип логики''' ====
+'''Пользователь''' — управляет системой через XIOT-APP, без доступа к настройкам проекта.
-Шаблон логического сценария: по времени, по событию, по кнопке, биоритм, рассвет, недельное расписание и т.д.
-'''Примечание''': Типы логики позволяют создать гибкие сценарии с возможностью настройки по индивидуальному расписанию или событиям.
-=== 👥 Роли и доступ ===
+----
-==== '''Интегратор''' ====
+== 🔁 '''Основные процессы''' ==
-Создаёт проект, настраивает структуру, сценарии и устройства, устанавливает и обновляет XIOT-PLC. Может передать проект Владельцу.
-'''Примечание''': Интегратор имеет полный доступ к настройкам проекта и может взаимодействовать с системными компонентами, но не имеет прав на управление пользователями.
-==== '''Владелец''' ====
+'''Передача проекта новому владельцу''' — административная смена владельца проекта после подтверждения сторон. Точный порядок и последствия для ролей и доступов приведены в статье [[Transfer-project-to-new-owner|Передача проекта новому владельцу]].
-Финальный собственник системы. Может управлять пользователями, назначать и временно ограничивать Интегратора, передавать проект.
-'''Примечание''': Владелец всегда имеет полный контроль над проектом и может назначить другого интегратора.
-==== '''Пользователь''' ====
+'''Привязка XIOT-PLC к проекту''' — назначение установленного XIOT-PLC проекту через локальный интерфейс <code>http://IP_контроллера:5551</code>. В текущем интерфейсе интегратор вводит email и пароль XIOT и выбирает проект. Операцию выполняют только из доверенной локальной сети. Сейчас у проекта один PLC-слот (<code>plc1</code>); до шести Wiren Board подключаются к этому XIOT-PLC как отдельные MQTT-подключения.
-Управляет системой через интерфейс. Не может редактировать проект. Владелец может ограничить доступ к комнатам и этажам.
-'''Примечание''': Пользователь может только использовать готовые сценарии и управлять устройствами, но не может изменять конфигурацию системы.
-=== 🔁 Процессы ===
+----
-==== '''Передача проекта''' ====
-При передаче:
-Интегратор остаётся;
-Все пользователи удаляются;
-Новый владелец получает полный контроль.
-'''Примечание''': Передача проекта — это важный процесс, который обеспечивает смену владельца с сохранением всех настроек и данных.
-==== '''Привязка контроллера''' ====
-Процесс связывания установленного XIOT-PLC с проектом в редакторе через ID.
-'''Примечание''': Этот процесс позволяет синхронизировать проект с физическим контроллером и начать управление устройствами.
-=== 📤 Взаимодействие ===
-==== '''Облако XIOT''' ====
-Сервис, обеспечивающий хранение проектов, загрузку обновлений, защищённую связку между контроллером и внешними интерфейсами.
-'''Примечание''': Облако XIOT также служит резервным хранилищем для проектов и обеспечивает доступ к проектам из любой точки мира, а также позволяет синхронизировать данные между различными устройствами.
-==== '''Интерфейс пользователя''' ====
-Доступен в локальной сети и через облако. Отображает состояния, позволяет запускать сценарии и управлять системой.
-'''Примечание''': Интерфейс пользователя интуитивно понятен и предоставляет все необходимые инструменты для управления системой, будь то с мобильного устройства или с рабочего стола.

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