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

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

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


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


Конфигурация создаётся в облачном редакторе '''XIOT-EDITOR''' и выполняется на локальном контроллере '''XIOT-PLC''', что гарантирует автономность, безопасность и стабильность работы даже без доступа к интернету. 
== '''Основные действия''' ==


💡 В XIOT особое внимание уделено:
Эти действия не заменяют друг друга. Для поиска в старых материалах могут встречаться названия «тег управления», «тег статуса» и «тег состояния»; в актуальной документации используются термины '''адрес управления''' и '''адрес состояния'''.
* '''надёжности проводных технологий''' — система базируется на открытых стандартах '''KNX''', '''Modbus''', '''DALI''', обеспечивая точное и предсказуемое управление оборудованием;
* '''интуитивно понятному пользовательскому интерфейсу''' — приложение и веб-интерфейсы разработаны так, чтобы взаимодействие с системой было простым и логичным даже для неподготовленного пользователя;
* '''удобству работы интеграторов''' — облачный редактор позволяет проектировать, настраивать и тестировать систему без программирования, с мгновенной синхронизацией изменений и визуальным контролем всех параметров.


XIOT объединяет инженерную точность с современным дизайном интерфейсов, создавая комфортную и надёжную среду управления домом или зданием.
{| class="wikitable" style="width:100%"
== 🧩 '''Компоненты платформы XIOT''' ==
! Термин !! Что означает !! Важно
|-
| '''Сохранить проект''' || Явно зафиксировать локальную датированную копию проекта. Отдельное сохранение удобно как контрольная точка, особенно во время вёрстки интерфейса в 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 и др.).  


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


=== '''Редактор XIOT''' ===
----
Облачный визуальный инструмент настройки проекта.   


Позволяет интегратору создавать структуру дома, добавлять устройства, сценарии и интерфейсы. 
== 🧩 '''Компоненты платформы XIOT''' ==
 
Версии:
* '''Lite''' — основная, подходит для всех задач и автоматического построения интерфейса;
* '''Pro''' — расширенная, с возможностью создания кастомных страниц, интеграций и отладки. 


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


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


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


Работает в локальной сети и облако XIOT-CLOUD.
----


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


=== '''Проект''' ===
'''Проект''' — конфигурация системы, включающая этажи, комнаты, устройства и сценарии.
Главная конфигурация системы, включающая этажи, комнаты, устройства и сценарии.
 
=== '''Этаж (часть здания)''' ===
Логическая группа комнат.
 
=== '''Комната''' ===
 
 
=== '''Устройство''' ===
Общее понятие, объединяющее как реальные (физические), так и программные (виртуальные) компоненты. 
Отображается в структуре проекта и пользовательском интерфейсе.


== ⚙️ '''Устройства в XIOT''' ==
'''Этаж''' — логическая группа комнат, используется для структурирования проекта и визуального отображения.


=== '''Физическое устройство''' ===
'''Комната''' — логическая единица проекта, содержащая устройства, сценарии и характеристики помещения (температура, освещённость, активность и др.).
Реальное оборудование, подключённое к системе XIOT через один из поддерживаемых протоколов: KNX, Modbus, MQTT, HTTP и др.


📘 '''Примеры:'''
'''Устройство''' — элемент системы, объединяющий физические и виртуальные компоненты.  
* Датчик температуры 🌡️ 
* Релейный модуль ⚡ 
* KNX-кнопка 🔘 
* Modbus-регулятор 🔄  


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


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


=== '''Виртуальное устройство''' ===
'''Физическое устройство''' — реальное оборудование, подключённое по протоколам KNX, Modbus, MQTT и др.   
Создаётся интегратором в редакторе и представляет собой логическую модель оборудования.   
Обменивается данными с XIOT-PLC через драйвер XIOT, адрес управления и адрес состояния.
Может быть связано с физическим устройством или работать как виртуальный элемент (например, счётчик, сцена, датчик логики).


'''Каждое устройство имеет:'''
'''Виртуальное устройство''' — логическая модель оборудования, создаваемая интегратором в редакторе.  
* тип (лампа, термостат, реле, счётчик); 
Может быть связано с физическим устройством или работать автономно.
* название и иконку; 
* характеристики (управляющие и статусные теги);  
* визуальные параметры отображения.


---
----


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


=== '''Тег''' ===
'''Адрес связи''' — идентификатор источника или приёмника значения в настроенном драйвере XIOT. Для исходящей команды используется адрес управления, для входящего фактического значения — адрес состояния.
Переменная, отображающая значение или состояние (температура, реле, команда).
Обеспечивает связь между физическими устройствами, виртуальными объектами и сценариями.


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


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


📘 '''Примеры:'''
'''Тип логики''' — шаблон сценария (по времени, событию, рассвету, циклу и т.д.).
* Включение света при движении 💡 
* Отключение воды при протечке 💧 
* Изменение температуры по расписанию 🕒 


Сценарии выполняются на уровне контроллера XIOT-PLC и работают автономно от облака.
----


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


=== '''Тип устройства''' ===
'''Интегратор''' — создаёт проект, настраивает устройства и сценарии, устанавливает XIOT-PLC на поддерживаемое устройство-хост и привязывает его к проекту.
Шаблон, определяющий функциональность и визуальное отображение устройства (лампа, термостат, розетка и т.д.).
Может передавать проект владельцу.


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


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


---
----
 
== 👥 '''Роли и доступ''' ==
 
=== '''Интегратор''' ===
Создаёт проект, настраивает структуру, устройства и сценарии. 
Отвечает за установку и обновление XIOT-PLC, может передать проект владельцу.
 
---
 
=== '''Владелец''' ===
Финальный собственник системы. 
Может управлять пользователями, ограничивать доступ интегратора или назначать нового. 
Всегда имеет полный административный контроль.
 
---
 
=== '''Пользователь''' ===
Использует систему через интерфейс XIOT-APP. 
Может управлять устройствами и сценами, но не редактировать проект.
 
---


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


=== '''Передача проекта''' ===
'''Передача проекта новому владельцу''' — административная смена владельца проекта после подтверждения сторон. Точный порядок и последствия для ролей и доступов приведены в статье [[Transfer-project-to-new-owner|Передача проекта новому владельцу]].
Процесс смены владельца: 
* интегратор остаётся разработчиком; 
* пользователи удаляются; 
* новый владелец получает полный контроль.
 
Работа системы при этом не прерывается.
 
---
 
=== '''Привязка контроллера''' ===
Процесс соединения установленного XIOT-PLC с проектом в редакторе через уникальный ID. 
После привязки контроллер синхронизируется с облаком и начинает выполнение сценариев.
 
---
 
== 🌐 '''Взаимодействие и управление''' ==
 
=== '''Облако XIOT''' ===
Обеспечивает безопасное соединение, синхронизацию данных, обновления и резервное хранение конфигурации.


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


=== '''Интерфейс пользователя''' ===
----
Доступен через локальную сеть или облако. 
Позволяет управлять устройствами, запускать сценарии и контролировать состояние системы. 
Интерфейс адаптирован под мобильные и настольные устройства 💻📱.

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