Перейти к содержанию

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

Материал из XIOT Wiki
м 1 версия импортирована
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показано 15 промежуточных версий этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE:Основные термины и сокращения}}
'''XIOT''' — программно-аппаратная платформа для создания надёжных проводных систем автоматизации: 
«умный дом», «умное здание» и промышленные объекты. 


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


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


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


=== ▶ Общие понятия ===
{| class="wikitable" style="width:100%"
! Термин !! Что означает !! Важно
|-
| '''Сохранить проект''' || Явно зафиксировать локальную датированную копию проекта. Отдельное сохранение удобно как контрольная точка, особенно во время вёрстки интерфейса в 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''' ====
Обычная последовательность: установить XIOT-PLC → привязать XIOT-PLC к проекту → настроить драйвер XIOT → назначить адреса управления и состояния → выполнить '''Загрузить конфигурацию на контроллер''' → проверить оборудование и сценарии. Для самостоятельной контрольной точки используйте '''Сохранить проект'''. Во время сохранения и загрузки не редактируйте проект; результат каждой операции проверяйте отдельно.
Платформа для создания проводных систем автоматизации: "умный дом", "умное здание", промышленная автоматизация. Поддерживает управление по расписаниям, логике, датчикам и через сценарии. Вся конфигурация создаётся в облачном редакторе и выполняется на локальном контроллере.
'''Примечание''': Основное внимание в XIOT уделяется проводным технологиям, таким как KNX и Wirenboard, для максимальной надёжности и интеграции.


==== '''XIOT-PLC''' ====
💡 Особое внимание уделено:
Программный сервер, устанавливаемый на контроллер (например, Wiren Board, JetHome). Исполняет проект, созданный в редакторе XIOT: обрабатывает сценарии, события, данные с устройств, взаимодействует с интерфейсами управления.
* надёжности проводных технологий (KNX, Modbus, DALI); 
'''Примечание''': XIOT-PLC можно настраивать для работы с различными физическими интерфейсами, такими как Modbus, MQTT, KNX.
* интуитивно понятному интерфейсу для пользователя и интегратора; 
* удобству проектирования и визуальной настройке без программирования.


==== '''Редактор XIOT''' ====
----
Облачный инструмент настройки проекта. Доступен в двух версиях: '''Lite''' (основной, подходит для всех задач) и '''Pro''' (расширенный, с доступом к коду и отладке). Запуск режима редактирования — клавиша '''F2'''.
'''Примечание''': Редактор предоставляет удобный визуальный интерфейс для интеграторов и владельцев, не требуя глубоких знаний программирования.


==== '''Облако XIOT''' ====
== 🧩 '''Компоненты платформы XIOT''' ==
Сервис, обеспечивающий хранение проектов, загрузку обновлений, защищённую связку между контроллером и внешними интерфейсами.
'''Примечание''': Облако XIOT также служит резервным хранилищем для проектов и обеспечивает доступ к проектам из любой точки мира, а также позволяет синхронизировать данные между различными устройствами.


==== '''Приложение XIOT''' ====
'''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>.
Мобильное приложение, которое предоставляет пользователям и владельцам удобный интерфейс для управления системой автоматизации. Приложение поддерживает доступ к проектам, позволяет управлять устройствами, запускать сценарии и получать уведомления.
'''Примечание''': Приложение доступно для устройств на платформе iOS и Android и позволяет пользователям взаимодействовать с системой в любом месте, обеспечивая гибкость и удобство в управлении.


=== 🧱 Структура проекта ===
'''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, без доступа к настройкам проекта.
Шаблон, определяющий функциональность и внешний вид устройства: например, лампа, термостат, розетка.
'''Примечание''': Каждый тип устройства может иметь свои уникальные параметры и особенности настройки.


==== '''Тип логики''' ====
----
Шаблон логического сценария: по времени, по событию, по кнопке, биоритм, рассвет, недельное расписание и т.д.
'''Примечание''': Типы логики позволяют создать гибкие сценарии с возможностью настройки по индивидуальному расписанию или событиям.


=== 👥 Роли и доступ ===
== 🔁 '''Основные процессы''' ==


==== '''Интегратор''' ====
'''Передача проекта новому владельцу''' — административная смена владельца проекта после подтверждения сторон. Точный порядок и последствия для ролей и доступов приведены в статье [[Transfer-project-to-new-owner|Передача проекта новому владельцу]].
Создаёт проект, настраивает структуру, сценарии и устройства, устанавливает и обновляет XIOT-PLC. Может передать проект Владельцу.
'''Примечание''': Интегратор имеет полный доступ к настройкам проекта и может взаимодействовать с системными компонентами, но не имеет прав на управление пользователями.


==== '''Владелец''' ====
'''Привязка 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 также служит резервным хранилищем для проектов и обеспечивает доступ к проектам из любой точки мира, а также позволяет синхронизировать данные между различными устройствами.
 
==== '''Интерфейс пользователя''' ====
Доступен в локальной сети и через облако. Отображает состояния, позволяет запускать сценарии и управлять системой.
'''Примечание''': Интерфейс пользователя интуитивно понятен и предоставляет все необходимые инструменты для управления системой, будь то с мобильного устройства или с рабочего стола.

Текущая версия от 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-подключения.