Home Assistant-automatiseringsveiledning

Home Assistant-automatiseringer lar deg automatisk synkronisere helsedataene dine med Home Assistant som sensorstatuser. Denne integrasjonen lar deg bruke helsedataene dine i Home Assistant-automatiseringer, dashboards og andre integrasjoner.

Oversikt

Home Assistant-automatiseringer sender helsemålingene dine til Home Assistants REST API, oppretter eller oppdaterer sensorstatuser som kan brukes i hele Home Assistant-instansen din. Dataene er formatert spesifikt for Home Assistants /states/ API.

Bruksområder:

• Vis helsemålinger på Home Assistant-dashboards
• Opprett automatiseringer basert på helsedata
• Integrer helsedata med andre smarte hjem-enheter
• Spor helsetrender over tid i Home Assistant

Nøkkelfunksjoner:

• Automatisk opprettelse av sensorstatus
• Kun JSON-format (optimalisert for Home Assistant)
• Kun Health Metrics-datatype
• Enkel URL-konfigurasjon

Begrensninger

• Tilgang til helsedata: Apper har ikke tillatelse til å få tilgang til helsedata mens iPhone er låst. Automatiseringer kjører bare når enheten er ulåst. Dette er en begrensning fra Apple som ikke kan omgås. Mer informasjon

• Bakgrunnsbehandling: iOS begrenser bakgrunnsbehandling for å bevare batterilevetiden. Automatiseringer er avhengige av App-oppdatering i bakgrunnen og kan ikke kjøre umiddelbart hvis:

  • App-oppdatering i bakgrunnen er deaktivert for appen
  • Enheten er i Strømsparemodus
  • Enheten har vært inaktiv i lengre perioder
  • Systemressurser er begrenset
  • Flere apper konkurrerer om bakgrunnskjøringstid

• Støtter kun Health Metrics-datatype

• Kun JSON-format (kan ikke endres)

Forutsetninger

• En Home Assistant-instans som kjører og er tilgjengelig på nettverket ditt
• Home Assistant API-tilgangstoken (Langtids-tilgangstoken)
• Nettverksforbindelse til Home Assistant-instansen din
• Home Assistant-versjon som støtter REST API

Konfigurasjon

Naviger til skjermen Automatiserte eksporter fra hovednavigasjonen, trykk deretter på "Ny automatisering" og velg "Home Assistant" som Automatiserings type.

Automatiseringsnavn

Skriv inn et beskrivende navn for automatiseringen din. Dette navnet vil bli brukt til å generere sensor-entitets-ID-en i Home Assistant.

Merk: Automatiseringsnavnet vil bli konvertert til små bokstaver med fjernede mellomrom for å opprette entitets-ID-en. For eksempel blir "Mine helsedata" til hae.minehelsedata.

Varsler

Konfigurer når du vil motta varsler:

• Varsle ved cacheoppdatering - Motta et varsel når hurtiglagrede data oppdateres
• Varsle ved kjøring - Motta et varsel hver gang automatiseringen kjører

Home Assistant-URL

Skriv inn grunn-URL-en for Home Assistant-instansen din. Dette bør inkludere protokollen og porten hvis du ikke bruker standarden.

Eksempel-URL-er:

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

Merk: URL-en må være tilgjengelig fra enheten din. Hvis du bruker HTTPS, sørg for at sertifikatet ditt er gyldig eller legg til et unntak.

Automatisk generert endepunkt

Appen genererer automatisk det fullstendige API-endepunktet basert på automatiseringsnavnet ditt:

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

For eksempel, hvis URL-en din er http://homeassistant.local:8123 og automatiseringsnavnet ditt er "Helsemålinger", vil endepunktet være:

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

Dette endepunktet vises under URL-feltet som referanse.

Forespørsels-timeout

Velg et timeout-intervall for HTTP-forespørsler til Home Assistant.

Tilgjengelige timeout-alternativer:

• 60 sekunder - Standard, egnet for de fleste Home Assistant-instanser
• 300 sekunder (5 minutter) - For tregere Home Assistant-instanser
• 1800 sekunder (30 minutter) - For veldig treg behandling
• 3600 sekunder (1 time) - Maksimal anbefalt timeout

HTTP-headere

Legg til autentiseringsheadere for tilgang til Home Assistant API. Du må legge til en Authorization-header med Langtids-tilgangstokenet ditt.

Påkrevd header:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

For å få et Langtids-tilgangstoken:

1. Åpne Home Assistant
2. Gå til profilen din (klikk på navnet ditt nederst til venstre)
3. Scroll ned til "Langtids-tilgangstokens"
4. Klikk på "Opprett token"
5. Gi det et navn (f.eks. "Health Auto Export")
6. Kopier tokenet og lim det inn i header-verdifeltet

Valgfrie headere:
Du kan legge til ytterligere headere hvis nødvendig for Home Assistant-oppsettet ditt.

For å legge til headere:

1. Trykk på "Legg til headere"
2. Skriv inn header-nøkkelen i venstre felt
3. Skriv inn header-verdien i høyre felt
4. Gjenta for ytterligere headere

Viktig: Hver header-nøkkel må ha en tilsvarende verdi. Tomme headere ignoreres.

Datatype-innstillinger

Datatype

Merk: Home Assistant-automatiseringer støtter kun Health Metrics-datatype. Denne innstillingen kan ikke endres og settes automatisk til Health Metrics.

Health Metrics-konfigurasjon

Velg Health Metrics - Velg hvilke spesifikke målinger som skal inkluderes. Du kan velge alle tilgjengelige målinger eller velge spesifikke.

Tips: Å velge bare målingene du trenger kan forbedre behandlingstiden og redusere datastørrelsen som sendes til Home Assistant.

Foretrukne kilder - Konfigurer hvilke datakilder som har prioritet når flere kilder leverer samme måling.

Eksportinnstillinger

Eksportformat

Merk: Home Assistant-automatiseringer støtter kun JSON-format. Denne innstillingen kan ikke endres og settes automatisk til JSON.

Eksportversjon

Merk: Eksportversjon er ikke tilgjengelig for Home Assistant-automatiseringer fordi formatet er optimalisert spesifikt for Home Assistants state API.

Datointervall

Velg når data skal eksporteres:

• Standard - Synkroniserer data for hele forrige dag pluss data opp til nåværende dato og tid
• I dag - Synkroniserer alle data for nåværende dato opp til nåværende tid
• I går - Synkroniserer alle data for hele forrige dag

Merk: Home Assistant-automatiseringer støtter ikke alternativene "Sanntid", "Siden siste synkronisering" eller "Siste 7 dager".

Sammendrag data

Slå Sammendrag data PÅ eller AV for Health Metrics.

• PÅ - Gir aggregerte datasammendrag (standard)
• AV - Gir desaggregerte data der det er mulig

Merk: Denne innstillingen gjelder kun for Health Metrics-datatype.

Tidsgruppering

Når Sammendrag data er aktivert, velg hvordan data skal aggregeres:

• Standard - Ingen aggregering, råe datapunkter
• Dager - Grupperer data etter dag (anbefalt)

Synkroniseringsfrekvens

Konfigurer hvor ofte automatiseringen skal synkronisere data med Home Assistant:

Velg et tall og intervall.

Testing og verifisering

Verifisering i Home Assistant

1. Åpne Home Assistant
2. Gå til Utviklerverktøy > Statuser
3. Søk etter hae.{your_automation_name} (små bokstaver, ingen mellomrom)
4. Verifiser at sensorstatusen viser helsedataene dine
5. Sjekk "Sist oppdatert"-tidsstemplet for å bekrefte nylige synkroniseringer

Sjekke Home Assistant-logger

Hvis data ikke vises i Home Assistant:

1. Åpne Home Assistant
2. Gå til Innstillinger > System > Logger
3. Se etter feil relatert til REST API eller sensorstatuser
4. Sjekk etter autentiseringsfeil eller ugyldig dataformat

Feilsøking

Vanlige problemer

Autentiseringsfeil

• Verifiser at Langtids-tilgangstokenet ditt er korrekt
• Sørg for at Authorization-headeren er formatert som: Bearer YOUR_TOKEN
• Sjekk at tokenet ikke har utløpt eller blitt tilbakekalt
• Verifiser at tokenet har passende tillatelser i Home Assistant

Sensor vises ikke i Home Assistant

• Sjekk at automatiseringsnavnet ikke inneholder spesialtegn
• Verifiser entitets-ID-formatet: hae.{automation_name} (små bokstaver, ingen mellomrom)
• Sjekk Home Assistant-logger for feil
• Sørg for at API-forespørselen var vellykket (sjekk Aktivitetslogger)

Data oppdateres ikke

• Sjekk at automatiseringen er aktivert
• Gjennomgå Aktivitetslogger for feil
• Sørg for nettverksforbindelse til Home Assistant

Tilkoblingstimeout

• Verifiser at Home Assistant kjører og er tilgjengelig
• Sjekk nettverksforbindelsen
• Øk innstillingen Forespørsels-timeout hvis Home Assistant responderer sakte
• Verifiser at URL-en og porten er korrekte

Feilmeldinger

Appen vil vise feilmeldinger hvis:

• URL-en er ugyldig eller utilgjengelig
• Autentiseringen mislykkes (sjekk Authorization-headeren)
• Home Assistant returnerer en feilstatuskode
• Nettverksforbindelsen ikke er tilgjengelig

Sjekk Aktivitetsloggene for detaljert feilinformasjon, inkludert HTTP-statuskoder og feilmeldinger fra Home Assistant.

Home Assistant-integrasjonstips

Bruke helsedata i automatiseringer

Når helsedataene dine er synkronisert med Home Assistant, kan du bruke dem i automatiseringer:

automation:
  - alias: "God søvnkvalitet"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Fantastisk søvn i går kveld!"

Opprette dashboards

Legg til helsemålinger på Home Assistant-dashboardet ditt:

1. Gå til dashboardet ditt
2. Legg til et nytt kort
3. Velg korttypen "Entiteter" eller "Gauge"
4. Legg til sensor-entitetene hae.{your_automation_name}

Sensorstatusstruktur

Sensorstatusen i Home Assistant inneholder:

• state: Den nåværende verdien eller statusen
• attributes: Tilleggsdata inkludert:
  • Tidsstempelinformasjon
  • Datastruktur som matcher det eksporterte JSON-formatet
  • Enhetsinformasjon der det er aktuelt

Tips og beste praksis

1. Automatisk synkronisering:

   • Lad enheten og bruk iPhone-speiling
     • Under lading setter iOS færre ytelsesbegrensninger, så data kan synkroniseres oftere
     • Med iPhone-speiling oppfører enheten seg som om den var ulåst. Health Auto Export får da tilgang til helsedata for automatiserte handlinger

2. Navngiving:

   • Unngå spesialtegn som kan forårsake problemer

3. Dataval:

   • Velg bare målingene du trenger

Visning av aktivitetslogger

1. Trykk på Vis aktivitetslogger på konfigurasjonsskjermen for automatisering.
2. Gå gjennom kjøringer (gruppert, nyeste først), og utvid hendelser i hver kjøring.
3. Skill mellom advarsler (f.eks. treg helsedataforespørsel) og feil (feil ved entitetspublisering eller tilkobling)—se Oversikt over automatiseringer — Aktivitetslogger.
4. Home Assistant-kjøringer kan logge resultater per entitet; en kjøring kan delvis lykkes når noen entiteter oppdateres og andre feiler.
5. Del (verktøylinje) eksporterer full diagnostisk ZIP av App-hendelseslogger for support (samme som Innstillinger → Avansert).
6. Tøm fjerner bare aktivitetshistorikken for denne automatiseringen.