Настройка штор ONVIZ через Wiren Board

Главная страница → Виртуальное устройство «Карниз» → Шторы ONVIZ через Wiren Board

Пример настройки раздвижной шторы в XIOT, когда привод уже подключён к Wiren Board и предоставляет каналы Position, Open, Stop и Close. XIOT передаёт команды и получает фактическое положение; релейную логику движения внутри XIOT в этой схеме не используют.

Пример основан на существующей конфигурации приводов ONVIZ с протоколом драйвера dooya. Название шаблона драйвера не подтверждает модель двигателя. Перед применением инструкции сверьте модель, поддерживаемый протокол и каналы своего привода. Это не инструкция по назначению адресов на шине и не пример релейного двигателя.

Форма редактора и основной интерфейс проверены 03.11.2026 в открытом проекте XIOT-EDITOR v15.2~beta10. При подготовке статьи приводы не перемещались и конфигурация контроллера не изменялась.

Подготовка

Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя.
Подключите драйвер Wiren Board в XIOT и получите список каналов. Для данного примера нужны Position, Open, Stop и Close одного привода.
Перед изменениями сделайте резервную копию проекта.

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

Устройство и параметры

В окне «Устройства и сценарии» выберите комнату. Откройте настройки существующей шторы или добавьте устройство «Карниз» (WindowCovering). Для каждого независимого привода нужна отдельная карточка.
Задайте понятное название. В параметре «Тип шторы» выберите «раздвижные шторы» для раздвижного карниза. Для другого механизма выбирайте соответствующий тип — он влияет на изображение шторы, но не заменяет привязки каналов.
Установите «Управление шторой через связанные реле» — «Отключено». В этом примере привод самостоятельно выполняет движение и сообщает положение. Времена движения релейной логики XIOT здесь не настраиваются.
Установите «Менять целевую позицию при нажатии кнопок (открыть/закрыть/стоп)» — «нет»: отдельные кнопки связаны с командами Open, Stop и Close самого привода.
Выберите «Участвовать в общем управлении шторами комнаты» в соответствии с задачей. В примере установлено «да». Это разрешает участие в общей команде комнаты, а не включает движение при открытии страницы.

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

Характеристики и связи

Включите необходимые характеристики: «Целевая позиция (0–100%)», «Фактическое положение (0–100%)», «Кнопка открыть», «Кнопка стоп» и «Кнопка закрыть». Активация характеристики определяет доступные возможности и элементы интерфейса, но сама по себе не назначает канал оборудования. Связанные базовые характеристики не нужно заполнять случайными физическими адресами.

Откройте «Настроить связи характеристики» у каждой из этих характеристик. Выбирайте канал именно нужного привода в драйвере Wiren Board.

Характеристика XIOT	Адрес управления	Адрес состояния
Целевая позиция (0–100%)	Position	Пусто
Фактическое положение (0–100%)	Пусто	Position
Кнопка открыть	Open	Пусто
Кнопка стоп	Stop	Пусто
Кнопка закрыть	Close	Пусто

Например, при имени устройства WB dooya_0x0203 выбирается /wb/dooya_0x0203/Position. Один канал используется в двух разных характеристиках: как команда целевой позиции и как обратная связь о фактическом положении. Адрес приведён как пример; в своём проекте выбирайте свой привод. Окончание /on вручную к адресу XIOT не добавляют — отправку команды обрабатывает драйвер.

Целевая позиция: канал Position назначен адресу управления, адрес состояния пуст — Целевая позиция — команда приводу.

Фактическое положение: адрес управления пуст, канал Position назначен адресу состояния — Фактическое положение — обратная связь от привода. Не подменяйте её отправленной целью.

Подробнее о назначении полей: привязка адресов к характеристикам.

Направление и преобразование процентов

Проверьте направление шкалы отдельно у целевой и фактической позиции. В рассмотренном примере сохранено обратное соответствие:

Значение характеристики XIOT	Значение канала WB
0 %	100
100 %	0

Для такой схемы откройте «Преобразование значений характеристики» и задайте соответствие крайних точек у обеих характеристик. Преобразование команды и обратного значения должно быть согласованным.

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

Назначение кнопок Open/Close также проверяется отдельно. Если они физически работают наоборот, сначала выясните направление привода и корректность выбранных каналов. Перестановка команд открытия/закрытия не заменяет проверку шкалы Position.

Как это выглядит в основном интерфейсе телефона

В комнате появляется карточка шторы. В показанном интерфейсе короткое нажатие является командой управления, а удержание карточки с включённой целевой позицией открывает отдельную страницу. На ней находятся ползунок положения и кнопки «Открыть», «Стоп», «Закрыть». Для открытия этой страницы не требуется двигать ползунок или нажимать команды.

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

Общее пользовательское управление описано отдельно: управление шторами в приложении.

Сохранение и приёмка

Сохраните проект штатной кнопкой и дождитесь подтверждения. При необходимости применения на контроллере отдельно выполните штатную загрузку конфигурации и проверьте её завершение. Save не равен загрузке в PLC.
Повторно откройте настройки: проверьте комнату, пять связей, параметры и преобразование обеих позиций.
Проверьте карточку и отдельную страницу шторы в основном интерфейсе телефона. Наличие ползунка ещё не подтверждает работу привода.
В согласованное время проверьте физические команды «Открыть», «Стоп», «Закрыть», затем промежуточную позицию. Сравните цель, фактический Position в WB и положение полотна.
При управлении штатным пультом привода проверьте, что фактическое положение обновляется и в XIOT.
Если разрешено общее управление комнатой, отдельно проверьте состав участвующих штор.

Если результат отличается от ожидаемого

Есть карточка, но штора не движется: проверьте загрузку конфигурации, связь с WB и адрес управления конкретного привода. Не подавайте повторные команды вслепую.
Цель меняется, фактическая позиция не обновляется: проверьте отдельную характеристику фактического положения и её адрес состояния Position.
Шкала или направление обратные: проверьте преобразование обеих позиций и отдельно назначение Open/Close.
Показывается прочерк или старое значение: проверьте связь и свежесть обратных показаний. Не считайте такое отображение доказательством реального положения.
Общая команда не затрагивает штору: проверьте комнату устройства и параметр участия в общем управлении.