Siirry sisältöön
Automate the North

Dashboardin tilarivi, joka kertoo mitä seuraavaksi tapahtuu

Yksi markdown-kortti dashboard-osion alussa tekee useasta entiteetistä otsikon ja lauseen. Vain vakiokortteja, toimii millä kielellä tahansa.

Julkaistu
Taso
Aloittelija

Korteilla täytetty dashboard kertoo jokaisen entiteetin tilan: pistorasia on pois, ajastus on päällä, lähtö on klo 7.45. Mitä seuraavaksi tapahtuu, se pitää silti päätellä itse. Tilarivi tekee päättelyn puolestasi. Se on osion ylimpänä ja kertoo yhdellä otsikolla ja lauseella, mitä on meneillään ja mitä tapahtuu seuraavaksi.

Kaikki tämän sivuston projektit käyttävät samaa mallia. Autolämmityksen osio sanoo esimerkiksi “Lämmitys alkaa klo 06:55” tai “Lämmitystä ei tarvita” neljän yhdessä luettavan kortin sijaan.

Mitä se tekee

  • Yksi otsikko, yksi lause. Otsikko on se tila, josta olet kiinnostunut, ja lause lisää yksityiskohdan, jonka muuten kävisit katsomassa.
  • Kiireellisin ensin. Yhteydetön laite menee käynnissä olevan edelle, se ajastuksen poiskytkennän edelle ja se seuraavan ajon edelle. Ensimmäinen osuma voittaa, joten rivillä ei ole koskaan kahta ristiriitaista viestiä.
  • Vain vakiokortteja. Kyseessä on tavallinen markdown-kortti, joten se kestää Home Assistantin päivitykset eikä tarvitse mitään HACS:sta.
  • Puhuu kieltäsi. Ajat ja desimaalit muotoillaan templatessa, joten suomenkielinen dashboard sanoo “12,3 °C” ja “klo 06:55”.

Malli

Tässä on runko. Vaihda entiteettien tunnisteet omiisi ja kirjoita tapaukset oman laitteesi mukaan.

Näytä tilarivin YAML
Tilarivi-kortti
# Tilarivi: yksi markdown-kortti, joka tekee useasta entiteetistä otsikon ja lauseen.
# Laita se dashboard-osion ensimmäiseksi. Käy tapaukset läpi kiireellisimmästä alkaen; ensimmäinen osuma voittaa.
type: markdown
text_only: true
grid_options:
columns: full
content: |-
{%- set temp = states('sensor.outdoor_temperature') | float(none) -%}
{%- if not has_value('switch.device') -%}
## Laite ei vastaa
Pistorasia ei ole yhteydessä. Tarkista virta ja Wi-Fi.
{%- elif is_state('switch.device', 'on') -%}
## Käynnissä
Päällä klo {{ (states.switch.device.last_changed | as_local).strftime('%H:%M') }} alkaen.
{%- elif is_state('input_boolean.device_schedule', 'off') -%}
## Ajastus pois
Mitään ei käynnisty, ennen kuin kytket sen itse.
{%- else -%}
{%- set next = today_at(states('sensor.device_next_run')) -%}
{%- if next < now() -%}{%- set next = next + timedelta(days=1) -%}{%- endif %}
## Seuraava ajo klo {{ states('sensor.device_next_run') }}
{%- set mins = ((next - now()).total_seconds() // 60) | int %}
Siihen on {{ mins // 60 }} h {{ mins % 60 }} min.
{%- endif -%}

Lisää Sections-näkymässä kortti osion ylimmäksi, avaa Muokkaa YAML:na ja liitä. text_only: true poistaa kortin taustan, jolloin rivi toimii alla olevien korttien otsikkona, ja columns: full levittää sen koko osion levyiseksi.

Tapausten kirjoittaminen

Aloita siitä, mikä voi mennä vikaan, sitten siitä, mitä tapahtuu nyt, ja lopuksi siitä, mitä tapahtuu seuraavaksi:

  1. Ei saatavilla. has_value('switch.device') on epätosi, kun entiteetti on tilassa unavailable tai unknown. Kerro, mitä kannattaa tarkistaa.
  2. Käynnissä. Laite on päällä. Kerro mistä lähtien tai mihin asti.
  3. Kytketty itse pois. Ajastus tai tila on pois päältä. Kerro, ettei mitään tapahdu itsestään.
  4. Odottaa. Kaikki on asetettu. Kerro, milloin seuraava asia tapahtuu.

Pidä otsikot muutaman sanan mittaisina. Jos tapaus vaatii pitkän selityksen, se kuuluu luultavasti projektin ohjeeseen eikä dashboardille.

Ajat ja luvut

Muutama template-yksityiskohta tekee rivistä luontevan:

{# Kellonaika tilan muutoksesta #}
{{ (states.switch.device.last_changed | as_local).strftime('%H:%M') }}
{# Desimaalipilkku suomenkieliselle dashboardille #}
{{ '%.1f' | format(states('sensor.outdoor_temperature') | float(0)) | replace('.', ',') }}
{# Aikaa jäljellä kellonaikaan; jos aika on jo mennyt, lasketaan huomiseen #}
{%- set next = today_at('06:55') -%}
{%- if next < now() -%}{%- set next = next + timedelta(days=1) -%}{%- endif -%}
{%- set mins = ((next - now()).total_seconds() // 60) | int -%}
{{ mins // 60 }} h {{ mins % 60 }} min

Home Assistantin oma time_until() on kätevä, mutta se kirjoittaa aina englanniksi (“21 hours”) ja palauttaa pelkän ajan, jos se on jo mennyt. Siksi yllä oleva esimerkki laskee minuutit itse.

Anna float()- ja int()-suodattimille aina oletusarvo, esimerkiksi float(none) tai int(0). Ilman sitä hetkeksi saavuttamattomissa oleva anturi rikkoo koko kortin.

Hyvä tietää

  • Testaa kohdassa Kehitystyökalut → Malli. Liitä sisältö sinne, niin näet tuloksen ja mahdolliset virheet heti.
  • Päivittyy itsestään. Kortti päivittyy, kun mikä tahansa templaten entiteetti muuttuu, ja minuutin välein, jos templatessa on now().
  • Piilota tilat, jotka rivi jo kertoo. Jos kortin tila toistaa tilarivin, aseta kortille hide_state: true. Se auttaa myös, kun tilaa ei ole käännetty: suomenkielisessä Home Assistantissa pistorasiaksi merkityt älypistorasiat näyttävät “On” ja “Off” eikä “Päällä” ja “Pois”.

Kaikki tiedostot GitHubissa

Palaute

Löysitkö virheen, jäikö jokin epäselväksi tai onko sinulla idea projektiksi? Kirjoita siitä tähän.

Nimetön: vain viesti ja tämän sivun osoite lähetetään. Älä kirjoita nimeäsi tai yhteystietojasi, sillä viestiin ei voi vastata.