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

Задачи и сценарии

http://<ip-платы>/tasks.html — где описаны автоматизации.

Задача — это правило «если триггер сработал и условия выполнены — выполни действия».

Анатомия задачи

Часть Сколько Логика Описание
Триггеры 1–3 ИЛИ Один из них должен сработать чтобы задача начала проверяться
Условия 0–3 (ESP8266), 0–4 (ESP32/C3) all / any (выбирается) Дополнительный фильтр перед действиями
Окно валидности 0–1 — По времени суток и дням недели
Действия 1–3 (ESP8266), 1–4 (ESP32/C3) последовательно Что выполнить

Триггеры

Тип триггера выбирается dropdown'ом — список приходит с /api/v1/triggers, то есть зависит от установленного набора возможностей.

interval

Срабатывает каждые interval_sec секунд. Простейший таймер.

Поле Назначение
interval_sec Период в секундах, 1..86400

Первое срабатывание — через interval_sec после загрузки платы (а не сразу).

cron

Поле Назначение
hour Час в диапазоне 0..23
minute Минута 0..59
days_mask Битмаска дней недели (bit 0 = вс, bit 6 = сб)

Нужна синхронизация времени

Cron работает только когда time.synced=true. Пока NTP не подключился, UI рисует warning. Если плата без интернета — установите время вручную в Настройках → Время или используйте триггеры interval и device_state.

sun (восход / закат)

Поле Назначение
event sunrise или sunset
offset_min Сдвиг в минутах: -30 = за полчаса до, +15 = через 15 минут после

Расчёт по NOAA-формуле, использует latitude и longitude из Настроек → Устройство. Без координат sun не сработает.

device_state

Поле Назначение
device_id ID устройства (из списка существующих)
compare above, below, equals
threshold Значение для сравнения (для above/below)
target_bool Для бинарных устройств (button, digital_input): true / false

Срабатывает при переходе через границу (edge-triggered), не на каждый цикл опроса. То есть «температура поднялась выше 25°C» сработает один раз, пока не упадёт обратно ниже и снова не превысит.

udp_event

Реакция на событие от mesh-соседа.

Поле Назначение
from_uuid UUID соседа (или * для любого)
event Имя события (строка, ≤16 символов)

Используется в паре с действием udp_send на соседе.

ping

Поле Назначение
host IP или hostname для проверки
port TCP-порт
interval_sec Период проверки
timeout_ms Таймаут одной попытки
expect up или down — что считается срабатыванием

Полезно для «если роутер недоступен — переключи питание» или «если погодный API не отвечает — не включай полив».

Условия

Каждое условие — это проверка в момент срабатывания триггера. Не события — просто моментальные проверки.

Тип Что проверяет
device_state Текущее значение/состояние устройства
wifi_rssi Сила сигнала Wi-Fi (полезно: «делай что-то только если связь хорошая»)
mesh_peer Есть ли в эфире сосед с заданным UUID
task_state Состояние другой задачи (последнее срабатывание, enabled/disabled)
sun_phase До/после восхода или заката, день/ночь/утро/вечер; смещение границ в минутах
uptime Время с загрузки платы — фильтр «не сразу после ребута»
time_window† Время суток (start_min..end_min) — отключён в дефолте с v0.4.76, дублирует встроенный «Срок действия» задачи. Наличие отдельного условия проверяйте в конструкторе, если нужна ИЛИ-логика с другими условиями.

Логика объединения: переключатель all / any в форме.

  • all — все условия должны быть выполнены (AND).
  • any — хотя бы одно (OR).

Фаза суток со смещением

Начиная с прошивки 0.6.1, условие sun_phase имеет поле «Смещение, мин» (offset_min, −180…180). Минус сдвигает границу раньше, плюс — позже. У существующей задачи без поля действует 0. Для дня/ночи/утра/вечера сдвигаются обе границы, включая расчётный полдень для утра/вечера.

Пример: включить свет по cron в 6:30, только пока ещё не наступил восход минус 10 минут:

{"type":"sun_phase","phase":"before_sunrise","offset_min":-10}

В задаче выключения задайте триггер «Восход», смещение −10. При восходе в 6:35 выключение пришлось бы на 6:25, поэтому в 6:30 условие включения уже ложно. При восходе в 6:40 граница равна 6:30: на самой границе условие «до» уже ложно, включения после выключения не будет.

Дополнительно в задачу выключения можно добавить второй триггер «Восход», смещение 0. Триггеры объединяются по ИЛИ. Он погасит свет на самом восходе, если тот был включён после первого выключения. Это резервное выключение, а не замена согласованному смещению условия.

Для появления поля формы обновите согласованную пару firmware и LittleFS из конструктора. Старые прошивки этого поля не поддерживают. Координаты и синхронизированное время обязательны.

Окно валидности

Глобальный фильтр поверх триггеров + условий.

Поле Назначение
start_min Минут от начала суток (0..1439). 8*60=480 = 08:00
end_min То же, конец окна
days_mask Битмаска дней недели, как у cron

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

Действия

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

relay

Поле Назначение
device_id ID реле
state on, off, toggle

udp_send

Поле Назначение
event Имя события (строка ≤16 символов)
payload Опциональная нагрузка (JSON-строка)

Шлёт событие в mesh-группу. Все соседи с подходящим udp_event-триггером сработают.

reboot

Перезагружает плату. Действий после него в цепочке не будет, очевидно.

wait

Поле Назначение
sec Задержка перед следующим действием, в секундах

Полезно для последовательностей «включи реле → подожди 5 сек → выключи».

reset_pulse

Поле Назначение
device_id ID pulse_counter устройства

Сбрасывает накопленный счёт обратно в 0.

Кнопка «▶ Запустить сейчас»

Каждая задача имеет кнопку ручного запуска — POST /api/v1/tasks/{id}/run. Уважает окно валидности и условия. Полезно для тестирования: «работает ли мой сценарий?» — нажал, посмотрел в RAM-логе.

Лимиты

Платформа TASKS_MAX
ESP8266 12
ESP32 32

Дальше

Контроль потери данных и связи

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

  • Триггер mesh_peer с peer_uuid и offline_after_sec (1–86400, по умолчанию 90 секунд) срабатывает при потере выбранного соседа. Условие mesh_peer только проверяет связь при запуске другой задачи и само выключение не вызывает.
  • Триггер sensor_missing с device_id и timeout_sec (1–86400, по умолчанию 60 секунд) отсчитывает время с последнего достоверного числового показания. Учитывается также отключённый/удалённый датчик. После старта без данных даётся полный выбранный интервал ожидания.
  • Оба триггера срабатывают один раз при переходе в состояние потери. После восстановления снова готовы зафиксировать следующую потерю. Это не команда, повторяемая каждый цикл, пока связь отсутствует.
  • Для числового device_state параметр fire_on_initial_match=true разрешает срабатывание уже на первом подходящем достоверном показании. Полезно для превышения порога, когда после старта температура уже высокая. По умолчанию сохраняется ожидание перехода через порог.

Для защиты по температуре задайте отдельные события: превышение предела, отсутствие показаний дольше выбранного времени и при необходимости потерю соседней платы. Действие — выключение нужного реле. В задаче включения проверяйте доступность/достоверное значение датчика, чтобы не включить нагрузку снова при продолжающемся отказе. Наличие сети по ping не доказывает исправность датчика.

Сохранённое устаревшее значение не считается свежим входом для условий. См. Удалённые показания.

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

Запуск после перезагрузки

У реле есть boot_policy: off выключает его при старте, off_if_timed выключает при прерванном временном включении, restore восстанавливает состояние. Выберите политику под нагрузку и проверьте физический выход после перезапуска.

Если задача использует окно времени, without_time=block блокирует её до получения достоверного времени; allow явно разрешает работу без часов. Разрешение без времени обходится без проверки этого временного окна, а не выдумывает подходящие часы.

Лимиты доступны в /api/v1/system/info → tasks: ESP8266/ESP-01S имеют до трёх триггеров, условий и действий на задачу; ESP32/C3 — до трёх триггеров и четырёх условий/действий. Число задач задаётся сборкой: ESP8266 по умолчанию четыре, в конструкторе можно выбрать пять; ESP32/C3 по умолчанию шестнадцать. Имя задачи занимает менее 64 байт UTF-8, а не 64 произвольных Unicode-символа.