Integración domótica AWTRIX 3, gratuita y de código abierto
Relojes AWTRIX 3 (Ulanzi TC001): notificaciones, valores de Gladys en pantalla, sensores.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Esta integración conecta a Gladys los relojes de píxeles AWTRIX 3: el «Smart Pixel Clock» Ulanzi TC001 y los montajes ESP32 propios con el firmware libre AWTRIX 3. Gladys los lee y los controla en la red local, mediante su API HTTP. Sin nube, sin cuenta, sin broker MQTT.
Desarrollada sin el hardware: sus comentarios son bienvenidos. La integración está construida y probada según la API de AWTRIX 3 tal como la describen su firmware y su documentación, no con un reloj real. Indique lo que funciona y lo que no en las issues.
AWTRIX y esta integración no están afiliados a Ulanzi.
Presentación
- Un dispositivo por reloj: pantalla encendida/apagada, brillo, brillo automático, un botón «aplicación siguiente», la aplicación en pantalla y los sensores del reloj (temperatura, humedad, luz ambiental, batería, señal Wi-Fi, tiempo de funcionamiento).
- Acciones de escena: mostrar una notificación (texto, color, icono, duración, sonido, esperar al botón), mantener un valor de Gladys en pantalla, encender los tres indicadores de color, cambiar la aplicación en pantalla.
- Un widget de panel con la aplicación en pantalla, los sensores y cuatro botones: Mensaje…, App siguiente, Apagar / Encender, Descartar.
- Los relojes se encuentran solos en la red (mDNS), o por sus direcciones.
Requisitos
- Gladys Assistant 5.2.0 o posterior.
- Un reloj con el firmware AWTRIX 3. La integración sigue la API de la 0.98, su última versión; actualice un reloj más antiguo desde su interfaz web. Consulte la documentación de AWTRIX 3 para flashear un Ulanzi TC001.
- AWTRIX NG, el firmware sucesor (2026), tiene otra API y no es compatible: la integración lo reconoce y lo indica.
- El reloj y Gladys en la misma red local.
Configuración
- En Gladys, abra Integraciones → Instalar desde GitHub e introduzca
https://github.com/guim31/gladys-awtrix(o instale AWTRIX 3 desde el catálogo). - En Configuración:
- Buscar los relojes en la red (activado por defecto): Gladys busca los relojes que se anuncian por mDNS y sigue a un reloj cuya dirección cambia.
- Direcciones de los relojes: las direcciones IP o nombres de host de
sus relojes, separados por comas (
192.168.1.50, 192.168.1.51). Útil cuando el mDNS no atraviesa su red, o para mantener una dirección fija. - Nombre de usuario y Contraseña: solo si ha definido «Auth Username» y «Auth Password» en la interfaz web de los relojes. Los mismos para todos los relojes.
- Intervalo de actualización: con qué frecuencia se leen los relojes (30 segundos por defecto).
- Idioma de los nombres de funciones: los nombres de las funciones al añadir un dispositivo y los mensajes de la integración.
- Haga clic en Probar la conexión: cada reloj encontrado aparece con su firmware y la aplicación en pantalla.
- En la pestaña Descubrir, añada los relojes a Gladys.
Cada lectura son dos pequeñas peticiones HTTP por reloj (/api/stats y
/api/settings), enviadas una tras otra: un reloj es un ESP32 y solo atiende
una petición cada vez. No hay cuota; mantenga un intervalo de 15 segundos o
más.
Dispositivos
Cada reloj es un dispositivo llamado «AWTRIX» seguido del final de su
identificador (por ejemplo AWTRIX 3c1a2b). Su identidad es el identificador
propio del reloj, no su dirección: una nueva dirección IP conserva el
dispositivo y su historial.
| Función | Qué hace |
|---|---|
| Pantalla | Enciende o apaga la matriz. El reloj sigue funcionando. |
| Brillo | De 0 a 100 %. Ajustarlo desactiva el brillo automático; si no, el reloj lo sustituiría enseguida. |
| Brillo automático | El reloj sigue la luz ambiental. |
| Aplicación siguiente | Un botón: muestra la aplicación siguiente, como el botón derecho del reloj. |
| Aplicación actual | La aplicación en pantalla: Time, Date, Temperature, una aplicación personalizada, Notification... |
| Temperatura | En °C. Solo si el reloj la indica (Ulanzi TC001, o montaje propio con sensor). |
| Humedad | En %. La misma condición. |
| Luz ambiental | En lux, según el sensor de luz del reloj. |
| Batería | En %. Solo Ulanzi TC001. |
| Señal Wi-Fi (dBm) | La señal recibida por el reloj, en dBm (−50: excelente, −80: débil). |
| Tiempo de funcionamiento | Horas desde el último reinicio del reloj. |
Estos son los nombres en español; el idioma elegido en la configuración da «Display», «Écran», «Anzeige»...
Widget
Añada el widget Reloj AWTRIX a un panel. Muestra la aplicación en pantalla, la pantalla, el brillo y la señal Wi-Fi, con la temperatura y la humedad cuando el reloj las tiene. Elija un reloj en su configuración, o déjelo vacío para todos (una línea cada uno).
Sus cuatro botones actúan sobre el reloj elegido, o sobre todos:
- Mensaje…: abre un formulario (texto, color, duración) y muestra el texto en el reloj.
- App siguiente: la siguiente aplicación de la rotación.
- Apagar / Encender: apaga la matriz o la vuelve a encender.
- Descartar: quita una notificación que espera que se pulse el botón.
Acciones de escena
Cada acción se dirige a un reloj, o a todos cuando el campo reloj queda vacío. Cada una devuelve el número de relojes alcanzados («Relojes alcanzados») y falla cuando ninguno la ha aceptado.
- Mostrar una notificación en AWTRIX: un texto mostrado una vez sobre las
aplicaciones. Opciones: color del texto (o arcoíris), un icono, la duración,
lo que hace un texto largo (se desplaza una vez entero, se desplaza durante
la duración, no se desplaza), un sonido, permanecer hasta pulsar el botón
central, encender la pantalla si está apagada. Escriba
{{en el texto para insertar un valor de la escena. - Descartar la notificación de AWTRIX: quita una notificación que espera que se pulse el botón.
- Mostrar un valor en AWTRIX: crea o actualiza una aplicación personalizada que se queda en la rotación del reloj. El mismo nombre actualiza la misma aplicación. Opciones: color, icono, una barra de progreso (0-100) y «Quitar después de (minutos)»: la aplicación desaparece si la escena deja de actualizarla, así un valor antiguo nunca queda en pantalla.
- Quitar un valor de AWTRIX: quita esa aplicación personalizada.
- Ajustar un indicador de AWTRIX: enciende uno de los tres puntos de color a la derecha de la pantalla (1 arriba a la derecha, 2 a la derecha, 3 abajo a la derecha), fijo, intermitente o pulsante, o lo apaga.
- Aplicación AWTRIX siguiente: la siguiente aplicación de la rotación.
- Mostrar una aplicación AWTRIX: salta a una aplicación por su nombre
(
Time,Date,Temperature,Humidity,Batteryo una aplicación personalizada).
Los iconos son identificadores de iconos LaMetric que primero se
descargan en el reloj: interfaz web del reloj, pestaña Icons, introduzca
el identificador (por ejemplo 2422), descárguelo. Los sonidos son una
melodía RTTTL escrita en el campo (beep:d=16,o=6,b=120:c,e), o el nombre de
un archivo de melodía del reloj (carpeta MELODIES), tocados por el zumbador
del Ulanzi TC001.
Disparadores de escena
Ninguno. Los botones del reloj comunican sus pulsaciones por MQTT, o por una llamada HTTP a una dirección que la integración no puede ofrecer desde su contenedor. Gladys ve igualmente lo que cambian los botones: la aplicación en pantalla y la pantalla son estados de dispositivo utilizables en una escena.
Ejemplos de escenas
- Temperatura exterior siempre en pantalla: disparador «el valor de un
dispositivo cambia» en su sensor exterior → acción Mostrar un valor en
AWTRIX, nombre
exterior, texto{{valor del disparador}} °C(insértelo con{{), un icono de termómetro, Quitar después de 60 minutos. - Lavadora terminada: disparador cuando la potencia del enchufe de la lavadora baja de 5 W → Mostrar una notificación en AWTRIX «Ropa lista», en verde, un sonido, Permanecer hasta pulsar el botón.
- Modo noche: a las 23:00, ponga la Pantalla del reloj en apagado; a las 7:00, de nuevo encendida. O manténgala encendida con el Brillo al 5 %.
- Puerta abierta: cuando se abre la puerta de entrada, Ajustar un indicador de AWTRIX 1 en rojo, intermitente; cuando se cierra, indicador 1 apagado.
Solución de problemas
- No se encuentra ningún reloj: el mDNS no siempre atraviesa los puntos de acceso Wi-Fi o las VLAN. Introduzca la dirección del reloj en Direcciones de los relojes. El reloj la muestra al arrancar, y su router la conoce.
- «no responde»: el reloj está apagado, en otra red, o su dirección ha cambiado. Con la búsqueda activada, Gladys lo busca de nuevo cada 10 minutos.
- «nombre de usuario o contraseña rechazados»: el reloj tiene un «Auth Username»; introduzca el mismo nombre de usuario y contraseña en la configuración.
- «firmware AWTRIX NG»: el reloj funciona con AWTRIX NG, no compatible.
- La temperatura es demasiado alta: el sensor del Ulanzi TC001 se
calienta con el propio reloj. AWTRIX 3 ofrece una compensación de
temperatura en su archivo
dev.json(temp_offset). - Un icono no aparece: descárguelo primero en el reloj (interfaz web, pestaña Icons).
- Más detalles: ponga
LOG_LEVEL=debugen la integración; los registros nunca contienen la contraseña.
Límites
- Desarrollada sin el hardware: probada solo según la API documentada y un reloj simulado.
- Solo AWTRIX 3; AWTRIX NG no es compatible.
- Ningún disparador para los botones del reloj (solo MQTT).
- Un solo nombre de usuario y contraseña para todos los relojes.
- Solo HTTP simple, como lo sirve AWTRIX 3: mantenga los relojes en una red de confianza.
- El brillo de un reloj con brillo automático cambia con la luz: Gladys muestra el valor leído en cada actualización.
Indique un problema o una idea en las issues.
Parámetros de configuración
Estos son los parámetros que AWTRIX 3 te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus relojes AWTRIX 3 | section | No | Relojes con el firmware AWTRIX 3 (Ulanzi TC001 o montaje propio) en la red local. Gladys los encuentra sola (mDNS); si no, introduzca sus direcciones. AWTRIX NG no es compatible. |
| Direcciones de los relojes | string | No | Direcciones IP o nombres de host, separados por comas. Opcional si Gladys encuentra sus relojes. |
| Buscar los relojes en la red | boolean | No | Gladys busca los relojes que se anuncian por mDNS y sigue a un reloj cuya dirección cambia. |
| Protección con contraseña | section | No | Solo si ha definido «Auth Username» y «Auth Password» en la interfaz web de los relojes (los mismos para todos). Si no, déjelo vacío. |
| Nombre de usuario | string | No | |
| Contraseña | secret | No | |
| Opciones | section | No | Los relojes se leen solo en la red local, una petición cada vez. |
| Intervalo de actualización | select | No | Con qué frecuencia se leen los relojes (sensores, pantalla, aplicación actual). |
| Idioma de los nombres de funciones | select | No | Nombres de las funciones al añadir un dispositivo y mensajes de la integración. |
Cómo instalar AWTRIX 3 en Gladys
- En Gladys, abre Integraciones: AWTRIX 3 aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-awtrix:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-awtrix.
AWTRIX 3 requiere Gladys >=5.2.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
AWTRIX 3 es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación