Vodič za Home Assistant automatizaciju

Automatizacije za Home Assistant omogućuju automatsku sinkronizaciju zdravstvenih podataka u Home Assistant kao stanja senzora. Ta integracija omogućuje korištenje zdravstvenih podataka u automatizacijama Home Assistant, nadzornim pločama i drugim integracijama.

Pregled

Automatizacije za Home Assistant šalju zdravstvene metrike na REST API Home Assistanta, stvarajući ili ažurirajući stanja senzora koja se mogu koristiti u cijeloj instanci Home Assistanta. Podaci su formatirani posebno za API Home Assistanta /states/<entity_id>.

Primjene:

• Prikaz zdravstvenih metrika na nadzornim pločama Home Assistanta
• Stvaranje automatizacija na temelju zdravstvenih podataka
• Integracija zdravstvenih podataka s drugim pametnim uređajima
• Praćenje zdravstvenih trendova u Home Assistantu

Ključne značajke:

• Automatsko stvaranje stanja senzora
• Samo JSON format (optimizirano za Home Assistant)
• Samo vrsta podataka Health Metrics
• Jednostavna konfiguracija URL-a

Ograničenja

• Pristup zdravstvenim podacima: Aplikacijama nije dopušten pristup zdravstvenim podacima dok je iPhone zaključan. Automatizacije će se pokretati samo dok je uređaj otključan. To je ograničenje Applea koje se ne može zaobići. Više informacija

• Obrada u pozadini: iOS ograničava obradu u pozadini radi uštede baterije. Automatizacije ovise o osvježavanju aplikacija u pozadini i možda neće odmah raditi ako:

  • je osvježavanje aplikacija u pozadini isključeno za aplikaciju
  • je uređaj u načinu niske potrošnje
  • je uređaj dugo neaktivan
  • su resursi sustava ograničeni
  • više aplikacija istodobno traži vrijeme izvršavanja u pozadini

• Podržana je samo vrsta podataka Health Metrics

• Samo JSON format (ne može se promijeniti)

Preduvjeti

• Pokrenuta i dostupna instanca Home Assistanta na vašoj mreži
• API pristupni token Home Assistanta (Long-Lived Access Token)
• Mrežna povezanost s instancom Home Assistanta
• Verzija Home Assistanta koja podržava REST API

Konfiguracija

U glavnoj navigaciji otvorite zaslon Automatskih izvoza, zatim dodirnite „New Automation” i odaberite „Home Assistant” kao vrstu automatizacije.

Naziv automatizacije

Unesite opisni naziv automatizacije. Taj naziv koristit će se za generiranje ID-a entiteta senzora u Home Assistantu.

Napomena: Naziv automatizacije pretvara se u mala slova bez razmaka radi stvaranja ID-a entiteta. Primjerice, „My Health Data” postaje hae.myhealthdata.

Obavijesti

Postavite kada želite primati obavijesti:

• Notify on Cache Update — obavijest kad se ažuriraju predmemorirani podaci
• Notify When Run — obavijest pri svakom izvršavanju automatizacije

URL Home Assistanta

Unesite bazni URL instance Home Assistanta. Uključite protokol i priključak ako ne koristite zadani.

Primjeri URL-ova:

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

Napomena: URL mora biti dostupan s vašeg uređaja. Ako koristite HTTPS, provjerite je li certifikat valjan ili dodajte iznimku.

Automatski generirani endpoint

Aplikacija automatski generira puni API endpoint na temelju naziva automatizacije:

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

Primjerice, ako je URL http://homeassistant.local:8123, a naziv automatizacije „Health Metrics”, endpoint će biti:

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

Ovaj endpoint prikazan je ispod polja URL-a radi referencije.

Istek zahtjeva (Request Timeout)

Odaberite interval isteka za HTTP zahtjeve prema Home Assistantu.

Dostupne opcije isteka:

• 60 sekundi — zadano, prikladno za većinu instanci
• 300 sekundi (5 minuta) — za sporije instance
• 1800 sekundi (30 minuta) — za vrlo sporu obradu
• 3600 sekundi (1 sat) — maksimalno preporučeni istek

HTTP zaglavlja

Dodajte zaglavlja autentifikacije za pristup API-ju Home Assistanta. Trebate dodati zaglavlje Authorization s Long-Lived Access Tokenom.

Obavezno zaglavlje:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Kako dobiti Long-Lived Access Token:

1. Otvorite Home Assistant
2. Idite na profil (klik na ime dolje lijevo)
3. Pomaknite se do „Long-Lived Access Tokens”
4. Kliknite „Create Token”
5. Dajte mu naziv (npr. „Health Auto Export”)
6. Kopirajte token i zalijepite u polje vrijednosti zaglavlja

Opcionalna zaglavlja:
Možete dodati dodatna zaglavlja ako vaša postavka Home Assistanta to zahtijeva.

Dodavanje zaglavlja:

1. Dodirnite „Add Headers”
2. Unesite ključ zaglavlja u lijevo polje
3. Unesite vrijednost zaglavlja u desno polje
4. Ponovite za dodatna zaglavlja

Važno: Svaki ključ zaglavlja mora imati odgovarajuću vrijednost. Prazna zaglavlja bit će zanemarena.

Postavke vrste podataka

Vrsta podataka

Napomena: Automatizacije za Home Assistant podržavaju samo vrstu Health Metrics. Ova se postavka ne može promijeniti i automatski je postavljena na Health Metrics.

Konfiguracija zdravstvenih metrika

Select Health Metrics — odaberite koje metrike uključiti. Možete odabrati sve dostupne ili pojedinačne.

Savjet: Odabirom samo potrebnih metrika možete poboljšati vrijeme obrade i smanjiti količinu podataka poslanih u Home Assistant.

Preferred Sources — postavite koji izvori imaju prednost kad više izvora daje istu metriku.

Postavke izvoza

Format izvoza

Napomena: Automatizacije za Home Assistant podržavaju samo JSON format. Ova se postavka ne može promijeniti i automatski je JSON.

Verzija izvoza

Napomena: Verzija izvoza nije dostupna za automatizacije Home Assistanta jer je format posebno optimiziran za state API Home Assistanta.

Raspon datuma

Odaberite kada izvesti podatke:

• Default — sinkronizira podatke za cijeli prethodni dan plus podatke do trenutnog datuma i vremena
• Today — sinkronizira sve podatke za tekući dan do trenutnog vremena
• Yesterday — sinkronizira sve podatke za cijeli prethodni dan

Napomena: Automatizacije Home Assistanta ne podržavaju opcije „Real Time”, „Since Last Sync” ni „Previous 7 Days”.

Summarize Data

Uključite ili isključite Summarize Data za Health Metrics.

• ON — agregirani sažeci (zadano)
• OFF — gdje je moguće, pojedinačne točke podataka

Napomena: Postavka vrijedi samo za vrstu podataka Health Metrics.

Vremensko grupiranje

Kad je Summarize Data uključeno, odaberite kako agregirati podatke:

• Default — bez agregacije, sirove točke podataka
• Days — grupiranje po danu (preporučeno)

Učestalost sinkronizacije

Postavite koliko često automatizacija treba sinkronizirati podatke u Home Assistant:

Odaberite broj i interval.

Testiranje i provjera

Provjera u Home Assistantu

1. Otvorite Home Assistant
2. Idite na Developer Tools > States
3. Pretražite hae.{your_automation_name} (mala slova, bez razmaka)
4. Provjerite prikazuju li stanje senzora vaše zdravstvene podatke
5. Provjerite vrijeme „Last Updated” radi nedavnih sinkronizacija

Provjera zapisa Home Assistanta

Ako se podaci ne pojavljuju u Home Assistantu:

1. Otvorite Home Assistant
2. Idite na Settings > System > Logs
3. Tražite greške vezane uz REST API ili stanja senzora
4. Provjerite greške autentifikacije ili nevažeći format podataka

Rješavanje problema

Uobičajeni problemi

Greške autentifikacije

• Provjerite je li Long-Lived Access Token ispravan
• Provjerite je li zaglavlje Authorization u obliku: Bearer YOUR_TOKEN
• Provjerite nije li token istekao ili opozvan
• Provjerite ima li token odgovarajuća dopuštenja u Home Assistantu

Senzor se ne pojavljuje u Home Assistantu

• Provjerite ne sadrži li naziv automatizacije posebne znakove
• Provjerite format ID-a entiteta: hae.{automation_name} (mala slova, bez razmaka)
• Pogledajte zapise Home Assistanta radi grešaka
• Provjerite je li API zahtjev uspio (Activity Logs)

Podaci se ne ažuriraju

• Provjerite je li automatizacija uključena
• Pregledajte Activity Logs radi grešaka
• Provjerite mrežnu povezanost s Home Assistantom

Istek veze (timeout)

• Provjerite radi li Home Assistant i je li dostupan
• Provjerite mrežnu povezanost
• Povećajte postavku Request Timeout ako Home Assistant sporo odgovara
• Provjerite URL i priključak

Poruke o greškama

Aplikacija prikazuje greške ako:

• je URL nevažeći ili nedostupan
• autentifikacija ne uspije (provjerite zaglavlje Authorization)
• Home Assistant vrati grešku statusa
• mrežna veza nije dostupna

Pogledajte Activity Logs za detalje, uključujući HTTP status kodove i poruke grešaka iz Home Assistanta.

Savjeti za integraciju Home Assistanta

Korištenje zdravstvenih podataka u automatizacijama

Kad se zdravstveni podaci sinkroniziraju u Home Assistant, možete ih koristiti u automatizacijama:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Stvaranje nadzornih ploča

Dodajte zdravstvene metrike na nadzornu ploču Home Assistanta:

1. Idite na nadzornu ploču
2. Dodajte novu karticu
3. Odaberite tip kartice „Entities” ili „Gauge”
4. Dodajte entitete senzora hae.{your_automation_name}

Struktura stanja senzora

Stanje senzora u Home Assistantu sadrži:

• state: trenutačna vrijednost ili status
• attributes: dodatni podaci uključujući:
  • informacije o vremenskoj oznaci
  • strukturu podataka koja odgovara izvezenom JSON formatu
  • informacije o jedinicama gdje je primjenjivo

Savjeti i najbolje prakse

1. Automatska sinkronizacija:

   • Punite uređaj i koristite iPhone Mirroring
     • Kad se uređaj puni, iOS manje ograničava performanse pa se podaci mogu češće sinkronizirati
     • iPhone Mirroring ponaša se kao da je uređaj otključan, pa Health Auto Export može pristupiti zdravstvenim podacima za automatizirane radnje

2. Imenovanje:

   • Izbjegavajte posebne znakove koji mogu uzrokovati probleme

3. Odabir podataka:

   • Odaberite samo metrike koje trebate

Pregled zapisnika aktivnosti

1. Dodirnite Prikaži zapisnike aktivnosti na zaslonu konfiguracije automatizacije.
2. Pregledajte pokretanja (grupirano, najnovije prvo) i proširite događaje unutar svakog pokretanja.
3. Razlikujte upozorenja (npr. spori upit zdravstvenih podataka) od greške (greške objave entiteta ili veze)—pogledajte Pregled automatizacija — Zapisnici aktivnosti.
4. Pokretanja Home Assistanta mogu zapisivati ishode po entitetu; pokretanje može djelomično uspjeti kada se neke entitete ažuriraju, a druge ne uspiju.
5. Podijeli (alatna traka) izvozi potpuni dijagnostički ZIP Zapisnici događaja aplikacije za podršku (isto kao Postavke → Napredno).
6. Očisti uklanja samo povijest aktivnosti ove automatizacije.