Просмотр кода страницы Onviz-curtain-setup

{{DISPLAYTITLE:Настройка штор ONVIZ через Wiren Board}}
[[Main-page|Главная страница]] → [[Curtain-track|Виртуальное устройство «Карниз»]] → '''Шторы ONVIZ через Wiren Board'''

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

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

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

== Подготовка ==

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

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

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

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

[[Файл:Onviz-curtain-editor-parameters-20261103.png|thumb|center|800px|alt=Параметры шторы: раздвижной тип, участие в общем управлении, релейная логика отключена, изменение целевой позиции кнопками выключено|Параметры существующей шторы в редакторе. Используется управление через каналы привода, без расчёта положения по времени реле.]]

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

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

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

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

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

[[Файл:Onviz-curtain-editor-target-20261103.png|thumb|center|800px|alt=Целевая позиция: канал Position назначен адресу управления, адрес состояния пуст|Целевая позиция — команда приводу.]]

[[Файл:Onviz-curtain-editor-feedback-20261103.png|thumb|center|800px|alt=Фактическое положение: адрес управления пуст, канал Position назначен адресу состояния|Фактическое положение — обратная связь от привода. Не подменяйте её отправленной целью.]]

Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]].

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

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

{| class="wikitable"
! Значение характеристики XIOT !! Значение канала WB
|-
| 0 % || 100
|-
| 100 % || 0
|}

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

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

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

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

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

[[Файл:Onviz-curtain-phone-control-20261103.png|thumb|center|370px|alt=Основной интерфейс телефона: страница шторы с ползунком и кнопками Открыть, Стоп, Закрыть|Настоящий предпросмотр основного интерфейса телефона в редакторе, фрагмент страницы управления. Это не фотография физического телефона. Показания на снимке не подтверждают положение механизма: при съёмке у редактора не было связи с PLC.]]

Общее пользовательское управление описано отдельно: [[Curtain-control-in-app|управление шторами в приложении]].

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

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

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

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

[[Категория:Документация XIOT]]