Onviz-curtain-setup - История изменений

Admin: Снимок шторы в веб-интерфейсе Wiren Board, связи всех пяти характеристик и преобразование значений

2026-11-03T21:26:42Z

Снимок шторы в веб-интерфейсе Wiren Board, связи всех пяти характеристик и преобразование значений

@@ Строка 10: / Строка 10: @@
 # Привод должен быть отдельно настроен в Wiren Board: иметь уникальный адрес на своей шине и отвечать на опрос. Концевые положения и направление настраиваются по документации конкретного двигателя.
 # Перед изменениями сделайте [[Project-backup|резервную копию проекта]].
 == 1. Найдите штору в драйвере Wiren Board ==
@@ Строка 51: / Строка 55: @@
 |}
-Например, на снимках выбран пункт '''«Позиция Спальня 3»'''. У '''«Целевой позиции»''' он назначен в поле '''«Адрес управления»''', а у '''«Фактического положения»''' — в поле '''«Адрес состояния»'''. В первом случае задаётся желаемое положение, во втором — отображается положение, которое сообщает привод. В своём проекте выберите соответствующий пункт нужной шторы.
+Ниже показаны связи всех пяти характеристик на примере одной шторы. В своём проекте выберите соответствующие пункты нужного привода.
 [[Файл:Onviz-curtain-editor-target-20261103.png|thumb|center|800px|alt=У целевой позиции выбран адрес управления «Позиция Спальня 3», адрес состояния пуст|Целевая позиция: заполнено поле «Адрес управления».]]
 [[Файл:Onviz-curtain-editor-feedback-20261103.png|thumb|center|800px|alt=У фактического положения выбран адрес состояния «Позиция Спальня 3», адрес управления пуст|Фактическое положение: заполнено поле «Адрес состояния».]]
 Подробнее о назначении полей: [[Device-bindings|привязка адресов к характеристикам]].
@@ Строка 72: / Строка 102: @@
 Для такой схемы откройте '''«Преобразование значений характеристики»''' и задайте соответствие крайних точек у обеих характеристик. Преобразование команды и обратного значения должно быть согласованным.
 '''Не копируйте это преобразование без проверки направления движения.''' У другого привода или другой установки направление может отличаться. Проверьте, каким значениям соответствуют полностью открытая и полностью закрытая штора.

Admin: Виджет шторы в драйвере Wiren Board и пошаговый порядок настройки в редакторе

2026-11-03T21:15:13Z

Виджет шторы в драйвере Wiren Board и пошаговый порядок настройки в редакторе

← Предыдущая версия		Версия от 21:15, 3 ноября 2026
Строка 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.

Admin: Инструкция языком редактора: убраны отчётные пометки, версии и внутренние обозначения; упрощены подписи к снимкам

2026-11-03T21:08:06Z

Инструкция языком редактора: убраны отчётные пометки, версии и внутренние обозначения; упрощены подписи к снимкам

Внесённые изменения

Admin: Пример настройки штор ONVIZ через WB: связи Position/Open/Stop/Close и реальные снимки редактора и телефонного интерфейса

2026-11-03T21:00:28Z

Пример настройки штор ONVIZ через WB: связи Position/Open/Stop/Close и реальные снимки редактора и телефонного интерфейса

Новая страница

{{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]]