Skicka din Amazfits puls, steg, sömn och batteri till Home Assistant (och 10 automationer)

AmazHA, en Home Assistant-app för Amazfit-klockor, fungerar mest åt ett håll: dina lampor, persienner och termostater på handleden. Funktionen Klocksensorer fungerar åt andra hållet. Klockan läser sin egen data, från steg och sömntillstånd till batteri, och skickar den till Home Assistant som sensorentiteter som du kan rita grafer av, visa på en instrumentpanel och använda i automationer.

Nedan: vad som skickas, hur det kommer dit, hur du slår på det, varför sensorer saknas, och tio automationer att klistra in.

Det korta svaret

Med AmazHA kan en Amazfit-klocka skicka upp till 18 mätvärden till Home Assistant: steg, distans, kalorier, puls, vilopuls, syremättnad, stress, sömnpoäng, sömnlängd, ett direkt läge för sover/vaken, bärstatus, lufttryck, batteri med mera. De kommer in via Home Assistants integration Mobile App som sensor.<prefix>_<key>, vid varje öppning av appen och sedan var 1:a till 6:e minut i bakgrunden.

Det här når Home Assistant

Arton sensorer, i fyra grupper, var och en påslagen separat. Det här är hela listan, med nyckeln som avslutar entitets-id:t och läget du ser i Home Assistant:

I AmazHA-inställningarna är de grupperade som Aktivitet, Hälsa, Miljö och Enhet, med etiketterna Steg, Distans, Kalorier, Ståtimmar, Intensiva minuter, PAI, Puls, Vilopuls, Syremättnad (SpO2), Stress, Kroppstemperatur, Sömnpoäng, Sömnlängd, Sömntillstånd, Lufttryck, Höjd, Klockans batteri och Bärstatus.

Enheter, klasser och långtidsstatistik

Sensorerna kommer med metadata för Home Assistant, så de beter sig som vilken annan sensor som helst. Batteriet har enhetsklassen battery, så det får batteriikonen och passar i en mätare. Distans och höjd är distance, lufttryck är atmospheric_pressure, kroppstemperatur är temperature, intensiva minuter och sömnlängd är duration. Varje sensor har sin egen ikon.

De dagliga räknarna (steg, distans, kalorier, ståtimmar, intensiva minuter) använder tillståndsklassen total_increasing: de går tillbaka till noll när klockan börjar en ny dag, och Home Assistant läser det som en nollställning, inte som ett fall. Mätarna (puls, batteri, tryck och resten) använder measurement. I båda fallen sparar Home Assistant långtidsstatistik för dem, så en statistikgraf över dina steg fungerar utan någon extra inställning.

sleep_state och wear är textlägen, utan enhet och utan klass. Använd dem i tillståndsutlösare och villkor.

Mätvärden som utelämnas

Klockan skickar en sensor bara när den har ett giltigt mätvärde. Den skickar ingen nolla eller platshållare i stället:

• Puls, vilopuls, stress, sömnpoäng och sömnlängd utelämnas medan klockan rapporterar 0, vilket betyder att den inte har mätt än. När klockan inte har några nya sömndata behåller sömnsensorerna sitt senaste värde.
• Syremättnad är en mätning, ingen kontinuerlig signal. AmazHA skickar den nyaste den kan hitta: en som just gjorts, de senaste två timmarnas mätpunkter, eller det senaste giltiga värdet upp till 24 timmar gammalt. spo2 är alltså ”den senaste mätningen”, inte ”just nu”.
• Kroppstemperatur skickas bara på klockor som har den sensorn, och först när den har data.
• Lufttryck och höjd skickas bara på klockor med barometer.
• Sömntillstånd skickas bara när klockan säger sover eller vaken.

När ett mätvärde utelämnas behåller Home Assistant det senaste värde den hade. Det spelar roll för automationer: en sensor som inte har ändrats kanske helt enkelt inte har uppdaterats.

Entitets-id:na

Varje entitet är sensor.<prefix>_<key>. Prefixet är det du skriver i Entitetsprefix (valfritt); lämnas det tomt är det klockans namn omgjort till ett giltigt entitets-id, så en ”Amazfit GTS 4” ger sensor.amazfit_gts_4_steps, sensor.amazfit_gts_4_battery och så vidare. Skärmen Klocksensorer skriver ut exakt id, med enhet, under varje sensor, så du behöver aldrig gissa.

Prefixet bestäms första gången klockan skickar sin data. Om du byter namn på klockan senare flyttas inte dina entiteter. Om du själv byter prefix gör de det: då registreras en andra enhet med nya entitets-id, och den gamla enheten ligger kvar i Home Assistant tills du tar bort den. Välj prefix innan du bygger automationer på det.

Så fungerar det: klockan blir en Mobile App-enhet

Klockan registrerar sig i Home Assistants integration Mobile App, samma som Home Assistants egen Companion-app använder. Din klocka blir en enhet, dess mätvärden blir sensorer på den enheten, och inget behöver installeras i HACS eller skrivas i configuration.yaml.

Vad som händer, steg för steg:

1. Klockan läser de sensorer du har slagit på och skickar dem till telefonen via Bluetooth.
2. AmazHA:s telefondel, som körs inne i Zepp-appen, registrerar klockan en gång i Home Assistants integration Mobile App. Enheten listas med Amazfit som tillverkare.
3. Varje sensor registreras en gång, med enhet, klass och ikon. Därefter är varje uppdatering ett enda samlat anrop för alla sensorerna.

Eftersom det här är riktiga entiteter i Home Assistants register, med ett unikt id, kan du byta namn på dem, ändra deras ikon, dölja dem eller lägga dem i ett område från Home Assistants gränssnitt. De finns kvar när Home Assistant startas om. Om du tar bort enheten i Home Assistant registrerar AmazHA den igen vid nästa sändning.

Integrationen Mobile App ingår i Home Assistants standardkonfiguration, så nästan varje installation har den redan. Om din inte läser in den faller AmazHA tillbaka på att skriva lägena direkt, vilket fungerar men ger entiteter som Home Assistant inte kan hantera från sitt gränssnitt och som försvinner när den startas om. Är det ditt fall, lägg till mobile_app: i din konfiguration.

Klockan pratar aldrig själv med Home Assistant. Det gör telefonen, med samma adresser som resten av AmazHA: den lokala adressen hemma, fjärradressen när du är ute. Om du bara har angett en lokal adress kan uppdateringar som skickas när du är borta inte nå Home Assistant. Fjärråtkomst för din klocka förklarar alternativen.

Slå på det, steg för steg

Du behöver fullversionen och en fungerande anslutning till Home Assistant först. Sedan tar det en minut, som i guide 9, Klocksensorer:

1. Öppna Klocksensorer. I AmazHA-inställningarna (i Zepp-appen: Profil › din klocka › Appar › AmazHA › Inställningar) trycker du på Klocksensorer. Steg 1.
2. Slå på funktionen. Slå på Skicka till Home Assistant. Steg 2.
3. Ge den ett namn om du vill. Entitetsprefix (valfritt) ger varje entitet namnet sensor.<prefix>_…. Lämnas det tomt används klockans namn. Steg 3.
4. Ställ in hur ofta. Uppdatera var anger intervallet i bakgrunden, från 1 till 6 minuter. Steg 4.
5. Välj sensorerna. Slå på dem du vill ha. Alla börjar avstängda. Steg 5.
6. Öppna AmazHA på klockan. Klockan skickar sina första mätvärden och ber om Bakgrundsaktivitet. Tillåt den. Steg 6.
7. Hitta den i Home Assistant. Gå till Inställningar › Enheter och tjänster › Mobile App och öppna din klocka. Steg 7.

Om skärmen Klocksensorer visar ett upplåsningskort i stället är fullversionen inte aktiv än: se Lås upp fullversionen. Om det står Anslut till Home Assistant först, ställ in anslutningen som i Anslut Home Assistant.

När data har kommit fram visar skärmen Klocksensorer en rad som Skickade 6 sensorer · 14:05, med · bakgrund på slutet när den kom från en uppdatering i bakgrunden. Den raden är det snabbaste sättet att se att allt fungerar.

Uppdateringar i bakgrunden: var 1:a till 6:e minut

Klockan skickar sina sensorer vid varje öppning av appen, och sedan i bakgrunden med det intervall du valt, så länge behörigheten Bakgrundsaktivitet är beviljad. Utan behörigheten uppdateras sensorerna bara när du öppnar AmazHA.

Alla kräver att telefonen är i närheten, med Bluetooth påslaget och Zepp-appen igång, eftersom det är telefonen som skickar datan till Home Assistant.

Att bevilja behörigheten

På en klocka där AmazHA har installerats från Zepp App Store ber klockan om Bakgrundsaktivitet nästa gång du öppnar AmazHA efter att ha slagit på funktionen. Den frågar en gång. Om du nekade, eller om begäran aldrig visades, har du två vägar tillbaka:

• Tillåt den i klockans egna inställningar: Appbehörigheter (eller Integritet, beroende på klocka), sedan AmazHA, och tillåt sedan bakgrundsaktivitet.
• Eller slå av och på Skicka till Home Assistant i AmazHA-inställningarna och öppna sedan AmazHA på klockan: den frågar igen.

Annat som är bra att veta

• Ändringar når bakgrunden vid nästa öppning av appen. Om du slår på eller av en sensor, eller ändrar Uppdatera var, öppnar du AmazHA på klockan en gång. Uppdateringarna i bakgrunden behåller det gamla urvalet till dess.
• Batterisparläget stoppar uppdateringar i bakgrunden. Medan klockan är i sitt batterisparläge kör den inga bakgrundsuppgifter, så sensorerna pausas; när du öppnar AmazHA efteråt kommer de tillbaka direkt.
• En omstart av klockan är inte slutet. Efter en kort omstart kommer uppdateringarna i bakgrunden tillbaka av sig själva, oftast inom en timme. Om du öppnar AmazHA kommer de tillbaka på en gång.

Varför dina klocksensorer inte dyker upp

När sensorer saknas är orsaken nästan alltid en av punkterna nedan. Gå igenom dem i den här ordningen:

1. Skicka till Home Assistant är avstängt. Inställningsmenyn visar Klocksensorer som På eller Av. Det måste vara På.
2. De enskilda sensorerna är avstängda. Varje sensor börjar avstängd. Skärmen Klocksensorer visar hur många du skickar, till exempel ”6 av 18 sensorer skickas till HA”.
3. Du har inte öppnat AmazHA på klockan sedan dess. De första data skickas från klockan när du öppnar appen. Öppna den en gång efter att du har ändrat något.
4. Fullversionen är inte aktiv. Utan licensen visar skärmen ett upplåsningskort och inget skickas.
5. Home Assistant är inte ansluten. Skärmen säger Anslut till Home Assistant först. Ordna anslutningen: guide 4, och för fel, När något krånglar.
6. Sensorn har inget giltigt mätvärde än. Syremättnad, stress och kroppstemperatur visas först efter en mätning; tryck och höjd bara på klockor med barometer. Om statusraden säger Inga sensorer aktiverade hade ingen av sensorerna du slagit på något mätvärde att skicka.
7. Den uppdateras bara när du öppnar appen. Det är behörigheten Bakgrundsaktivitet: se ovan.
8. Du letar på fel ställe. Sensorerna hör till en enhet under Inställningar › Enheter och tjänster › Mobile App, döpt efter ditt prefix. Du kan också söka efter prefixet på fliken Entiteter i Inställningar › Enheter och tjänster.
9. Telefonen når inte Home Assistant. När du är borta behöver telefonen en fjärradress. Öppna din Home Assistant-adress i telefonens webbläsare: misslyckas det där, misslyckas det för sensorerna också. Steg 3 i felsökningsguiden går igenom det.
10. Värdena ser frusna ut. Kontrollera tiden på statusraden. Är den gammal har telefonen eller klockan inte skickat något sedan dess: telefonen utom räckvidd, Zepp-appen stängd, batterisparläget på eller behörigheten saknas.

Tio automationer

De tio automationerna nedan täcker de önskemål som dyker upp gång på gång: lågt batteri, att somna, att vakna, klockan kvar på laddaren, aktivitetsmål. De använder den aktuella syntaxen i Home Assistant och kan klistras in som de är.

För att lägga till en: Inställningar › Automationer och scener › Skapa automation › Skapa ny automation, sedan menyn med tre punkter, Redigera i YAML, och klistra in.

Varje entitets-id här är ett exempel. Klocksensorerna använder prefixet amazfit_gts_4; byt ut det mot ditt. notify.mobile_app_your_phone är aviseringsåtgärden för en telefon som kör Home Assistants Companion-app; hitta din under Utvecklarverktyg › Åtgärder genom att skriva ”notify”. Lampor, persienner, scener och personentiteten är platshållare för dina egna. Tröskelvärdena är startpunkter: titta på en veckas historik innan du bestämmer dig för dina.

1. Lågt batteri i klockan

En avisering när klockan sjunker under 15 %.

alias: Lågt batteri i klockan
description: Avisera när klockans batteri sjunker under 15 %
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    below: 15
actions:
  - action: notify.mobile_app_your_phone
    data:
      title: Lågt batteri i klockan
      message: "Klockan har {{ states('sensor.amazfit_gts_4_battery') }} % kvar."
mode: single

En utlösare av typen numeric_state aktiveras när värdet korsar gränsen, inte vid varje uppdatering under den, så den här aviserar dig en gång per urladdning.

2. Ladda den före läggdags

Om du vill följa din sömn måste klockan räcka hela natten. En påminnelse på kvällen när den inte gör det:

alias: Ladda klockan före läggdags
triggers:
  - trigger: time
    at: "21:30:00"
conditions:
  - condition: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    below: 30
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "Klockan har {{ states('sensor.amazfit_gts_4_battery') }} %: ladda den nu för att följa nattens sömn."
mode: single

3. Sover: släck lamporna, sänk värmen

När klockan säger att du sover, och har sagt det i tio minuter, släcker du lamporna i vardagsrummet och sänker termostaten i sovrummet.

alias: Sover - släck lamporna
triggers:
  - trigger: state
    entity_id: sensor.amazfit_gts_4_sleep_state
    to: "asleep"
    for:
      minutes: 10
conditions:
  - condition: time
    after: "21:00:00"
    before: "04:00:00"
actions:
  - action: light.turn_off
    target:
      area_id: living_room
  - action: climate.set_temperature
    target:
      entity_id: climate.bedroom
    data:
      temperature: 18
mode: single

Tidsfönstret hindrar en tupplur på eftermiddagen från att stänga av huset; ett fönster som passerar midnatt fungerar bra i ett tidsvillkor. De tio minuterna i for: filtrerar bort en kort slummer i soffan. Tänk på att läget når Home Assistant först vid nästa uppdatering, så den verkliga fördröjningen är ditt intervall plus for:.

4. Vaken: morgonrutinen

När du vaknar en vardagsmorgon öppnas persiennerna i sovrummet, köksljuset tänds och kaffebryggaren startar, en gång om dagen.

alias: Vaken - morgonrutin
triggers:
  - trigger: state
    entity_id: sensor.amazfit_gts_4_sleep_state
    from: "asleep"
    to: "awake"
    for:
      minutes: 5
conditions:
  - condition: time
    after: "05:30:00"
    before: "10:30:00"
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
  - condition: template
    value_template: >-
      {{ this.attributes.last_triggered is none
         or this.attributes.last_triggered < today_at() }}
actions:
  - action: cover.open_cover
    target:
      entity_id: cover.bedroom_blinds
  - action: light.turn_on
    target:
      entity_id: light.kitchen
    data:
      brightness_pct: 60
  - action: switch.turn_on
    target:
      entity_id: switch.coffee_machine
mode: single

from: "asleep" spelar roll: bara en verklig ändring från sover till vaken räknas, inte att sensorn kommer tillbaka från unknown eller unavailable, vilket annars skulle kunna starta din morgon klockan 3 på natten. Mallvillkoret låter den bara köras en gång om dagen, så om du vaknar klockan 6, somnar om och vaknar igen klockan 7 öppnas persiennerna en gång.

5. Laddad och kvar på laddaren

Klockan är fulladdad men fortfarande inte på handleden: en knuff att sätta på den igen.

alias: Klockan laddad, sätt på den igen
triggers:
  - trigger: state
    entity_id: sensor.amazfit_gts_4_wear
    to: "not_worn"
    for:
      minutes: 45
conditions:
  - condition: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    above: 90
  - condition: time
    after: "07:00:00"
    before: "22:00:00"
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: Klockan är laddad och har legat av handleden i 45 minuter.
mode: single

Av handleden med högt batteri betyder oftast att den ligger på laddaren eller på skrivbordet. Observera att unknown också är ett giltigt värde för wear: klockan var inte säker. I Home Assistant ser det precis ut som ”unknown” för en sensor utan data, så utlös aldrig på det.

6. Vilopuls över din vanliga

En försiktig varning när din vilopuls ligger kvar över ditt normala intervall. Det här är en knuff att känna efter hur du mår, inte ett medicinskt larm.

alias: Vilopuls över den vanliga
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_resting_heart_rate
    above: 80
    for:
      hours: 1
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "Vilopuls {{ states('sensor.amazfit_gts_4_resting_heart_rate') }} bpm, över din vanliga."
mode: single

Sätt tröskeln utifrån din egen historik: öppna sensorn i Home Assistant och titta på några veckor. Ett värde 10 till 15 bpm över din vanliga vilopuls är en rimlig startpunkt.

7. Stegmålet nått

En avisering i samma stund som du passerar 10 000 steg.

alias: Stegmålet nått
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_steps
    above: 9999
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "10 000 steg i dag. Snyggt jobbat."
mode: single

above betyder strikt större än, därav 9999. Stegen går tillbaka till noll när klockan börjar en ny dag, så utlösaren är redo igen nästa dag.

8. En knuff till en kvällspromenad

Klockan 18.30, om du har klockan på dig och fortfarande ligger under 5 000 steg, ett förslag att ta en promenad.

alias: Knuff till kvällspromenad
triggers:
  - trigger: time
    at: "18:30:00"
conditions:
  - condition: numeric_state
    entity_id: sensor.amazfit_gts_4_steps
    below: 5000
  - condition: state
    entity_id: sensor.amazfit_gts_4_wear
    state:
      - worn
      - in_motion
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "{{ states('sensor.amazfit_gts_4_steps') }} steg hittills i dag. Dags för en promenad?"
mode: single

Villkoret för bärstatus gör att du inte blir tjatad på en dag då klockan låg kvar på laddaren: det låga antalet skulle vara klockans, inte ditt.

9. Sömnrapport på morgonen

En kort sammanfattning av natten klockan 9.00, i timmar och minuter.

alias: Sömnrapport på morgonen
triggers:
  - trigger: time
    at: "09:00:00"
conditions:
  - condition: template
    value_template: "{{ states('sensor.amazfit_gts_4_sleep_duration') | is_number }}"
actions:
  - variables:
      mins: "{{ states('sensor.amazfit_gts_4_sleep_duration') | int(0) }}"
  - action: notify.mobile_app_your_phone
    data:
      title: I natt
      message: >-
        {{ mins // 60 }} h {{ mins % 60 }} min,
        sömnpoäng {{ states('sensor.amazfit_gts_4_sleep_score') }}.
mode: single

Sömnpoäng och sömnlängd följer klockans egen sömnsammanfattning, som klockan uppdaterar enligt sitt eget schema. En rapport vid en fast tid en bra stund efter att du har gått upp är pålitligare än en som utlöses i samma stund som du vaknar.

10. En stressig kväll: lugnare ljus

När stressvärdet ligger högt i en kvart på kvällen medan du är hemma byter vardagsrummet till en lugn scen.

alias: Hög stress - lugnt ljus
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_stress
    above: 75
    for:
      minutes: 15
conditions:
  - condition: state
    entity_id: person.you
    state: "home"
  - condition: time
    after: "17:00:00"
    before: "23:00:00"
actions:
  - action: scene.turn_on
    target:
      entity_id: scene.living_room_calm
mode: single

Närvaron kommer från person.you, inte från klockan. De 15 minuterna i for: betyder att värdet måste ligga högt över flera uppdateringar, vilket filtrerar bort en enskild topp efter en trappa.

En anmärkning om tidsåtgång

Varje automation ovan reagerar på ett läge som Home Assistant har fått från telefonen. Med ett intervall på 5 minuter kan en ändring på klockan ta upp till 5 minuter att komma fram, och en for: lägger till sin egen tid ovanpå. Välj automationer där några minuter inte spelar någon roll: lampor efter att du har somnat, ja; ett larm när du går hemifrån, nej.

Idéer för instrumentpanelen

Klocksensorerna är vanliga sensorer i Home Assistant, så varje standardkort fungerar med dem. Några upplägg som är lätta att läsa:

• Ett klockkort högst upp på telefonens instrumentpanel: ett Tile card (rutkort) för battery, wear och sleep_state sida vid sida.
• Batteriet som mätare: ett Gauge card (mätarkort) på battery med färger för allvarlighetsgrad, till exempel rött under 20 och gult under 40.
• Pulsen under dagen: ett History graph card (historikgraf) med heart_rate och resting_heart_rate över 24 timmar.
• Steg per dag: ett Statistics graph card (statistikgraf) på steps med dygnsperiod och statistiken ”change” (förändring). Det fungerar eftersom de dagliga räknarna använder tillståndsklassen total_increasing.
• Natten på en rad: ett Entities card (entitetskort) med sleep_score, sleep_duration och spo2.
• Väderstation på handleden: på klockor med barometer visar ett History graph card för pressure över två eller tre dagar den trend som ett väderomslag ger.

Sömnlängden kommer i minuter. Föredrar du timmar på instrumentpanelen, lägg till en mallsensor: Inställningar › Enheter och tjänster › Hjälpare › Skapa hjälpare › Mall och sedan Template a sensor (mallsensor), med den här tillståndsmallen och h som enhet:

{{ (states('sensor.amazfit_gts_4_sleep_duration') | float(0) / 60) | round(1) }}

Vad det inte är

Klocksensorerna är användbara för automationer som kan vänta några minuter. De ersätter inte dedikerade sensorer, och tre gränser är bra att känna till innan du förlitar dig på dem.

Inte omedelbart. Uppdateringar kommer vid varje öppning av appen och sedan med ditt intervall, från 1 till 6 minuter. En lägesändring på klockan kan ta så lång tid att nå Home Assistant, och längre när telefonen är utom räckvidd, Zepp-appen är stängd eller batterisparläget är på. Uppdateringar i bakgrunden beror också på behörigheten Bakgrundsaktivitet.

Ingen närvarosensor. Ingen av de 18 sensorerna säger var du är. wear säger om klockan sitter på en handled, inte vems handled eller i vilket hus. Uppdateringarna kräver att telefonen är i närheten, men det säger ingenting om huruvida du är hemma. Använd din telefon, en personentitet eller en rumssensor för närvaro.

Inga medicinska data. Puls, syremättnad, stress och kroppstemperatur kommer från klockans egna sensorer. De är bra för trender och försiktiga knuffar, inte för diagnoser eller larm som du skulle sätta din hälsa på. Syremättnaden i synnerhet är den senaste mätningen som klockan gjorde, och den kan vara flera timmar gammal.

Din data förblir din. Mätvärdena går från klockan till telefonen via Bluetooth, och från telefonen till din egen Home Assistant. AmazHA har inga konton, ingen analys och ingen egen server, och hälsodata skickas aldrig till utvecklaren eller någon tredje part. I Home Assistant lagras de som vilken annan sensor som helst, enligt dina inställningar för lagringstid. Varje sensor är avstängd tills du slår på den, så du skickar exakt det du väljer. Integritetspolicyn har detaljerna.