Home Assistant-automaatio-opas

Home Assistant -automaatiot synkronoivat terveysdatasi automaattisesti Home Assistantiin anturitiloina. Integraation avulla voit käyttää terveysdataa Home Assistantin automaatioissa, koontinäytöissä ja muissa integraatioissa.

Yleiskatsaus

Home Assistant -automaatiot lähettävät terveysmittauksesi Home Assistantin REST API:in ja luovat tai päivittävät anturitiloja, joita voi käyttää koko Home Assistant -instanssissasi. Data on muotoiltu erityisesti Home Assistantin /states/<entity_id> -API:lle.

Käyttötapaukset:

• Terveysmittausten näyttäminen Home Assistant -koontinäytöillä
• Automaatioiden luominen terveysdatan perusteella
• Terveysdatan yhdistäminen muihin älykotilaitteisiin
• Terveystrendien seuranta Home Assistantissa ajan myötä

Keskeiset ominaisuudet:

• Anturitilojen automaattinen luonti
• Vain JSON-muoto (optimoitu Home Assistantille)
• Vain Health Metrics -datatyyppi
• Yksinkertainen URL-määritys

Rajoitukset

• Pääsy terveystietoihin: Sovellukset eivät saa käyttää terveystietoja, kun iPhone on lukittu. Automaatiot toimivat vain, kun laitteesi on avattu. Tämä on Applen asettama rajoitus, jota ei voi kiertää. Lisätietoja

• Taustakäsittely: iOS rajoittaa taustakäsittelyä akun keston vuoksi. Automaatiot käyttävät taustasovellusten päivitystä (Background App Refresh) eivätkä välttämättä suoritu heti, jos:

  • Taustasovellusten päivitys on pois käytöstä sovellukselta
  • Laite on vähävirtaisessa tilassa
  • Laite on ollut pitkään passiivisena
  • Järjestelmän resurssit ovat kireät
  • Useat sovellukset kilpailevat taustasuorituksesta

• Tukee vain Health Metrics -datatyyppiä

• Vain JSON-muoto (ei voi muuttaa)

Edellytykset

• Home Assistant -instanssi käynnissä ja tavoitettavissa verkossasi
• Home Assistant API -käyttötunniste (Long-Lived Access Token)
• Verkkoyhteys Home Assistant -instanssiin
• Home Assistant -versio, joka tukee REST API:a

Määritys

Siirry päävalikosta automaattisten vientien näyttöön, napauta New Automation ja valitse automaation tyypiksi Home Assistant.

Automaation nimi

Anna automaatiolle kuvaava nimi. Nimestä muodostetaan anturin entity ID Home Assistantissa.

Huom: Automaation nimi muunnetaan pieniksi kirjaimiksi ja välilyönnit poistetaan entity ID:tä varten. Esimerkiksi ”My Health Data” → hae.myhealthdata.

Ilmoitukset

Määritä, milloin haluat ilmoituksia:

• Notify on Cache Update – Ilmoitus, kun välimuistidata päivittyy
• Notify When Run – Ilmoitus joka kerta, kun automaatio suoritetaan

Home Assistant -URL

Anna Home Assistant -instanssisi perus-URL. Sisällytä protokolla ja portti, jos et käytä oletusta.

Esimerkki-URL-osoitteita:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Huom: URL:n on oltava laitteesi saavutettavissa. HTTPS:llä varmista, että varmenne on kelvollinen tai lisää poikkeus.

Automaattisesti muodostettu päätepiste

Sovellus muodostaa täydellisen API-päätepisteen automaation nimen perusteella:

{your_url}/api/states/hae.{automation_name}

Esimerkiksi jos URL on http://homeassistant.local:8123 ja automaation nimi on ”Health Metrics”, päätepiste on:

http://homeassistant.local:8123/api/states/hae.healthmetrics

Tämä päätepiste näytetään URL-kentän alla viitteeksi.

Pyynnön aikakatkaisu

Valitse HTTP-pyyntöjen aikakatkaisu Home Assistantiin.

Saatavilla olevat vaihtoehdot:

• 60 sekuntia – Oletus, sopii useimmille instansseille
• 300 sekuntia (5 minuuttia) – Hitaammille instansseille
• 1800 sekuntia (30 minuuttia) – Hyvin hitaalle käsittelylle
• 3600 sekuntia (1 tunti) – Enimmäissuositus aikakatkaisulle

HTTP-otsikot

Lisää todennusotsikot Home Assistant API -käyttöä varten. Tarvitset Authorization-otsikon Long-Lived Access Tokenilla.

Pakollinen otsikko:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Long-Lived Access Tokenin saaminen:

1. Avaa Home Assistant
2. Siirry profiiliin (napauta nimeäsi alavasemmalla)
3. Vieritä kohtaan Long-Lived Access Tokens
4. Napauta Create Token
5. Anna nimi (esim. ”Health Auto Export”)
6. Kopioi tunniste ja liitä se otsikon arvokenttään

Valinnaiset otsikot:

Voit lisätä muita otsikoita Home Assistant -asetuksesi mukaan.

Otsikoiden lisääminen:

1. Napauta Add Headers
2. Kirjoita otsikon avain vasempaan kenttään
3. Kirjoita otsikon arvo oikeaan kenttään
4. Toista tarvittaessa

Tärkeää: Jokaisella otsikkoavaimella on oltava vastaava arvo. Tyhjät otsikot ohitetaan.

Datatyypin asetukset

Datatyyppi

Huom: Home Assistant -automaatiot tukevat vain Health Metrics -datatyyppiä. Tätä ei voi muuttaa; se on automaattisesti Health Metrics.

Health Metrics -asetukset

Select Health Metrics – Valitse, mitkä mittarit sisällytetään. Voit valita kaikki saatavilla olevat tai tiettyjä.

Vinkki: Vain tarvitsemiesi mittareiden valinta voi nopeuttaa käsittelyä ja pienentää Home Assistantiin lähetettävää datamäärää.

Preferred Sources – Määritä, mitkä datalähteet ovat etusijalla, kun sama mittari tulee useasta lähteestä.

Viennin asetukset

Viennin muoto

Huom: Home Assistant -automaatiot tukevat vain JSON-muotoa. Tätä ei voi muuttaa; se on automaattisesti JSON.

Viennin versio

Huom: Export Version ei ole käytettävissä Home Assistant -automaatioissa, koska muoto on optimoitu Home Assistantin tilojen API:lle.

Aikaväli

Valitse, milloin data viedään:

• Default – Synkronoi datan koko edelliseltä päivältä sekä kuluvaan päivään ja -aikaan asti
• Today – Synkronoi kaiken kuluvan päivän datan kuluvaan hetkeen asti
• Yesterday – Synkronoi koko edellisen päivän data

Huom: Home Assistant -automaatiot eivät tue vaihtoehtoja ”Real Time”, ”Since Last Sync” tai ”Previous 7 Days”.

Yhteenveto datasta

Kytke Summarize Data päälle tai pois Health Metricsille.

• Päällä – Tarjoaa koostetut yhteenvedot (oletus)
• Poissa – Tarjoaa mahdollisuuksien mukaan erittelemätön datan

Huom: Tämä koskee vain Health Metrics -datatyyppiä.

Aikaryhmittely

Kun Summarize Data on päällä, valitse, miten data koostetaan:

• Default – Ei koostamista, raakat datapisteet
• Days – Ryhmittelee datan päivittäin (suositeltu)

Synkronoinnin tiheys

Määritä, kuinka usein automaation tulisi synkronoida data Home Assistantiin:

Valitse luku ja aikaväli.

Testaus ja varmistus

Tarkistus Home Assistantissa

1. Avaa Home Assistant
2. Siirry Developer Tools > States
3. Etsi hae.{your_automation_name} (pienet kirjaimet, ei välilyöntejä)
4. Varmista, että anturitila näyttää terveysdatasi
5. Tarkista Last Updated -aikaleima viimeisimpien synkronointien varmistamiseksi

Home Assistant -lokien tarkistus

Jos data ei näy Home Assistantissa:

1. Avaa Home Assistant
2. Siirry Settings > System > Logs
3. Etsi virheitä, jotka liittyvät REST API:in tai anturitiloihin
4. Tarkista todennusvirheet tai virheellinen datamuoto

Ongelmanratkaisu

Yleisiä ongelmia

Todennusvirheet

• Varmista, että Long-Lived Access Token on oikein
• Varmista, että Authorization-otsikko on muodossa: Bearer YOUR_TOKEN
• Tarkista, ettei tunniste ole vanhentunut tai mitätöity
• Varmista, että tunnisteella on tarvittavat oikeudet Home Assistantissa

Anturi ei näy Home Assistantissa

• Tarkista, ettei automaation nimessä ole erikoismerkkejä
• Varmista entity ID:n muoto: hae.{automation_name} (pienet kirjaimet, ei välilyöntejä)
• Tarkista Home Assistantin lokit virheiden varalta
• Varmista, että API-pyyntö onnistui (katso toimintalokit)

Data ei päivity

• Varmista, että automaatio on käytössä
• Tarkista toimintalokit virheiden varalta
• Varmista verkkoyhteys Home Assistantiin

Yhteys aikakatkaisuun

• Varmista, että Home Assistant on käynnissä ja tavoitettavissa
• Tarkista verkkoyhteys
• Nosta Request Timeout -asetusta, jos Home Assistant vastaa hitaasti
• Varmista URL ja portti

Virheilmoitukset

Sovellus näyttää virheilmoituksia, jos:

• URL on virheellinen tai tavoittamaton
• Todennus epäonnistuu (tarkista Authorization-otsikko)
• Home Assistant palauttaa virhetilakoodin
• Verkkoyhteys ei ole käytettävissä

Tarkista toimintalokit tarkempia virhetietoja varten, mukaan lukien HTTP-tilakoodit ja Home Assistantin virheilmoitukset.

Home Assistant -integraatiovinkit

Terveysdatan käyttö automaatioissa

Kun terveysdata on synkronoitu Home Assistantiin, voit käyttää sitä automaatioissa:

automation:
  - alias: "Hyvä unen laatu"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Hyvä uni viime yönä!"

Koontinäyttöjen luominen

Lisää terveysmittauksia Home Assistant -koontinäyttöön:

1. Siirry koontinäyttöösi
2. Lisää uusi kortti
3. Valitse korttityypiksi Entities tai Gauge
4. Lisää hae.{your_automation_name} -anturientiteetit

Anturitilan rakenne

Anturitila Home Assistantissa sisältää:

• state: Nykyinen arvo tai tila
• attributes: Lisätietoja, mukaan lukien:
  • Aikaleimatiedot
  • Rakenne vastaa viedyn JSON-muodon rakennetta
  • Yksikkötiedot soveltuvin osin

Vinkkejä ja hyviä käytäntöjä

1. Automaattinen synkronointi:

   • Lataa laitetta ja käytä iPhonen peilausta (iPhone Mirroring)
     • Latauksen aikana iOS rajoittaa laitteen suorituskykyä vähemmän, jolloin data voi synkronoitua useammin
     • Peilauksella laite käyttäytyy kuin lukitsemattomana, jolloin Health Auto Export voi käyttää terveysdataa automaattisten toimintojen suorittamiseen

2. Nimeäminen:

   • Vältä erikoismerkkejä, jotka voivat aiheuttaa ongelmia

3. Datan valinta:

   • Valitse vain tarvitsemasi mittarit

Aktiviteettilokien tarkastelu

1. Napauta Näytä aktiviteettilokit automaation määritysnäytössä.
2. Tarkista ajot (ryhmitelty, uusimmat ensin) ja laajenna tapahtumat kullekin ajolle.
3. Erottele varoitukset (esim. hidas terveysdatakysely) ja virheet (entiteetin julkaisu- tai yhteysvirheet)—katso Automaatioiden yleiskatsaus — Aktiviteettilokit.
4. Home Assistant -ajot voivat kirjata tulokset entiteettikohtaisesti; ajo voi onnistua osittain, kun jotkin entiteetit päivittyvät ja toiset epäonnistuvat.
5. Jaa (työkalurivi) vie täyden Sovellustapahtumalokit-diagnostiikka-ZIPin tukea varten (sama kuin Asetukset → Lisäasetukset).
6. Tyhjennä poistaa vain tämän automaation aktiviteettihistorian.