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

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

Материал из XIOT Wiki
COR-07: исправлены подтверждённые битые внутренние ссылки
OLD-05B: актуальный порядок создания дома, зон, комнат и устройств
Строка 1: Строка 1:
== 🏗️ Настройка структуры проекта: Этажи, комнаты и устройства ==
'''Виртуальное устройство''' — объект проекта XIOT: оно задаёт структуру дома, свойства устройства и точки для сценариев и интерфейса. Физические каналы подключаются к нужным характеристикам отдельно. В этом порядке сначала создают структуру, затем устройства внутри комнат.


== 📌 Общее описание ==
== Перед началом ==


Для настройки структуры проекта в редакторе XIOT (добавление этажей, комнат и устройств), нажмите на иконку '''«Лампочка»''' под номером '''7''' в интерфейсе редактора:
Откройте нужный проект в XIOT-EDITOR и перейдите в раздел '''Устройства и сценарии'''. Если элементы нельзя изменять, включите режим редактирования клавишей '''F2''' (на некоторых ноутбуках — '''Fn+F2'''). Убедитесь, что редактируете нужный проект и нужную часть дома.


[[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|каталогом]] и карточкой выбранного типа.


[[File:Xiot_21_1.png|600px]]
'''Результат:''' виртуальное устройство видно в нужной комнате. Оно ещё не управляет физическим оборудованием: для этого требуются драйвер, адреса и загрузка конфигурации.


📌 Подробности — в разделе [[Создание виртуальных устройств#🏠 Название дома|«Название дома»]].
Тип '''Плеер''' сейчас виден в меню редактора, но для проверенного пакета XIOT-PLC 14.1-1-1 не подтверждён runtime-класс. Не добавляйте его в рабочий проект до обновления и отдельной приёмки.


== 🏢 Создание этажей ==
== Следующий шаг ==


Нажмите кнопку '''«Создать этаж»''' (цифра '''3''' на рисунке) для добавления уровня/группы. Можно создать любое количество этажей по структуре вашего объекта.
Настройте [[Настройка драйверов|нужный драйвер]], получите действительные адреса физических каналов и выполните [[Привязка реальных устройств к виртуальным|привязку характеристик]]. После этого примените конфигурацию на XIOT-PLC и проверьте физическую реакцию. Сценарии создавайте после проверки базовых каналов: [[Создание сценариев]].


[[File:Xiot_21_1.png|600px]]
Если интерфейс проекта уже верстается в Pro, отдельная команда '''Сохранить проект''' может служить самостоятельной контрольной точкой. Она не меняет конфигурацию контроллера; порядок сохранения и применения описан в [[Сохранение резервной копии проекта]].


== 📝 Название этажей ==
== Если не получилось ==


Назовите каждый этаж через меню '''«Настройки этажа»''' (цифры '''2''' и '''3'''). Название отобразится в пользовательском интерфейсе.
* '''Нет кнопки создания:''' проверьте режим редактирования, права доступа и выбранный родительский объект.
* '''Комната или устройство попали не туда:''' проверьте выбранный этаж и комнату до дальнейшей настройки адресов.
* '''Тип есть в меню, но не описан в каталоге:''' не используйте его как подтверждённый для текущего пакета XIOT-PLC; уточните версию и поддержку типа.
* '''Устройство создано, но не реагирует:''' одно создание виртуального объекта не настраивает физическую связь. Перейдите к привязке и приёмке на объекте.


[[File:Xiot_21_2.png|600px]]
== См. также ==


📌 Подробнее — в разделе [[Создание виртуальных устройств#📝 Название этажей|«Название этажей»]].
* [[Первая лампа в XIOT]] — полный пример от создания до физической проверки.
* [[Lite и Pro версии редактора]] — автоматический интерфейс и кастомная вёрстка одного проекта.


== 🚪 Создание комнат ==
[[Категория:Документация XIOT]]
 
Нажмите кнопку '''«Галочка»''' (цифра '''1''').
 
Затем нажмите кнопку '''«Создать комнату»''' (цифра '''4''').
 
[[File:Xiot_21_2.png|600px]]
 
== 🏷️ Название комнат ==
 
Укажите названия в меню '''«Настройки комнаты»''' (цифры '''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 и др.).
 
🔗 [[Привязка реальных устройств к виртуальным]] — связывание физических адресов управления и состояния с виртуальными объектами.
 
📜 [[Создание сценариев]] — создание логики автоматизации.

Версия от 21:08, 15 сентября 2026

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

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

Откройте нужный проект в XIOT-EDITOR и перейдите в раздел Устройства и сценарии. Если элементы нельзя изменять, включите режим редактирования клавишей F2 (на некоторых ноутбуках — Fn+F2). Убедитесь, что редактируете нужный проект и нужную часть дома.

Назовите дом

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

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

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

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

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

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

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

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

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

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

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

Тип Плеер сейчас виден в меню редактора, но для проверенного пакета XIOT-PLC 14.1-1-1 не подтверждён runtime-класс. Не добавляйте его в рабочий проект до обновления и отдельной приёмки.

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

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

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

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

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

См. также