Onviz-curtain-setup: различия между версиями

Версия от 21:08, 3 ноября 2026

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

Пример настройки раздвижной шторы ONVIZ в редакторе XIOT. Привод уже подключён к Wiren Board; в списке адресов доступны «Позиция», «Открыть», «Остановить» и «Закрыть». После настройки в приложении появятся карточка шторы, ползунок положения и кнопки управления.

Подготовка

Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя.
Подключите драйвер Wiren Board в XIOT и получите список адресов. Найдите «Позиция», «Открыть», «Остановить» и «Закрыть» нужной шторы.
Перед изменениями сделайте резервную копию проекта.

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

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

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

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

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

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

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

Характеристика XIOT	Адрес управления	Адрес состояния
Целевая позиция (0–100%)	Позиция нужной шторы	Пусто
Фактическое положение (0–100%)	Пусто	Позиция той же шторы
Кнопка открыть	Открыть нужную штору	Пусто
Кнопка стоп	Остановить нужную штору	Пусто
Кнопка закрыть	Закрыть нужную штору	Пусто

Например, на снимках выбран пункт «Позиция Спальня 3». У «Целевой позиции» он назначен в поле «Адрес управления», а у «Фактического положения» — в поле «Адрес состояния». В первом случае задаётся желаемое положение, во втором — отображается положение, которое сообщает привод. В своём проекте выберите соответствующий пункт нужной шторы.

У целевой позиции выбран адрес управления «Позиция Спальня 3», адрес состояния пуст — Целевая позиция: заполнено поле «Адрес управления».

У фактического положения выбран адрес состояния «Позиция Спальня 3», адрес управления пуст — Фактическое положение: заполнено поле «Адрес состояния».

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

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

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

Значение характеристики	Значение привода
0 %	100
100 %	0

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

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

Кнопки «Открыть» и «Закрыть» проверяются отдельно. Если они работают наоборот, проверьте направление привода и выбранные адреса. Перестановка команд открытия и закрытия не заменяет проверку шкалы положения.

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

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

Основной интерфейс телефона: страница шторы с ползунком и кнопками Открыть, Стоп, Закрыть — Страница управления шторой в основном интерфейсе телефона. Предпросмотр в редакторе.

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

Сохранение и проверка

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

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

Есть карточка, но штора не движется: проверьте завершение загрузки на контроллер, связь с Wiren Board и адрес управления нужной шторы.
Цель меняется, фактическая позиция не обновляется: проверьте характеристику «Фактическое положение» и выбранный у неё «Адрес состояния».
Шкала или направление обратные: проверьте преобразование обеих позиций и отдельно адреса кнопок «Открыть» и «Закрыть».
Показывается прочерк или старое значение: проверьте связь с контроллером и обновление «Фактического положения».
Общая команда не затрагивает штору: проверьте комнату устройства и параметр участия в общем управлении.

@@ Строка 2: / Строка 2: @@
 [[Main-page|Главная страница]] → [[Curtain-track|Виртуальное устройство «Карниз»]] → '''Шторы ONVIZ через Wiren Board'''
-Пример настройки раздвижной шторы в XIOT, когда привод уже подключён к Wiren Board и предоставляет каналы '''Position''', '''Open''', '''Stop''' и '''Close'''. XIOT передаёт команды и получает фактическое положение; релейную логику движения внутри XIOT в этой схеме не используют.
+Пример настройки раздвижной шторы ONVIZ в редакторе XIOT. Привод уже подключён к Wiren Board; в списке адресов доступны '''«Позиция»''', '''«Открыть»''', '''«Остановить»''' и '''«Закрыть»'''. После настройки в приложении появятся карточка шторы, ползунок положения и кнопки управления.
-Пример основан на существующей конфигурации приводов 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 одного привода.
+# Подключите [[Wiren-board-driver-setup|драйвер Wiren Board в XIOT]] и получите список адресов. Найдите '''«Позиция»''', '''«Открыть»''', '''«Остановить»''' и '''«Закрыть»''' нужной шторы.
 # Перед изменениями сделайте [[Project-backup|резервную копию проекта]].
-'''Предпросмотр может управлять настоящими шторами.''' Просмотр формы и навигация не требуют нажатия команд движения. Физическую приёмку проводите отдельно, когда зона движения свободна и работа согласована с ответственным за объект.
+'''Кнопки в предпросмотре могут двигать настоящие шторы.''' Перед проверкой управления убедитесь, что движению полотна ничего не мешает.
 == Устройство и параметры ==
-# В окне '''«Устройства и сценарии»''' выберите комнату. Откройте настройки существующей шторы или добавьте устройство [[Curtain-track|«Карниз» (WindowCovering)]]. Для каждого независимого привода нужна отдельная карточка.
+# В окне '''«Устройства и сценарии»''' выберите комнату. Откройте настройки существующей шторы или добавьте устройство [[Curtain-track|«Карниз»]]. Для каждой независимо управляемой шторы нужна отдельная карточка.
 # Задайте понятное название. В параметре '''«Тип шторы»''' выберите '''«раздвижные шторы»''' для раздвижного карниза. Для другого механизма выбирайте соответствующий тип — он влияет на изображение шторы, но не заменяет привязки каналов.
-# Установите '''«Управление шторой через связанные реле» — «Отключено»'''. В этом примере привод самостоятельно выполняет движение и сообщает положение. Времена движения релейной логики XIOT здесь не настраиваются.
+# Установите '''«Управление шторой через связанные реле» — «Отключено»'''. В этом примере привод самостоятельно выполняет движение и сообщает положение.
-# Установите '''«Менять целевую позицию при нажатии кнопок (открыть/закрыть/стоп)» — «нет»''': отдельные кнопки связаны с командами Open, Stop и Close самого привода.
+# Установите '''«Менять целевую позицию при нажатии кнопок (открыть/закрыть/стоп)» — «нет»''': кнопки будут связаны с отдельными командами открытия, остановки и закрытия привода.
-# Выберите '''«Участвовать в общем управлении шторами комнаты»''' в соответствии с задачей. В примере установлено '''«да»'''. Это разрешает участие в общей команде комнаты, а не включает движение при открытии страницы.
+# Выберите '''«Участвовать в общем управлении шторами комнаты» — «да»''', если штора должна выполнять общие команды комнаты. Чтобы исключить её из общих команд, выберите '''«нет»'''.
-[[Файл:Onviz-curtain-editor-parameters-20261103.png|thumb|center|800px|alt=Параметры шторы: раздвижной тип, участие в общем управлении, релейная логика отключена, изменение целевой позиции кнопками выключено|Параметры существующей шторы в редакторе. Используется управление через каналы привода, без расчёта положения по времени реле.]]
+[[Файл:Onviz-curtain-editor-parameters-20261103.png|thumb|center|800px|alt=Параметры шторы: раздвижной тип, участие в общем управлении, управление через связанные реле отключено|Параметры раздвижной шторы в редакторе.]]
 == Характеристики и связи ==
-Включите необходимые характеристики: '''«Целевая позиция (0–100%)»''', '''«Фактическое положение (0–100%)»''', '''«Кнопка открыть»''', '''«Кнопка стоп»''' и '''«Кнопка закрыть»'''. Активация характеристики определяет доступные возможности и элементы интерфейса, но сама по себе не назначает канал оборудования. Связанные базовые характеристики не нужно заполнять случайными физическими адресами.
+Включите характеристики: '''«Целевая позиция (0–100%)»''', '''«Фактическое положение (0–100%)»''', '''«Кнопка открыть»''', '''«Кнопка стоп»''' и '''«Кнопка закрыть»'''. Они добавляют соответствующие возможности и элементы управления в приложении. Затем назначьте им адреса.
 Откройте '''«Настроить связи характеристики»''' у каждой из этих характеристик. Выбирайте канал именно нужного привода в драйвере Wiren Board.
@@ Строка 35: / Строка 31: @@
 ! Характеристика XIOT !! Адрес управления !! Адрес состояния
 |-
-| Целевая позиция (0–100%) || Position || Пусто
+| Целевая позиция (0–100%) || Позиция нужной шторы || Пусто
 |-
-| Фактическое положение (0–100%) || Пусто || Position
+| Фактическое положение (0–100%) || Пусто || Позиция той же шторы
 |-
-| Кнопка открыть || Open || Пусто
+| Кнопка открыть || Открыть нужную штору || Пусто
 |-
-| Кнопка стоп || Stop || Пусто
+| Кнопка стоп || Остановить нужную штору || Пусто
 |-
-| Кнопка закрыть || Close || Пусто
+| Кнопка закрыть || Закрыть нужную штору || Пусто
 |}
-Например, при имени устройства WB <code>dooya_0x0203</code> выбирается <code>/wb/dooya_0x0203/Position</code>. Один канал используется в двух разных характеристиках: как '''команда целевой позиции''' и как '''обратная связь о фактическом положении'''. Адрес приведён как пример; в своём проекте выбирайте свой привод. Окончание <code>/on</code> вручную к адресу XIOT не добавляют — отправку команды обрабатывает драйвер.
+Например, на снимках выбран пункт '''«Позиция Спальня 3»'''. У '''«Целевой позиции»''' он назначен в поле '''«Адрес управления»''', а у '''«Фактического положения»''' — в поле '''«Адрес состояния»'''. В первом случае задаётся желаемое положение, во втором — отображается положение, которое сообщает привод. В своём проекте выберите соответствующий пункт нужной шторы.
-[[Файл:Onviz-curtain-editor-target-20261103.png|thumb|center|800px|alt=Целевая позиция: канал Position назначен адресу управления, адрес состояния пуст|Целевая позиция — команда приводу.]]
+[[Файл:Onviz-curtain-editor-target-20261103.png|thumb|center|800px|alt=У целевой позиции выбран адрес управления «Позиция Спальня 3», адрес состояния пуст|Целевая позиция: заполнено поле «Адрес управления».]]
-[[Файл:Onviz-curtain-editor-feedback-20261103.png|thumb|center|800px|alt=Фактическое положение: адрес управления пуст, канал Position назначен адресу состояния|Фактическое положение — обратная связь от привода. Не подменяйте её отправленной целью.]]
+[[Файл:Onviz-curtain-editor-feedback-20261103.png|thumb|center|800px|alt=У фактического положения выбран адрес состояния «Позиция Спальня 3», адрес управления пуст|Фактическое положение: заполнено поле «Адрес состояния».]]
 Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]].
@@ Строка 59: / Строка 55: @@
 {| class="wikitable"
-! Значение характеристики XIOT !! Значение канала WB
+! Значение характеристики !! Значение привода
 |-
 | 0 % || 100
@@ Строка 68: / Строка 64: @@
 Для такой схемы откройте '''«Преобразование значений характеристики»''' и задайте соответствие крайних точек у обеих характеристик. Преобразование команды и обратного значения должно быть согласованным.
-'''Не копируйте инверсию автоматически.''' У другого привода или другой установки направление может отличаться. Не определяйте открытое положение только по числу 0 или 100: сравните оба края с физическим полотном при приёмке.
+'''Не копируйте это преобразование без проверки направления движения.''' У другого привода или другой установки направление может отличаться. Проверьте, каким значениям соответствуют полностью открытая и полностью закрытая штора.
-Назначение кнопок Open/Close также проверяется отдельно. Если они физически работают наоборот, сначала выясните направление привода и корректность выбранных каналов. Перестановка команд открытия/закрытия не заменяет проверку шкалы Position.
+Кнопки '''«Открыть»''' и '''«Закрыть»''' проверяются отдельно. Если они работают наоборот, проверьте направление привода и выбранные адреса. Перестановка команд открытия и закрытия не заменяет проверку шкалы положения.
 == Как это выглядит в основном интерфейсе телефона ==
@@ Строка 76: / Строка 72: @@
 В комнате появляется карточка шторы. В показанном интерфейсе короткое нажатие является командой управления, а удержание карточки с включённой целевой позицией открывает отдельную страницу. На ней находятся ползунок положения и кнопки '''«Открыть»''', '''«Стоп»''', '''«Закрыть»'''. Для открытия этой страницы не требуется двигать ползунок или нажимать команды.
-[[Файл:Onviz-curtain-phone-control-20261103.png|thumb|center|370px|alt=Основной интерфейс телефона: страница шторы с ползунком и кнопками Открыть, Стоп, Закрыть|Настоящий предпросмотр основного интерфейса телефона в редакторе, фрагмент страницы управления. Это не фотография физического телефона. Показания на снимке не подтверждают положение механизма: при съёмке у редактора не было связи с PLC.]]
+[[Файл:Onviz-curtain-phone-control-20261103.png|thumb|center|370px|alt=Основной интерфейс телефона: страница шторы с ползунком и кнопками Открыть, Стоп, Закрыть|Страница управления шторой в основном интерфейсе телефона. Предпросмотр в редакторе.]]
 Общее пользовательское управление описано отдельно: [[Curtain-control-in-app|управление шторами в приложении]].
-== Сохранение и приёмка ==
+== Сохранение и проверка ==
-# Сохраните проект штатной кнопкой и дождитесь подтверждения. При необходимости применения на контроллере отдельно выполните штатную загрузку конфигурации и проверьте её завершение. '''Save не равен загрузке в PLC.'''
+# Нажмите '''«Сохранить проект»''' и дождитесь подтверждения. Чтобы применить настройки на контроллере, нажмите '''«Загрузить конфигурацию на контроллер»''' и дождитесь завершения загрузки.
 # Повторно откройте настройки: проверьте комнату, пять связей, параметры и преобразование обеих позиций.
-# Проверьте карточку и отдельную страницу шторы в основном интерфейсе телефона. Наличие ползунка ещё не подтверждает работу привода.
+# Откройте комнату в основном интерфейсе телефона и проверьте карточку шторы и её страницу управления.
-# В согласованное время проверьте физические команды «Открыть», «Стоп», «Закрыть», затем промежуточную позицию. Сравните цель, фактический Position в WB и положение полотна.
+# Проверьте команды '''«Открыть»''', '''«Стоп»''', '''«Закрыть»''', затем задайте промежуточную позицию. Сравните заданную цель, '''«Фактическое положение»''' и положение полотна.
 # При управлении штатным пультом привода проверьте, что фактическое положение обновляется и в XIOT.
 # Если разрешено общее управление комнатой, отдельно проверьте состав участвующих штор.
@@ Строка 91: / Строка 87: @@
 == Если результат отличается от ожидаемого ==
-* '''Есть карточка, но штора не движется:''' проверьте загрузку конфигурации, связь с WB и адрес управления конкретного привода. Не подавайте повторные команды вслепую.
+* '''Есть карточка, но штора не движется:''' проверьте завершение загрузки на контроллер, связь с Wiren Board и адрес управления нужной шторы.
-* '''Цель меняется, фактическая позиция не обновляется:''' проверьте отдельную характеристику фактического положения и её адрес состояния Position.
+* '''Цель меняется, фактическая позиция не обновляется:''' проверьте характеристику '''«Фактическое положение»''' и выбранный у неё '''«Адрес состояния»'''.
-* '''Шкала или направление обратные:''' проверьте преобразование обеих позиций и отдельно назначение Open/Close.
+* '''Шкала или направление обратные:''' проверьте преобразование обеих позиций и отдельно адреса кнопок '''«Открыть»''' и '''«Закрыть»'''.
-* '''Показывается прочерк или старое значение:''' проверьте связь и свежесть обратных показаний. Не считайте такое отображение доказательством реального положения.
+* '''Показывается прочерк или старое значение:''' проверьте связь с контроллером и обновление '''«Фактического положения»'''.
 * '''Общая команда не затрагивает штору:''' проверьте комнату устройства и параметр участия в общем управлении.
 [[Категория:Документация XIOT]]

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