Intégration domotique AWTRIX 3, gratuite et open source
Horloges AWTRIX 3 (Ulanzi TC001) : notifications, valeurs Gladys à l'écran, capteurs.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.2.0
- ★ 0
Cette intégration relie à Gladys les horloges à matrice LED AWTRIX 3 : la « Smart Pixel Clock » Ulanzi TC001 et les montages ESP32 maison qui tournent sous le firmware libre AWTRIX 3. Gladys les lit et les pilote sur le réseau local, par leur API HTTP. Pas de cloud, pas de compte, pas de broker MQTT.
Développée sans le matériel : vos retours sont les bienvenus. L'intégration est construite et testée d'après l'API AWTRIX 3 telle que son firmware et sa documentation la décrivent, pas sur une vraie horloge. Dites ce qui marche et ce qui ne marche pas dans les issues.
AWTRIX et cette intégration ne sont pas affiliés à Ulanzi.
Présentation
- Un appareil par horloge : écran allumé/éteint, luminosité, luminosité automatique, un bouton « application suivante », l'application affichée, et les capteurs de l'horloge (température, humidité, luminosité ambiante, batterie, signal Wi-Fi, durée de fonctionnement).
- Actions de scène : afficher une notification (texte, couleur, icône, durée, son, attente du bouton), garder une valeur de Gladys à l'écran, allumer les trois indicateurs de couleur, changer l'application affichée.
- Un widget de tableau de bord avec l'application affichée, les capteurs et quatre boutons : Message…, App suivante, Éteindre / Allumer, Effacer.
- Les horloges sont trouvées seules sur le réseau (mDNS), ou par leurs adresses.
Prérequis
- Gladys Assistant 5.2.0 ou plus récent.
- Une horloge sous le firmware AWTRIX 3. L'intégration suit l'API de la 0.98, sa dernière version ; mettez à jour une horloge plus ancienne depuis son interface web. Voir la documentation AWTRIX 3 pour flasher une Ulanzi TC001.
- AWTRIX NG, le firmware qui lui succède (2026), a une autre API et n'est pas pris en charge : l'intégration le reconnaît et le signale.
- L'horloge et Gladys sur le même réseau local.
Configuration
- Dans Gladys, ouvrez Intégrations → Installer depuis GitHub et
saisissez
https://github.com/guim31/gladys-awtrix(ou installez AWTRIX 3 depuis le catalogue). - Dans Configuration :
- Trouver les horloges sur le réseau (activé par défaut) : Gladys cherche les horloges qui s'annoncent en mDNS, et suit une horloge dont l'adresse change.
- Adresses des horloges : les adresses IP ou noms d'hôte de vos
horloges, séparés par des virgules (
192.168.1.50, 192.168.1.51). Utile quand le mDNS ne traverse pas votre réseau, ou pour garder une adresse fixe. - Nom d'utilisateur et Mot de passe : seulement si vous avez défini « Auth Username » et « Auth Password » dans l'interface web des horloges. Les mêmes pour toutes les horloges.
- Intervalle de rafraîchissement : fréquence de lecture des horloges (30 secondes par défaut).
- Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités à l'ajout d'un appareil, et les messages de l'intégration.
- Cliquez sur Tester la connexion : chaque horloge trouvée est listée avec son firmware et l'application affichée.
- Dans l'onglet Découverte, ajoutez les horloges à Gladys.
Chaque lecture fait deux petites requêtes HTTP par horloge (/api/stats et
/api/settings), envoyées l'une après l'autre : une horloge est un ESP32 et ne
sert qu'une requête à la fois. Il n'y a pas de quota ; gardez un intervalle de
15 secondes ou plus.
Appareils
Chaque horloge est un appareil nommé « AWTRIX » suivi de la fin de son
identifiant (par exemple AWTRIX 3c1a2b). Son identité est l'identifiant
propre de l'horloge, pas son adresse : une nouvelle adresse IP garde
l'appareil et son historique.
| Fonctionnalité | Ce qu'elle fait |
|---|---|
| Écran | Allume ou éteint la matrice. L'horloge continue de tourner. |
| Luminosité | 0 à 100 %. La régler coupe la luminosité automatique, sinon l'horloge la remplacerait aussitôt. |
| Luminosité automatique | L'horloge suit la lumière ambiante. |
| Application suivante | Un bouton : affiche l'application suivante, comme le bouton droit de l'horloge. |
| Application en cours | L'application affichée : Time, Date, Temperature, une application personnalisée, Notification... |
| Température | En °C. Seulement si l'horloge la remonte (Ulanzi TC001, ou montage maison avec capteur). |
| Humidité | En %. Même condition. |
| Luminosité ambiante | En lux, d'après le capteur de lumière de l'horloge. |
| Batterie | En %. Ulanzi TC001 seulement. |
| Signal Wi-Fi (dBm) | Le signal reçu par l'horloge, en dBm (−50 : excellent, −80 : faible). |
| Durée de fonctionnement | Heures depuis le dernier redémarrage de l'horloge. |
Ces noms sont ceux du français ; la langue choisie dans la configuration donne « Display », « Anzeige », « Pantalla »...
Widget
Ajoutez le widget Horloge AWTRIX à un tableau de bord. Il montre l'application affichée, l'écran, la luminosité et le signal Wi-Fi, avec la température et l'humidité quand l'horloge les a. Choisissez une horloge dans ses réglages, ou laissez vide pour toutes (une ligne chacune).
Ses quatre boutons agissent sur l'horloge choisie, ou sur toutes :
- Message… : ouvre un formulaire (texte, couleur, durée) et affiche le texte sur l'horloge.
- App suivante : l'application suivante de la rotation.
- Éteindre / Allumer : éteint la matrice, ou la rallume.
- Effacer : retire une notification qui attend l'appui sur le bouton.
Actions de scène
Chaque action vise une horloge, ou toutes quand le champ horloge reste vide. Chacune renvoie le nombre d'horloges atteintes (« Horloges atteintes »), et échoue quand aucune ne l'a acceptée.
- Afficher une notification sur AWTRIX : un texte affiché une fois
par-dessus les applications. Options : couleur du texte (ou arc-en-ciel),
une icône, la durée, ce que fait un texte long (défile une fois en entier,
défile pendant la durée, ne défile pas), un son, rester jusqu'à l'appui sur
le bouton du milieu, allumer l'écran s'il est éteint. Tapez
{{dans le texte pour insérer une valeur de la scène. - Effacer la notification AWTRIX : retire une notification qui attend l'appui sur le bouton.
- Afficher une valeur sur AWTRIX : crée ou met à jour une application personnalisée qui reste dans la rotation de l'horloge. Le même nom met à jour la même application. Options : couleur, icône, une barre de progression (0-100), et « Retirer après (minutes) » : l'application disparaît si la scène cesse de la mettre à jour, ainsi une vieille valeur ne reste jamais à l'écran.
- Retirer une valeur d'AWTRIX : retire cette application personnalisée.
- Régler un indicateur AWTRIX : allume l'un des trois points de couleur à droite de l'écran (1 en haut à droite, 2 à droite, 3 en bas à droite), fixe, clignotant ou en pulsation, ou l'éteint.
- Application AWTRIX suivante : l'application suivante de la rotation.
- Afficher une application AWTRIX : passe à une application par son nom
(
Time,Date,Temperature,Humidity,Batteryou une application personnalisée).
Les icônes sont des identifiants d'icônes LaMetric à télécharger d'abord
sur l'horloge : interface web de l'horloge, onglet Icons, saisissez
l'identifiant (par exemple 2422), téléchargez. Les sons sont une
mélodie RTTTL saisie dans le champ (beep:d=16,o=6,b=120:c,e), ou le nom d'un
fichier mélodie de l'horloge (dossier MELODIES), joués par le buzzer de
l'Ulanzi TC001.
Déclencheurs de scène
Aucun. Les boutons de l'horloge signalent leurs appuis en MQTT, ou par un appel HTTP vers une adresse que l'intégration ne peut pas offrir depuis son conteneur. Gladys voit tout de même ce que les boutons changent : l'application affichée et l'écran sont des états d'appareil utilisables dans une scène.
Exemples de scènes
- Température extérieure toujours à l'écran : déclencheur « la valeur
d'un appareil change » sur votre sonde extérieure → action Afficher une
valeur sur AWTRIX, nom
exterieur, texte{{valeur du déclencheur}} °C(à insérer avec{{), une icône de thermomètre, Retirer après 60 minutes. - Lave-linge terminé : déclencheur sur la puissance de la prise du lave-linge qui passe sous 5 W → Afficher une notification sur AWTRIX « Linge prêt », en vert, un son, Rester jusqu'à l'appui sur le bouton.
- Mode nuit : à 23 h, passez l'Écran de l'horloge à éteint ; à 7 h, rallumez-le. Ou gardez-le allumé avec la Luminosité à 5 %.
- Porte restée ouverte : à l'ouverture de la porte d'entrée, Régler un indicateur AWTRIX 1 en rouge, clignotant ; à la fermeture, indicateur 1 éteint.
Dépannage
- Aucune horloge trouvée : le mDNS ne traverse pas toujours les points d'accès Wi-Fi ou les VLAN. Saisissez l'adresse de l'horloge dans Adresses des horloges. Elle s'affiche sur l'horloge au démarrage, et dans votre box.
- « ne répond pas » : l'horloge est éteinte, sur un autre réseau, ou son adresse a changé. Avec la découverte active, Gladys la recherche toutes les 10 minutes.
- « nom d'utilisateur ou mot de passe refusé » : l'horloge a un « Auth Username » ; saisissez le même nom d'utilisateur et mot de passe dans la configuration.
- « firmware AWTRIX NG » : l'horloge tourne sous AWTRIX NG, non pris en charge.
- La température est trop haute : le capteur de l'Ulanzi TC001 est
chauffé par l'horloge elle-même. AWTRIX 3 propose un décalage de
température dans son fichier
dev.json(temp_offset). - Une icône ne s'affiche pas : téléchargez-la d'abord sur l'horloge (interface web, onglet Icons).
- Plus de détails : passez
LOG_LEVEL=debugsur l'intégration ; les journaux ne contiennent jamais le mot de passe.
Limites
- Développée sans le matériel : testée seulement d'après l'API documentée et une horloge simulée.
- AWTRIX 3 seulement ; AWTRIX NG n'est pas pris en charge.
- Pas de déclencheur pour les boutons de l'horloge (MQTT seulement).
- Un seul nom d'utilisateur et mot de passe pour toutes les horloges.
- HTTP simple seulement, comme AWTRIX 3 le sert : gardez les horloges sur un réseau de confiance.
- La luminosité d'une horloge en luminosité automatique bouge avec la lumière : Gladys montre la valeur lue à chaque rafraîchissement.
Signalez un problème ou une idée dans les issues.
Paramètres de configuration
Voici les paramètres demandés par AWTRIX 3 dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos horloges AWTRIX 3 | section | Non | Horloges sous le firmware AWTRIX 3 (Ulanzi TC001 ou montage maison), sur le réseau local. Gladys les trouve seule (mDNS) ; sinon, saisissez leurs adresses. AWTRIX NG n'est pas pris en charge. |
| Adresses des horloges | string | Non | Adresses IP ou noms d'hôte, séparés par des virgules. Facultatif si Gladys trouve vos horloges. |
| Trouver les horloges sur le réseau | boolean | Non | Gladys cherche les horloges qui s'annoncent en mDNS, et suit une horloge dont l'adresse change. |
| Protection par mot de passe | section | Non | Seulement si vous avez défini « Auth Username » et « Auth Password » dans l'interface web des horloges (les mêmes pour toutes). Sinon, laissez vide. |
| Nom d'utilisateur | string | Non | |
| Mot de passe | secret | Non | |
| Options | section | Non | Les horloges sont lues sur le réseau local seulement, une requête à la fois. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture des horloges (capteurs, écran, application en cours). |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités à l'ajout d'un appareil, et messages de l'intégration. |
Comment installer AWTRIX 3 dans Gladys
- Dans Gladys, ouvrez Intégrations : AWTRIX 3 apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-awtrix:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-awtrix.
AWTRIX 3 nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
AWTRIX 3 est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation