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

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

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


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


«умный дом», «умное здание», промышленные объекты. 
== '''Основные действия''' ==


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


Конфигурация создаётся в облачном редакторе и исполняется на локальном контроллере, обеспечивая автономность и стабильность.
{| 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 основное внимание уделено проводным технологиям на стандартизированных протоколах (KNX, Modbus, DALI) для обеспечения максимальной надёжности и интеграции.
Обычная последовательность: установить XIOT-PLC → привязать XIOT-PLC к проекту → настроить драйвер XIOT → назначить адреса управления и состояния → выполнить '''Загрузить конфигурацию на контроллер''' → проверить оборудование и сценарии. Для самостоятельной контрольной точки используйте '''Сохранить проект'''. Во время сохранения и загрузки не редактируйте проект; результат каждой операции проверяйте отдельно.


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


=== '''XIOT-PLC''' ===
----
Программный модуль, устанавливаемый на контроллер Linux (Wiren Board, JetHome и др.). 
Исполняет проект, созданный в редакторе: обрабатывает сценарии, данные датчиков и события, управляет оборудованием и интерфейсами. 


'''💡 Примечание:''' XIOT-PLC может работать с интерфейсами Modbus, MQTT, KNX, HTTP API и другими протоколами.
== 🧩 '''Компоненты платформы XIOT''' ==
 
---
 
=== '''Редактор XIOT''' ===
Облачный визуальный инструмент настройки проекта. 
Позволяет интегратору создавать структуру дома, добавлять устройства, сценарии и интерфейсы. 
 
Версии:
* '''Lite''' — базовая, подходит для всех задач и автоматического построения интерфейса; 
* '''Pro''' — расширенная, с возможностью создания кастомных страниц, интеграций и отладки. 
 
'''💡 Примечание:''' Для входа в режим редактирования используется клавиша '''F2'''. Редактор не требует знаний программирования.
 
---
 
=== '''XIOT-CLOUD''' ===
Облачный сервис, обеспечивающий хранение проектов, синхронизацию, обновления и связь между контроллерами и интерфейсами. 
Служит центральным звеном экосистемы 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>.


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


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


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


---
----


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


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


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


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


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


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


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


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


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


---
----


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


=== '''Тег''' ===
'''Адрес связи''' — идентификатор источника или приёмника значения в настроенном драйвере XIOT. Для исходящей команды используется адрес управления, для входящего фактического значения — адрес состояния.
Переменная, отображающая значение или состояние (температура, реле, команда). 
Обеспечивает связь между физическими устройствами, виртуальными объектами и сценариями.
 
---
 
=== '''Сценарий''' ===
Логика поведения системы: по времени, событию, датчику или кнопке. 
Может содержать условия, циклы, задержки и комбинации действий.
 
📘 '''Примеры:'''
* Включение света при движении 💡 
* Отключение воды при протечке 💧 
* Изменение температуры по расписанию 🕒 
 
Сценарии выполняются на уровне контроллера XIOT-PLC и работают автономно от облака.
 
---
 
=== '''Тип устройства''' ===
Шаблон, определяющий функциональность и визуальное отображение устройства (лампа, термостат, розетка и т.д.).
 
---


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


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


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


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


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


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


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


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