Виртуальные устройства XIOT
Виртуальное устройство XIOT — логический объект проекта: дом, часть дома, комната, датчик, исполнительное устройство или системный элемент. Оно отделяет интерфейс и сценарии от конкретного физического оборудования. При замене оборудования интегратор может назначить характеристикам новые адреса, не создавая заново сам виртуальный объект, если назначение и логика сигналов остались совместимыми.
Как устроен проект
Дом содержит части дома (этажи или зоны), части дома — комнаты, а комнаты — устройства. Эта структура помогает строить интерфейс и сценарии. Дом, часть дома и комната также имеют собственные характеристики и могут собирать состояния вложенных устройств; точный набор и поведение зависят от типа, активных характеристик и конфигурации. Не предполагайте, что любая общая команда автоматически управляет каждым дочерним устройством.
Устройство и его характеристики существуют в проекте независимо от физического адреса. К характеристике при необходимости подключают адрес управления для команды и адрес состояния для значения или обратной связи. У части логических характеристик физической привязки нет. Режим ожидания ответа, работа без одного из адресов и ограничения ручного управления описаны в Механизм работы тегов в XIOT.
В Lite редактор строит типовой интерфейс из структуры проекта; в Pro интегратор может верстать собственные страницы того же проекта. Это не означает, что каждый технический объект обязан отображаться у владельца. Подробнее: Lite и Pro версии редактора.
Правки в редакторе сами по себе не меняют конфигурацию XIOT-PLC. Отдельное Сохранить проект сохраняет проект локально для дальнейшей работы. Команда Загрузить конфигурацию на контроллер сначала выполняет локальное сохранение и только после его успеха отправляет сохранённый снимок на привязанный XIOT-PLC. Облачная синхронизация и публикация приложения имеют отдельные статусы: успешная загрузка на контроллер не подтверждает их завершение. Подробнее: Сохранение резервной копии проекта. Загруженная автоматика исполняется на XIOT-PLC локально, но доступность внешних сервисов и удалённого управления зависит от их связи и настроек.
Как пользоваться каталогом
- Создайте структуру проекта по инструкции Создание виртуальных устройств: дом → часть дома (этаж или зона) → комната → устройства.
- Выберите ниже тип виртуального устройства. Если для него есть ссылка подробнее, откройте отдельную карточку; для недавно добавленных типов краткое описание приведено прямо в каталоге.
- Настройте нужный физический интерфейс в разделе Настройка драйверов и получите фактические адреса каналов.
- Выполните привязку: адрес управления отправляет команду, адрес состояния принимает фактическое значение или обратную связь.
- Нажмите Загрузить конфигурацию на контроллер. Дождитесь успешного локального сохранения и загрузки, затем проверьте связь с XIOT-PLC. Статусы облачной синхронизации и публикации приложения проверяйте отдельно.
- Проверьте на объекте команду, физическую реакцию и обратную связь. Наличие адреса или изменение значения в редакторе само по себе не подтверждает работу оборудования.
Перечень сверен 16 сентября 2026 года по актуальным исходникам XIOT-EDITOR и XIOT-PLC: в схеме редактора и классах устройств контроллера есть 48 типов, включая дом, часть дома и комнату. Плеер, кубик и автоматический выключатель включены ниже. Наличие реализации не означает поддержку любой модели оборудования или всех интерфейсов: проверяйте установленную версию контроллера, конкретный драйвер, привязки и результат на объекте. Состав старого публичного пакета 14.1-1-1 не определяет возможности актуальных исходников.
1. Дом 
Системное устройство верхнего уровня: присутствие, общие команды света, время контроллера, признаки дня/ночи и агрегированные состояния частей дома.
2. Этаж (часть дома) 
Группирует комнаты в этаж или зону, управляет светом этой зоны и передает агрегаты движения, света и нагрева в дом.
3. Комната 
Центральный агрегатор помещения: свет, сцены, шторы, климатические устройства, датчики и статусы комнаты.
4. Светильник 
Управляет светом: включение, яркость, цветовая температура, цвет и плавное диммирование.
5. Переключатель 
Логический выключатель с действиями при включении и выключении.
6. Розетка 
Управляет питанием розетки и поддерживает автоматическое выключение после включения.
7. Карниз 
Управляет шторами, жалюзи и рулонными системами: открытие, закрытие, стоп и позиция в процентах.
8. Вентилятор 
Передает команды включения, направления и скорости вращения физическому вентилятору или шлюзу.
9. Кондиционер 
Управляет кондиционером, агрегирует датчики температуры и рассчитывает статусы нагрева и охлаждения по уставке.
10. Кран 
Управляет водяным краном или клапаном: открытие, закрытие, позиция и связанные реле.
11. Тёплый пол 
Терморегулятор электрического или водяного тёплого пола с режимами комфорта пола и воздуха, реле, сервоприводом и программной диагностикой. Программные отключения не заменяют аппаратную защиту.
12. Климат-контроль 
Центральная логика климата комнаты: сезон, режимы, уставки, кондиционеры, радиаторы, конвекторы и тёплые полы.
13. Радиатор 
Управляет отопительным радиатором по температуре воздуха через реле или сервопривод.
14. Конвектор 
Управляет отопительным конвектором, нагревом и скоростью вентилятора.
15. Приточная вентиляция 
Хранит команды приточной установки и агрегирует CO₂, VOC, качество воздуха и влажность от датчиков.
16. Сирена 
Простое исполнительное устройство для включения и выключения сирены или тревожного выхода.
17. Реле 
Технический дискретный выход для исполнительных цепей и других виртуальных устройств.
18. Сервопривод 
Управляет термоэлектрическим приводом клапана через медленный ШИМ на реле.
19. Клапан вентиляции 
Технический исполнительный клапан вентиляционной зоны: включение, процент открытия и ограничения минимального и максимального положения заслонки.
20. Видеокамера 
При доступном видеопотоке и установленном ffmpeg получает кадр и передаёт превью в интерфейс.
21. Зуммер 
Управляет короткими звуковыми сигналами, громкостью, частотой и серией импульсов.
22. Кнопка 
Обрабатывает касание, отпускание, одиночные/двойные/тройные клики и удержание; управляет светом, шторами, устройствами и действиями.
23. Пульт 
Передает команды AV-устройствам: питание, входы, меню, курсор, цифры, плеер, громкость и обложка трека.
24. Датчик температуры 
Принимает температуру, проверяет диапазон, учитывает калибровку, ошибку, батарейку и передает данные в комнату.
25. Датчик движения 
Фиксирует движение по контакту или уровню, управляет устройствами и запускает действия по таймеру.
26. Датчик шума 
Определяет сильный шум по усредненному уровню и передает уровень шума в комнату.
27. Датчик углекислого газа 
Контролирует уровень CO₂, флаг высокого содержания и действия по порогу.
28. Геркон 
Контролирует открытие двери, окна или технического контакта и передает статус в комнату.
29. Датчик давления 
Для реализованного профиля 0,5–4,5 В / 0–12 бар рассчитывает давление и усредняет до трёх последних значений.
30. Датчик протечки воды 
Фиксирует протечку, формирует тревожное событие XIOT и передаёт статус в комнату и сценарии защиты.
31. Датчик дождя 
Фиксирует дождь по сухому контакту или уровню с порогом и задержкой сброса.
32. Датчик ветра 
Хранит признак сильного ветра и может использоваться сценариями защиты наружных устройств.
33. Датчик конденсата 
Фиксирует конденсат, запускает действия и передает агрегированный статус в комнату.
34. Датчик освещенности 
Принимает освещенность в люксах, рассчитывает процент и передает значения в комнату.
35. Датчик влажности 
Принимает влажность, проверяет диапазон, учитывает калибровку и передает данные в комнату.
36. Датчик качества воздуха 
Рассчитывает качество воздуха по VOC с порогами, гистерезисом и действиями по уровням.
37. Датчик дыма 
Хранит признак дыма и при срабатывании формирует тревожное событие XIOT. Доставка внешнего уведомления зависит от отдельно настроенного канала.
38. Счетчик воды 
Хранит расход воды и может увеличивать значение по импульсам сухого контакта.
39. Счетчик электроэнергии 
Хранит значение потребления электроэнергии от связанного счетчика или интеграции.
40. Вольтметр 
Хранит напряжение и сглаживает небольшие колебания входных значений.
41. Амперметр 
Хранит силу тока и фильтрует шум по абсолютному и относительному порогу.
42. Ваттметр 
Хранит текущее потребление мощности в ваттах.
43. Увлажнитель 
Управляет увлажнением по текущей и целевой влажности через связанное реле.
44. Экран кинотеатра 
Управляет моторизированным экраном: открытие, закрытие, стоп, позиция и релейная логика движения.
45. Насос
Принимает запросы на работу от логики, учитывает аварийную блокировку и может сформировать команду выключения по тайм-ауту, если запрос перестал обновляться.
46. Плеер
Виртуальное AV-устройство для команд воспроизведения и получения состояния медиаплеера. Обязательные характеристики — PlayerCommand (команда воспроизведения) и CurrentMediaState (текущее состояние). Дополнительно предусмотрены питание, выбор источника, громкость и сведения о треке, если их передаёт интеграция.
Сам объект не подключает музыкальные сервисы и не воспроизводит звук на XIOT-PLC. Команды и обратную связь нужно связать с поддерживаемым оборудованием через настроенный драйвер.
47. Кубик
Устройство ввода, которое принимает жесты кубика и запускает назначенные действия. Основная характеристика — CubeAction; дополнительные — текущая грань, исходная и конечная грани, угол вращения, режим и заряд батареи. Доступность значений зависит от физического кубика и его интеграции.
Адрес жеста назначают вручную. Для управления светом или шторами вращением также нужны активные привязки грани и угла вращения; одно добавление виртуального кубика не создаёт эти связи.
48. Автоматический выключатель
Виртуальный объект управляемого автоматического выключателя с характеристиками On и EmergencyBlock. При наличии соответствующих каналов оборудования можно добавить состояние аварии защиты, причину отключения и электрические измерения.
При получении активной аварии защиты логика фиксирует аварийную блокировку и формирует команду выключения. Снятие сигнала аварии само по себе не снимает блокировку; пока авария активна, сброс блокировки отклоняется. Это программная логика: виртуальный объект не заменяет физический аппарат защиты, а команда выключения не доказывает отключение цепи.