La resposta curta
Sí. AmazHA, una app de Home Assistant per a rellotges Amazfit, funciona en 25 models amb Zepp OS i controla llums, clima, persianes, panys, multimèdia, escenes i molt més des del canell. No hi ha cap app oficial de Home Assistant per a Zepp OS. El rellotge parla amb el mòbil per Bluetooth, el mòbil parla amb Home Assistant i, a casa, només li cal la teva adreça local.
| D’un cop d’ull | |
|---|---|
| Rellotges | 25 models Amazfit amb Zepp OS, quadrats i rodons |
| Tipus de dispositiu | 17, cadascun amb la seva pantalla de control |
| Connexió | Rellotge ↔ mòbil per Bluetooth, mòbil ↔ Home Assistant per HTTP |
| Adreces | URL local a casa, URL remot opcional fora |
| Token | Un token d’accés de llarga durada d’un administrador, guardat al mòbil |
| Actualització | Cada 8 segons mentre l’app és oberta |
| Dispositius al rellotge | Fins a 100; amb unes quantes desenes va ràpid |
| Widget a l’esfera | Fins a quatre dispositius |
| Dades del rellotge a Home Assistant | 18 sensors opcionals, a través de la integració Mobile App |
| Model de preu | Demo gratuïta i després un desbloqueig únic, sense subscripció |
Com parla un rellotge Zepp OS amb Home Assistant
El rellotge no parla mai directament amb Home Assistant: ho fa el mòbil. Una app de rellotge Zepp OS no pot fer peticions web, així que AmazHA està feta de dues meitats. Una funciona al rellotge i dibuixa les pantalles. L’altra funciona al mòbil, dins de l’app Zepp, i és l’única part que parla amb el teu servidor de Home Assistant.
Rellotge ↔ mòbil per Bluetooth, mòbil ↔ Home Assistant per HTTP
Quan obres una habitació al rellotge, el rellotge ho demana al mòbil per Bluetooth. El mòbil crida l’API REST de Home Assistant amb la teva adreça i el teu token, redueix la resposta al que necessita el rellotge i la hi torna. Quan toques un llum, el mateix camí funciona a la inversa: el rellotge avisa el mòbil, i el mòbil crida el servei a Home Assistant.
D’aquest disseny se’n deriven dues conseqüències:
- Només arriba al rellotge el que has triat. El mòbil carrega els dispositius que has activat a la configuració i res més, i així el trànsit Bluetooth es manté petit.
- La pantalla del rellotge no depèn d’on vénen les dades. La demo gratuïta i la teva llar real fan servir les mateixes pantalles; només canvia l’origen.
El que no arriba mai al rellotge
L’adreça del teu Home Assistant i el teu token d’accés de llarga durada es queden al mòbil. El rellotge rep els noms dels dispositius, els seus estats i els valors que mostra, i res més. El token només s’envia al teu servidor de Home Assistant, i un cop desat, la configuració del mòbil mostra punts en lloc del token. AmazHA no té comptes, ni analítiques, ni cap servidor del desenvolupador que guardi res sobre tu o sobre casa teva.
Per què el mòbil ha d’estar a prop i per què el rellotge no necessita wifi
El rellotge arriba a Home Assistant a través del mòbil, així que el mòbil ha d’estar dins l’abast del Bluetooth, amb el Bluetooth activat i l’app Zepp en marxa en segon pla. El rellotge en si no necessita wifi ni dades mòbils: el Bluetooth cap al mòbil és el seu únic enllaç.
El mòbil, al seu torn, ha d’arribar al teu servidor. A casa, això és la xarxa local. Fora de casa necessita una adreça remota, i si no fas servir mai el rellotge fora de casa, no en necessites cap.
Primer la local, la remota quan ets fora
Pots introduir dues adreces: un URL local (LAN), com ara http://192.168.1.50:8123 (un exemple), i un URL remot per quan ets fora. Qualsevol dels dos camps pot quedar buit. Amb tots dos configurats, AmazHA prefereix la local i passa tota sola a la remota quan la local no respon. Un sol token serveix per a totes dues. L’article sobre l’accés remot compara Home Assistant Cloud, les VPN i el teu propi domini.
Què pots controlar des del canell
AmazHA gestiona 17 tipus de dispositiu de Home Assistant, i cadascun té la seva pròpia pantalla de control. La pantalla d’inici mostra les teves àrees, amb els noms de Home Assistant; una habitació mostra els seus dispositius agrupats per tipus; un toc a una tessel·la obre els controls complets. Els llums, els interruptors i els ventiladors també tenen un interruptor a la mateixa tessel·la, i les escenes, els scripts, les automatitzacions i els botons s’executen des de la seva.
| Tipus de dispositiu | Dominis de Home Assistant | Què fa la pantalla del rellotge |
|---|---|---|
| Llum | light |
Control lliscant de brillantor; la corona la canvia en passos del 4%. Un llum que no es pot regular té un simple dial d’encès/apagat |
| Interruptor | switch |
Un gran control d’encès/apagat |
| Ventilador | fan |
Control lliscant de velocitat i botó d’encesa; els ventiladors sense velocitats només tenen el control d’encès/apagat |
| Clima | climate |
Temperatura objectiu en un dial, mig grau per cada pas de la corona; modes Apagat, Calor, Fred i Automàtic |
| Persiana | cover |
Obre, Atura, Tanca, i a més un control lliscant de posició i la corona quan la persiana admet posicions |
| Pany | lock |
Es tanca amb un toc; per obrir-lo cal un segon toc de confirmació |
| Alarma | alarm_control_panel |
S’arma en els modes que admet la teva central (a casa, fora); per desarmar-la et demana el codi en un teclat |
| Multimèdia | media_player |
Reprodueix, pausa, anterior i següent, un control lliscant de volum (la corona ajusta el volum) i encesa, quan el reproductor ho admet |
| Aspiradora | vacuum |
Engega, pausa, atura i torna a la base |
| Escena | scene |
S’executa amb un toc |
| Script | script |
S’executa amb un toc |
| Automatització | automation |
S’activa amb un toc |
| Botó | button, input_button |
Es prem amb un toc |
| Selector | select, input_select |
La llista d’opcions; toca’n una per triar-la |
| Sensor | sensor |
El valor actual en lletra gran; els sensors sense classe es mostren com a text (l’estat d’una bústia, el dia de recollida d’escombraries) |
| Càmera | camera |
Una imatge fixa que obté el mòbil, amb Actualitza i En directe |
| Localitzador | device_tracker, person |
Només de lectura: a casa, fora o la zona, amb l’última actualització i la bateria quan Home Assistant les té |
Els sensors es filtren per les classes que tenen sentit en un rellotge: temperatura, humitat, potència, energia, bateria, qualitat de l’aire, il·luminància, pressió i similars. Els sensors de diagnòstic, com la intensitat del senyal o el voltatge, i les marques de temps queden fora expressament.
Els canvis són optimistes: la tessel·la canvia en el moment que la toques, la crida va a Home Assistant en segon pla, i la següent actualització corregeix la pantalla si Home Assistant no hi està d’acord.
Quins rellotges funcionen
AmazHA funciona en 25 models Amazfit amb Zepp OS, amb disposicions per a pantalles quadrades i rodones. Als rellotges rodons, els títols van centrats i les llistes fan servir tot el vidre.
| Forma | Models |
|---|---|
| Quadrat | Active, Active 2, Bip 6, Bip Max, Cheetah Square, GTS 4 |
| Rodó | 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 |
Tres rellotges queden fora per disseny. L’Active Edge i el Bip 5 tenen pantalles massa petites per a la disposició, i el T-Rex 2 no té prou memòria. Els models Zepp OS més antics, per sota del nivell d’API 3.0, queden fora de l’abast. Per a un sí o un no model per model, mira quins rellotges Amazfit funcionen amb Home Assistant.
La comprovació més ràpida és la mateixa botiga: a l’app Zepp, obre l’App Store i cerca AmazHA. Si el teu rellotge està vinculat i és compatible, la pots instal·lar i provar la demo.
Què necessites abans de començar
Necessites quatre coses: un servidor de Home Assistant al qual el mòbil pugui arribar, un token d’accés de llarga durada d’un administrador, l’app Zepp i el rellotge vinculat amb ella.
| Requisit | Per què |
|---|---|
| Home Assistant accessible des del mòbil | El mòbil fa totes les peticions. A casa n’hi ha prou amb l’adreça local |
| Un token d’accés de llarga durada d’un administrador | AmazHA llegeix les teves àrees a través de l’API de plantilles, que Home Assistant reserva als administradors |
| L’app Zepp a Android o iPhone | La configuració d’AmazHA i la seva meitat del mòbil hi viuen a dins |
| Un rellotge compatible, vinculat per Bluetooth | El rellotge arriba al mòbil de la mateixa manera que ja ho fa l’app Zepp |
No cal instal·lar res a Home Assistant per controlar els teus dispositius: AmazHA fa servir l’API REST que té qualsevol servidor de Home Assistant. El token es crea a Home Assistant, al teu perfil, a la pestanya Seguretat; l’article sobre el token d’accés de llarga durada n’explica els passos i per què el token d’un usuari normal no n’hi ha prou.
Configuració en sis passos
Tota la configuració porta uns minuts, i els dos primers passos no costen res. Cada pas té un breu tutorial en vídeo.
1. Instal·la AmazHA
A l’app Zepp del mòbil, obre l’App Store, toca la icona de cerca i escriu AmazHA. Obre AmazHA — Home Assistant Companion App i toca Instal·la: va directament al rellotge. Després, al rellotge, obre la llista d’apps i toca AmazHA. (Instal·la AmazHA)
2. Prova la demo
AmazHA s’obre amb una casa de demo, amb habitacions i dispositius. Totes les pantalles funcionen amb dades d’exemple, sense límit de temps: obre una habitació, acciona un interruptor, gira la corona en un llum. És la manera honesta de veure com va l’app al teu propi rellotge abans de pagar res. (Mou-te pel rellotge)
3. Desbloqueja-la un sol cop
Al rellotge, toca el bàner taronja Mode demo · sense llicència, a dalt de la pantalla d’inici. El rellotge mostra un codi de 5 dígits. Al mòbil, obre kzl.io/code al navegador, introdueix el codi, toca Continue i completa el pagament. El rellotge mostra Purchase Successful! i torna sol a l’app. Més detalls a continuació. (Desbloqueja la versió completa)
4. Connecta Home Assistant
A l’app Zepp, ves a Perfil › el teu rellotge › Aplicacions › AmazHA › Configuració i toca Home Assistant. Introdueix l’URL local (LAN) i, si vols el rellotge fora de casa, l’URL remot. Enganxa el token a Token d’accés de llarga durada i toca Connecta. Amb una adreça, el resultat diu Connectat; amb totes dues, mostra LAN i Remot per separat. (Connecta Home Assistant, a partir del pas 4)
5. Tria els teus dispositius
A la configuració d’AmazHA, toca Dispositius. Hi ha les teves habitacions, i tots els dispositius comencen ocults: obre una habitació i activa el que fas servir. Les llistes llargues, com ara Altres, on van a parar els dispositius sense habitació, tenen un quadre de Cerca; Mostra-ho tot i Amaga-ho tot només afecten els dispositius que coincideixen. Les persones i els mòbils tenen la seva pròpia àrea, Localitzadors. (Tria els teus dispositius)
6. Obre AmazHA al rellotge
Les teves habitacions i els teus dispositius apareixen al rellotge. A partir d’ara, el rellotge arrenca amb les teves últimes dades a l’instant i les actualitza des de Home Assistant mentre l’app és oberta.
Fes-la teva
Tot el que canvia com es veu el rellotge es configura a la configuració del mòbil, i el rellotge ho agafa d’allà.
Preferits i Preferits com a pantalla d’inici
A Dispositius › Preferits, activa Mostra al rellotge i tria qualsevol dispositiu de qualsevol habitació, fins i tot un que no hagis activat a la seva habitació. Reordena els preferits en defineix l’ordre. Llavors els Preferits apareixen en primer lloc a la pantalla d’inici del rellotge. Activa Usa els Preferits com a pantalla d’inici i l’inici del rellotge passa a ser només aquesta llista, i només es carreguen aquests dispositius. Les àrees tornen quan ho desactivis. (Preferits i energia, pas 4)
El tauler d’energia
A Dispositius › Energia, activa Mostra el tauler d’energia i tria un sensor per a cada rol que tinguis, com ara Potència de xarxa (amb signe), la solar, la bateria, i el consum i el cost d’avui. Només surten els sensors que encaixen amb el rol. La pantalla d’inici del rellotge guanya una àrea Energia amb la potència de la xarxa en aquest moment, si importes o exportes, i després la solar, la bateria i els totals d’avui. (Preferits i energia)
Xips d’inici, ordre de les habitacions i icones
A Aparença › Xips d’inici, cadascun dels tres xips de dalt de la pantalla d’inici pot comptar llums, interruptors, persianes, clima, multimèdia, panys, càmeres o localitzadors, o bé mostrar l’alarma, la teva energia o res. Disposició de l’inici defineix l’ordre de les àrees, i un toc a la icona d’una habitació en tria una altra. A Dispositius, una habitació amb sensors de temperatura o d’humitat et deixa triar quin sensor alimenta els xips d’aquella habitació, perquè la lectura interna d’un dispositiu no s’imposi al sensor de l’habitació. (Fes-la teva)
Noms personalitzats
Els noms llargs de Home Assistant rarament caben en una tessel·la de rellotge. A Dispositius, cada dispositiu que mostra el rellotge té un llapis després del nom: toca el nom i escriu-ne un de nou a Nom al rellotge, fins a 32 caràcters. El rellotge el fa servir a totes les pantalles i al widget, mentre que Home Assistant manté el seu nom. Restaura el nom original hi torna. Els noms es guarden al mòbil i es mantenen després de Restableix la cau. (Noms personalitzats i el widget)
Mida del text, mida de les targetes, vibració i temps d’espera de la pantalla
A Preferències:
- Mida de la lletra fa més gran tot el text del rellotge: 110%, 120% o 130%. S’aplica a partir de la propera vegada que obris AmazHA al rellotge.
- Mida de les targetes amplia les targetes d’àrea de la pantalla d’inici i les tessel·les dels dispositius: 115%, 130% o 145%.
- Vibra amb les accions fa una vibració curta quan toques un dispositiu, executes una acció o gires la corona en una pantalla de control. Per defecte està desactivada.
- Temps d’espera de la pantalla defineix quant de temps queda encesa la pantalla mentre AmazHA és oberta: 30 segons, 1 minut, 5 minuts o Mai, l’opció per defecte. «Mai» també ignora quan abaixes el canell: és pràctic, però consumeix més bateria.
L’idioma del rellotge segueix el seu propi idioma del sistema; Idioma, a la configuració, només canvia la pàgina de configuració. (Preferències)
El widget a l’esfera
El widget posa fins a quatre dels teus dispositius a les targetes d’accés directe del rellotge, a un toc, sense obrir l’app. Forma part de la versió completa; a la versió gratuïta, ofereix el desbloqueig.
Per configurar-lo, obre Dispositius › Widget al rellotge a la configuració del mòbil i toca fins a quatre dispositius, en l’ordre que vulguis: d’esquerra a dreta, de dalt a baix. Després, al rellotge, llisca cap a la dreta des de l’esfera fins a les targetes d’accés directe, toca Edita i afegeix AmazHA. Fins que no obris l’app una vegada, el widget diu Obre AmazHA; després, els teus dispositius ja hi són. (Noms personalitzats i el widget, pas 4)
El que fa un toc al widget depèn del dispositiu:
| Dispositiu al widget | Un toc |
|---|---|
| Llum, interruptor, ventilador | L’encén o l’apaga; el widget mostra l’estat nou |
| Escena, script, botó, automatització | L’executa |
| Qualsevol altre (un pany, una persiana, un sensor, una càmera) | Obre la seva pròpia pantalla a AmazHA, on un pany encara et demana que ho confirmis |
Si una ordre no arriba, la pantalla diu per què, amb Reintenta i Obre AmazHA; Reintenta no executa mai una acció dues vegades. La capçalera del widget sempre diu quina antiguitat tenen els estats, per exemple AmazHA · fa 1 min. Es torna gris mentre el rellotge està fora de línia, o quan els estats tenen 12 hores, i aleshores un toc obre l’app, que els posa al dia. Els canvis que facis al mòbil arriben al widget la propera vegada que obris AmazHA.
Una nota pràctica: als rellotges més nous, una actualització d’AmazHA instal·lada mentre el widget és a l’esfera manté en marxa una part de la versió antiga fins que el rellotge es reinicia. Mentrestant, la pantalla d’inici mostra Reinicia el rellotge.
Les dades del teu rellotge a Home Assistant
AmazHA també funciona a la inversa: pot enviar 18 lectures del teu rellotge a Home Assistant com a entitats de sensor. Arriben a través de la integració Mobile App de Home Assistant, com un dispositiu amb els seus sensors, amb el nom sensor.<prefix>_<key>.
Les lectures cobreixen l’activitat (passos, distància, calories, hores dret, minuts intensos, PAI), la salut (freqüència cardíaca, freqüència cardíaca en repòs, SpO2, estrès, temperatura corporal, puntuació del son, durada del son, estat del son), l’entorn (pressió atmosfèrica, altitud) i el dispositiu (bateria del rellotge, estat de portar-lo). Totes comencen desactivades, i només actives les que vulguis, a Sensors del rellotge › Envia a Home Assistant.
El rellotge envia les seves dades cada cop que obres AmazHA. Per tenir actualitzacions amb l’app tancada, configura Actualitza cada (d’1 a 6 minuts) i permet l’Activitat en segon pla quan el rellotge t’ho demani; el mòbil ha d’estar a prop per a cada actualització. A Home Assistant trobaràs el rellotge a Configuració › Dispositius i serveis › Mobile App. L’article sobre els sensors del rellotge té la taula completa i exemples d’automatitzacions. (Sensors del rellotge)
Límits que val la pena conèixer
Una app de rellotge que passa pel mòbil té alguns límits per disseny, i és millor conèixer-los abans de comprar.
| Límit | Què vol dir a la pràctica |
|---|---|
| El mòbil ha d’estar a prop | Sense enllaç Bluetooth amb el mòbil, no hi ha control. El rellotge mostra Sense connexió · El telèfon no respon |
| Els estats s’actualitzen mentre l’app és oberta | Cada 8 segons, així que un canvi fet en un altre lloc apareix en pocs segons. Amb l’app tancada, no s’actualitza res |
| Home Assistant no envia res per iniciativa pròpia | El rellotge demana els estats; Home Assistant no pot enviar notificacions ni actualitzacions al rellotge a través d’AmazHA |
| Com a màxim, 100 dispositius | Amb unes quantes desenes va ràpid. La pantalla Dispositius recomana 40 o menys per àrea: en alguns rellotges, una àrea amb 70 o més es pot quedar sense memòria i deixar la pantalla en negre |
| Fora de casa cal una adreça remota | Només si la vols fer servir a fora; l’adreça local cobreix casa teva |
| Actualitzacions dels sensors en segon pla | Necessiten el permís d’Activitat en segon pla i el mòbil a l’abast; si no, el rellotge envia les seves dades quan obres l’app |
| Només Zepp OS | Hi ha una versió per a Wear OS en desenvolupament, sense data |
Les dues primeres files expliquen la majoria de sorpreses. Si deixes el mòbil en una altra habitació i surts de l’abast del Bluetooth, el rellotge continua mostrant les teves últimes dades, però no pot canviar res. I si un llum canvia mentre AmazHA és tancada, el rellotge mostra l’estat nou la propera vegada que l’obris.
Quan alguna cosa falla
Quan alguna cosa no funciona, el rellotge diu què passa, i cada missatge té una causa habitual. Aquesta taula segueix el tutorial de resolució de problemes, que té un pas per a cada missatge.
| El rellotge diu | Causa | Solució |
|---|---|---|
| Cap dispositiu seleccionat | Tots els dispositius comencen ocults | Activa els dispositius que vulguis a Dispositius, a la configuració d’AmazHA (pas 1) |
| Sense connexió · El telèfon no respon | El rellotge no pot arribar al mòbil | Tingues el mòbil a prop, amb el Bluetooth activat i l’app Zepp en marxa (pas 2) |
| Sense connexió · Home Assistant no accessible | El mòbil no pot arribar a Home Assistant | Obre la teva adreça al navegador del mòbil: ha de funcionar des d’on es troba el mòbil i, fora de casa, necessita HTTPS amb un certificat vàlid (pas 3) |
| Adreça incorrecta | L’adreça respon, però no és l’API de Home Assistant | Fes servir només l’adreça del servidor, sense res al darrere (sense /lovelace) (pas 4) |
| Cal un token admin | El token és d’un usuari sense permisos d’administrador | Crea un token de llarga durada nou com a administrador i enganxa’l (pas 5) |
| Revisa el token | El token té un caràcter que cap token no té, normalment per una còpia tallada (…) | Torna’l a copiar, sencer, i enganxa’l (pas 6) |
| El rellotge va lent o es reinicia | Massa dispositius | Mantén la selecció petita: amb unes quantes desenes va ràpid, i el límit és 100 (pas 7) |
| Mode demo · sense llicència | L’app no està desbloquejada | Toca el bàner i desbloqueja-la (Desbloqueja la versió completa) |
| Mode demo · Configura el servidor HA a l’app del mòbil | Desbloquejada, però encara sense servidor | Introdueix la teva adreça i el token a Home Assistant, a la configuració (Connecta Home Assistant) |
| Reinicia el rellotge | Una actualització instal·lada mentre el widget era a l’esfera | Reinicia el rellotge |
Sota un bàner Sense connexió, el rellotge hi afegeix Reintent cada 8 s, així que no has de fer res quan la causa desapareix, i una petita línia de codi a sota que indica al suport exactament què ha fallat. Una foto del rellotge és el més útil que pots enviar.
Si res de la llista no encaixa, obre Preferències, toca Restableix la cau i després Torna a tocar per confirmar. S’esborren les dades en memòria cau del rellotge i del mòbil, i es conserven la connexió, els dispositius i la llicència; després torna a obrir AmazHA al rellotge (pas 8). Si això tampoc no ajuda, el formulari de Suport de la configuració envia un informe amb el teu missatge. No inclou mai la teva adreça de Home Assistant, el teu token ni els noms dels teus dispositius.
Un exemple pràctic: prova en verd, rellotge buit
Un cas habitual el primer dia: Connecta es posa en verd, però el rellotge no mostra res. Dues causes cobreixen gairebé tots els casos. O encara no hi ha cap dispositiu activat, i el rellotge diu Cap dispositiu seleccionat, o el token és d’un usuari que no és administrador, i el rellotge diu Cal un token admin. La segona sorprèn perquè la prova de connexió llegeix els estats sense problemes; és la consulta de les àrees, a través de l’API de plantilles, el que Home Assistant nega a un usuari normal. Un token nou creat amb la sessió iniciada com a administrador ho soluciona.
Desbloquejar la versió completa
El desbloqueig és un pagament únic que es fa des del rellotge, a través de KiezelPay: sense compte, sense subscripció, sense anuncis. Connecta AmazHA al teu propi Home Assistant, en local i en remot, i activa els sensors del rellotge i el widget. Fins aleshores, l’app és una demo amb dades d’exemple, i no arriba res a cap servidor real.
- Al rellotge, toca el bàner taronja Mode demo · sense llicència. El rellotge mostra un codi de 5 dígits.
- Al mòbil, obre kzl.io/code al navegador.
- Escriu el codi i toca Continue.
- Paga un sol cop, amb targeta o PayPal. És una llicència de per vida.
- El rellotge mostra Purchase Successful! i torna sol a l’app.
El tutorial Desbloqueja la versió completa mostra cada pantalla, i la secció de preus de la pàgina d’inici indica què inclou cada versió.