Механизм работы тегов в XIOT

Материал из XIOT Wiki
Перейти к навигации Перейти к поиску


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

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

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

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


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

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

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

  • Если галочка включена — характеристика строго привязана к значению тега.
 При изменении характеристики система:
 * отправляет новое значение в тег управления,
 * но не меняет характеристику, пока это значение не вернётся обратно через тег статуса.
 Это гарантирует, что физическое устройство действительно выполнило команду. Такой режим рекомендуется при работе с KNX, Modbus и другими системами с подтверждением.
  • Если галочка отключена — характеристика обновляется сразу после изменения, не дожидаясь подтверждения от устройства.
 Это полезно при отладке, тестировании, или если устройство не отправляет обратную связь.
  • Включайте привязку только в характеристиках с заданным тэгом статуса.

Важно:

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

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

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

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

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

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

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

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

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

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

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

🔍 См. также

Источник — https://wiki.xiot.ru/index.php?title=Механизм_работы_тегов_в_XIOT&oldid=851