La respuesta corta
Sí. AmazHA, una app de Home Assistant para relojes Amazfit, funciona en 25 modelos con Zepp OS y controla desde la muñeca luces, clima, persianas, cerraduras, multimedia, escenas y mucho más. No existe una app oficial de Home Assistant para Zepp OS. El reloj habla con tu móvil por Bluetooth, el móvil habla con Home Assistant y, en casa, basta con tu dirección local.
| De un vistazo | |
|---|---|
| Relojes | 25 modelos Amazfit con Zepp OS, cuadrados y redondos |
| Tipos de dispositivo | 17, cada uno con su propia pantalla de control |
| Conexión | Reloj ↔ móvil por Bluetooth, móvil ↔ Home Assistant por HTTP |
| Direcciones | URL local en casa, URL remota opcional fuera |
| Token | Un token de acceso de larga duración de un administrador, guardado en el móvil |
| Actualización | Cada 8 segundos mientras la app está abierta |
| Dispositivos en el reloj | Hasta 100; con unas pocas decenas va rápido |
| Widget en la esfera | Hasta cuatro dispositivos |
| Datos del reloj en Home Assistant | 18 sensores opcionales, a través de la integración Mobile App |
| Modelo de precio | Demo gratuita y después un desbloqueo único, sin suscripción |
Cómo habla un reloj Zepp OS con Home Assistant
El reloj nunca habla directamente con Home Assistant: lo hace tu móvil. Una app de reloj de Zepp OS no puede hacer peticiones web, así que AmazHA está construida en dos mitades. Una funciona en el reloj y dibuja las pantallas. La otra funciona en tu móvil, dentro de la app Zepp, y es la única parte que se comunica con tu servidor de Home Assistant.
Reloj ↔ móvil por Bluetooth, móvil ↔ Home Assistant por HTTP
Cuando abres una habitación en el reloj, el reloj se lo pide al móvil por Bluetooth. El móvil llama a la API REST de Home Assistant con tu dirección y tu token, reduce la respuesta a lo que el reloj necesita y se la devuelve. Cuando tocas una luz, el mismo camino se recorre al revés: el reloj se lo dice al móvil y el móvil llama al servicio en Home Assistant.
De este diseño se derivan dos consecuencias:
- Al reloj solo llega lo que has elegido. El móvil carga los dispositivos que has activado en los ajustes y nada más, lo que mantiene pequeño el tráfico Bluetooth.
- La pantalla del reloj no depende de dónde vienen los datos. La demo gratuita y tu casa real usan las mismas pantallas; solo cambia la fuente.
Lo que nunca llega al reloj
Tu dirección de Home Assistant y tu token de acceso de larga duración se quedan en el móvil. El reloj recibe los nombres de los dispositivos, sus estados y los valores que muestra, y nada más. El token solo se envía a tu servidor de Home Assistant y, una vez guardado, los ajustes del móvil muestran puntos en lugar del token. AmazHA no tiene cuentas, ni analíticas, ni ningún servidor del desarrollador que guarde nada sobre ti o tu casa.
Por qué el móvil tiene que estar cerca y por qué el reloj no necesita wifi
El reloj llega a Home Assistant a través del móvil, así que el móvil tiene que estar al alcance del Bluetooth, con el Bluetooth activado y la app Zepp en marcha en segundo plano. El reloj en sí no necesita wifi ni datos móviles: el Bluetooth hacia el móvil es su único enlace.
El móvil, a su vez, tiene que llegar a tu servidor. En casa, eso es tu red local. Fuera de casa necesita una dirección remota, y si nunca usas el reloj fuera de casa, nunca la necesitarás.
Primero la local, la remota cuando estás fuera
Puedes introducir dos direcciones: una URL local (LAN), como http://192.168.1.50:8123 (un ejemplo), y una URL remota para cuando estás fuera. Cualquiera de los dos campos puede quedarse vacío. Con los dos configurados, AmazHA prefiere la local y pasa sola a la remota cuando la local no responde. Un solo token sirve para las dos. El artículo sobre el acceso remoto compara Home Assistant Cloud, las VPN y tu propio dominio.
Lo que puedes controlar desde la muñeca
AmazHA gestiona 17 tipos de dispositivo de Home Assistant, y cada uno tiene su propia pantalla de control. El inicio muestra tus áreas, con los nombres de Home Assistant; una habitación muestra sus dispositivos agrupados por tipo; un toque en un mosaico abre todos los controles. Las luces, los interruptores y los ventiladores tienen además un interruptor en el propio mosaico, y las escenas, los scripts, las automatizaciones y los botones se ejecutan desde el suyo.
| Tipo de dispositivo | Dominios de Home Assistant | Qué hace la pantalla del reloj |
|---|---|---|
| Luz | light |
Control deslizante de brillo; la corona lo cambia en pasos del 4%. Una luz que no se puede regular tiene un dial simple de encendido y apagado |
| Interruptor | switch |
Un único control grande de encendido y apagado |
| Ventilador | fan |
Control deslizante de velocidad y botón de encendido; los ventiladores sin velocidades tienen solo el control de encendido y apagado |
| Clima | climate |
Temperatura objetivo en un dial, medio grado por paso de corona; modos Apagado, Calor, Frío y Auto |
| Persiana | cover |
Abrir, Parar, Cerrar, además de un control deslizante de posición y la corona cuando la persiana admite posiciones |
| Cerradura | lock |
Cierra con un toque; para abrirla pide un segundo toque de confirmación |
| Alarma | alarm_control_panel |
Arma en los modos que admite tu central (casa, fuera); para desarmar pide tu código en un teclado |
| Multimedia | media_player |
Reproducir, pausar, anterior y siguiente, un control deslizante de volumen (la corona ajusta el volumen) y encendido, cuando el reproductor los admite |
| Aspiradora | vacuum |
Iniciar, pausar, parar y mandarla de vuelta a su base |
| Escena | scene |
Se ejecuta con un toque |
| Script | script |
Se ejecuta con un toque |
| Automatización | automation |
Se ejecuta con un toque |
| Botón | button, input_button |
Se pulsa con un toque |
| Selector | select, input_select |
La lista de opciones; toca una para elegirla |
| Sensor | sensor |
El valor actual en letra grande; los sensores sin clase se muestran como texto (el estado de un buzón, el día de la basura) |
| Cámara | camera |
Una imagen fija que obtiene el móvil, con Actualizar y En vivo |
| Localizador | device_tracker, person |
Solo lectura: en casa, fuera o la zona, con la última actualización y la batería cuando Home Assistant las tiene |
Los sensores se filtran a las clases que tienen sentido en un reloj: temperatura, humedad, potencia, energía, batería, calidad del aire, iluminancia, presión y similares. Los sensores de diagnóstico, como la intensidad de la señal o el voltaje, y las marcas de tiempo se dejan fuera a propósito.
Los cambios son optimistas: el mosaico cambia en cuanto lo tocas, la llamada va a Home Assistant en segundo plano y la siguiente actualización corrige la pantalla si Home Assistant no está de acuerdo.
Qué relojes funcionan
AmazHA funciona en 25 modelos Amazfit con Zepp OS, con diseños para pantallas cuadradas y redondas. En los relojes redondos los títulos van centrados y las listas aprovechan todo el cristal.
| Forma | Modelos |
|---|---|
| Cuadrada | Active, Active 2, Bip 6, Bip Max, Cheetah Square, GTS 4 |
| Redonda | 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 relojes se quedan fuera a propósito. El Active Edge y el Bip 5 tienen pantallas demasiado pequeñas para el diseño, y el T-Rex 2 no tiene memoria suficiente. Los modelos Zepp OS más antiguos, por debajo del nivel de API 3.0, quedan fuera del alcance. Para un sí o un no por modelo, consulta qué relojes Amazfit funcionan con Home Assistant.
La comprobación más rápida es la propia tienda: en la app Zepp, abre la App Store y busca AmazHA. Si tu reloj está vinculado y es compatible, puedes instalarla y probar la demo.
Lo que necesitas antes de empezar
Necesitas cuatro cosas: un servidor de Home Assistant al que llegue tu móvil, un token de acceso de larga duración de un administrador, la app Zepp y tu reloj vinculado con ella.
| Requisito | Por qué |
|---|---|
| Home Assistant accesible desde el móvil | El móvil hace todas las peticiones. En casa basta con la dirección local |
| Un token de acceso de larga duración de un administrador | AmazHA lee tus áreas a través de la API de plantillas, que Home Assistant reserva a los administradores |
| La app Zepp en Android o iPhone | Los ajustes de AmazHA y su mitad del móvil viven dentro de ella |
| Un reloj compatible, vinculado por Bluetooth | El reloj llega al móvil del mismo modo que ya lo hace la app Zepp |
No hay que instalar nada en Home Assistant para controlar tus dispositivos: AmazHA usa la API REST que tiene cualquier servidor de Home Assistant. El token se crea en Home Assistant, en tu perfil, en la pestaña Seguridad; el artículo sobre el token de acceso de larga duración explica los pasos y por qué no basta con el token de un usuario normal.
Configuración en seis pasos
Toda la configuración lleva unos minutos, y los dos primeros pasos no cuestan nada. Cada paso tiene un breve tutorial en vídeo.
1. Instala AmazHA
En la app Zepp de tu móvil, abre la App Store, toca el icono de búsqueda y escribe AmazHA. Abre AmazHA — Home Assistant Companion App y toca Instalar: se instala directamente en tu reloj. Después, en el reloj, abre la lista de apps y toca AmazHA. (Instala AmazHA)
2. Prueba la demo
AmazHA se abre en una casa demo con habitaciones y dispositivos. Todas las pantallas funcionan con datos de ejemplo, sin límite de tiempo: abre una habitación, acciona un interruptor, gira la corona sobre una luz. Es la forma honesta de ver cómo se siente la app en tu propio reloj antes de pagar nada. (Muévete por el reloj)
3. Desbloquéala una sola vez
En el reloj, toca el banner naranja Modo demo · sin licencia de la parte superior del inicio. El reloj muestra un código de 5 dígitos. En tu móvil, abre kzl.io/code en el navegador, introduce el código, toca Continue y completa el pago. El reloj muestra Purchase Successful! y vuelve solo a la app. Más detalles abajo. (Desbloquea la versión completa)
4. Conecta Home Assistant
En la app Zepp, ve a Perfil › tu reloj › Apps › AmazHA › Ajustes y toca Home Assistant. Introduce la URL local (LAN) y, si quieres usar el reloj fuera de casa, la URL remota. Pega el token en Token de acceso de larga duración y toca Conectar. Con una sola dirección, el resultado indica Conectado; con las dos, muestra LAN y Remota por separado. (Conecta Home Assistant, a partir del paso 4)
5. Elige tus dispositivos
En los ajustes de AmazHA, toca Dispositivos. Tus habitaciones están ahí, y todos los dispositivos empiezan ocultos: abre una habitación y activa lo que uses. Las listas largas, como Otros, donde van los dispositivos sin habitación, tienen un cuadro Buscar; Mostrar todo y Ocultar todo actúan solo sobre los dispositivos que coinciden. Las personas y los móviles tienen su propia área, Localizadores. (Elige tus dispositivos)
6. Abre AmazHA en el reloj
Tus habitaciones y dispositivos aparecen en el reloj. A partir de ahora, el reloj arranca al momento con tus últimos datos y los actualiza desde Home Assistant mientras la app está abierta.
Hazlo tuyo
Todo lo que cambia el aspecto del reloj se configura en los ajustes del móvil, y el reloj lo toma de ahí.
Favoritos y Favoritos como inicio
En Dispositivos › Favoritos, activa Mostrar en el reloj y elige cualquier dispositivo de cualquier habitación, incluso uno que no hayas activado en su habitación. Reordenar favoritos fija su orden. Favoritos aparece entonces el primero en el inicio del reloj. Activa Usar Favoritos como pantalla de inicio y el inicio del reloj pasa a ser solo esa lista, y solo se cargan esos dispositivos. Las áreas vuelven cuando lo desactivas. (Favoritos y energía, paso 4)
El panel de energía
En Dispositivos › Energía, activa Mostrar panel de energía y elige un sensor para cada función que tengas, como Potencia de red (con signo), la solar, la batería y el consumo y el coste de hoy. Solo aparecen los sensores que encajan con la función. El inicio del reloj gana un área Energía con la potencia de red en este momento, importando o exportando, y después la solar, la batería y los totales de hoy. (Favoritos y energía)
Chips de inicio, orden e iconos de las habitaciones
En Apariencia › Chips de inicio, cada uno de los tres chips de la parte superior del inicio puede contar luces, interruptores, persianas, clima, multimedia, cerraduras, cámaras o localizadores, o mostrar la alarma, tu energía o nada. Diseño de Inicio fija el orden de las áreas, y un toque en el icono de una habitación permite elegir otro. Dentro de Dispositivos, una habitación con sensores de temperatura o humedad te deja elegir qué sensor alimenta los chips de esa habitación, para que la lectura interna de un dispositivo no se imponga al sensor de la habitación. (Hazlo tuyo)
Nombres propios
Los nombres largos de Home Assistant rara vez caben en un mosaico del reloj. En Dispositivos, cada dispositivo que muestra el reloj tiene un lápiz tras su nombre: toca el nombre y escribe uno nuevo en Nombre en el reloj, hasta 32 caracteres. El reloj lo usa en todas las pantallas y en el widget, mientras que Home Assistant conserva su propio nombre. Restaurar nombre original vuelve a él. Los nombres se guardan en el móvil y se mantienen tras Restablecer caché. (Nombres propios y el widget)
Tamaño del texto, de las tarjetas, vibración y tiempo de pantalla
En Preferencias:
- Tamaño del texto agranda todo el texto del reloj: 110%, 120% o 130%. Se aplica a partir de la próxima vez que abras AmazHA en el reloj.
- Tamaño de tarjetas agranda las tarjetas de área del inicio y los mosaicos de dispositivos: 115%, 130% o 145%.
- Vibrar al actuar da un pequeño tic al tocar un dispositivo, ejecutar una acción o girar la corona en una pantalla de control. Viene desactivado por defecto.
- Tiempo de pantalla fija cuánto tiempo sigue encendida la pantalla mientras AmazHA está abierta: 30 segundos, 1 minuto, 5 minutos o Nunca, la opción predeterminada. «Nunca» también ignora que bajes la muñeca, lo que es cómodo pero gasta más batería.
El idioma del reloj sigue su propio idioma del sistema; Idioma, en los ajustes, solo cambia la página de ajustes. (Preferencias)
El widget en la esfera
El widget pone hasta cuatro de tus dispositivos en las tarjetas de acceso directo del reloj, a un toque y sin abrir la app. Forma parte de la versión completa; en la versión gratuita ofrece el desbloqueo.
Para configurarlo, abre Dispositivos › Widget en el reloj en los ajustes del móvil y toca hasta cuatro dispositivos, en el orden que quieras: de izquierda a derecha y de arriba abajo. Después, en el reloj, desliza hacia la derecha desde la esfera hasta las tarjetas de acceso directo, toca Editar y añade AmazHA. Hasta que abras la app una vez, el widget dice Abrir AmazHA; después, tus dispositivos estarán ahí. (Nombres propios y el widget, paso 4)
Lo que hace un toque en el widget depende del dispositivo:
| Dispositivo en el widget | Un toque |
|---|---|
| Luz, interruptor, ventilador | Lo enciende o lo apaga; el widget muestra el estado nuevo |
| Escena, script, botón, automatización | Lo ejecuta |
| Cualquier otro (una cerradura, una persiana, un sensor, una cámara) | Abre su propia pantalla en AmazHA, donde una cerradura te sigue pidiendo confirmación |
Si una orden no llega, la pantalla dice por qué, con Reintentar y Abrir AmazHA; Reintentar nunca ejecuta una acción dos veces. La cabecera del widget siempre indica la antigüedad de sus estados, por ejemplo AmazHA · hace 1 min. Se vuelve gris mientras el reloj está sin conexión, o cuando sus estados tienen 12 horas, y entonces un toque abre la app, que lo pone al día. Los cambios que hagas en el móvil llegan al widget la próxima vez que abras AmazHA.
Una nota práctica: en los relojes más recientes, una actualización de AmazHA instalada con el widget en la esfera mantiene en marcha parte de la versión anterior hasta que el reloj se reinicia. Mientras tanto, el inicio muestra Reinicia el reloj.
Los datos de tu reloj en Home Assistant
AmazHA también funciona al revés: puede enviar 18 lecturas de tu reloj a Home Assistant como entidades de sensor. Llegan a través de la propia integración Mobile App de Home Assistant, como un dispositivo con sus sensores, con el nombre sensor.<prefix>_<key>.
Las lecturas abarcan la actividad (pasos, distancia, calorías, horas de pie, minutos intensos, PAI), la salud (frecuencia cardíaca, frecuencia cardíaca en reposo, SpO2, estrés, temperatura corporal, puntuación de sueño, duración del sueño, estado del sueño), el entorno (presión atmosférica, altitud) y el dispositivo (batería del reloj, estado de uso). Todas empiezan desactivadas, y tú activas solo las que quieras, en Sensores del reloj › Enviar a Home Assistant.
El reloj envía sus datos cada vez que abres AmazHA. Para que se actualicen con la app cerrada, configura Actualizar cada (de 1 a 6 minutos) y permite la Actividad en segundo plano cuando el reloj lo pida; el móvil tiene que estar cerca en cada actualización. En Home Assistant, el reloj está en Configuración › Dispositivos y servicios › Mobile App. El artículo sobre los sensores del reloj tiene la tabla completa y ejemplos de automatizaciones. (Sensores del reloj)
Límites que conviene conocer
Una app de reloj que pasa por el móvil tiene algunos límites por diseño, y es mejor conocerlos antes de comprar.
| Límite | Qué significa en la práctica |
|---|---|
| El móvil tiene que estar cerca | Sin enlace Bluetooth con el móvil, no hay control. El reloj muestra Sin conexión · El teléfono no responde |
| Los estados se actualizan mientras la app está abierta | Cada 8 segundos, así que un cambio hecho en otro sitio aparece en pocos segundos. Con la app cerrada, no se actualiza nada |
| Home Assistant no envía nada por su cuenta | El reloj pide los estados; Home Assistant no puede enviar notificaciones ni actualizaciones al reloj a través de AmazHA |
| 100 dispositivos como máximo | Con unas pocas decenas va rápido. La pantalla Dispositivos recomienda 40 o menos por área: en algunos relojes, un área con 70 o más puede quedarse sin memoria y dejar la pantalla en negro |
| Fuera de casa hace falta una dirección remota | Solo si quieres usarlo fuera; la dirección local cubre la casa |
| Actualizaciones de sensores en segundo plano | Necesitan el permiso de Actividad en segundo plano y el móvil al alcance; si no, el reloj envía sus datos al abrir la app |
| Solo Zepp OS | Hay una versión para Wear OS en desarrollo, sin fecha |
Las dos primeras filas explican la mayoría de las sorpresas. Si dejas el móvil en otra habitación y sales del alcance del Bluetooth, el reloj sigue mostrando tus últimos datos, pero no puede cambiar nada. Y si una luz cambia mientras AmazHA está cerrada, el reloj muestra el estado nuevo la próxima vez que lo abras.
Cuando algo falla
Cuando algo no funciona, el reloj dice qué pasa, y cada mensaje tiene una causa habitual. Esta tabla sigue el tutorial Cuando algo falla, que tiene un paso para cada mensaje.
| El reloj dice | Causa | Solución |
|---|---|---|
| Ningún dispositivo elegido | Todos los dispositivos empiezan ocultos | Activa los dispositivos que quieras en Dispositivos, en los ajustes de AmazHA (paso 1) |
| Sin conexión · El teléfono no responde | El reloj no consigue llegar a tu móvil | Ten el móvil cerca, con el Bluetooth activado y la app Zepp en marcha (paso 2) |
| Sin conexión · Home Assistant no accesible | El móvil no consigue llegar a Home Assistant | Abre tu dirección en el navegador del móvil: tiene que funcionar desde donde está el móvil, y fuera de casa necesita HTTPS con un certificado válido (paso 3) |
| Dirección incorrecta | La dirección responde, pero no es la API de Home Assistant | Usa solo la dirección del servidor, sin nada detrás (sin /lovelace) (paso 4) |
| Se necesita token admin | El token es de un usuario sin permisos de administrador | Crea un nuevo token de larga duración como administrador y pégalo (paso 5) |
| Revisa el token | El token tiene un carácter que ningún token lleva, normalmente por una copia cortada (…) | Vuelve a copiarlo, entero, y pégalo (paso 6) |
| El reloj va lento o se reinicia | Demasiados dispositivos | Mantén la selección pequeña: con unas pocas decenas va rápido, y 100 es el límite (paso 7) |
| Modo demo · sin licencia | La app no está desbloqueada | Toca el banner y desbloquéala (Desbloquea la versión completa) |
| Modo demo · Configura tu servidor HA en la app del móvil | Desbloqueada, pero aún sin servidor configurado | Introduce tu dirección y tu token en Home Assistant, en los ajustes (Conecta Home Assistant) |
| Reinicia el reloj | Una actualización instalada con el widget en la esfera | Reinicia el reloj |
Bajo un banner Sin conexión, el reloj añade Reintento cada 8 s, así que no tienes que hacer nada cuando la causa desaparece, y debajo una pequeña línea de código que le dice al soporte exactamente qué ha fallado. Una foto del reloj es lo más útil que puedes enviar.
Si nada de la lista encaja, abre Preferencias, toca Restablecer caché y luego Toca de nuevo para confirmar. Borra los datos en caché del reloj y del móvil, y conserva tu conexión, tus dispositivos y tu licencia; después, vuelve a abrir AmazHA en el reloj (paso 8). Si eso tampoco ayuda, el formulario de Soporte de los ajustes envía un informe con tu mensaje. Nunca incluye tu dirección de Home Assistant, tu token ni los nombres de tus dispositivos.
Un ejemplo práctico: prueba en verde, reloj vacío
Un aviso habitual el primer día: Conectar se pone en verde, pero el reloj no muestra nada. Dos causas cubren casi todos los casos. O todavía no hay ningún dispositivo activado, y el reloj dice Ningún dispositivo elegido, o el token es de un usuario que no es administrador, y el reloj dice Se necesita token admin. Lo segundo sorprende porque la prueba de conexión lee los estados sin problema; es la consulta de las áreas, a través de la API de plantillas, la que Home Assistant le niega a un usuario normal. Un token nuevo, creado con la sesión iniciada como administrador, lo soluciona.
Desbloquear la versión completa
El desbloqueo es un pago único que se hace desde el reloj, a través de KiezelPay: sin cuenta, sin suscripción, sin anuncios. Conecta AmazHA a tu propio Home Assistant, en local y en remoto, y activa los sensores del reloj y el widget. Hasta entonces, la app es una demo con datos de ejemplo y nada llega a un servidor real.
- En el reloj, toca el banner naranja Modo demo · sin licencia. El reloj muestra un código de 5 dígitos.
- En tu móvil, abre kzl.io/code en el navegador.
- Escribe el código y toca Continue.
- Paga una sola vez, con tarjeta o PayPal. Es una licencia de por vida.
- El reloj muestra Purchase Successful! y vuelve solo a la app.
El tutorial Desbloquea la versión completa muestra cada pantalla, y la sección de precios de la página de inicio enumera lo que incluye cada versión.