Просмотр кода страницы Automatic-irrigation-scenario

{{DISPLAYTITLE:Сценарий "Автополив"}}
__NOTOC__

= Автополив =

[[Файл:Автополив в приложении XIOT.png|без|мини|1000пкс|Страница сценария «Автополив» в приложении XIOT]]

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

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

Сценарий поддерживает от 1 до 16 зон. Он подходит как для простых систем, работающих только по времени, так и для систем с одним или несколькими датчиками влажности почвы в каждой зоне.

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

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

== Подключаемые устройства ==

=== Входные блоки ===

{| class="wikitable"
! Блок
! Что подключается
! Обязательность
|-
| '''Датчик дождя'''
| датчик с характеристикой '''обнаружен дождь'''.
| необязательно
|-
| '''Зона 1: датчики влажности почвы''' ... '''Зона 16: датчики влажности почвы'''
| один или несколько датчиков влажности соответствующей зоны.
| необязательно
|}

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

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

{| class="wikitable"
! Блок
! Что подключается
|-
| '''Насос полива'''
| устройство типа '''Насос'''. Сценарий отправляет ему характеристику '''запрос на работу'''.
|-
| '''Зона 1: клапан полива''' ... '''Зона 16: клапан полива'''
| кран воды, реле, выключатель, розетка или сервопривод соответствующей зоны.
|}

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

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

{| class="wikitable"
! Характеристика
! Назначение
|-
| '''включение сценария'''
| разрешает или запрещает автоматическую работу по расписанию.
|-
| '''периоды разрешённого полива'''
| дни недели и интервалы времени, в которые может выполняться программа.
|-
| '''полив активен'''
| показывает, выполняется ли полив; запись 1 запускает программу вручную, запись 0 останавливает её.
|-
| '''текущая зона'''
| номер зоны, которая сейчас поливается. При выборе другой зоны во время работы сценарий переключается на неё и начинает отсчёт заново.
|-
| '''следующая зона'''
| зона, с которой начнётся следующий запуск или продолжение программы.
|-
| '''оставшееся время'''
| количество секунд до завершения полива текущей зоны.
|-
| '''Зона N: время полива'''
| длительность полива выбранной зоны в минутах.
|}

== Основные параметры ==

{| class="wikitable"
! Параметр
! По умолчанию
! Назначение
|-
| '''Название сценария'''
| Автополив
| название в редакторе и приложении.
|-
| '''Количество зон полива'''
| 1
| количество участвующих зон, от 1 до 16.
|-
| '''Название зоны N'''
| Зона N
| понятное пользователю название зоны.
|-
| '''Зона N: порог влажности для пропуска полива'''
| 30%
| если расчётная влажность не ниже порога, зона пропускается.
|-
| '''Останавливать полив при дожде'''
| да
| блокирует запуск и останавливает выполняющийся полив при сигнале дождя.
|-
| '''Работа сценария по присутствию'''
| всегда
| разрешает работу всегда, только когда дома или только когда никого нет.
|-
| '''Учёт нескольких датчиков влажности в зоне'''
| по среднему значению
| выбирает среднее, минимальное или максимальное значение исправных датчиков зоны.
|-
| '''Пауза после открытия клапана до запуска насоса'''
| 3 сек.
| даёт клапану время открыться до подачи давления.
|-
| '''Пауза после остановки насоса до закрытия клапана'''
| 3 сек.
| снимает давление перед закрытием клапана.
|-
| '''Пауза между зонами'''
| 5 сек.
| задержка перед переходом к следующей зоне.
|}

Для каждой активной зоны характеристика '''время полива''' по умолчанию равна 10 минутам.

== Расписание ==

По умолчанию создан один период: '''06:00–22:00, каждый день'''. В приложении можно изменить начало, окончание, активность периода и дни недели.

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

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

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

== Учёт влажности почвы ==

Для каждой зоны сценарий использует собственный порог влажности:

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

Если в одной зоне установлено несколько датчиков, доступны три способа расчёта:

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

Значения датчиков с активной ошибкой не участвуют в расчёте.

== Последовательность работы ==

При запуске сценарий:

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

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

== Работа с приложением ==

На странице сценария отображаются:

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

Нажатие на зону при остановленном поливе выбирает её как следующую. При работающем поливе выбор другой зоны останавливает текущий цикл и запускает выбранную зону с полным заданным временем.

Изменение длительности текущей зоны также перезапускает отсчёт этой зоны с новым значением.

== Блокировки и сообщения ==

Сценарий не запускает полив, если:

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

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

== Рекомендации по настройке ==

* Укажите понятные названия зон: '''Газон''', '''Клумбы''', '''Теплица'''.
* Сначала проверьте открытие каждого клапана без работающего насоса.
* Для насоса используйте устройство '''Насос''', чтобы несколько сценариев могли безопасно формировать общий запрос на работу.
* Подберите задержку открытия клапана по фактическому времени срабатывания привода.
* Не задавайте слишком короткий период расписания: в нём должно помещаться полное время нужных зон и технологические паузы.
* Для участка с заметно разной влажностью используйте несколько датчиков и режим '''по минимальному значению'''.

== Проверка после настройки ==

Проверьте:

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

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