Xiot-tags

В системе XIOT все устройства и характеристики взаимодействуют с физическим оборудованием через теги. Тег — это ссылка на источник или приёмник значения: MQTT, Modbus, KNX и другие.

🔁 Общая логика

Каждая характеристика может использовать два типа тегов:

Тег для отправки — используется для передачи значения из системы в физическое устройство (на запись)
Тег для получения — используется для получения значения от физического устройства (на чтение)

Если пользователь изменяет характеристику вручную (через приложение) или это происходит в результате сценария, значение записывается в **тег отправки**. Если физическое устройство присылает новое значение, оно попадает в **тег получения**, и система обновляет характеристику.

📤 Тег для отправки значения

Этот тег используется при:

изменении значения в интерфейсе (вручную)
изменении значения по сценарию
запуске действия другим устройством

Система публикует новое значение в указанный тег:

MQTT: публикация в топик
Modbus: запись в регистр
KNX: отправка телеграммы в групповой адрес

📥 Тег для получения значения

Этот тег нужен, чтобы получать актуальное значение из физического устройства. Когда оборудование отправляет данные:

через MQTT (топик обновляется)
по Modbus (значение читается по опросу)
по шине KNX (входит телеграмма состояния)

Система записывает полученное значение в тег, и если он привязан к характеристике, она обновляется.

✅ Привязка значения характеристики к значению тега

В редакторе рядом с полем тег получения находится галочка, которая определяет способ обновления характеристики:

Если галочка включена — характеристика строго привязана к значению тега.

 При изменении значения (через интерфейс, сценарий или панель) система:
 * отправляет новое значение в тег управления,
 * но не меняет характеристику, пока это значение не вернётся обратно через тег получения.

 Это гарантирует, что физическое устройство действительно выполнило команду. Такой режим рекомендуется при работе с KNX, Modbus и другими системами с подтверждением.

Если галочка отключена — характеристика обновляется сразу после изменения, не дожидаясь подтверждения от устройства.

 Это полезно при отладке, тестировании, или если устройство не отправляет обратную связь.

Важно:

В устройствах не обязательно указывать теги во всех характеристиках.

 Некоторые характеристики служат как логические или системные и не требуют физической привязки.  
 Подробнее — в Описания устройств.

⚙️ Возможные конфигурации

Только тег отправки → характеристика управляет устройством, но не знает его текущее состояние
Только тег получения → характеристику нельзя изменить вручную, она только отображает входящие данные
Оба тега → полноценная двусторонняя связь: управление + подтверждение

📌 Примеры использования

🔧 Особенность для Wiren Board

При интеграции с контроллерами и модулями Wiren Board указывается базовый путь тега, без уточнений типа (`/on`, `/set`, `/meta` и др.).

XIOT автоматически добавляет нужные постфиксы:

Для тега получения → добавляется `/on` или соответствующий путь для чтения
Для тега отправки → добавляется `/on/set`, `/brightness/set` и т.д.

Например:

Указан путь: `/wb/relay/1`

 Система использует:
 * `/wb/relay/1/on` — как тег получения
 * `/wb/relay/1/on/set` — как тег отправки

Примеры устройств

Светильник с Modbus:

 * Тег отправки: /wb/relay/1
 * Тег получения: /wb/relay/1

Кнопка с входом WB-MDM3:

 * Тег получения: /wb/wb-mdm3_42/input 3

Выключатель KNX:

 * Тег отправки: 1/1/10
 * Тег получения: 1/1/11

🌐 Виртуальные устройства без физической привязки

В XIOT можно создавать устройства без привязки к физическому оборудованию:

Теги можно не указывать вовсе
Устройство будет отображаться в приложении и доступно для управления
Оно пробрасывается в систему Умный дом Яндекс (при включённой интеграции)
Можно строить сценарии, логики, панели и полностью проектировать систему без реального оборудования

Это удобно для:

демонстрационных стендов и презентаций
разработки интерфейсов
подготовки проекта до монтажа оборудования

🔧 Рекомендации

Всегда указывайте тег получения, если нужна подтверждённая обратная связь
Используйте галочку привязки, чтобы быть уверенным, что устройство реально выполнило команду
Не обязательно задавать теги во всех характеристиках — системные параметры могут работать автономно