Просмотр кода страницы Creating-devices

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

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

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

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

== Назовите дом ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== См. также ==

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

[[Категория:Документация XIOT]]