Device-bindings: различия между версиями

Версия от 21:09, 15 сентября 2026

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

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

@@ Строка 1: / Строка 1: @@
-После настройки нужного драйвера XIOT по инструкции [[Настройка драйверов]] можно перейти к привязке реальных устройств к виртуальным.
+'''Привязка''' связывает характеристику виртуального устройства с фактическими каналами оборудования. Настройка адресов в редакторе — ещё не доказательство работы на объекте: после загрузки конфигурации проверяют команду, физическую реакцию и обратную связь.
-) Переходим в раздел «Устройства и сценарии»:</br>
+== Перед началом ==
-[[File:Xiot_34.png|600px]]</br>
-) Выбираем ранее созданное виртуальное устройство, к примеру виртуальное устройство "Лампочка" Инструкции по созданию виртуальных устройств описано в разделе [[Создание виртуальных устройств]].</br>
-[[File:Xiot_21_5.png|800px]]</br>
-) Нажимаем на нее и видим меню настройки виртуального устройства "Лампочка":</br>
-[[File:Xiot_35.png|800px]]</br>
-) Добавляем адрес управления и адрес состояния, которые предоставляет настроенный драйвер XIOT:</br>
-[[File:Xiot_36.png|800px]]</br>
-) Нажимаем на нужное поле и выбираем адрес из списка:</br>
-[[File:Xiot_37.png|800px]]</br>
-) Для Wiren Board адрес управления и адрес состояния часто совпадают. В KNX обычно используются разные групповые адреса: один для команды, другой для обратной связи. После добавления адресов настройка выглядит следующим образом:</br>
-[[File:Xiot_38.png|800px]]</br>
-) Нажимаем '''Загрузить конфигурацию на контроллер'''. Эта команда сама сохраняет проект, создаёт одну новую версию и передаёт на привязанный XIOT-PLC точный снимок этой версии. Дожидаемся завершения загрузки и проверяем управление и обратную связь на физическом устройстве.</br>
-Если отдельная контрольная точка нужна до загрузки, нажмите '''Сохранить проект''' заранее. Не повторяйте сохранение непосредственно перед загрузкой без отдельной причины, иначе появятся две последовательные версии.
-[[File:Xiot_26.png|600px]]</br>
-Лампочка настроена. Можно управлять созданной лампочкой с мобильного приложения, с планшета и через яндекс станцию с Алисой.
+# Создайте виртуальное устройство в нужной комнате: [[Создание виртуальных устройств]].
-Добавление устройств в Умный дом яндекс описано в статье.
+# Настройте соответствующий [[Настройка драйверов|драйвер XIOT]] и проверьте, что нужный физический канал доступен в его списке адресов.
+# Уточните по схеме и настройкам оборудования, какой канал принимает команду и какой передаёт состояние. Не выбирайте адрес только по похожему названию.
-После этого по аналогии настраиваем остальные устройства.
+== Назначьте адреса характеристике ==
-После привязки всех реальных устройств к виртуальным, переходим к созданию сценариев работы системы Умного дома. Подробное описание приведено в разделе [[Создание сценариев]]. </br>
+Откройте в XIOT-EDITOR раздел '''Устройства и сценарии''', выберите виртуальное устройство и нужную характеристику. Для светильника начните с характеристики '''Включение'''; яркость, цвет и другие каналы настраивайте отдельно только при их наличии у оборудования.
+* '''Адрес управления''' — куда XIOT отправляет команду или значение. Для управляемой физической нагрузки выберите фактический канал записи.
+* '''Адрес состояния''' — откуда XIOT получает значение или обратную связь. Выберите фактический канал чтения, если оборудование его предоставляет.
+Набор адресов зависит от роли характеристики. У логических и системных характеристик физический адрес может не требоваться. Для датчика часто нужен только адрес состояния; для команды без обратной связи — только адрес управления. Не подменяйте отсутствующую обратную связь локальным отображением команды.
+У Wiren Board адреса управления и состояния '''могут''' совпадать, если конкретный канал действительно принимает команду и публикует состояние. У KNX они часто различаются. В обоих случаях сверяйте фактическую схему, тип значения, направление и поведение драйвера; совпадение адресов не является универсальным правилом.
+'''Результат:''' у каждой нужной характеристики указаны именно те адреса, которые относятся к её физическому каналу.
+== Настройте ожидание обратной связи ==
+Если включён режим ожидания обратной связи от адреса состояния, новое состояние должно подтверждаться ответом из этого адреса. Включайте ожидание только тогда, когда настроенный физический канал действительно возвращает подходящее значение. Без такого ответа команда может быть отправлена, но характеристика не получит подтверждения. Отключённое ожидание позволяет обновить локальное значение сразу; оно не доказывает, что оборудование выполнило команду.
+Режим ожидания не заменяет права доступа и не делает характеристику «только для чтения». Подробная схема работы: [[Механизм работы тегов в XIOT]].
+== Примените конфигурацию и проверьте результат ==
+# Проверьте выбранный проект, привязанный XIOT-PLC, типы значений и адреса всех изменённых характеристик.
+# Нажмите '''Загрузить конфигурацию на контроллер'''. Эта команда также запускает сохранение проекта. Дождитесь сообщений о завершении операций; в истории проверьте появление версии и убедитесь, что контроллер снова на связи. Отдельное '''Сохранить проект''' можно использовать заранее как самостоятельную контрольную точку, но это не заменяет загрузку.
+# Отправьте команду из XIOT и наблюдайте '''физическую''' реакцию оборудования. Затем измените состояние на самом устройстве или дождитесь его ответа и проверьте, что значение характеристики обновилось через назначенный адрес состояния.
+# Повторите проверку с XIOT-APP или панели, если именно ими будет пользоваться владелец. Приложение, голосовая интеграция и тип устройства имеют отдельные условия поддержки; одна только привязка адресов не гарантирует работу во всех интерфейсах.
+'''Успешный результат:''' контроллер применил конфигурацию, физическая нагрузка выполнила команду, а характеристика отражает фактическое состояние там, где обратная связь предусмотрена. Порядок сохранения и восстановления: [[Сохранение резервной копии проекта]].
+== После замены оборудования ==
+Можно сохранить виртуальный объект и переназначить его адреса, '''если''' новое оборудование выполняет ту же функцию и его сигналы совместимы по типу и смыслу. После замены снова загрузите конфигурацию и проведите физическую приёмку. Не считайте сохранение сценариев автоматическим при изменении назначения или полярности сигнала.
+== Если не получилось ==
+* '''Нет адреса в списке:''' проверьте драйвер, связь с оборудованием и создание нужного канала.
+* '''Команда не действует:''' проверьте адрес управления, тип значения, направление канала и связь контроллера.
+* '''Команда действует, но состояние не возвращается:''' проверьте адрес состояния и реальную публикацию обратной связи; при её отсутствии выключите ожидание.
+* '''Значение в редакторе меняется, а нагрузка нет:''' локальное изменение не подтверждает физическую реакцию. Проверьте загрузку, канал записи и устройство на объекте.
+* '''Загрузка завершилась неопределённо:''' не повторяйте её вслепую; сначала выясните текущую конфигурацию и состояние контроллера.
+== См. также ==
+* [[Виртуальные устройства XIOT]] — каталог типов и характеристик.
+* [[Первая лампа в XIOT]] — пример одной нагрузки.
+* [[Создание сценариев]] — следующий шаг после проверки базовых каналов.
+[[Категория:Документация XIOT]]

Admin (обсуждение | вклад)