Перейти к содержанию

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

Материал из XIOT Wiki
Инструкция языком редактора: убраны отчётные пометки, версии и внутренние обозначения; упрощены подписи к снимкам
Виджет шторы в драйвере Wiren Board и пошаговый порядок настройки в редакторе
Строка 3: Строка 3:


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


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


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


'''Кнопки в предпросмотре могут двигать настоящие шторы.''' Перед проверкой управления убедитесь, что движению полотна ничего не мешает.
== 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|«Карниз»]]. Для каждой независимо управляемой шторы нужна отдельная карточка.
Строка 22: Строка 31:
[[Файл: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%)»''', '''«Кнопка открыть»''', '''«Кнопка стоп»''' и '''«Кнопка закрыть»'''. Они добавляют соответствующие возможности и элементы управления в приложении. Затем назначьте им адреса.
Включите характеристики: '''«Целевая позиция (0–100%)»''', '''«Фактическое положение (0–100%)»''', '''«Кнопка открыть»''', '''«Кнопка стоп»''' и '''«Кнопка закрыть»'''. Они добавляют соответствующие возможности и элементы управления в приложении. Затем назначьте им адреса.
Строка 50: Строка 59:
Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]].
Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]].


== Направление и преобразование процентов ==
== 4. Согласуйте направление шкалы ==


Проверьте направление шкалы '''отдельно у целевой и фактической позиции'''. В рассмотренном примере сохранено обратное соответствие:
Проверьте направление шкалы '''отдельно у целевой и фактической позиции'''. В рассмотренном примере сохранено обратное соответствие:
Строка 68: Строка 77:
Кнопки '''«Открыть»''' и '''«Закрыть»''' проверяются отдельно. Если они работают наоборот, проверьте направление привода и выбранные адреса. Перестановка команд открытия и закрытия не заменяет проверку шкалы положения.
Кнопки '''«Открыть»''' и '''«Закрыть»''' проверяются отдельно. Если они работают наоборот, проверьте направление привода и выбранные адреса. Перестановка команд открытия и закрытия не заменяет проверку шкалы положения.


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


В комнате появляется карточка шторы. В показанном интерфейсе короткое нажатие является командой управления, а удержание карточки с включённой целевой позицией открывает отдельную страницу. На ней находятся ползунок положения и кнопки '''«Открыть»''', '''«Стоп»''', '''«Закрыть»'''. Для открытия этой страницы не требуется двигать ползунок или нажимать команды.
В комнате появляется карточка шторы. В показанном интерфейсе короткое нажатие является командой управления, а удержание карточки с включённой целевой позицией открывает отдельную страницу. На ней находятся ползунок положения и кнопки '''«Открыть»''', '''«Стоп»''', '''«Закрыть»'''. Для открытия этой страницы не требуется двигать ползунок или нажимать команды.
Строка 76: Строка 91:
Общее пользовательское управление описано отдельно: [[Curtain-control-in-app|управление шторами в приложении]].
Общее пользовательское управление описано отдельно: [[Curtain-control-in-app|управление шторами в приложении]].


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


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

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

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

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

Порядок настройки: драйвер Wiren Board → устройство «Карниз» → характеристики и связи → направление шкалы → сохранение и загрузка → управление с телефона.

Подготовка

  1. Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя.
  2. Перед изменениями сделайте резервную копию проекта.

1. Найдите штору в драйвере Wiren Board

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

Кнопки и ползунок виджета управляют настоящей шторой. Чтобы посмотреть доступные элементы, нажимать команды не нужно. «Сбросить настройки» для привязки к XIOT не используется.

2. Добавьте и настройте устройство «Карниз»

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

3. Включите характеристики и назначьте связи

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

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

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

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

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

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

4. Согласуйте направление шкалы

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

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

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

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

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

5. Сохраните проект и загрузите настройки

  1. Нажмите «Сохранить проект» и дождитесь подтверждения.
  2. Повторно откройте настройки шторы: проверьте комнату, пять связей, параметры и преобразование обеих позиций.
  3. Чтобы применить настройки на контроллере, нажмите «Загрузить конфигурацию на контроллер» и дождитесь завершения загрузки.

6. Откройте управление шторой на телефоне

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

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

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

Проверка управления

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

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

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

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