Device-bindings

Привязка связывает характеристику виртуального устройства с фактическими каналами оборудования. Настройка адресов в редакторе — ещё не доказательство работы на объекте: после загрузки конфигурации проверяют команду, физическую реакцию и обратную связь.

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

1. Создайте виртуальное устройство в нужной комнате: Создание виртуальных устройств.
2. Настройте соответствующий драйвер XIOT и проверьте, что нужный физический канал доступен в его списке адресов.
3. Уточните по схеме и настройкам оборудования, какой канал принимает команду и какой передаёт состояние. Не выбирайте адрес только по похожему названию.

Назначьте адреса характеристике

Откройте в XIOT-EDITOR раздел Устройства и сценарии, выберите виртуальное устройство и нужную характеристику. Для светильника начните с характеристики Включение; яркость, цвет и другие каналы настраивайте отдельно только при их наличии у оборудования.

Если в переключателе Интерфейс выбран Новый (бета), откройте у устройства вкладку Характеристики, при необходимости включите дополнительную характеристику и нажмите её кнопку Привязка тегов. В открывшемся блоке находятся оба адреса. Вкладка Привязки у устройства предназначена для связей с другими виртуальными объектами и не заменяет адреса физического канала у характеристики.

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

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

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

Результат: у каждой нужной характеристики указаны именно те адреса, которые относятся к её физическому каналу.

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

В новом окне рядом с адресом состояния есть флажок Связать управление с состоянием. Его название не означает «ждать ответ»:

• Флажок снят, оба адреса заданы: команда отправляется по адресу управления, а новое состояние ожидается из адреса состояния.
• Флажок установлен: после отправки команды локальное значение обновляется сразу, без ожидания ответа. Это не доказывает, что оборудование выполнило команду.
• Адрес состояния не задан: ждать подтверждение из него невозможно; снятый флажок не создаёт обратную связь.

Ожидание имеет смысл только тогда, когда настроенный физический канал действительно возвращает подходящее значение. Без такого ответа команда может быть отправлена, но подтверждение не будет получено. Приведённая схема описывает базовый механизм; специальные типы устройств могут дополнительно обрабатывать команды и входные значения.

Режим ожидания не заменяет права доступа и не делает характеристику «только для чтения». Подробная схема работы: Механизм работы тегов в XIOT.

Примените конфигурацию и проверьте результат

1. Проверьте выбранный проект, привязанный XIOT-PLC, типы значений и адреса всех изменённых характеристик.
2. Нажмите Загрузить конфигурацию на контроллер. Редактор сначала сохраняет проект локально и только после успеха отправляет сохранённый снимок. Дождитесь результата загрузки и убедитесь, что контроллер снова на связи. Отдельное Сохранить проект можно использовать заранее как самостоятельную контрольную точку, но это не заменяет загрузку. Облачное сохранение и публикация приложения имеют отдельные статусы.
3. Отправьте команду из XIOT и наблюдайте физическую реакцию оборудования. Затем измените состояние на самом устройстве или дождитесь его ответа и проверьте, что значение характеристики обновилось через назначенный адрес состояния.
4. Если владелец будет пользоваться XIOT-APP, проверьте завершение публикации приложения, затем повторите проверку из него. Панель также проверьте отдельно, если она используется на объекте. Приложение, голосовая интеграция и тип устройства имеют отдельные условия поддержки; одна только привязка адресов не гарантирует работу во всех интерфейсах.

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

После замены оборудования

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

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

• Нет адреса в списке: проверьте драйвер, связь с оборудованием и создание нужного канала.
• Команда не действует: проверьте адрес управления, тип значения, направление канала и связь контроллера.
• Команда действует, но состояние не возвращается: проверьте адрес состояния и реальную публикацию обратной связи; при её отсутствии выключите ожидание.
• Значение в редакторе меняется, а нагрузка нет: локальное изменение не подтверждает физическую реакцию. Проверьте загрузку, канал записи и устройство на объекте.
• Загрузка завершилась неопределённо: не повторяйте её вслепую; сначала выясните текущую конфигурацию и состояние контроллера.

См. также

• Виртуальные устройства XIOT — каталог типов и характеристик.
• Первая лампа в XIOT — пример одной нагрузки.
• Создание сценариев — следующий шаг после проверки базовых каналов.