La risposta breve
Sì. AmazHA, un’app per Amazfit dedicata a Home Assistant, gira su 25 modelli Zepp OS e controlla dal polso luci, clima, tapparelle, serrature, media, scene e altro. Non esiste un’app ufficiale di Home Assistant per Zepp OS. L’orologio parla con il telefono via Bluetooth, il telefono parla con Home Assistant, e a casa basta il tuo indirizzo locale.
| In sintesi | |
|---|---|
| Orologi | 25 modelli Amazfit con Zepp OS, quadrati e rotondi |
| Tipi di dispositivo | 17, ognuno con la sua schermata di controllo |
| Connessione | Orologio ↔ telefono via Bluetooth, telefono ↔ Home Assistant via HTTP |
| Indirizzi | URL locale a casa, URL remoto facoltativo fuori casa |
| Token | Un token di accesso a lunga scadenza di un amministratore, conservato sul telefono |
| Aggiornamento | Ogni 8 secondi mentre l’app è aperta |
| Dispositivi sull’orologio | Fino a 100; con qualche decina resta veloce |
| Widget sul quadrante | Fino a quattro dispositivi |
| Dati dell’orologio in Home Assistant | 18 sensori facoltativi, tramite l’integrazione Mobile App |
| Modello di prezzo | Demo gratuita, poi uno sblocco una tantum, senza abbonamento |
Come un orologio Zepp OS parla con Home Assistant
L’orologio non parla mai direttamente con Home Assistant: lo fa il telefono. Un’app per orologi Zepp OS non può fare richieste web, quindi AmazHA è costruita in due metà. Una gira sull’orologio e disegna le schermate. L’altra gira sul telefono dentro l’app Zepp, ed è l’unica parte che comunica con il tuo server Home Assistant.
Orologio ↔ telefono via Bluetooth, telefono ↔ Home Assistant via HTTP
Quando apri una stanza sull’orologio, l’orologio chiede al telefono via Bluetooth. Il telefono chiama la REST API di Home Assistant con il tuo indirizzo e il tuo token, riduce la risposta a ciò che serve all’orologio e la rimanda indietro. Quando tocchi una luce, lo stesso percorso funziona al contrario: l’orologio lo dice al telefono, e il telefono chiama il servizio in Home Assistant.
Da questa architettura derivano due conseguenze:
- All’orologio arriva solo ciò che hai scelto. Il telefono carica i dispositivi che hai attivato nelle impostazioni e nient’altro, così il traffico Bluetooth resta ridotto.
- Le schermate dell’orologio non dipendono da dove arrivano i dati. La demo gratuita e la tua casa vera usano le stesse schermate; cambia solo la fonte.
Cosa non arriva mai all’orologio
L’indirizzo del tuo Home Assistant e il tuo token di accesso a lunga scadenza restano sul telefono. L’orologio riceve i nomi dei dispositivi, gli stati e i valori che mostra, e nient’altro. Il token viene inviato solo al tuo server Home Assistant, e una volta salvato le impostazioni sul telefono mostrano dei puntini al posto del token. AmazHA non ha account, non ha analytics e non ha un server dello sviluppatore che conservi qualcosa su di te o sulla tua casa.
Perché il telefono deve essere vicino, e perché l’orologio non ha bisogno del Wi-Fi
L’orologio raggiunge Home Assistant tramite il telefono, quindi il telefono deve essere nel raggio del Bluetooth, con il Bluetooth attivo e l’app Zepp in esecuzione in background. L’orologio in sé non ha bisogno né del Wi-Fi né dei dati mobili: il Bluetooth verso il telefono è il suo unico collegamento.
Il telefono, a sua volta, deve raggiungere il tuo server. A casa lo fa tramite la rete locale. Fuori casa serve un indirizzo remoto, e se non usi mai l’orologio fuori casa non ti serve mai.
Prima il locale, il remoto quando sei fuori
Puoi inserire due indirizzi: un URL locale (LAN), come http://192.168.1.50:8123 (un esempio), e un URL remoto per quando sei fuori. Entrambi i campi possono restare vuoti. Con tutti e due impostati, AmazHA preferisce quello locale e passa da sola a quello remoto quando il locale non risponde. Un solo token vale per entrambi. L’articolo sull’accesso da remoto mette a confronto Home Assistant Cloud, VPN e un tuo dominio.
Cosa puoi controllare dal polso
AmazHA gestisce 17 tipi di dispositivo di Home Assistant, e ognuno ha la sua schermata di controllo. La home mostra le tue aree, con i nomi che hanno in Home Assistant; una stanza mostra i suoi dispositivi raggruppati per tipo; un tocco su un riquadro apre i controlli completi. Luci, prese e ventole hanno anche un interruttore direttamente sul riquadro, e scene, script, automazioni e pulsanti partono dal loro.
| Tipo di dispositivo | Domini di Home Assistant | Cosa fa la schermata sull’orologio |
|---|---|---|
| Luce | light |
Cursore della luminosità; la corona la cambia a passi del 4%. Una luce che non si regola ha un semplice quadrante on/off |
| Presa | switch |
Un unico grande controllo on/off |
| Ventola | fan |
Cursore della velocità e pulsante di accensione; le ventole senza velocità hanno solo il controllo on/off |
| Clima | climate |
Temperatura desiderata su un quadrante, mezzo grado per scatto della corona; modalità Off, Caldo, Freddo e Auto |
| Tapparella | cover |
Apri, Ferma, Chiudi, più un cursore di posizione e la corona quando la tapparella supporta le posizioni |
| Serratura | lock |
Chiude con un tocco; per aprire chiede un secondo tocco di conferma |
| Allarme | alarm_control_panel |
Inserimento nelle modalità supportate dalla tua centrale (casa, fuori); per disinserire chiede il tuo codice su un tastierino |
| Media | media_player |
Riproduci, pausa, precedente e successivo, un cursore del volume (la corona regola il volume) e accensione, quando il lettore li supporta |
| Aspirapolvere | vacuum |
Avvia, metti in pausa, ferma e rimanda alla base |
| Scena | scene |
Parte con un tocco |
| Script | script |
Parte con un tocco |
| Automazione | automation |
Si avvia con un tocco |
| Pulsante | button, input_button |
Si preme con un tocco |
| Selettore | select, input_select |
L’elenco delle opzioni; tocca quella che vuoi scegliere |
| Sensore | sensor |
Il valore attuale a caratteri grandi; i sensori senza classe compaiono come testo (lo stato della cassetta della posta, il giorno della raccolta rifiuti) |
| Telecamera | camera |
Un’immagine fissa scaricata dal telefono, con Aggiorna e Live |
| Tracker | device_tracker, person |
Sola lettura: a casa, fuori o la zona, con ultimo aggiornamento e batteria quando Home Assistant li ha |
I sensori sono filtrati alle classi che hanno senso su un orologio: temperatura, umidità, potenza, energia, batteria, qualità dell’aria, illuminamento, pressione e simili. I sensori diagnostici, come l’intensità del segnale o la tensione, e i timestamp sono esclusi di proposito.
Le modifiche sono ottimistiche: il riquadro cambia nel momento in cui lo tocchi, la chiamata va a Home Assistant in background, e l’aggiornamento successivo corregge lo schermo se Home Assistant non è d’accordo.
Quali orologi funzionano
AmazHA gira su 25 modelli Amazfit con Zepp OS, con layout per schermi quadrati e rotondi. Sugli orologi rotondi i titoli sono centrati e gli elenchi usano tutto il vetro.
| Forma | Modelli |
|---|---|
| Quadrati | Active, Active 2, Bip 6, Bip Max, Cheetah Square, GTS 4 |
| Rotondi | Active 2, Active 2 Golf, Active 3 Premium, Active Max, Balance, Balance 2, Balance 2 XT, Balance 3, Balance 3 Ti, Balance Ultra, Cheetah 2 Pro, Cheetah 2 Ultra, Cheetah Pro, Cheetah Round, Falcon, GTR 4, T-Rex 3, T-Rex 3 Pro, T-Rex Ultra, T-Rex Ultra 2 |
Tre orologi sono esclusi per scelta. Active Edge e Bip 5 hanno schermi troppo piccoli per il layout, e il T-Rex 2 non ha abbastanza memoria. I modelli Zepp OS più vecchi, sotto l’API level 3.0, sono fuori dal perimetro. Per un sì o un no modello per modello, vedi quali orologi Amazfit funzionano con Home Assistant.
La verifica più rapida è lo store stesso: nell’app Zepp, apri l’App Store e cerca AmazHA. Se il tuo orologio è associato e supportato, puoi installarla e provare la demo.
Cosa ti serve prima di iniziare
Ti servono quattro cose: un server Home Assistant raggiungibile dal telefono, un token di accesso a lunga scadenza di un amministratore, l’app Zepp e il tuo orologio associato a essa.
| Requisito | Perché |
|---|---|
| Home Assistant raggiungibile dal telefono | Il telefono fa ogni richiesta. A casa basta l’indirizzo locale |
| Un token di accesso a lunga scadenza di un amministratore | AmazHA legge le tue aree tramite l’API dei template, che Home Assistant riserva agli amministratori |
| L’app Zepp su Android o iPhone | Le impostazioni di AmazHA e la sua metà sul telefono vivono lì dentro |
| Un orologio supportato, associato via Bluetooth | L’orologio raggiunge il telefono nello stesso modo in cui lo fa già l’app Zepp |
Per controllare i tuoi dispositivi non devi installare nulla in Home Assistant: AmazHA usa la REST API che ogni server Home Assistant ha. Il token si crea in Home Assistant nel tuo profilo, nella scheda Sicurezza; l’articolo sul token di accesso a lunga scadenza spiega i passaggi e perché il token di un utente normale non basta.
La configurazione in sei passi
L’intera configurazione richiede pochi minuti, e i primi due passi non costano nulla. Ogni passo ha un breve video tutorial.
1. Installa AmazHA
Nell’app Zepp sul telefono, apri l’App Store, tocca l’icona di ricerca e digita AmazHA. Apri AmazHA — Home Assistant Companion App e tocca Installa: arriva direttamente sull’orologio. Poi, sull’orologio, apri l’elenco delle app e tocca AmazHA. (Installa AmazHA)
2. Prova la demo
AmazHA si apre su una casa demo con stanze e dispositivi. Ogni schermata funziona con dati di esempio, senza limiti di tempo: apri una stanza, aziona una presa, ruota la corona su una luce. È il modo onesto per capire come si comporta l’app sul tuo orologio prima di pagare qualsiasi cosa. (Orientati sull’orologio)
3. Sbloccala una volta
Sull’orologio, tocca il banner arancione Demo · senza licenza in cima alla home. L’orologio mostra un codice di 5 cifre. Sul telefono, apri kzl.io/code nel browser, inserisci il codice, tocca Continue e completa il pagamento. L’orologio mostra Purchase Successful! e torna all’app da solo. Ne parliamo più sotto. (Sblocca la versione completa)
4. Collega Home Assistant
Nell’app Zepp, vai su Profilo › il tuo orologio › App › AmazHA › Impostazioni e tocca Home Assistant. Inserisci l’URL locale (LAN), e l’URL remoto se vuoi usare l’orologio fuori casa. Incolla il token in Token di accesso a lunga scadenza e tocca Connetti. Con un solo indirizzo il risultato indica Connesso; con entrambi, mostra LAN e Remoto separatamente. (Collega Home Assistant, dal passo 4)
5. Scegli i tuoi dispositivi
Nelle impostazioni di AmazHA, tocca Dispositivi. Le tue stanze sono lì, e ogni dispositivo parte nascosto: apri una stanza e attiva ciò che usi. Gli elenchi lunghi, come Altro, dove finiscono i dispositivi senza stanza, hanno un campo Cerca; Mostra tutti e Nascondi tutti agiscono solo sui dispositivi che corrispondono. Persone e telefoni hanno un’area tutta loro, Tracker. (Scegli i tuoi dispositivi)
6. Apri AmazHA sull’orologio
Le tue stanze e i tuoi dispositivi compaiono sull’orologio. Da qui in poi l’orologio parte subito con i tuoi ultimi dati e li aggiorna da Home Assistant mentre l’app è aperta.
Rendila tua
Tutto ciò che cambia l’aspetto dell’orologio si imposta nelle impostazioni sul telefono, e l’orologio lo riprende da lì.
I Preferiti e i Preferiti come home
In Dispositivi › Preferiti, attiva Mostra sull’orologio e scegli qualsiasi dispositivo da qualsiasi stanza, anche uno che non hai attivato nella sua stanza. Riordina preferiti ne imposta l’ordine. I Preferiti compaiono poi per primi nella home dell’orologio. Attiva Usa i Preferiti come home e la home dell’orologio diventa solo quell’elenco, e vengono caricati solo quei dispositivi. Le aree tornano quando disattivi l’opzione. (Preferiti ed energia, passo 4)
Il pannello energia
In Dispositivi › Energia, attiva Mostra pannello energia e scegli un sensore per ogni ruolo che hai, come Potenza rete (con segno), solare, batteria, e consumo e costo di oggi. Compaiono solo i sensori adatti al ruolo. La home dell’orologio riceve un’area Energia con la potenza della rete in questo momento, in prelievo o in immissione, poi solare, batteria e i totali di oggi. (Preferiti ed energia)
Chip della home, ordine e icone delle stanze
In Aspetto › Chip home, ognuno dei tre chip in cima alla home può contare luci, prese, tapparelle, clima, media, serrature, telecamere o tracker, oppure mostrare l’allarme, la tua energia o niente. Layout home imposta l’ordine delle aree, e un tocco sull’icona di una stanza ne sceglie un’altra. Dentro Dispositivi, una stanza con sensori di temperatura o umidità ti fa scegliere quale sensore alimenta i chip di quella stanza, così la lettura interna di un dispositivo non prevale sul sensore della stanza. (Rendila tua)
Nomi personalizzati
I nomi lunghi di Home Assistant raramente stanno in un riquadro dell’orologio. In Dispositivi, ogni dispositivo mostrato sull’orologio ha una matita dopo il nome: tocca il nome e scrivine uno nuovo in Nome sull’orologio, fino a 32 caratteri. L’orologio lo usa in ogni schermata e sul widget, mentre Home Assistant mantiene il proprio nome. Ripristina nome originale torna a quello. I nomi restano sul telefono e sopravvivono a Resetta cache. (Nomi personalizzati e widget)
Dimensione testo, dimensione card, vibrazione e timeout schermo
In Preferenze:
- Dimensione testo ingrandisce tutto il testo sull’orologio: 110%, 120% o 130%. Vale dalla prossima volta che apri AmazHA sull’orologio.
- Dimensione card ingrandisce le card delle aree nella home e i riquadri dei dispositivi: 115%, 130% o 145%.
- Vibra sulle azioni dà una breve vibrazione quando tocchi un dispositivo, avvii un’azione o ruoti la corona in una schermata di controllo. È disattivata per impostazione predefinita.
- Timeout schermo imposta per quanto lo schermo resta acceso mentre AmazHA è aperta: 30 secondi, 1 minuto, 5 minuti o Mai, il valore predefinito. “Mai” ignora anche l’abbassamento del polso: comodo, ma pesa di più sulla batteria.
La lingua dell’orologio segue la sua lingua di sistema; Lingua nelle impostazioni cambia solo la pagina delle impostazioni. (Preferenze)
Il widget sul quadrante
Il widget porta fino a quattro dei tuoi dispositivi nelle schede rapide dell’orologio, a un tocco di distanza senza aprire l’app. Fa parte della versione completa; nella versione gratuita propone invece lo sblocco.
Per configurarlo, apri Dispositivi › Widget sul quadrante nelle impostazioni sul telefono e tocca fino a quattro dispositivi, nell’ordine che vuoi: da sinistra a destra, dall’alto in basso. Poi, sull’orologio, scorri verso destra dal quadrante fino alle schede rapide, tocca Modifica e aggiungi AmazHA. Finché non apri l’app una volta, il widget dice Apri AmazHA; dopo, i tuoi dispositivi sono lì. (Nomi personalizzati e widget, passo 4)
Cosa fa un tocco sul widget dipende dal dispositivo:
| Dispositivo sul widget | Un tocco |
|---|---|
| Luce, presa, ventola | Lo accende o lo spegne; il widget mostra il nuovo stato |
| Scena, script, pulsante, automazione | Lo avvia |
| Tutto il resto (una serratura, una tapparella, un sensore, una telecamera) | Apre la sua schermata in AmazHA, dove una serratura ti chiede comunque di confermare |
Se un comando non va a buon fine, lo schermo dice perché, con Riprova e Apri AmazHA; Riprova non esegue mai un’azione due volte. L’intestazione del widget dice sempre quanto sono vecchi i suoi stati, per esempio AmazHA · 1 min fa. Diventa grigio mentre l’orologio è offline, o quando i suoi stati hanno 12 ore, e un tocco apre allora l’app, che lo aggiorna. Le modifiche che fai sul telefono arrivano al widget la prossima volta che apri AmazHA.
Una nota pratica: sugli orologi più recenti, un aggiornamento di AmazHA installato mentre il widget è sul quadrante lascia in funzione una parte della vecchia versione finché l’orologio non si riavvia. La home mostra allora Riavvia l’orologio finché non lo fai.
I dati del tuo orologio in Home Assistant
AmazHA funziona anche al contrario: può inviare 18 letture del tuo orologio a Home Assistant come entità sensore. Arrivano tramite l’integrazione Mobile App di Home Assistant, come un unico dispositivo con i suoi sensori, con nomi sensor.<prefix>_<key>.
Le letture coprono l’attività (passi, distanza, calorie, ore in piedi, minuti intensi, PAI), la salute (frequenza cardiaca, frequenza cardiaca a riposo, SpO2, stress, temperatura corporea, punteggio del sonno, durata del sonno, stato del sonno), l’ambiente (pressione atmosferica, altitudine) e il dispositivo (batteria dell’orologio, stato di indosso). Partono tutte disattivate, e attivi solo quelle che vuoi, in Sensori orologio › Invia a Home Assistant.
L’orologio invia i suoi dati ogni volta che apri AmazHA. Per gli aggiornamenti ad app chiusa, imposta Aggiorna ogni (da 1 a 6 minuti) e consenti Attività in background quando l’orologio lo chiede; per ogni aggiornamento il telefono deve essere vicino. In Home Assistant trovi l’orologio in Impostazioni › Dispositivi e servizi › Mobile App. L’articolo sui sensori dell’orologio ha la tabella completa ed esempi di automazione. (Sensori dell’orologio)
I limiti da conoscere
Un’app per orologio che passa dal telefono ha per natura alcuni limiti, ed è meglio conoscerli prima di comprarla.
| Limite | Cosa significa in pratica |
|---|---|
| Il telefono deve essere vicino | Senza collegamento Bluetooth con il telefono, nessun controllo. L’orologio mostra Offline · Il telefono non risponde |
| Gli stati si aggiornano mentre l’app è aperta | Ogni 8 secondi, quindi una modifica fatta altrove compare in pochi secondi. Ad app chiusa, non si aggiorna nulla |
| Nessuna notifica push da Home Assistant | È l’orologio a chiedere gli stati; Home Assistant non può inviare notifiche o aggiornamenti all’orologio tramite AmazHA |
| Al massimo 100 dispositivi | Con qualche decina resta veloce. La schermata Dispositivi consiglia al massimo 40 per area: su alcuni orologi un’area con 70 o più può esaurire la memoria e lasciare lo schermo nero |
| Fuori casa serve un indirizzo remoto | Solo se vuoi usarla fuori; l’indirizzo locale copre la casa |
| Aggiornamenti dei sensori in background | Richiedono il permesso Attività in background e il telefono nel raggio; altrimenti l’orologio invia i suoi dati quando apri l’app |
| Solo Zepp OS | È in sviluppo una versione per Wear OS, senza data |
Le prime due righe spiegano la maggior parte delle sorprese. Se lasci il telefono in un’altra stanza ed esci dal raggio del Bluetooth, l’orologio continua a mostrare i tuoi ultimi dati ma non può cambiare nulla. E se una luce cambia mentre AmazHA è chiusa, l’orologio mostra il nuovo stato la prossima volta che la apri.
Quando qualcosa non va
Quando qualcosa non funziona, l’orologio dice di cosa si tratta, e ogni messaggio ha una causa abituale. Questa tabella segue il tutorial sulla risoluzione dei problemi, che ha un passo per ogni messaggio.
| L’orologio dice | Causa | Soluzione |
|---|---|---|
| Nessun dispositivo selezionato | Ogni dispositivo parte nascosto | Attiva i dispositivi che vuoi in Dispositivi, nelle impostazioni di AmazHA (passo 1) |
| Offline · Il telefono non risponde | L’orologio non riesce a raggiungere il telefono | Tieni il telefono vicino, con il Bluetooth attivo e l’app Zepp in esecuzione (passo 2) |
| Offline · Home Assistant non raggiungibile | Il telefono non riesce a raggiungere Home Assistant | Apri il tuo indirizzo nel browser del telefono: deve funzionare da dove si trova il telefono, e fuori casa serve HTTPS con un certificato valido (passo 3) |
| Indirizzo sbagliato | L’indirizzo risponde, ma non è l’API di Home Assistant | Usa solo l’indirizzo del server, senza nulla dopo (niente /lovelace) (passo 4) |
| Serve un token admin | Il token appartiene a un utente senza diritti di amministratore | Crea un nuovo token a lunga scadenza come amministratore e incollalo (passo 5) |
| Controlla il token | Il token contiene un carattere che nessun token ha, di solito per una copia tagliata (…) | Copialo di nuovo, per intero, e incollalo (passo 6) |
| L’orologio è lento o si riavvia | Troppi dispositivi | Tieni la selezione piccola: con qualche decina resta veloce, 100 è il limite (passo 7) |
| Demo · senza licenza | L’app non è sbloccata | Tocca il banner e sbloccala (Sblocca la versione completa) |
| Modalità demo · Imposta il server HA nell’app sul telefono | Sbloccata, ma nessun server ancora impostato | Inserisci il tuo indirizzo e il token in Home Assistant nelle impostazioni (Collega Home Assistant) |
| Riavvia l’orologio | Un aggiornamento installato mentre il widget era sul quadrante | Riavvia l’orologio |
Sotto un banner Offline l’orologio aggiunge Riprovo ogni 8 s, così non devi fare nulla una volta sparita la causa, e sotto ancora una piccola riga di codice che dice al supporto esattamente cosa non ha funzionato. Una foto dell’orologio è la cosa più utile da inviare.
Se nulla nell’elenco corrisponde, apri Preferenze, tocca Resetta cache, poi Tocca di nuovo per confermare. Cancella i dati in cache sull’orologio e sul telefono e mantiene connessione, dispositivi e licenza; poi riapri AmazHA sull’orologio (passo 8). Se nemmeno questo aiuta, il modulo Supporto nelle impostazioni invia un rapporto con il tuo messaggio. Non include mai l’indirizzo del tuo Home Assistant, il tuo token o i nomi dei tuoi dispositivi.
Un esempio concreto: test verde, orologio vuoto
Una segnalazione tipica del primo giorno: Connetti diventa verde, ma l’orologio non mostra nulla. Due cause coprono quasi ogni caso. O non è ancora attivo nessun dispositivo, e l’orologio dice Nessun dispositivo selezionato, oppure il token appartiene a un utente che non è amministratore, e l’orologio dice Serve un token admin. Il secondo caso sorprende perché il test di connessione legge gli stati senza problemi; è la ricerca delle aree, tramite l’API dei template, che Home Assistant rifiuta a un utente normale. Un nuovo token creato con l’accesso da amministratore lo risolve.
Sbloccare la versione completa
Lo sblocco è un pagamento una tantum fatto dall’orologio, tramite KiezelPay: niente account, niente abbonamento, niente pubblicità. Collega AmazHA al tuo Home Assistant, in locale e da remoto, e attiva i sensori dell’orologio e il widget. Fino ad allora l’app è una demo su dati di esempio, e nulla raggiunge un server reale.
- Sull’orologio, tocca il banner arancione Demo · senza licenza. L’orologio mostra un codice di 5 cifre.
- Sul telefono, apri kzl.io/code nel browser.
- Digita il codice e tocca Continue.
- Paga una volta sola, con carta o PayPal. È una licenza a vita.
- L’orologio mostra Purchase Successful! e torna all’app da solo.
Il tutorial Sblocca la versione completa mostra ogni schermata, e la sezione prezzi della home page elenca cosa include ogni versione.