Alert

01

Kdy Alert použít

Alert se hodí ve chvíli, kdy nestačí jednorázová automatizace. Pokud například senzor vody přejde do stavu on, Alert může poslat první zprávu a potom připomínat problém každých několik minut, dokud senzor nehlásí klid.

Integrace sama neřeší složité podmínky. Sleduje jednu entitu a porovnává její stav s nastavenou hodnotou. Pro více podmínek nejdřív vytvořte pomocný binární senzor a Alert napojte až na jeho výsledný stav.

02

Příprava

Nejdřív ověřte, že už umíte z RichPear Home poslat běžné oznámení. Alert používá existující oznamovací služby, například mobilní aplikaci, skupinu příjemců nebo jinou službu s názvem notify.*.

Vyberte sledovanou entitu, problémový stav a příjemce. U kritických stavů si předem rozmyslete, jestli má jít upozornění potvrdit, nebo jestli má pokračovat až do skutečného vyřešení.

03

Základní nastavení

Alert se zapisuje ručně do configuration.yaml. Po úpravě zkontrolujte konfiguraci a restartujte RichPear Home, aby se nová entita načetla.

alert:
  garazova_vrata:
    name: Garážová vrata jsou otevřená
    done_message: Garážová vrata jsou zavřená
    entity_id: binary_sensor.garazova_vrata
    state: "on"
    repeat: 30
    can_acknowledge: true
    skip_first: true
    notifiers:
      - mobile_app_telefon

Klíč garazova_vrata vytvoří entitu alert.garazova_vrata. Do notifiers zapisujte jen koncovou část oznamovací služby, tedy například mobile_app_telefon, ne celý název notify.mobile_app_telefon.

04

Stavy entity

Alert vytvoří samostatnou entitu alert.*. Stav idle znamená, že sledovaná podmínka neplatí. Stav on znamená, že problém právě trvá a upozornění se může posílat. Stav off znamená, že problém stále trvá, ale někdo ho potvrdil.

Potvrzení je dočasné. Jakmile se sledovaná entita vrátí mimo problémový stav, Alert se vyčistí. Při dalším výskytu problému začne znovu od začátku.

05

Opakování

repeat určuje prodlevu v minutách. Jedno číslo znamená stálý interval, například repeat: 30 opakuje upozornění každých 30 minut.

alert:
  unik_vody:
    name: Detekován únik vody
    entity_id: binary_sensor.unik_vody
    state: "on"
    repeat:
      - 5
      - 15
      - 60
    skip_first: false
    notifiers:
      - mobile_app_telefon

Seznam hodnot mění interval v čase. V příkladu odejde první zpráva hned, další po 5 minutách, další po 15 minutách a potom každou hodinu. Pokud nastavíte skip_first: true, první zpráva se neposílá hned, ale až po první prodlevě.

06

Složitější pravidla

Pro pravidla typu „baterie je pod 15 %“, „je noc a okno je otevřené“ nebo „problém platí jen ve všední den“ nejdřív vytvořte pomocnou entitu, která vrací jednoduché on nebo off.

template:
  - binary_sensor:
      - name: Baterie pohybového senzoru je nízká
        state: "{{ state_attr('sensor.pohyb', 'battery') | float(default=0) < 15 }}"
        device_class: battery

alert:
  nizka_baterie_pohyb:
    name: Baterie pohybového senzoru je nízká
    entity_id: binary_sensor.baterie_pohyboveho_senzoru_je_nizka
    repeat: 30
    notifiers:
      - mobile_app_telefon

Tím zůstane Alert jednoduchý a čitelný. Složitější rozhodování patří do pomocné entity, kde ho lze samostatně zkontrolovat.

07

Text zpráv

Bez vlastního textu použije Alert jako zprávu hodnotu name. Položkou message nastavíte problémovou zprávu, done_message zprávu po návratu do pořádku a title nadpis, pokud ho zvolená oznamovací služba podporuje.

alert:
  kvetina_pracovna:
    name: Kytka v pracovně potřebuje péči
    entity_id: plant.kvetina_pracovna
    state: "problem"
    repeat: 30
    message: "Kytka v pracovně hlásí problém: {{ state_attr('plant.kvetina_pracovna', 'problem') }}"
    done_message: Kytka v pracovně je v pořádku
    title: RichPear Home
    notifiers:
      - mobile_app_telefon

Zpráva po vyřešení se odešle jen tehdy, pokud už předtím odešla alespoň jedna problémová zpráva. U odloženého prvního upozornění se tedy při rychlém vyřešení nemusí poslat nic.

08

Doplňková data

Některé oznamovací služby podporují další parametry, například tag, tlačítka, barvu nebo cílový kanál. Tyto hodnoty patří do data a předávají se vybrané službě beze změny.

alert:
  garazova_vrata:
    name: Garážová vrata jsou otevřená
    done_message: clear_notification
    entity_id: binary_sensor.garazova_vrata
    state: "on"
    repeat: 30
    skip_first: true
    notifiers:
      - mobile_app_telefon
    data:
      tag: garazova-vrata

U mobilních oznámení se stejným tag obvykle nahrazuje starší oznámení novějším. Hodnota clear_notification v done_message se používá pro odstranění souvisejícího oznámení po vyřešení.

09

Kontrola provozu

Po restartu najděte vytvořenou entitu alert.* a ověřte její stav. Potom bezpečně vyvolejte ověřovací problém, zkontrolujte první zprávu, opakování a návrat do idle.

Pokud zprávy nechodí, zkontrolujte název v notifiers, funkčnost samotné oznamovací služby a přesný stav sledované entity. Nejčastější chyba je rozdíl mezi očekávaným stavem on a reálnou hodnotou, kterou entita skutečně hlásí.