Curtain-triggered-lighting-scenario - История изменений

Admin: Английские адреса Wiki: обновление ссылок с сохранением русских подписей

2026-10-02T22:31:24Z

Английские адреса Wiki: обновление ссылок с сохранением русских подписей

← Предыдущая версия		Версия от 22:31, 2 октября 2026
Строка 253:		Строка 253:
	[[Категория:Сценарии XIOT]]		[[Категория:Сценарии XIOT]]
	[[Категория:Документация XIOT]]		[[Категория:Документация XIOT]]
			{{DEFAULTSORT:Сценарий "Управление светом по движению штор"}}

Admin: Admin переименовал страницу Сценарий "Управление светом по движению штор" в Curtain-triggered-lighting-scenario: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T21:50:16Z

Admin переименовал страницу Сценарий "Управление светом по движению штор" в Сценарий "Управление светом по движению штор": Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия	Версия от 21:50, 2 октября 2026
(нет различий)

Admin: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T21:50:13Z

Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия		Версия от 21:50, 2 октября 2026
Строка 1:		Строка 1:
			{{DISPLAYTITLE:Сценарий "Управление светом по движению штор"}}
	__NOTOC__		__NOTOC__

Admin: Уточнен режим день/ночь для сценария света по шторам

2026-06-02T07:26:40Z

Уточнен режим день/ночь для сценария света по шторам

← Предыдущая версия		Версия от 07:26, 2 июня 2026
Строка 69:		Строка 69:
	* '''Только ночью''' — сценарий работает только когда дом находится в ночном состоянии;		* '''Только ночью''' — сценарий работает только когда дом находится в ночном состоянии;
	* '''Только днём''' — сценарий работает только когда дом не находится в ночном состоянии.		* '''Только днём''' — сценарий работает только когда дом не находится в ночном состоянии.

			В этом сценарии ночь определяется по характеристике дома '''ночь по закату'''. Это период после заката и до рассвета, рассчитанный по времени рассвета и заката.

			Характеристика '''ночь по времени''' для этого режима не используется: она относится к пользовательскому расписанию сна и пробуждения.

	По умолчанию используется режим '''Только ночью''', так как основной кейс связан с вечерним или ночным открытием штор.		По умолчанию используется режим '''Только ночью''', так как основной кейс связан с вечерним или ночным открытием штор.

Admin: Обновлен сценарий управления светом по шторам

2026-06-02T07:21:02Z

Обновлен сценарий управления светом по шторам

@@ Строка 18: / Строка 18: @@
 * при обратном движении или достижении обратного положения восстанавливает сохранённое состояние;
 * может восстановить не только включение, но и яркость светильников;
 * может не перезаписывать свет, который пользователь включил вручную после срабатывания сценария.
@@ Строка 120: / Строка 122: @@
 Если параметр выключен, сценарий восстанавливает только состояние включения / выключения.
 === Не перезаписывать свет, включённый вручную ===
@@ Строка 162: / Строка 186: @@
 # Оставьте параметр '''Когда восстанавливать свет''' = '''после достижения обратного положения'''.
 # Оставьте режим '''Режим работы день/ночь''' = '''Только ночью'''.
 # Включите сценарий через характеристику '''Включение сценария'''.
@@ Строка 175: / Строка 201: @@
 Если светильник был включён с яркостью 30%, после восстановления он снова будет включён с яркостью 30%, если параметр восстановления яркости включён.
 === Несколько штор ===
@@ Строка 196: / Строка 232: @@
 * движение в заданном направлении — сохранение состояния и выключение света;
 * обратное движение или достижение обратного положения — восстановление света;
 * пропуск срабатывания — сценарий выключен, не выполнены условия день/ночь или дома/не дома, выбранный свет уже выключен.
@@ Строка 203: / Строка 240: @@
 * Для ночного сценария оставляйте режим '''Только ночью'''.
 * Если у привода нет точного положения, привяжите хотя бы статус открыто / закрыто.
 * Для нескольких штор используйте восстановление '''после достижения обратного положения'''.

Admin: Убраны технические имена характеристик из инструкции сценария

2026-05-27T19:02:49Z

Убраны технические имена характеристик из инструкции сценария

← Предыдущая версия		Версия от 19:02, 27 мая 2026
Строка 28:		Строка 28:
	Сценарий может работать с одной или несколькими шторами. Если выбрано несколько штор, восстановление по положению выполняется только тогда, когда все выбранные шторы достигли обратного положения.		Сценарий может работать с одной или несколькими шторами. Если выбрано несколько штор, восстановление по положению выполняется только тогда, когда все выбранные шторы достигли обратного положения.

	Сценарий определяет движение штор по доступным характеристикам:		Сценарий определяет движение штор по доступным характеристикам устройства:

	* '''~~PositionState~~''' — открывается, закрывается, остановлена;		* '''Состояние: открывается/закрывается/стоп''' — показывает, что штора открывается, закрывается или остановлена;
	* '''~~DirectionMove~~''' — последнее направление движения;		* '''Состояние: последнее направление движения''' — показывает последнее направление движения шторы;
	* '''~~Close~~''' — команда открыть / закрыть;		* '''Управление''' — команда открыть или закрыть штору;
	* '''~~CloseState~~''' — фактическое состояние ~~открыто / закрыто~~;		* '''Состояние''' — фактическое состояние шторы: открыта или закрыта;
	* '''~~TargetPosition~~''' — ~~целевое~~ положение;		* '''Целевая позиция (0–100%)''' — положение, к которому должна прийти штора;
	* '''~~CurrentPosition~~''' — текущее положение.		* '''Фактическое положение (0–100%)''' — текущее положение шторы.

	Это позволяет использовать сценарий с разными типами приводов и разными способами обратной связи.		Это позволяет использовать сценарий с разными типами приводов и разными способами обратной связи.
Строка 45:		Строка 45:
	Сценарий сохраняет:		Сценарий сохраняет:

	* состояние ~~включения~~ '''On''';		* состояние характеристики '''включение''';
	* ~~яркость~~ '''~~Brightness~~''', если ~~характеристика~~ есть у выбранного светильника.		* значение характеристики '''яркость''', если она есть у выбранного светильника.

	== Характеристики сценария ==		== Характеристики сценария ==
Строка 144:		Строка 144:
	Порог положения шторы в процентах, при котором штора считается открытой.		Порог положения шторы в процентах, при котором штора считается открытой.

	Используется для приводов, которые передают '''~~CurrentPosition~~''' или '''~~TargetPosition~~'''. По умолчанию: '''5%'''.		Используется для приводов, которые передают '''Фактическое положение (0–100%)''' или '''Целевая позиция (0–100%)'''. По умолчанию: '''5%'''.

	=== Положение считается закрытым ===		=== Положение считается закрытым ===
Строка 150:		Строка 150:
	Порог положения шторы в процентах, при котором штора считается закрытой.		Порог положения шторы в процентах, при котором штора считается закрытой.

	Используется для приводов, которые передают '''~~CurrentPosition~~''' или '''~~TargetPosition~~'''. По умолчанию: '''95%'''.		Используется для приводов, которые передают '''Фактическое положение (0–100%)''' или '''Целевая позиция (0–100%)'''. По умолчанию: '''95%'''.

	== Пример настройки ==		== Пример настройки ==

Admin: Добавлена инструкция сценария управления светом по движению штор

2026-05-27T18:50:13Z

Добавлена инструкция сценария управления светом по движению штор

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

__NOTOC__

= Управление светом по движению штор =

== Назначение ==

'''Управление светом по движению штор''' — сценарий для автоматического выключения и восстановления освещения при движении штор.

Основной сценарий использования: ночью в комнате с панорамными окнами пользователь открывает шторы, чтобы посмотреть на улицу или на звёзды. В этот момент свет в комнате автоматически выключается, чтобы помещение не было видно снаружи. Когда шторы закрываются обратно, свет возвращается в то состояние, в котором он был до срабатывания сценария.

Сценарий можно использовать и для других задач, потому что условия работы, направление движения, задержки и способ восстановления вынесены в параметры.

== Что делает сценарий ==

* отслеживает движение выбранных штор;
* при заданном направлении движения сохраняет состояние выбранных светильников;
* выключает включённые светильники;
* при обратном движении или достижении обратного положения восстанавливает сохранённое состояние;
* может восстановить не только включение, но и яркость светильников;
* может не перезаписывать свет, который пользователь включил вручную после срабатывания сценария.

== Устройства сценария ==

=== Входные устройства ===

'''Шторы''' — устройства типа '''Карниз / Штора'''.

Сценарий может работать с одной или несколькими шторами. Если выбрано несколько штор, восстановление по положению выполняется только тогда, когда все выбранные шторы достигли обратного положения.

Сценарий определяет движение штор по доступным характеристикам:

* '''PositionState''' — открывается, закрывается, остановлена;
* '''DirectionMove''' — последнее направление движения;
* '''Close''' — команда открыть / закрыть;
* '''CloseState''' — фактическое состояние открыто / закрыто;
* '''TargetPosition''' — целевое положение;
* '''CurrentPosition''' — текущее положение.

Это позволяет использовать сценарий с разными типами приводов и разными способами обратной связи.

=== Управляемые устройства ===

'''Светильники''' — устройства типа '''Светильник'''.

Сценарий сохраняет:

* состояние включения '''On''';
* яркость '''Brightness''', если характеристика есть у выбранного светильника.

== Характеристики сценария ==

В виджете сценария доступна только характеристика '''Включение сценария'''.

Если сценарий выключен, движение штор игнорируется. Это сделано намеренно: сценарии в XIOT должны быть опциональными, чтобы пользователь мог быстро отключить автоматизацию из интерфейса.

== Параметры ==

=== Название сценария ===

Отображаемое имя сценария в редакторе и интерфейсе.

=== Режим работы день/ночь ===

Определяет, когда сценарий имеет право срабатывать:

* '''Всегда''' — сценарий работает в любое время;
* '''Только ночью''' — сценарий работает только когда дом находится в ночном состоянии;
* '''Только днём''' — сценарий работает только когда дом не находится в ночном состоянии.

По умолчанию используется режим '''Только ночью''', так как основной кейс связан с вечерним или ночным открытием штор.

=== Режим работы дома/не дома ===

Определяет зависимость от присутствия:

* '''Всегда''' — сценарий не проверяет присутствие;
* '''Если я дома''' — сценарий работает только когда пользователи дома;
* '''Если я не дома''' — сценарий работает только когда пользователей нет дома.

По умолчанию используется режим '''Всегда''', чтобы сценарий можно было применять не только для жилого ночного кейса, но и для других задач автоматизации.

=== Когда выключать свет ===

Определяет направление движения штор, которое запускает выключение света:

* '''при открытии штор''' — свет выключается, когда шторы начинают открываться;
* '''при закрытии штор''' — свет выключается, когда шторы начинают закрываться.

По умолчанию: '''при открытии штор'''.

=== Когда восстанавливать свет ===

Определяет момент восстановления сохранённого света:

* '''после достижения обратного положения''' — сценарий ждёт, пока штора фактически дойдёт до обратного положения;
* '''при начале обратного движения''' — свет восстанавливается сразу, когда штора начинает двигаться обратно.

По умолчанию: '''после достижения обратного положения'''.

Для основного ночного сценария это означает:

* открыли шторы — свет выключился;
* закрыли шторы полностью — свет восстановился.

=== Задержка выключения света ===

Время в секундах между обнаружением движения штор и выключением света.

Если значение равно '''0''', свет выключается сразу.

=== Задержка восстановления света ===

Время в секундах между выполнением условия восстановления и включением сохранённого света.

Если значение равно '''0''', свет восстанавливается сразу.

=== Восстанавливать яркость ===

Если параметр включён, сценарий перед включением светильника возвращает сохранённую яркость.

Если параметр выключен, сценарий восстанавливает только состояние включения / выключения.

=== Не перезаписывать свет, включённый вручную ===

Если параметр включён, сценарий не будет изменять светильник, который пользователь включил вручную после автоматического выключения.

Пример:

* шторы открылись, сценарий выключил свет;
* пользователь вручную включил один светильник;
* шторы закрылись;
* сценарий не перезапишет этот светильник сохранённым состоянием.

Такой режим защищает ручное управление пользователя от неожиданного изменения.

=== Запускать только если выбранный свет включён ===

Если параметр включён, сценарий запускается только тогда, когда хотя бы один выбранный светильник был включён.

Если все выбранные светильники уже выключены, сценарий ничего не делает и не создаёт снимок состояния.

=== Положение считается открытым ===

Порог положения шторы в процентах, при котором штора считается открытой.

Используется для приводов, которые передают '''CurrentPosition''' или '''TargetPosition'''. По умолчанию: '''5%'''.

=== Положение считается закрытым ===

Порог положения шторы в процентах, при котором штора считается закрытой.

Используется для приводов, которые передают '''CurrentPosition''' или '''TargetPosition'''. По умолчанию: '''95%'''.

== Пример настройки ==

Для комнаты с панорамным окном:

# Создайте сценарий '''Управление светом по движению штор'''.
# В блоке '''Шторы''' выберите карнизы или шторы этой комнаты.
# В блоке '''Светильники''' выберите светильники, которые должны временно выключаться.
# Оставьте параметр '''Когда выключать свет''' = '''при открытии штор'''.
# Оставьте параметр '''Когда восстанавливать свет''' = '''после достижения обратного положения'''.
# Оставьте режим '''Режим работы день/ночь''' = '''Только ночью'''.
# Включите сценарий через характеристику '''Включение сценария'''.

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

== Особенности работы ==

=== Сохранение состояния ===

Снимок состояния создаётся только в момент срабатывания сценария. В снимок попадают выбранные светильники и их текущие значения.

Если светильник был выключен до открытия штор, он останется выключенным после восстановления.

Если светильник был включён с яркостью 30%, после восстановления он снова будет включён с яркостью 30%, если параметр восстановления яркости включён.

=== Несколько штор ===

Если в сценарии выбрано несколько штор и включён режим восстановления по положению, сценарий ждёт обратного положения по всем выбранным шторам.

Это нужно, чтобы свет не включался раньше времени, если одна штора уже закрылась, а другая ещё открыта.

=== Ручное управление ===

По умолчанию сценарий уважает ручное включение света после автоматического выключения.

Если нужно, чтобы сценарий всегда принудительно возвращал исходное состояние, выключите параметр '''Не перезаписывать свет, включённый вручную'''.

== Отладка ==

Для проверки сценария удобно включить отладку устройства в редакторе и наблюдать сообщения сценария.

Основные события:

* движение в заданном направлении — сохранение состояния и выключение света;
* обратное движение или достижение обратного положения — восстановление света;
* пропуск срабатывания — сценарий выключен, не выполнены условия день/ночь или дома/не дома, выбранный свет уже выключен.

Технические причины пропусков записываются в отладочные сообщения, пользовательские действия сценария — в события.

== Рекомендации ==

* Для ночного сценария оставляйте режим '''Только ночью'''.
* Если у привода нет точного положения, привяжите хотя бы статус открыто / закрыто.
* Для нескольких штор используйте восстановление '''после достижения обратного положения'''.
* Если светом часто управляют вручную, оставьте включённым параметр защиты ручного включения.

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