Creating-devices

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

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

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

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

Назовите дом

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

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