Задачи и сценарии¶
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 минут:
В задаче выключения задайте триггер «Восход», смещение −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-символа.