Blog

Invia a Home Assistant frequenza cardiaca, passi, sonno e batteria del tuo Amazfit (e 10 automazioni)

Il tuo Amazfit sa già quando ti addormenti, quanti passi hai fatto e quanta batteria gli resta. Ecco come portare tutto in Home Assistant come normali sensori, e cosa automatizzarci.

Pubblicato 17 min di lettura

In questo articolo
  1. La risposta breve
  2. Cosa arriva in Home Assistant
    1. Unità, classi e statistiche a lungo termine
    2. Le letture che restano fuori
    3. Gli entity id
  3. Come funziona: l’orologio diventa un dispositivo Mobile App
  4. Attivalo, passo dopo passo
  5. Aggiornamenti in background: ogni 1-6 minuti
    1. Concedere il permesso
    2. Cos’altro sapere
  6. Perché i sensori dell’orologio non compaiono
  7. Dieci automazioni
    1. 1. Batteria dell’orologio scarica
    2. 2. Ricaricalo prima di dormire
    3. 3. Addormentato: luci spente, riscaldamento giù
    4. 4. Sveglio: la routine del mattino
    5. 5. Carico e dimenticato sul caricatore
    6. 6. Frequenza cardiaca a riposo sopra il solito
    7. 7. Obiettivo di passi raggiunto
    8. 8. Una spinta per la passeggiata serale
    9. 9. Il rapporto mattutino sul sonno
    10. 10. Serata stressante: luci più calme
    11. Una nota sui tempi
  8. Idee per la plancia
  9. Cosa non è
  10. Domande frequenti

AmazHA, un’app per Amazfit dedicata a Home Assistant, funziona soprattutto in una direzione: luci, tapparelle e termostati al tuo polso. La sua funzione Sensori orologio funziona al contrario. L’orologio legge i propri dati, dai passi allo stato del sonno alla batteria, e li invia a Home Assistant come entità sensore che puoi mettere in grafico, mostrare su una plancia e usare nelle automazioni.

Qui sotto: cosa viene inviato, come arriva, come attivarlo, perché mancano dei sensori, e dieci automazioni da incollare.

La risposta breve

Con AmazHA, un orologio Amazfit può inviare a Home Assistant fino a 18 letture: passi, distanza, calorie, frequenza cardiaca, frequenza cardiaca a riposo, ossigeno nel sangue, stress, punteggio del sonno, durata del sonno, uno stato addormentato/sveglio in tempo reale, stato al polso, pressione atmosferica, batteria e altro. Arrivano tramite l’integrazione Mobile App di Home Assistant come sensor.<prefix>_<key>, a ogni apertura dell’app e poi ogni 1-6 minuti in background.

Cosa arriva in Home Assistant

Diciotto sensori, in quattro gruppi, ognuno attivabile separatamente. Questo è l’elenco completo, con la chiave che chiude l’entity id e lo stato che vedrai in Home Assistant:

Chiave Unità Cos’è Stato d’esempio
steps passi Passi contati oggi 6412
distance m Distanza percorsa oggi 4870
calories kcal Calorie bruciate oggi 1834
stand h Ore in piedi oggi 7
fat_burning min Minuti intensi oggi 22
pai — Punteggio PAI 68
heart_rate bpm L’ultima lettura della frequenza cardiaca dell’orologio 71
resting_heart_rate bpm Frequenza cardiaca a riposo 58
spo2 % Ultima misurazione dell’ossigeno nel sangue 97
stress — Valore attuale dello stress 34
body_temperature °C Temperatura corporea, un decimale 36.4
sleep_score — Punteggio dell’ultimo sonno 81
sleep_duration min Durata dell’ultimo sonno 452
sleep_state — Se stai dormendo in questo momento asleep / awake
pressure hPa Pressione atmosferica, un decimale 1013.2
altitude m Altitudine dal barometro 212
battery % La batteria dell’orologio 64
wear — Se l’orologio è al polso not_worn / worn / in_motion / unknown

Nelle impostazioni di AmazHA sono raggruppati in Attività, Salute, Ambiente e Dispositivo, con le etichette Passi, Distanza, Calorie, Ore in piedi, Minuti intensi, PAI, Frequenza cardiaca, Frequenza cardiaca a riposo, Ossigeno nel sangue (SpO2), Stress, Temperatura corporea, Punteggio del sonno, Durata del sonno, Stato del sonno, Pressione atmosferica, Altitudine, Batteria orologio e Stato al polso.

Unità, classi e statistiche a lungo termine

I sensori arrivano con i metadati di Home Assistant, quindi si comportano come qualsiasi altro sensore. La batteria ha la classe di dispositivo battery, quindi riceve l’icona della batteria e si presta a un indicatore. Distanza e altitudine sono distance, la pressione atmosferica è atmospheric_pressure, la temperatura corporea è temperature, minuti intensi e durata del sonno sono duration. Ogni sensore ha la sua icona.

I contatori giornalieri (passi, distanza, calorie, ore in piedi, minuti intensi) usano la classe di stato total_increasing: tornano a zero quando l’orologio inizia un nuovo giorno, e Home Assistant lo interpreta come un azzeramento, non come un calo. Le misure (frequenza cardiaca, batteria, pressione e le altre) usano measurement. In entrambi i casi Home Assistant ne conserva le statistiche a lungo termine, quindi un grafico statistico dei tuoi passi funziona senza alcuna configurazione aggiuntiva.

sleep_state e wear sono stati testuali, senza unità e senza classe. Usali in trigger e condizioni di stato.

Le letture che restano fuori

L’orologio invia un sensore solo quando ha una lettura valida. Non invia al suo posto uno zero o un valore segnaposto:

  • Frequenza cardiaca, frequenza cardiaca a riposo, stress, punteggio del sonno e durata del sonno restano fuori finché l’orologio riporta 0, che significa che non ha ancora misurato. Quando l’orologio non ha nuovi dati sul sonno, i sensori del sonno mantengono il loro ultimo valore.
  • L’ossigeno nel sangue è una misurazione, non un segnale continuo. AmazHA invia la più recente che riesce a trovare: una appena presa, i campioni delle ultime due ore, o l’ultimo valore buono fino a 24 ore prima. Quindi spo2 è “l’ultima misurazione”, non “adesso”.
  • La temperatura corporea viene inviata solo sugli orologi che hanno quel sensore, e solo quando ha dei dati.
  • Pressione atmosferica e altitudine vengono inviate solo sugli orologi con barometro.
  • Lo stato del sonno viene inviato solo quando l’orologio dice addormentato o sveglio.

Quando una lettura resta fuori, Home Assistant mantiene l’ultimo valore che aveva. Questo conta per le automazioni: un sensore che non è cambiato potrebbe semplicemente non essere stato aggiornato.

Gli entity id

Ogni entità è sensor.<prefix>_<key>. Il prefisso è ciò che scrivi in Prefisso entità (opzionale); se lo lasci vuoto, è il nome del tuo orologio reso valido per un entity id, quindi un “Amazfit GTS 4” dà sensor.amazfit_gts_4_steps, sensor.amazfit_gts_4_battery e così via. La schermata Sensori orologio stampa l’id esatto, con la sua unità, sotto ogni sensore, così non devi mai indovinare.

Il prefisso viene fissato la prima volta che l’orologio invia i suoi dati. Rinominare l’orologio in seguito non sposta le tue entità. Cambiare il prefisso tu stesso invece sì: registra un secondo dispositivo con nuovi entity id, e il vecchio dispositivo resta in Home Assistant finché non lo elimini. Scegli il prefisso prima di costruirci sopra delle automazioni.

Come funziona: l’orologio diventa un dispositivo Mobile App

L’orologio si registra con l’integrazione Mobile App di Home Assistant, la stessa che usa l’app Companion ufficiale di Home Assistant. Il tuo orologio diventa un dispositivo, le sue letture diventano sensori di quel dispositivo, e non c’è nulla da installare in HACS né da scrivere in configuration.yaml.

Cosa succede, passo dopo passo:

  1. L’orologio legge i sensori che hai attivato e li invia al telefono via Bluetooth.
  2. La parte di AmazHA sul telefono, che gira dentro l’app Zepp, registra l’orologio una volta sola con l’integrazione Mobile App di Home Assistant. Il dispositivo compare con Amazfit come produttore.
  3. Ogni sensore viene registrato una volta sola, con la sua unità, la sua classe e la sua icona. Da lì in poi, ogni aggiornamento è un’unica chiamata cumulativa per tutti i sensori.

Dato che sono entità vere nel registro di Home Assistant, con un id univoco, puoi rinominarle, cambiarne l’icona, nasconderle o metterle in un’area dall’interfaccia di Home Assistant. Restano anche quando Home Assistant si riavvia. Se elimini il dispositivo in Home Assistant, AmazHA lo registra di nuovo all’invio successivo.

L’integrazione Mobile App fa parte della configurazione predefinita di Home Assistant, quindi quasi ogni installazione ce l’ha già. Se la tua non la carica, AmazHA ripiega sulla scrittura diretta degli stati, che funziona ma produce entità che Home Assistant non può gestire dalla sua interfaccia e che spariscono quando si riavvia. Se è il tuo caso, aggiungi mobile_app: alla tua configurazione.

L’orologio non parla mai direttamente con Home Assistant. Lo fa il telefono, usando gli stessi indirizzi del resto di AmazHA: l’indirizzo locale a casa, quello remoto quando sei fuori. Se imposti solo un indirizzo locale, gli aggiornamenti inviati mentre sei fuori non possono raggiungere Home Assistant. L’accesso da remoto per il tuo orologio spiega le opzioni.

Attivalo, passo dopo passo

Prima ti servono la versione completa e una connessione funzionante con Home Assistant. Poi ci vuole un minuto, come mostra il tutorial 9, Sensori dell’orologio:

  1. Apri Sensori orologio. Nelle impostazioni di AmazHA (nell’app Zepp: Profilo › il tuo orologio › App › AmazHA › Impostazioni), tocca Sensori orologio. Passo 1.
  2. Attivalo. Attiva Invia a Home Assistant. Passo 2.
  3. Dagli un nome, se vuoi. Prefisso entità (opzionale) dà a ogni entità il nome sensor.<prefix>_…. Se lo lasci vuoto, usa il nome del tuo orologio. Passo 3.
  4. Scegli la frequenza. Aggiorna ogni imposta l’intervallo in background, da 1 a 6 minuti. Passo 4.
  5. Scegli i sensori. Attiva quelli che vuoi. All’inizio sono tutti disattivati. Passo 5.
  6. Apri AmazHA sull’orologio. L’orologio invia le sue prime letture e chiede il permesso Attività in background. Consentilo. Passo 6.
  7. Trovalo in Home Assistant. Vai su Impostazioni › Dispositivi e servizi › Mobile App e apri il tuo orologio. Passo 7.

Se la schermata Sensori orologio mostra invece una scheda di sblocco, la versione completa non è ancora attiva: vedi sblocca la versione completa. Se dice Prima collegati a Home Assistant, configura la connessione come in Collega Home Assistant.

Quando i dati sono arrivati, la schermata Sensori orologio mostra una riga come Inviati 6 sensori · 14:05, con · background alla fine quando provengono da un aggiornamento in background. Quella riga è il controllo più rapido che tutto funzioni.

Aggiornamenti in background: ogni 1-6 minuti

L’orologio invia i suoi sensori a ogni apertura dell’app, e poi in background all’intervallo che hai scelto, purché il permesso Attività in background sia concesso. Senza il permesso, i sensori si aggiornano solo quando apri AmazHA.

Quando Serve
All’apertura dell’app Ogni volta che apri AmazHA sull’orologio Niente oltre alla configurazione
Mentre l’app è aperta Al tuo intervallo Niente oltre alla configurazione
In background Al tuo intervallo, da 1 a 6 min (5 per impostazione predefinita), ad app chiusa Attività in background consentita sull’orologio

In tutti i casi serve il telefono vicino, con il Bluetooth attivo e l’app Zepp in esecuzione, perché è il telefono a inviare i dati a Home Assistant.

Concedere il permesso

Su un orologio con AmazHA installata dallo Zepp App Store, l’orologio chiede il permesso Attività in background la prossima volta che apri AmazHA dopo aver attivato la funzione. Lo chiede una volta sola. Se hai rifiutato, o la richiesta non è mai comparsa, hai due modi per rimediare:

  • Consentilo nelle impostazioni dell’orologio stesso: Permessi app (o Privacy, a seconda dell’orologio), poi AmazHA, poi consenti l’attività in background.
  • Oppure disattiva e riattiva Invia a Home Assistant nelle impostazioni di AmazHA, poi apri AmazHA sull’orologio: te lo chiede di nuovo.

Cos’altro sapere

  • Le modifiche arrivano al background alla prossima apertura dell’app. Se attivi o disattivi un sensore, o cambi Aggiorna ogni, apri AmazHA sull’orologio una volta. Fino ad allora gli aggiornamenti in background mantengono la vecchia selezione.
  • Il risparmio energetico ferma gli aggiornamenti in background. Mentre l’orologio è in modalità di risparmio energetico non esegue attività in background, quindi i sensori si fermano; aprire AmazHA dopo li fa ripartire subito.
  • Un riavvio dell’orologio non è la fine. Dopo un breve riavvio gli aggiornamenti in background tornano da soli, di solito entro l’ora. Aprire AmazHA li riporta subito.

Perché i sensori dell’orologio non compaiono

Quando mancano dei sensori, la causa è quasi sempre una delle voci qui sotto. Controllale in quest’ordine:

  1. Invia a Home Assistant è disattivato. Il menu delle impostazioni mostra Sensori orologio come On o Off. Deve essere On.
  2. I singoli sensori sono disattivati. Ogni sensore parte disattivato. La schermata Sensori orologio mostra quanti ne invii, per esempio “6 di 18 sensori inviati a HA”.
  3. Da allora non hai aperto AmazHA sull’orologio. I primi dati partono dall’orologio quando apri l’app. Aprila una volta dopo ogni modifica.
  4. La versione completa non è attiva. Senza licenza la schermata mostra una scheda di sblocco e non viene inviato nulla.
  5. Home Assistant non è collegato. La schermata dice Prima collegati a Home Assistant. Sistema la connessione: tutorial 4, e per gli errori, Quando qualcosa non va.
  6. Il sensore non ha ancora una lettura valida. Ossigeno nel sangue, stress e temperatura corporea compaiono solo dopo una misurazione; pressione e altitudine solo sugli orologi con barometro. Se la riga di stato indica Nessun sensore abilitato, nessuno dei sensori che hai attivato aveva una lettura da inviare.
  7. Si aggiorna solo quando apri l’app. È il permesso Attività in background: vedi sopra.
  8. Stai cercando nel posto sbagliato. I sensori appartengono a un dispositivo in Impostazioni › Dispositivi e servizi › Mobile App, con il nome del tuo prefisso. Puoi anche cercare il prefisso nella scheda Entità di Impostazioni › Dispositivi e servizi.
  9. Il telefono non riesce a raggiungere Home Assistant. Fuori casa, il telefono ha bisogno di un indirizzo remoto. Apri l’indirizzo del tuo Home Assistant nel browser del telefono: se lì non funziona, non funziona nemmeno per i sensori. Lo copre il passo 3 del tutorial sulla risoluzione dei problemi.
  10. I valori sembrano congelati. Controlla l’ora nella riga di stato. Se è vecchia, il telefono o l’orologio non hanno inviato nulla da allora: telefono fuori portata, app Zepp chiusa, risparmio energetico attivo, oppure manca il permesso.

Dieci automazioni

Le dieci automazioni qui sotto coprono le richieste che tornano più spesso: batteria scarica, andare a dormire, svegliarsi, l’orologio dimenticato sul caricatore, gli obiettivi di attività. Usano la sintassi attuale di Home Assistant e si possono incollare così come sono.

Per aggiungerne una: Impostazioni › Automazioni e scene › Crea automazione › Crea nuova automazione, poi il menu con i tre puntini, Modifica in YAML, e incolla.

Ogni entity id qui è un esempio. I sensori dell’orologio usano il prefisso amazfit_gts_4; sostituiscilo con il tuo. notify.mobile_app_your_phone è l’azione di notifica di un telefono con l’app Companion di Home Assistant; trova la tua in Strumenti per sviluppatori › Azioni digitando “notify”. Luci, tapparelle, scene e l’entità persona sono segnaposto per i tuoi. Le soglie sono punti di partenza: guarda una settimana di cronologia prima di fissare le tue.

1. Batteria dell’orologio scarica

Una notifica quando l’orologio scende sotto il 15%.

alias: Batteria orologio scarica
description: Notifica quando la batteria dell’orologio scende sotto il 15 %
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    below: 15
actions:
  - action: notify.mobile_app_your_phone
    data:
      title: Batteria orologio scarica
      message: "Il tuo orologio è al {{ states('sensor.amazfit_gts_4_battery') }} %."
mode: single

Un trigger numeric_state scatta quando il valore attraversa la soglia, non a ogni aggiornamento sotto di essa, quindi ti avvisa una volta per scarica.

2. Ricaricalo prima di dormire

Se vuoi il monitoraggio del sonno, l’orologio deve durare tutta la notte. Un promemoria serale quando non ce la farà:

alias: Ricarica l’orologio prima di dormire
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: "Orologio al {{ states('sensor.amazfit_gts_4_battery') }} %: ricaricalo ora per monitorare il sonno di stanotte."
mode: single

3. Addormentato: luci spente, riscaldamento giù

Quando l’orologio dice che stai dormendo, e lo dice da dieci minuti, spegni le luci del soggiorno e abbassa il termostato della camera.

alias: Addormentato - luci spente
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

La finestra oraria evita che un pisolino pomeridiano spenga la casa; in una condizione di tempo una finestra che attraversa la mezzanotte va benissimo. I dieci minuti di for: filtrano un breve sonnellino sul divano. Tieni presente che lo stato arriva a Home Assistant solo all’aggiornamento successivo, quindi il ritardo reale è il tuo intervallo più il for:.

4. Sveglio: la routine del mattino

Quando ti svegli la mattina di un giorno feriale, apri le tapparelle della camera, accendi la luce della cucina e avvia la macchina del caffè, una volta al giorno.

alias: Sveglio - routine del mattino
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" è importante: conta solo un vero passaggio da addormentato a sveglio, non il sensore che torna da unknown o unavailable, che altrimenti potrebbe far partire la tua mattina alle 3. La condizione template la lascia girare una sola volta al giorno, quindi svegliarti alle 6, riappisolarti e risvegliarti alle 7 apre le tapparelle una volta sola.

5. Carico e dimenticato sul caricatore

L’orologio è carico ma ancora fuori dal polso: un promemoria per rimetterlo.

alias: Orologio carico, rimettilo al polso
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: Il tuo orologio è carico e non è al polso da 45 minuti.
mode: single

Fuori dal polso con la batteria alta di solito significa che è sul caricatore o sulla scrivania. Nota che anche unknown è un valore valido di wear: l’orologio non ne era sicuro. In Home Assistant ha esattamente l’aspetto dello “sconosciuto” di un sensore senza dati, quindi non usarlo mai come trigger.

6. Frequenza cardiaca a riposo sopra il solito

Un avviso discreto quando la tua frequenza cardiaca a riposo resta sopra il tuo intervallo normale. È un invito a controllare come ti senti, non un allarme medico.

alias: Frequenza a riposo sopra il solito
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: "Frequenza cardiaca a riposo {{ states('sensor.amazfit_gts_4_resting_heart_rate') }} bpm, sopra il tuo solito."
mode: single

Imposta la soglia in base alla tua cronologia: apri il sensore in Home Assistant e guarda qualche settimana. Un valore di 10-15 bpm sopra la tua frequenza a riposo abituale è un punto di partenza ragionevole.

7. Obiettivo di passi raggiunto

Una notifica nel momento in cui superi i 10.000 passi.

alias: Obiettivo di passi raggiunto
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_steps
    above: 9999
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "10.000 passi oggi. Ottimo lavoro."
mode: single

above significa strettamente maggiore, da qui il 9999. I passi tornano a zero quando l’orologio inizia un nuovo giorno, quindi il trigger è di nuovo pronto il giorno dopo.

8. Una spinta per la passeggiata serale

Alle 18:30, se indossi l’orologio e sei ancora sotto i 5.000 passi, un suggerimento di fare una passeggiata.

alias: Spinta per la passeggiata serale
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') }} passi finora oggi. Che ne dici di una passeggiata?"
mode: single

La condizione sul polso evita di tormentarti in un giorno in cui l’orologio è rimasto sul caricatore: il conteggio basso sarebbe dell’orologio, non tuo.

9. Il rapporto mattutino sul sonno

Un breve riassunto della notte alle 9:00, in ore e minuti.

alias: Rapporto mattutino sul sonno
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: La notte scorsa
      message: >-
        {{ mins // 60 }} h {{ mins % 60 }} min,
        punteggio del sonno {{ states('sensor.amazfit_gts_4_sleep_score') }}.
mode: single

Punteggio e durata del sonno seguono il riepilogo del sonno dell’orologio, che l’orologio aggiorna con i suoi tempi. Un rapporto a un’ora fissa, ben dopo che ti sei alzato, è più affidabile di uno che scatta nel momento in cui ti svegli.

10. Serata stressante: luci più calme

Quando il valore dello stress resta alto per un quarto d’ora di sera mentre sei in casa, passa il soggiorno a una scena rilassante.

alias: Stress alto - luci calme
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

La presenza viene da person.you, non dall’orologio. I 15 minuti di for: significano che il valore deve restare alto per diversi aggiornamenti, il che filtra un singolo picco dopo aver fatto le scale.

Una nota sui tempi

Ogni automazione qui sopra reagisce a uno stato che Home Assistant ha ricevuto dal telefono. Con un intervallo di 5 minuti, un cambiamento sull’orologio può impiegare fino a 5 minuti ad arrivare, e un for: aggiunge il suo tempo in più. Scegli automazioni in cui qualche minuto non conta: le luci dopo che ti sei addormentato, sì; un allarme quando esci di casa, no.

Idee per la plancia

I sensori dell’orologio sono normali sensori di Home Assistant, quindi ogni scheda standard funziona con loro. Alcune disposizioni che si leggono bene:

  • Una scheda dell’orologio in cima alla plancia del telefono: una Tile card (scheda Riquadro) per battery, wear e sleep_state affiancati.
  • La batteria come indicatore: una Gauge card (scheda Indicatore) su battery con i colori di gravità, per esempio rosso sotto 20 e ambra sotto 40.
  • La frequenza cardiaca nel corso della giornata: una History graph card (scheda Grafico della cronologia) con heart_rate e resting_heart_rate sulle 24 ore.
  • I passi al giorno: una Statistics graph card (scheda Grafico statistico) su steps con il periodo giornaliero e la statistica “change”. Funziona perché i contatori giornalieri usano la classe di stato total_increasing.
  • La notte in una riga: una Entities card (scheda Entità) con sleep_score, sleep_duration e spo2.
  • Una stazione meteo al polso: sugli orologi con barometro, una History graph card di pressure su due o tre giorni mostra la tendenza che porta un cambio di tempo.

La durata del sonno arriva in minuti. Se preferisci le ore sulla plancia, aggiungi un sensore template: Impostazioni › Dispositivi e servizi › Aiutanti › Crea aiutante › Template, poi l’opzione per un sensore (Template a sensor nell’interfaccia inglese), con questo template di stato e h come unità:

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

Cosa non è

I sensori dell’orologio sono utili per le automazioni che possono aspettare qualche minuto. Non sostituiscono i sensori dedicati, e prima di farci affidamento vale la pena conoscere tre limiti.

Non è istantaneo. Gli aggiornamenti arrivano a ogni apertura dell’app e poi al tuo intervallo, da 1 a 6 minuti. Un cambiamento di stato sull’orologio può impiegare tanto ad arrivare a Home Assistant, e di più quando il telefono è fuori portata, l’app Zepp è chiusa o il risparmio energetico è attivo. Gli aggiornamenti in background dipendono anche dal permesso Attività in background.

Non è un sensore di presenza. Nessuno dei 18 sensori dice dove ti trovi. wear dice se l’orologio è al polso, non al polso di chi né in quale casa. Gli aggiornamenti richiedono il telefono vicino, ma questo non dice nulla sul fatto che tu sia a casa. Per la presenza usa il telefono, un’entità persona o un sensore di stanza.

Non sono dati medici. Frequenza cardiaca, ossigeno nel sangue, stress e temperatura corporea vengono dai sensori dell’orologio stesso. Vanno bene per le tendenze e per avvisi discreti, non per diagnosi o allarmi su cui scommetteresti la tua salute. L’ossigeno nel sangue in particolare è l’ultima misurazione presa dall’orologio, che può risalire a ore prima.

I tuoi dati restano tuoi. Le letture vanno dall’orologio al telefono via Bluetooth, e dal telefono al tuo Home Assistant. AmazHA non ha account, non ha analytics e non ha un proprio server, e i dati sulla salute non vengono mai inviati allo sviluppatore né a terzi. In Home Assistant vengono conservati come qualsiasi altro sensore, secondo le tue impostazioni di conservazione. Ogni sensore è disattivato finché non lo attivi, quindi invii esattamente ciò che scegli. L’informativa sulla privacy ha i dettagli.

Domande frequenti

Devo installare qualcosa in Home Assistant o in HACS?

No. L’orologio si registra tramite l’integrazione Mobile App di Home Assistant, che la configurazione predefinita carica già. Niente da installare da HACS, niente YAML da aggiungere: l’orologio compare in Impostazioni › Dispositivi e servizi › Mobile App dopo il primo invio.

Perché i sensori dell’orologio si aggiornano solo quando apro AmazHA?

Gli aggiornamenti in background richiedono il permesso Attività in background sull’orologio. Accetta la richiesta che l’orologio mostra alla prossima apertura, oppure consentilo a mano nelle impostazioni dell’orologio stesso (Permessi app, o Privacy, poi AmazHA). Disattivare e riattivare Invia a Home Assistant fa sì che l’orologio lo chieda di nuovo. Vedi il tutorial 9, passo 6.

Ogni quanto si aggiornano i sensori?

Ogni volta che apri AmazHA sull’orologio, e poi in background all’intervallo che imposti in Aggiorna ogni: da 1 a 6 minuti, 5 per impostazione predefinita. Mentre l’app è aperta continua a inviare allo stesso intervallo. Il telefono deve essere vicino con l’app Zepp in esecuzione, perché è il telefono a parlare con Home Assistant.

Quali sono gli entity id?

Ogni sensore è sensor.<prefix>_<key>, per esempio sensor.amazfit_gts_4_battery. Il prefisso è ciò che scrivi in Prefisso entità (opzionale); se lo lasci vuoto, è il nome del tuo orologio. La schermata Sensori orologio mostra l’id esatto sotto ogni sensore. Cambiare il prefisso in seguito crea un secondo dispositivo con nuovi id.

Posso usare l’orologio come sensore di presenza?

No. Nessuno dei 18 sensori dice dove ti trovi, e gli aggiornamenti arrivano al massimo ogni pochi minuti. Per la presenza usa il telefono o un’entità persona, e l’orologio per ciò in cui è bravo: sonno, stato al polso, attività e la sua batteria.

Funziona con la versione gratuita?

No. I sensori dell’orologio fanno parte della versione completa, come la connessione al tuo Home Assistant. La versione gratuita è una demo su dati di esempio. La versione completa è uno sblocco una tantum senza abbonamento.

Perché ossigeno nel sangue, stress o temperatura corporea non compaiono mai?

Ogni sensore viene inviato solo con una lettura valida. Ossigeno nel sangue, stress e temperatura corporea compaiono quando l’orologio li ha effettivamente misurati, la temperatura corporea solo sugli orologi con quel sensore, e pressione atmosferica e altitudine solo sugli orologi con barometro.

Dove finiscono i miei dati sulla salute?

Dall’orologio al telefono via Bluetooth, e dal telefono al tuo Home Assistant. Non vengono mai inviati allo sviluppatore né a terzi: AmazHA non ha account, non ha analytics e non ha un proprio server. Vedi l’informativa sulla privacy.

Guardalo in video

I brevi tutorial su cui si basa questo articolo: video in inglese, ogni passaggio scritto in italiano.

Tutti gli articoli