Pravidla¶

Pravidla umožňují, aby položka reagovala na víc než jen svůj vlastní stav. Existují u každého druhu položky: světel, LED pásků, spotřebičů, doku robotického vysavače, nábytku, textů i místností.

Sekce Pravidla u spotřebiče se dvěma pravidly, jedno v režimu entit a jedno v režimu Jinja

Jak se pravidla vyhodnocují¶

rules je uspořádaný seznam. Každé pravidlo má podmínky (if) a výstupy. U každého výstupního pole vyhrává první pravidlo, jehož podmínky platí všechny a které toto pole nastavuje. Pravidlo bez if je výchozí.

rules:
  - if: [ ... ]        # musí platit všechny podmínky (AND)
    color: red
  - color: blue        # bez "if": platí, když žádné dřívější pravidlo barvu nenastavilo

Podmínky¶

Podmínky můžeš psát ve dvou režimech. Každé pravidlo má přepínač Podle entit / Šablona Jinja; přepnutí z entit na Jinja stávající podmínky převede.

Podle entitŠablona Jinja

Podmínka je {entity, attribute?, state | state_not | above | below}. state a state_not mohou být seznam. {any: [podmínky]} je skupina OR.

if:
  - entity: climate.living_room
    attribute: hvac_action
    state: heating
  - entity: sensor.outdoor_temperature
    below: 5
  - any:
      - entity: binary_sensor.window
        state: "on"
      - entity: binary_sensor.door
        state: "on"

Ve formuláři má každá podmínka entitu (se zkratkou tato entita), volitelný atribut a operátor je / není / větší než / menší než / šablona. Nové podmínky se předvyplní entitou položky (místnost použije svůj senzor teploty).

Jediná podmínka {template: "{{ ... }}"}. Home Assistant ji vyhodnocuje živě a platí pro true, on, yes, 1 nebo nenulové číslo.

if:
  - template: "{{ is_state('binary_sensor.front_door', 'on') and states('sensor.outdoor_temperature') | float(0) < 0 }}"

Výstup text, který obsahuje {{ }}, je rovněž šablona.

Výstupy¶

Výstup	Efekt
`color`	Obarví ikonu a rámeček odznaku; u nábytku obrys a výplň; u světla přebije barvu žárovky (odznak, záře, pásek); u robota nahradí barvu motivu, i v doku
`glow`	Přidá kolem položky záři
`animate`	Přebije `active` u spotřebiče: `true` / `false`. `animate: false` zastaví i animaci ikony
`wave`	Barva vln tepla u radiátoru
`text`	Nahradí text pod ikonou (prostý nebo šablona)
`tint` (nebo `color`)	U místnosti: podbarví podlahu; `opacity` určuje sílu (výchozí 0,14)
`hide`	Skryje položku (u místnosti její jmenovku)
`icon`	Vymění ikonu (spotřebiče, světla, nábytek, dok). `none` ji odstraní; vyber ji ve výběru ikon
`background`	Pozadí textové položky
`fx`	Animace kruhu: `ring`, `radar`, `comet`, `countdown`, `spin`, `orbit`, `breath`, `blink`, `heartbeat`, `shake`, `none`
`progress`	Entita, která řídí `countdown` (viz níže)
`progress_total`	Délka v minutách pro `countdown`

Barvy: red, orange, yellow, green, blue, purple, pink, white, black, libovolný název barvy motivu vybraný ve formuláři (ukládá se pod názvem, například teal), nebo libovolná barva CSS (hex, rgb(...), var(...)).

Světla, LED pásky, dok a nábytek nemají vlastní animaci kruhu, takže se kruh objeví, jen když ho pravidlo nastaví přes fx. Kruh LED pásku je uprostřed pásku, u nábytku uprostřed obdélníku.

Pro výstup kruhu platí priorita: pravidlo, pak vlastní nastavení spotřebiče, pak výchozí chování alarmu podle stavu.

Odpočet¶

fx: countdown kreslí ubývající oblouk. Odkud bere průběh:

progress: timer.kitchen: timer (aktivní nebo pozastavený),
progress: sensor.dryer_remaining s device_class: duration (sekundy, minuty nebo hodiny; celek je progress_total, jinak nejvyšší dosud viděná hodnota),
progress: sensor.dryer_end s device_class: timestamp (čas konce; začátek je last_changed běžícího zařízení, jinak progress_total),
progress: sensor.dryer_progress v %: kruh se plní jako baterie (0 % prázdný, 100 % plný),
progress_total: 45 bez entity: odpočet o této délce v minutách, počítaný od změny entity z podmínky pravidla (u spotřebiče od okamžiku, kdy se rozběhne).

Bez ničeho z toho je odpočet jen dekorativní cyklus o délce 4 sekundy.

Pravidla jako YAML¶

Každé pravidlo má v hlavičce tlačítko { }, které otevře jen toto pravidlo jako YAML v editoru kódu Home Assistantu (barvy syntaxe, čísla řádků, nápovědy entit a ikon). Změna se potvrdí, když editor opustíš. Stejné YAML vidíš ve formátu plánu.

Jedno pravidlo otevřené jako YAML z hlavičky pravidla

Asistent AI Task¶

Pokud má tvůj Home Assistant entitu ai_task.*, která podporuje generování dat, zobrazí sekce Pravidla tlačítko Navrhnout s AI. Jednou větou popiš, co chceš. Editor pošle popis službě ai_task.generate_data spolu s formátem pravidel, výstupy povolenými pro tuto položku, její entitou (stav a atributy), stávajícími pravidly a seznamem tvých entit (až 1500, bez entit update, event, scene a script). Odpověď dorazí jako YAML a otevře se jako návrh; pravidla nahradí teprve Použít návrh. Pokud požadavek nejde splnit, asistent odpoví jednou větou, kterou uvidíš jako zprávu.

Příklady¶

Dokončení praní¶

devices:
  - id: washer
    kind: generic
    name: Pračka
    entity: sensor.washer_state
    icon: mdi:washing-machine
    x: 1.2
    z: 3.4
    rules:
      - if:
          - entity: sensor.washer_state
            state: running
        color: blue
        animate: true
        fx: countdown
        progress: sensor.washer_finish_time   # device_class: timestamp
      - if:
          - entity: sensor.washer_state
            state: finished
        color: green
        fx: blink
        text: Hotovo

Otevřené dveře¶

Šablona s now() se překresluje každou minutu, takže se pravidlo zapne pět minut po otevření dveří.

rooms:
  - id: hall
    name: Předsíň
    points: [[0, 0], [3, 0], [3, 2.5], [0, 2.5]]
    rules:
      - if:
          - template: >-
              {{ is_state('binary_sensor.front_door', 'on')
                 and (now() - states.binary_sensor.front_door.last_changed).total_seconds() > 300 }}
        tint: orange
        opacity: 0.3

Poplach při úniku vody¶

devices:
  - id: leak
    kind: generic
    name: Únik vody
    entity: binary_sensor.kitchen_leak
    x: 2.0
    z: 1.0
    rules:
      - if:
          - entity: binary_sensor.kitchen_leak
            state: "on"
        color: red
        glow: true
        fx: blink
        text: Únik!
      - hide: true

Poslední pravidlo nemá podmínku, takže se položka skryje vždy, když voda neuniká.

Procentuální kruh jako baterie¶

devices:
  - id: phone_battery
    kind: generic
    name: Telefon
    entity: sensor.phone_battery_level
    x: 4.0
    z: 2.0
    rules:
      - if:
          - entity: sensor.phone_battery_level
            below: 20
        color: red
        fx: countdown
        progress: sensor.phone_battery_level
      - fx: countdown
        progress: sensor.phone_battery_level
        color: green

Odpočet časovače¶

Trouba, která odpočítává 45 minut od okamžiku zapnutí:

devices:
  - id: oven
    kind: generic
    name: Trouba
    entity: switch.oven
    x: 3.1
    z: 0.4
    rules:
      - if:
          - entity: switch.oven
            state: "on"
        fx: countdown
        progress_total: 45
        color: orange

A pomocník kuchyňský časovač, který řídí kruh:

    rules:
      - if:
          - entity: timer.kitchen
            state: active
        fx: countdown
        progress: timer.kitchen
        color: yellow

Radiátor reagující na okno, boost a ventil¶

devices:
  - id: radiator_living
    kind: radiator
    entity: climate.living_room
    x: 4.3
    z: 1.1
    rules:
      - if:
          - entity: switch.boost_living_room
            state: "on"
        color: yellow
      - if:
          - any:
              - entity: binary_sensor.living_room_window
                state: "on"
              - entity: binary_sensor.balcony_door
                state: "on"
        color: blue
      - if:
          - entity: switch.valve_living_room
            state: "on"
        color: orange
        animate: true
        wave: red
      - animate: false

Zpět na Položky nebo do Formátu plánu.