Просмотр кода страницы Curtain-triggered-lighting-scenario

{{DISPLAYTITLE:Сценарий "Управление светом по движению штор"}}
__NOTOC__

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Время плавного изменения яркости ===

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

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

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

Светильники без управляемой яркости включаются и выключаются обычной командой '''включение'''.

=== Возвращать свет после закрытия штор в течение ===

Время в минутах, в течение которого сценарий хранит снимок света для восстановления.

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

Если значение больше '''0''', сценарий сбросит сохранённое состояние после указанного времени. После этого закрытие штор уже не вернёт старый свет.

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

Для ночного сценария «посмотреть на звёздное небо» обычно удобно указывать '''30–60 минут''': этого достаточно, чтобы открыть шторы, некоторое время смотреть на улицу, а затем закрыть шторы и вернуть свет.

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Плавное изменение яркости ===

Плавное изменение применяется только к светильникам, у которых настроена управляемая характеристика '''яркость'''.

Обычные недиммируемые светильники продолжают включаться и выключаться сразу.

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

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

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

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

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

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

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

== Отладка ==

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

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

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

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

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

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

[[Категория:Сценарии XIOT]]
[[Категория:Документация XIOT]]
{{DEFAULTSORT:Сценарий "Управление светом по движению штор"}}