Перейти к содержанию

Xiot-tags

Материал из XIOT Wiki
Версия от 16:11, 23 августа 2026; Admin (обсуждение | вклад) (COR-06: единый словарь действий и адресов управления/состояния)

В системе XIOT характеристики виртуальных устройств взаимодействуют с физическим оборудованием через адреса, которые предоставляет настроенный драйвер XIOT. Адресом может быть, например, MQTT-топик Wiren Board или групповой адрес KNX.

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

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

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


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

✅ Ожидание обратной связи

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

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

Важно:

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

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

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

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

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

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

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

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

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

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

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

🔍 См. также