Onviz-curtain-setup: различия между версиями
Admin (обсуждение | вклад) Пример настройки штор ONVIZ через WB: связи Position/Open/Stop/Close и реальные снимки редактора и телефонного интерфейса |
Admin (обсуждение | вклад) Снимок шторы в веб-интерфейсе Wiren Board, связи всех пяти характеристик и преобразование значений |
||
| (не показаны 2 промежуточные версии этого же участника) | |||
| Строка 2: | Строка 2: | ||
[[Main-page|Главная страница]] → [[Curtain-track|Виртуальное устройство «Карниз»]] → '''Шторы ONVIZ через Wiren Board''' | [[Main-page|Главная страница]] → [[Curtain-track|Виртуальное устройство «Карниз»]] → '''Шторы ONVIZ через Wiren Board''' | ||
Пример настройки раздвижной шторы в XIOT | Пример настройки раздвижной шторы ONVIZ в редакторе XIOT. Привод уже подключён к Wiren Board; в списке адресов доступны '''«Позиция»''', '''«Открыть»''', '''«Остановить»''' и '''«Закрыть»'''. После настройки в приложении появятся карточка шторы, ползунок положения и кнопки управления. | ||
'''Порядок настройки:''' драйвер Wiren Board → устройство «Карниз» → характеристики и связи → направление шкалы → сохранение и загрузка → управление с телефона. | |||
'' | |||
== Подготовка == | == Подготовка == | ||
# Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя. | # Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя. | ||
# Перед изменениями сделайте [[Project-backup|резервную копию проекта]]. | # Перед изменениями сделайте [[Project-backup|резервную копию проекта]]. | ||
''' | В веб-интерфейсе Wiren Board откройте раздел устройств и найдите нужную штору. В примере ниже — та же штора, которая далее показана в редакторе XIOT. | ||
[[Файл:Onviz-curtain-wb-webui-20261104.png|thumb|center|450px|alt=Виджет шторы в веб-интерфейсе Wiren Board: ползунок положения и кнопки управления|Штора в разделе устройств веб-интерфейса Wiren Board.]] | |||
== 1. Найдите штору в драйвере Wiren Board == | |||
# В редакторе откройте '''«Драйверы» → «Wiren Board»'''. Если драйвер ещё не подключён, выполните [[Wiren-board-driver-setup|настройку подключения Wiren Board]] и получите список адресов. | |||
# Найдите нужную штору в списке устройств и раскройте её виджет нажатием на заголовок. В примере это '''«Спальня 3»'''. | |||
# Найдите ползунок '''«Позиция»''' и команды '''«Открыть»''', '''«Закрыть»''', '''«Остановить»'''. Эти же пункты понадобятся при назначении связей «Карниза». | |||
[[Файл:Onviz-curtain-editor-wb-widget-20261104.png|thumb|center|646px|alt=Виджет шторы в драйвере Wiren Board редактора XIOT: позиция и команды открытия, закрытия и остановки|Виджет шторы в разделе «Драйверы → Wiren Board».]] | |||
'''Кнопки и ползунок виджета управляют настоящей шторой.''' Чтобы посмотреть доступные элементы, нажимать команды не нужно. '''«Сбросить настройки»''' для привязки к XIOT не используется. | |||
== | == 2. Добавьте и настройте устройство «Карниз» == | ||
# В окне '''«Устройства и сценарии»''' выберите комнату. Откройте настройки существующей шторы или добавьте устройство [[Curtain-track|«Карниз» | # В окне '''«Устройства и сценарии»''' выберите комнату. Откройте настройки существующей шторы или добавьте устройство [[Curtain-track|«Карниз»]]. Для каждой независимо управляемой шторы нужна отдельная карточка. | ||
# Задайте понятное название. В параметре '''«Тип шторы»''' выберите '''«раздвижные шторы»''' для раздвижного карниза. Для другого механизма выбирайте соответствующий тип — он влияет на изображение шторы, но не заменяет привязки каналов. | # Задайте понятное название. В параметре '''«Тип шторы»''' выберите '''«раздвижные шторы»''' для раздвижного карниза. Для другого механизма выбирайте соответствующий тип — он влияет на изображение шторы, но не заменяет привязки каналов. | ||
# Установите '''«Управление шторой через связанные реле» — «Отключено»'''. В этом примере привод самостоятельно выполняет движение и сообщает положение | # Установите '''«Управление шторой через связанные реле» — «Отключено»'''. В этом примере привод самостоятельно выполняет движение и сообщает положение. | ||
# Установите '''«Менять целевую позицию при нажатии кнопок (открыть/закрыть/стоп)» — «нет»''': | # Установите '''«Менять целевую позицию при нажатии кнопок (открыть/закрыть/стоп)» — «нет»''': кнопки будут связаны с отдельными командами открытия, остановки и закрытия привода. | ||
# Выберите '''«Участвовать в общем управлении шторами комнаты»''' | # Выберите '''«Участвовать в общем управлении шторами комнаты» — «да»''', если штора должна выполнять общие команды комнаты. Чтобы исключить её из общих команд, выберите '''«нет»'''. | ||
[[Файл:Onviz-curtain-editor-parameters-20261103.png|thumb|center|800px|alt=Параметры шторы: раздвижной тип, участие в общем управлении, | [[Файл:Onviz-curtain-editor-parameters-20261103.png|thumb|center|800px|alt=Параметры шторы: раздвижной тип, участие в общем управлении, управление через связанные реле отключено|Параметры раздвижной шторы в редакторе.]] | ||
== | == 3. Включите характеристики и назначьте связи == | ||
Включите | Включите характеристики: '''«Целевая позиция (0–100%)»''', '''«Фактическое положение (0–100%)»''', '''«Кнопка открыть»''', '''«Кнопка стоп»''' и '''«Кнопка закрыть»'''. Они добавляют соответствующие возможности и элементы управления в приложении. Затем назначьте им адреса. | ||
Откройте '''«Настроить связи характеристики»''' у каждой из этих характеристик. Выбирайте канал именно нужного привода в драйвере Wiren Board. | Откройте '''«Настроить связи характеристики»''' у каждой из этих характеристик. Выбирайте канал именно нужного привода в драйвере Wiren Board. | ||
| Строка 35: | Строка 44: | ||
! Характеристика XIOT !! Адрес управления !! Адрес состояния | ! Характеристика XIOT !! Адрес управления !! Адрес состояния | ||
|- | |- | ||
| Целевая позиция (0–100%) || | | Целевая позиция (0–100%) || Позиция нужной шторы || Пусто | ||
|- | |- | ||
| Фактическое положение (0–100%) || Пусто || | | Фактическое положение (0–100%) || Пусто || Позиция той же шторы | ||
|- | |- | ||
| Кнопка открыть || | | Кнопка открыть || Открыть нужную штору || Пусто | ||
|- | |- | ||
| Кнопка стоп || | | Кнопка стоп || Остановить нужную штору || Пусто | ||
|- | |- | ||
| Кнопка закрыть || | | Кнопка закрыть || Закрыть нужную штору || Пусто | ||
|} | |} | ||
Ниже показаны связи всех пяти характеристик на примере одной шторы. В своём проекте выберите соответствующие пункты нужного привода. | |||
=== 3.1. Целевая позиция === | |||
В поле '''«Адрес управления»''' выберите позицию нужной шторы. В примере это '''«Позиция Спальня 3»'''. Поле '''«Адрес состояния»''' оставьте пустым. Эта связь задаёт желаемое положение. | |||
[[Файл:Onviz-curtain-editor-target-20261103.png|thumb|center|800px|alt=У целевой позиции выбран адрес управления «Позиция Спальня 3», адрес состояния пуст|Целевая позиция: заполнено поле «Адрес управления».]] | |||
=== 3.2. Фактическое положение === | |||
В поле '''«Адрес состояния»''' выберите позицию той же шторы — в примере '''«Позиция Спальня 3»'''. Поле '''«Адрес управления»''' оставьте пустым. Эта связь отображает положение, которое сообщает привод. | |||
[[Файл:Onviz-curtain-editor-feedback-20261103.png|thumb|center|800px|alt= | [[Файл:Onviz-curtain-editor-feedback-20261103.png|thumb|center|800px|alt=У фактического положения выбран адрес состояния «Позиция Спальня 3», адрес управления пуст|Фактическое положение: заполнено поле «Адрес состояния».]] | ||
=== 3.3. Кнопка открыть === | |||
В поле '''«Адрес управления»''' выберите команду '''«Открыть»''' нужной шторы. Поле '''«Адрес состояния»''' оставьте пустым. | |||
[[Файл:Onviz-curtain-editor-open-binding-20261104.png|thumb|center|609px|alt=Связь характеристики «Кнопка открыть» с командой открытия шторы|Кнопка открыть: команда открытия в поле «Адрес управления».]] | |||
=== 3.4. Кнопка стоп === | |||
В поле '''«Адрес управления»''' выберите команду '''«Остановить»''' той же шторы. Поле '''«Адрес состояния»''' оставьте пустым. | |||
[[Файл:Onviz-curtain-editor-stop-binding-20261104.png|thumb|center|609px|alt=Связь характеристики «Кнопка стоп» с командой остановки шторы|Кнопка стоп: команда остановки в поле «Адрес управления».]] | |||
=== 3.5. Кнопка закрыть === | |||
В поле '''«Адрес управления»''' выберите команду '''«Закрыть»''' той же шторы. Поле '''«Адрес состояния»''' оставьте пустым. | |||
[[Файл:Onviz-curtain-editor-close-binding-20261104.png|thumb|center|609px|alt=Связь характеристики «Кнопка закрыть» с командой закрытия шторы|Кнопка закрыть: команда закрытия в поле «Адрес управления».]] | |||
Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]]. | Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]]. | ||
== | == 4. Согласуйте направление шкалы == | ||
Проверьте направление шкалы '''отдельно у целевой и фактической позиции'''. В рассмотренном примере сохранено обратное соответствие: | Проверьте направление шкалы '''отдельно у целевой и фактической позиции'''. В рассмотренном примере сохранено обратное соответствие: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Значение характеристики | ! Значение характеристики !! Значение привода | ||
|- | |- | ||
| 0 % || 100 | | 0 % || 100 | ||
| Строка 68: | Строка 103: | ||
Для такой схемы откройте '''«Преобразование значений характеристики»''' и задайте соответствие крайних точек у обеих характеристик. Преобразование команды и обратного значения должно быть согласованным. | Для такой схемы откройте '''«Преобразование значений характеристики»''' и задайте соответствие крайних точек у обеих характеристик. Преобразование команды и обратного значения должно быть согласованным. | ||
[[Файл:Onviz-curtain-editor-target-conversion-20261104.png|thumb|center|800px|alt=Окно преобразования значений: закрыты — характеристика 100, значение тэга 0; открыты — характеристика 0, значение тэга 100|Преобразование целевой позиции. Для фактического положения в этом примере задано такое же соответствие.]] | |||
'''Не копируйте это преобразование без проверки направления движения.''' У другого привода или другой установки направление может отличаться. Проверьте, каким значениям соответствуют полностью открытая и полностью закрытая штора. | |||
== | Кнопки '''«Открыть»''' и '''«Закрыть»''' проверяются отдельно. Если они работают наоборот, проверьте направление привода и выбранные адреса. Перестановка команд открытия и закрытия не заменяет проверку шкалы положения. | ||
== 5. Сохраните проект и загрузите настройки == | |||
# Нажмите '''«Сохранить проект»''' и дождитесь подтверждения. | |||
# Повторно откройте настройки шторы: проверьте комнату, пять связей, параметры и преобразование обеих позиций. | |||
# Чтобы применить настройки на контроллере, нажмите '''«Загрузить конфигурацию на контроллер»''' и дождитесь завершения загрузки. | |||
== 6. Откройте управление шторой на телефоне == | |||
В комнате появляется карточка шторы. В показанном интерфейсе короткое нажатие является командой управления, а удержание карточки с включённой целевой позицией открывает отдельную страницу. На ней находятся ползунок положения и кнопки '''«Открыть»''', '''«Стоп»''', '''«Закрыть»'''. Для открытия этой страницы не требуется двигать ползунок или нажимать команды. | В комнате появляется карточка шторы. В показанном интерфейсе короткое нажатие является командой управления, а удержание карточки с включённой целевой позицией открывает отдельную страницу. На ней находятся ползунок положения и кнопки '''«Открыть»''', '''«Стоп»''', '''«Закрыть»'''. Для открытия этой страницы не требуется двигать ползунок или нажимать команды. | ||
[[Файл:Onviz-curtain-phone-control-20261103.png|thumb|center|370px|alt=Основной интерфейс телефона: страница шторы с ползунком и кнопками Открыть, Стоп, Закрыть| | [[Файл:Onviz-curtain-phone-control-20261103.png|thumb|center|370px|alt=Основной интерфейс телефона: страница шторы с ползунком и кнопками Открыть, Стоп, Закрыть|Страница управления шторой в основном интерфейсе телефона. Предпросмотр в редакторе.]] | ||
Общее пользовательское управление описано отдельно: [[Curtain-control-in-app|управление шторами в приложении]]. | Общее пользовательское управление описано отдельно: [[Curtain-control-in-app|управление шторами в приложении]]. | ||
== | === Проверка управления === | ||
'''Кнопки в предпросмотре также могут двигать настоящие шторы.''' Перед проверкой управления убедитесь, что движению полотна ничего не мешает. | |||
# | # Проверьте команды '''«Открыть»''', '''«Стоп»''', '''«Закрыть»''', затем задайте промежуточную позицию. Сравните заданную цель, '''«Фактическое положение»''' и положение полотна. | ||
# При управлении штатным пультом привода проверьте, что фактическое положение обновляется и в XIOT. | # При управлении штатным пультом привода проверьте, что фактическое положение обновляется и в XIOT. | ||
# Если разрешено общее управление комнатой, отдельно проверьте состав участвующих штор. | # Если разрешено общее управление комнатой, отдельно проверьте состав участвующих штор. | ||
| Строка 91: | Строка 133: | ||
== Если результат отличается от ожидаемого == | == Если результат отличается от ожидаемого == | ||
* '''Есть карточка, но штора не движется:''' проверьте | * '''Есть карточка, но штора не движется:''' проверьте завершение загрузки на контроллер, связь с Wiren Board и адрес управления нужной шторы. | ||
* '''Цель меняется, фактическая позиция не обновляется:''' проверьте | * '''Цель меняется, фактическая позиция не обновляется:''' проверьте характеристику '''«Фактическое положение»''' и выбранный у неё '''«Адрес состояния»'''. | ||
* '''Шкала или направление обратные:''' проверьте преобразование обеих позиций и отдельно | * '''Шкала или направление обратные:''' проверьте преобразование обеих позиций и отдельно адреса кнопок '''«Открыть»''' и '''«Закрыть»'''. | ||
* '''Показывается прочерк или старое значение:''' проверьте связь и | * '''Показывается прочерк или старое значение:''' проверьте связь с контроллером и обновление '''«Фактического положения»'''. | ||
* '''Общая команда не затрагивает штору:''' проверьте комнату устройства и параметр участия в общем управлении. | * '''Общая команда не затрагивает штору:''' проверьте комнату устройства и параметр участия в общем управлении. | ||
[[Категория:Документация XIOT]] | [[Категория:Документация XIOT]] | ||
Текущая версия от 21:26, 3 ноября 2026
Главная страница → Виртуальное устройство «Карниз» → Шторы ONVIZ через Wiren Board
Пример настройки раздвижной шторы ONVIZ в редакторе XIOT. Привод уже подключён к Wiren Board; в списке адресов доступны «Позиция», «Открыть», «Остановить» и «Закрыть». После настройки в приложении появятся карточка шторы, ползунок положения и кнопки управления.
Порядок настройки: драйвер Wiren Board → устройство «Карниз» → характеристики и связи → направление шкалы → сохранение и загрузка → управление с телефона.
Подготовка
- Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя.
- Перед изменениями сделайте резервную копию проекта.
В веб-интерфейсе Wiren Board откройте раздел устройств и найдите нужную штору. В примере ниже — та же штора, которая далее показана в редакторе XIOT.

1. Найдите штору в драйвере Wiren Board
- В редакторе откройте «Драйверы» → «Wiren Board». Если драйвер ещё не подключён, выполните настройку подключения Wiren Board и получите список адресов.
- Найдите нужную штору в списке устройств и раскройте её виджет нажатием на заголовок. В примере это «Спальня 3».
- Найдите ползунок «Позиция» и команды «Открыть», «Закрыть», «Остановить». Эти же пункты понадобятся при назначении связей «Карниза».

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

3. Включите характеристики и назначьте связи
Включите характеристики: «Целевая позиция (0–100%)», «Фактическое положение (0–100%)», «Кнопка открыть», «Кнопка стоп» и «Кнопка закрыть». Они добавляют соответствующие возможности и элементы управления в приложении. Затем назначьте им адреса.
Откройте «Настроить связи характеристики» у каждой из этих характеристик. Выбирайте канал именно нужного привода в драйвере Wiren Board.
| Характеристика XIOT | Адрес управления | Адрес состояния |
|---|---|---|
| Целевая позиция (0–100%) | Позиция нужной шторы | Пусто |
| Фактическое положение (0–100%) | Пусто | Позиция той же шторы |
| Кнопка открыть | Открыть нужную штору | Пусто |
| Кнопка стоп | Остановить нужную штору | Пусто |
| Кнопка закрыть | Закрыть нужную штору | Пусто |
Ниже показаны связи всех пяти характеристик на примере одной шторы. В своём проекте выберите соответствующие пункты нужного привода.
3.1. Целевая позиция
В поле «Адрес управления» выберите позицию нужной шторы. В примере это «Позиция Спальня 3». Поле «Адрес состояния» оставьте пустым. Эта связь задаёт желаемое положение.

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

3.3. Кнопка открыть
В поле «Адрес управления» выберите команду «Открыть» нужной шторы. Поле «Адрес состояния» оставьте пустым.

3.4. Кнопка стоп
В поле «Адрес управления» выберите команду «Остановить» той же шторы. Поле «Адрес состояния» оставьте пустым.

3.5. Кнопка закрыть
В поле «Адрес управления» выберите команду «Закрыть» той же шторы. Поле «Адрес состояния» оставьте пустым.

Подробнее о назначении полей: привязка адресов к характеристикам.
4. Согласуйте направление шкалы
Проверьте направление шкалы отдельно у целевой и фактической позиции. В рассмотренном примере сохранено обратное соответствие:
| Значение характеристики | Значение привода |
|---|---|
| 0 % | 100 |
| 100 % | 0 |
Для такой схемы откройте «Преобразование значений характеристики» и задайте соответствие крайних точек у обеих характеристик. Преобразование команды и обратного значения должно быть согласованным.

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

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