Creating-devices: различия между версиями

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

Виртуальное устройство — объект проекта XIOT: оно задаёт структуру дома, свойства устройства и точки для сценариев и интерфейса. Физические каналы подключаются к нужным характеристикам отдельно. В этом порядке сначала создают структуру, затем устройства внутри комнат.

Перед началом

Откройте нужный проект в актуальном XIOT-EDITOR и перейдите в раздел Устройства и сценарии. В заголовке окна есть переключатель Интерфейс: Старый и Новый (бета). Это два варианта окна в текущем редакторе, а не два разных проекта; переключение не переносит и не заменяет данные проекта.

Для шагов создания структуры ниже выберите Старый. Добавление устройства через новый интерфейс описано отдельно в этой же статье. Убедитесь, что у вас есть права изменения и выбран нужный проект.

Назовите дом

Откройте Настройки дома и укажите название, по которому владелец узнает свой объект в интерфейсе. Имя дома относится к проекту, а не к адресу физического контроллера.

Результат: новое название видно в структуре проекта.

Создайте этаж или зону

В структуре дома нажмите Создать этаж и назовите добавленную часть дома в Настройках этажа. Часть дома может обозначать этаж, крыло или другую понятную зону объекта; не обязательно повторять строительную нумерацию. Для следующей зоны повторите действие.

Результат: нужная часть дома видна под домом и готова содержать комнаты.

Создайте комнату

Выберите нужный этаж или зону, нажмите Создать комнату и задайте её название в Настройках комнаты. Проверьте родительскую часть дома: комната должна оказаться в выбранной зоне, а не в соседней. Создайте остальные комнаты по плану объекта.

Результат: комнаты находятся в правильных частях дома и имеют понятные пользователю названия.

Добавьте устройство

Выберите комнату, где устройство должно отображаться и участвовать в логике.
Нажмите Создать устройство и выберите тип по его назначению, например свет (в каталоге — Светильник) для освещения или датчик температуры для измерения.
Назовите устройство так, чтобы его можно было отличить от других устройств той же комнаты.
Откройте настройки созданного устройства и проверьте его характеристики. Набор и смысл характеристик зависят от типа; сверяйтесь с каталогом и карточкой выбранного типа.

Результат: виртуальное устройство видно в нужной комнате. Оно ещё не управляет физическим оборудованием: для этого требуются драйвер, адреса и загрузка конфигурации.

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

Добавление через новый интерфейс

Переключите Интерфейс на Новый (бета) и выберите существующую комнату в дереве проекта.
Откройте вкладку Устройства и нажмите Добавить устройство.
Проверьте поле Расположение, найдите тип через Найти тип и нажмите его карточку. Устройство сразу добавляется в текущую конфигурацию.
У созданного устройства на вкладке Основное задайте Название, затем перейдите в Характеристики. Дополнительные характеристики включайте только при необходимости.

Оба варианта окна редактируют ту же структуру проекта. Создание и переименование объекта не заменяют сохранение проекта и загрузку на контроллер.

Следующий шаг

Настройте нужный драйвер, получите действительные адреса физических каналов и выполните привязку характеристик. После этого примените конфигурацию на XIOT-PLC и проверьте физическую реакцию. Сценарии создавайте после проверки базовых каналов: Создание сценариев.

Если интерфейс проекта уже верстается в Pro, отдельная команда Сохранить проект сохраняет локальную контрольную точку без загрузки на контроллер. Команда Загрузить конфигурацию на контроллер сначала ждёт успешного локального сохранения, затем отправляет сохранённый снимок. Облачная синхронизация и публикация приложения проверяются отдельно: Сохранение резервной копии проекта.

Если не получилось

Нет кнопки создания: проверьте выбранный вариант окна, права доступа и родительский объект. Для добавления устройства нужна уже созданная комната; в новом окне кнопка находится на вкладке Устройства.
Комната или устройство попали не туда: проверьте выбранный этаж и комнату до дальнейшей настройки адресов.
Тип есть в меню, но не описан в каталоге: уточните версию и поддержку типа в установленном XIOT-PLC. Одно наличие пункта меню не подтверждает совместимость конкретного оборудования.
Устройство создано, но не реагирует: одно создание виртуального объекта не настраивает физическую связь. Перейдите к привязке и приёмке на объекте.

См. также

Первая лампа в XIOT — полный пример от создания до физической проверки.
Lite и Pro версии редактора — автоматический интерфейс и кастомная вёрстка одного проекта.

@@ Строка 1: / Строка 1: @@
-__NOTOC__
+{{DISPLAYTITLE:Создание виртуальных устройств}}
+'''Виртуальное устройство''' — объект проекта XIOT: оно задаёт структуру дома, свойства устройства и точки для сценариев и интерфейса. Физические каналы подключаются к нужным характеристикам отдельно. В этом порядке сначала создают структуру, затем устройства внутри комнат.
-= 🏗️ Настройка структуры проекта: Этажи, комнаты и устройства =
+== Перед началом ==
-== 📌 Общее описание ==
+Откройте нужный проект в актуальном XIOT-EDITOR и перейдите в раздел '''Устройства и сценарии'''. В заголовке окна есть переключатель '''Интерфейс''': '''Старый''' и '''Новый (бета)'''. Это два варианта окна в текущем редакторе, а не два разных проекта; переключение не переносит и не заменяет данные проекта.
-Для настройки структуры проекта в редакторе XIOT (добавление этажей, комнат и устройств), нажмите на иконку '''«Лампочка»''' под номером '''7''' в интерфейсе редактора:
+Для шагов создания структуры ниже выберите '''Старый'''. Добавление устройства через новый интерфейс описано отдельно в этой же статье. Убедитесь, что у вас есть права изменения и выбран нужный проект.
-[[File:Xiot_18_2.png|400px]]
+== Назовите дом ==
+Откройте '''Настройки дома''' и укажите название, по которому владелец узнает свой объект в интерфейсе. Имя дома относится к проекту, а не к адресу физического контроллера.
-<div style="border:1px solid #ccc; background-color:#f9f9f9; padding:10px; margin:10px 0; border-left:5px solid #36c;">
+'''Результат:''' новое название видно в структуре проекта.
-'''❓ Подсказка: Зачем нужны виртуальные устройства в XIOT'''
-В платформе XIOT устройства делятся на '''виртуальные''' и '''физические'''. Это сделано для повышения гибкости и отказоустойчивости системы.
+== Создайте этаж или зону ==
-Если физическое устройство добавляется напрямую, его уникальный ID используется в сценариях. При замене такого устройства сценарии теряют связь, и интегратору приходится вручную всё перепривязывать.
+В структуре дома нажмите '''Создать этаж''' и назовите добавленную часть дома в '''Настройках этажа'''. Часть дома может обозначать этаж, крыло или другую понятную зону объекта; не обязательно повторять строительную нумерацию. Для следующей зоны повторите действие.
-Виртуальные устройства решают эту проблему: они сохраняются в структуре проекта, а физическое оборудование привязывается к ним через теги. При замене оборудования достаточно просто подключить новое устройство к тому же виртуальному объекту — вся логика и сценарии продолжат работать без изменений.
+'''Результат:''' нужная часть дома видна под домом и готова содержать комнаты.
-Помимо обычных устройств (освещение, розетки, датчики и т.д.), в XIOT предусмотрены и '''абстрактные виртуальные устройства''': '''Дом''', '''Этаж''' и '''Комната'''. Они формируют структуру проекта и позволяют удобно организовывать логику и интерфейс управления.
+== Создайте комнату ==
-Эти устройства обладают характеристиками, отражающими состояние группы вложенных в них устройств. Например:
+Выберите нужный этаж или зону, нажмите '''Создать комнату''' и задайте её название в '''Настройках комнаты'''. Проверьте родительскую часть дома: комната должна оказаться в выбранной зоне, а не в соседней. Создайте остальные комнаты по плану объекта.
-* '''Комната''' может отображать, включён ли свет, есть ли движение, среднюю температуру или уровень освещённости.
-* '''Этаж''' может агрегировать параметры всех комнат, входящих в него.
-* '''Дом''' управляет общими сценариями (например, режимы "Я дома" / "Я не дома") и может активировать соответствующие действия при приходе или уходе жильцов.
-Такая архитектура позволяет централизованно управлять логикой и строить удобный пользовательский интерфейс.
+'''Результат:''' комнаты находятся в правильных частях дома и имеют понятные пользователю названия.
-</div>
-== 🏠 Название дома ==
+== Добавьте устройство ==
-Введите название дома в меню '''«Настройки дома»''' (см. цифры '''1''' и '''2''' на рисунке). Это название будет отображаться в пользовательском интерфейсе.
+# Выберите комнату, где устройство должно отображаться и участвовать в логике.
+# Нажмите '''Создать устройство''' и выберите тип по его назначению, например '''свет''' (в каталоге — '''Светильник''') для освещения или '''датчик температуры''' для измерения.
+# Назовите устройство так, чтобы его можно было отличить от других устройств той же комнаты.
+# Откройте настройки созданного устройства и проверьте его характеристики. Набор и смысл характеристик зависят от типа; сверяйтесь с [[Xiot-devices|каталогом]] и карточкой выбранного типа.
-[[File:Xiot_21_1.png|600px]]
+'''Результат:''' виртуальное устройство видно в нужной комнате. Оно ещё не управляет физическим оборудованием: для этого требуются драйвер, адреса и загрузка конфигурации.
-📌 Подробности — в разделе [[Настройки дома]].
+В актуальных исходниках редактора и контроллера есть '''Плеер''', '''Кубик''' и '''Автоматический выключатель'''. Прежнее ограничение плеера относилось к старому публичному пакету. Для объекта всё равно нужно проверить совместимость установленного XIOT-PLC, драйвера и физического оборудования.
-== 🏢 Создание этажей ==
+== Добавление через новый интерфейс ==
-Нажмите кнопку '''«Создать этаж»''' (цифра '''3''' на рисунке) для добавления уровня/группы. Можно создать любое количество этажей по структуре вашего объекта.
+# Переключите '''Интерфейс''' на '''Новый (бета)''' и выберите существующую комнату в дереве проекта.
+# Откройте вкладку '''Устройства''' и нажмите '''Добавить устройство'''.
+# Проверьте поле '''Расположение''', найдите тип через '''Найти тип''' и нажмите его карточку. Устройство сразу добавляется в текущую конфигурацию.
+# У созданного устройства на вкладке '''Основное''' задайте '''Название''', затем перейдите в '''Характеристики'''. Дополнительные характеристики включайте только при необходимости.
-[[File:Xiot_21_1.png|600px]]
+Оба варианта окна редактируют ту же структуру проекта. Создание и переименование объекта не заменяют сохранение проекта и загрузку на контроллер.
-== 📝 Название этажей ==
+== Следующий шаг ==
-Назовите каждый этаж через меню '''«Настройки этажа»''' (цифры '''2''' и '''3'''). Название отобразится в пользовательском интерфейсе.
+Настройте [[Driver-setup|нужный драйвер]], получите действительные адреса физических каналов и выполните [[Device-bindings|привязку характеристик]]. После этого примените конфигурацию на XIOT-PLC и проверьте физическую реакцию. Сценарии создавайте после проверки базовых каналов: [[Creating-scenarios|Создание сценариев]].
-[[File:Xiot_21_2.png|600px]]
+Если интерфейс проекта уже верстается в Pro, отдельная команда '''Сохранить проект''' сохраняет локальную контрольную точку без загрузки на контроллер. Команда '''Загрузить конфигурацию на контроллер''' сначала ждёт успешного локального сохранения, затем отправляет сохранённый снимок. Облачная синхронизация и публикация приложения проверяются отдельно: [[Project-backup|Сохранение резервной копии проекта]].
-📌 Подробнее — в разделе [[Настройки этажа]].
+== Если не получилось ==
-== 🚪 Создание комнат ==
+* '''Нет кнопки создания:''' проверьте выбранный вариант окна, права доступа и родительский объект. Для добавления устройства нужна уже созданная комната; в новом окне кнопка находится на вкладке '''Устройства'''.
+* '''Комната или устройство попали не туда:''' проверьте выбранный этаж и комнату до дальнейшей настройки адресов.
+* '''Тип есть в меню, но не описан в каталоге:''' уточните версию и поддержку типа в установленном XIOT-PLC. Одно наличие пункта меню не подтверждает совместимость конкретного оборудования.
+* '''Устройство создано, но не реагирует:''' одно создание виртуального объекта не настраивает физическую связь. Перейдите к привязке и приёмке на объекте.
-Нажмите кнопку '''«Галочка»''' (цифра '''1''').
+== См. также ==
-Затем нажмите кнопку '''«Создать комнату»''' (цифра '''4''').
+* [[First-light-in-xiot|Первая лампа в XIOT]] — полный пример от создания до физической проверки.
+* [[Editor-lite-and-pro|Lite и Pro версии редактора]] — автоматический интерфейс и кастомная вёрстка одного проекта.
-[[File:Xiot_21_2.png|600px]]
+[[Категория:Документация XIOT]]
+{{DEFAULTSORT:Создание виртуальных устройств}}
-== 🏷️ Название комнат ==
-Укажите названия в меню '''«Настройки комнаты»''' (цифры '''2''' и '''3'''). Названия будут использоваться в интерфейсе.
-[[File:Xiot_21_3.png|600px]]
-📌 Подробнее — в разделе [[Настройки комнаты]].
-== 💡 Добавление виртуальных устройств ==
-Нажмите кнопку '''«Галочка»''' (цифра '''1''').
-Выберите '''«Создать устройство»''' (цифра '''4''').
-[[File:Xiot_21_3.png|600px]]
-Выберите нужный тип устройства из списка.
-📖 Список доступных типов приведён в разделе [https://blog.xiot.ru/%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0/ Устройства].
-[[File:Xiot_21_4.png|600px]]
-При необходимости упорядочите отображение устройств в интерфейсе:
-[[File:Xiot_21_5.png|600px]]
-== 📋 Дальнейшие шаги ==
-После создания структуры проекта выполните следующие действия:
-🔧 [[Настройка драйверов]] — настройка связи с реальными устройствами (KNX, Wirenboard и др.).
-🔗 [[Привязка реальных устройств к виртуальным]] — связывание физических тегов с виртуальными объектами.
-📜 [[Создание сценариев]] — создание логики автоматизации.

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