Home Assistant automatizálási útmutató

A Home Assistant automatizálásokkal automatikusan szinkronizálhatod egészségügyi adataidat Home Assistantba érzékelőállapotként. Ez lehetővé teszi, hogy egészségügyi adataidat Home Assistant automatizálásokban, irányítópultokon és más integrációkban használd.

Áttekintés

A Home Assistant automatizálások az egészségügyi metrikáidat a Home Assistant REST API-jára küldik, érzékelőállapotokat hozva létre vagy frissítve, amelyek a teljes Home Assistant példányodban használhatók. Az adatok a Home Assistant /states/<entity_id> API-jához igazított formátumban kerülnek küldésre.

Használati esetek:

• Egészségügyi metrikák megjelenítése Home Assistant irányítópultokon
• Automatizálások létrehozása egészségügyi adatok alapján
• Egészségügyi adatok integrálása más okosotthon-eszközökkel
• Egészségügyi trendek követése a Home Assistantban

Fő jellemzők:

• Automatikus érzékelőállapot-létrehozás
• Csak JSON formátum (Home Assistantra optimalizálva)
• Csak Egészségügyi metrikák adattípus
• Egyszerű URL-konfiguráció

Korlátok

• Egészségügyi adatok elérése: Az alkalmazások nem férnek hozzá egészségügyi adatokhoz, amíg az iPhone zárolva van. Az automatizálások csak akkor futnak, amikor az eszköz fel van oldva. Ezt az Apple korlátozása nem kerülhető meg. További információ

• Háttérfeldolgozás: Az iOS korlátozza a háttérben futó feldolgozást az akkumulátor védelme érdekében. Az automatizálások a háttérben futó alkalmazás-frissítésre támaszkodnak, és nem feltétlenül futnak le azonnal, ha:

  • A háttérben futó alkalmazás-frissítés ki van kapcsolva az alkalmazásnál
  • Az eszköz alacsony töltöttségi módban van
  • Az eszköz hosszú ideje inaktív
  • A rendszer erőforrásai szűkösek
  • Több alkalmazás verseng a háttérben futásért

• Csak Egészségügyi metrikák adattípus támogatott

• Csak JSON formátum (nem változtatható)

Előfeltételek

• Futtatott és a hálózaton elérhető Home Assistant példány
• Home Assistant API hozzáférési token (Long-Lived Access Token)
• Hálózati kapcsolat a Home Assistant példányhoz
• Olyan Home Assistant verzió, amely támogatja a REST API-t

Konfiguráció

Lépj az Automatizált exportok képernyőre a fő navigációból, majd koppints az „Új automatizálás” lehetőségre, és válaszd a „Home Assistant” automatizálástípust.

Automatizálás neve

Adj leíró nevet az automatizálásnak. Ebből generálódik az érzékelő entitásazonosítója a Home Assistantban.

Megjegyzés: Az automatizálás neve kisbetűssé és szóköz nélkül alakul entitásazonosítóvá. Például a „My Health Data” → hae.myhealthdata.

Értesítések

Állítsd be, mikor szeretnél értesítést kapni:

• Értesítés gyorsítótár-frissítéskor – Értesítés, ha a gyorsítótárazott adat frissül
• Értesítés futtatáskor – Értesítés minden alkalommal, amikor az automatizálás lefut

Home Assistant URL

Add meg a Home Assistant példányod alap URL-jét. Tartalmazza a protokollt és a portot, ha nem az alapértelmezettet használod.

Példa URL-ek:

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

Megjegyzés: Az URL-nek elérhetőnek kell lennie az eszközödről. HTTPS esetén győződj meg róla, hogy az tanúsítvány érvényes, vagy adj hozzá kivételt.

Automatikusan generált végpont

Az alkalmazás automatikusan összeállítja a teljes API-végpontot az automatizálás neve alapján:

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

Például ha az URL http://homeassistant.local:8123, és az automatizálás neve „Health Metrics”, a végpont:

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

Ez a végpont az URL mező alatt jelenik meg tájékoztatásként.

Kérés időtúllépése

Válassz időtúllépést a Home Assistant felé küldött HTTP-kérésekhez.

Elérhető időtúllépések:

• 60 másodperc – Alapértelmezés, a legtöbb Home Assistant példányhoz megfelelő
• 300 másodperc (5 perc) – Lassabb példányokhoz
• 1800 másodperc (30 perc) – Nagyon lassú feldolgozáshoz
• 3600 másodperc (1 óra) – Maximálisan ajánlott időtúllépés

HTTP-fejlécek

Adj hozzá hitelesítési fejléceket a Home Assistant API eléréséhez. Szükséged lesz egy Authorization fejlécre a Long-Lived Access Tokennel.

Kötelező fejléc:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Long-Lived Access Token beszerzése:

1. Nyisd meg a Home Assistantot
2. Lépj a profilodra (kattints a nevedre bal alul)
3. Görgess a „Long-Lived Access Tokens” részhez
4. Kattints a „Create Token” lehetőségre
5. Adj nevet (pl. „Health Auto Export”)
6. Másold ki a tokent, és illeszd be a fejléc értékmezőjébe

Opcionális fejlécek:
Szükség szerint további fejléceket adhatsz a Home Assistant beállításodhoz.

Fejlécek hozzáadása:

1. Koppints a „Fejlécek hozzáadása” lehetőségre
2. Írd be a fejléc kulcsát a bal mezőbe
3. Írd be a fejléc értékét a jobb mezőbe
4. Ismeld további fejlécekhez

Fontos: Minden fejléc-kulcshoz tartoznia kell értéknek. Az üres fejlécek figyelmen kívül maradnak.

Adattípus-beállítások

Adattípus

Megjegyzés: A Home Assistant automatizálások csak az Egészségügyi metrikák adattípust támogatják. Ez nem változtatható, automatikusan Egészségügyi metrikákra van állítva.

Egészségügyi metrikák konfigurációja

Egészségügyi metrikák kiválasztása – Válaszd ki, mely konkrét metrikák kerüljenek bele. Kiválaszthatod az összes elérhető metrikát vagy csak bizonyosakat.

Tipp: Ha csak a szükséges metrikákat választod, javulhat a feldolgozási idő és csökkenhet a Home Assistantnak küldött adatméret.

Preferált források – Állítsd be, mely adatforrások kapjanak prioritást, ha több forrás ugyanazt a metrikát szolgáltatja.

Exportbeállítások

Exportformátum

Megjegyzés: A Home Assistant automatizálások csak JSON formátumot támogatnak. Ez nem változtatható, automatikusan JSON-ra van állítva.

Export verzió

Megjegyzés: Export verzió nem érhető el Home Assistant automatizálásoknál, mert a formátum kifejezetten a Home Assistant állapot API-jához van optimalizálva.

Dátumtartomány

Válaszd ki, mikor kerüljenek exportálásra az adatok:

• Alapértelmezés – Szinkronizálja az előző teljes nap adatait, valamint az aktuális dátum és időig terjedő adatokat
• Ma – Szinkronizálja a mai nap összes adatát az aktuális időpontig
• Tegnap – Szinkronizálja a teljes előző nap adatait

Megjegyzés: A Home Assistant automatizálások nem támogatják a „Valós idejű”, „Az utolsó szinkron óta” vagy „Előző 7 nap” opciókat.

Adatok összefoglalása

Kapcsold BE vagy KI az „Adatok összefoglalása” beállítást az Egészségügyi metrikákhoz.

• BE – összesített adatösszefoglalók (alapértelmezés)
• KI – ahol lehetséges, szétbontott adat

Megjegyzés: Ez a beállítás csak az Egészségügyi metrikák adattípusra vonatkozik.

Időcsoportosítás

Ha az adatok összefoglalása be van kapcsolva, válaszd ki, hogyan legyenek az adatok összesítve:

• Alapértelmezés – nincs összesítés, nyers adatpontok
• Napok – adatok napi csoportosítása (ajánlott)

Szinkrongyakoriság

Állítsd be, milyen gyakran szinkronizáljon az automatizálás adatot a Home Assistantba:

Válassz számot és intervallumot.

Tesztelés és ellenőrzés

Ellenőrzés a Home Assistantban

1. Nyisd meg a Home Assistantot
2. Lépj a Developer Tools > States menüpontra
3. Keress rá hae.{your_automation_name} kifejezésre (kisbetű, szóköz nélkül)
4. Ellenőrizd, hogy az érzékelőállapot mutatja-e az egészségügyi adatokat
5. Nézd meg a „Last Updated” időbélyeget a legutóbbi szinkronok megerősítéséhez

Home Assistant naplók ellenőrzése

Ha nem jelennek meg adatok a Home Assistantban:

1. Nyisd meg a Home Assistantot
2. Lépj a Settings > System > Logs menüpontra
3. Keress REST API-val vagy érzékelőállapotokkal kapcsolatos hibákat
4. Ellenőrizd a hitelesítési hibákat vagy érvénytelen adatformátumot

Hibaelhárítás

Gyakori problémák

Hitelesítési hibák

• Ellenőrizd, hogy helyes-e a Long-Lived Access Token
• Az Authorization fejléc formátuma legyen: Bearer YOUR_TOKEN
• Ellenőrizd, hogy a token nem járt-e le és nem vonták-e vissza
• Győződj meg róla, hogy a tokennek megfelelő jogosultságai vannak a Home Assistantban

Nem jelenik meg az érzékelő a Home Assistantban

• Ellenőrizd, hogy az automatizálás neve nem tartalmaz speciális karaktereket
• Ellenőrizd az entitásazonosító formátumát: hae.{automation_name} (kisbetű, szóköz nélkül)
• Nézd meg a Home Assistant naplóit hibákért
• Győződj meg róla, hogy az API-kérés sikeres volt (nézd a tevékenységnaplót)

Nem frissülnek az adatok

• Ellenőrizd, hogy az automatizálás be van-e kapcsolva
• Nézd át a tevékenységnaplót hibákért
• Győződj meg róla, hogy van hálózati kapcsolat a Home Assistanthoz

Kapcsolat időtúllépése

• Ellenőrizd, hogy a Home Assistant fut és elérhető
• Ellenőrizd a hálózati kapcsolatot
• Növeld a kérés időtúllépését, ha a Home Assistant lassan válaszol
• Ellenőrizd az URL-t és a portot

Hibaüzenetek

Az alkalmazás hibaüzenetet jelenít meg, ha:

• Az URL érvénytelen vagy elérhetetlen
• A hitelesítés sikertelen (ellenőrizd az Authorization fejlécet)
• A Home Assistant hibaállapotkódot ad vissza
• Nincs hálózati kapcsolat

A tevékenységnaplóban részletes hibainformáció található, beleértve HTTP állapotkódokat és a Home Assistant hibaüzeneteit.

Home Assistant integrációs tippek

Egészségügyi adatok használata automatizálásokban

Miután az egészségügyi adatok szinkronizálódtak a Home Assistantba, használhatod őket automatizálásokban:

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!"

Irányítópultok létrehozása

Adj egészségügyi metrikákat a Home Assistant irányítópultodhoz:

1. Lépj az irányítópultra
2. Adj hozzá új kártyát
3. Válaszd az „Entities” vagy „Gauge” kártyatípust
4. Add hozzá a hae.{your_automation_name} érzékelő entitásokat

Érzékelőállapot szerkezete

A Home Assistantban az érzékelőállapot tartalmazza:

• state: az aktuális érték vagy állapot
• attributes: további adatok, többek között:
  • Időbélyeg-információk
  • Az exportált JSON formátumnak megfelelő adatszerkezet
  • Ahol érvényes, mértékegység-információ

Tippek és ajánlott gyakorlat

1. Automatikus szinkronizálás:

   • Töltse az eszközt és használja az iPhone-tükrözést
     • Töltés közben az iOS kevesebb teljesítménykorlátozást alkalmaz, így az adatok gyakrabban szinkronizálhatók
     • Az iPhone-tükrözéssel az eszköz úgy viselkedik, mintha fel lenne oldva. Így a Health Auto Export hozzáfér az egészségadatokhoz az automatizált műveletekhez

2. Automatikus szinkron:

   • Töltsd az eszközt, és használd az iPhone tükrözést
     • Töltés közben az iOS kevésbé korlátozza a teljesítményt
     • Az iPhone tükrözéssel az eszköz úgy viselkedik, mintha fel lenne oldva

3. Elnevezés:

   • Kerüld a speciális karaktereket, amelyek problémát okozhatnak

4. Adatkiválasztás:

   • Csak a szükséges metrikákat válaszd

Tevékenységnaplók megtekintése

1. Koppintson a Tevékenységnaplók megtekintése elemre az automatizálás konfigurációs képernyőjén.
2. Tekintse át a futtatások elemeket (csoportosítva, legújabb elöl), és bontsa ki az eseményeket minden futtatáson belül.
3. Különböztesse meg a figyelmeztetések (pl. lassú egészségadat-lekérdezés) és a hibák (entitás közzétételi vagy kapcsolati hibák) típusokat—lásd: Automatizálások áttekintése — Tevékenységnaplók.
4. A Home Assistant futtatások entitásonként naplózhatnak eredményeket; a futtatás részben sikeres lehet, ha egyes entitások frissülnek, mások pedig nem.
5. Megosztás (eszköztár) exportálja a teljes Alkalmazásesemény-naplók diagnosztikai ZIP-et támogatáshoz (ugyanaz, mint Beállítások → Speciális).
6. Törlés csak ennek az automatizálásnak a tevékenységtörténetét távolítja el.