Intégration communautaire Tasmota, gratuite et open source

Pilotez vos appareils Tasmota en local (MQTT ou HTTP) : relais, lampes, énergie, capteurs.
Pilotez vos appareils Tasmota depuis Gladys, 100 % en local : prises, relais, ampoules et rubans LED, variateurs, volets, ventilateurs, compteurs d'énergie et capteurs. Aucun cloud.
Ce que vous obtenez
- Découverte automatique en MQTT (
LWT,Status 0et la découverte native de Tasmota) et en HTTP (une liste d'adresses, ou le scan d'une plage d'IP). - Chaque appareil est identifié par son adresse MAC : le renommer, changer son topic ou son IP, ou le passer de HTTP à MQTT conserve le même appareil Gladys et son historique.
- Relais (
POWER1…POWER8), lampes (marche/arrêt, luminosité, couleur RVB, température de blanc, effets et leur vitesse), ventilateurs (FanSpeed), volets (ouvrir / fermer / stop, position). - Mesure d'énergie : puissance, puissances apparente et réactive, tension, courant, énergie du jour, de la veille et totale (le total est un index cumulé, exploitable par le suivi d'énergie de Gladys), compteurs multi-canaux compris.
- Capteurs : température, humidité, pression, luminosité, CO2, COV, PM2.5 / PM10, distance, indice UV, humidité du sol, entrées analogiques, compteurs d'impulsions, entrées interrupteur, température de la puce, signal Wi-Fi et durée de fonctionnement.
- Déclencheurs de scène : bouton appuyé (simple, double, triple… appui long), entrée interrupteur changée, code RF reçu (Sonoff RF Bridge), code IR reçu, appareil en ligne / hors ligne.
- Actions de scène : envoyer n'importe quelle commande Tasmota (Backlog, RfSend, IRSend, Rule…), allumer un relais un moment, faire clignoter une lampe, redémarrer un appareil.
- Widgets de tableau de bord : vue d'ensemble, fiche d'un appareil, fiche énergie.
- Un badge « Local » sur chaque appareil, orange quand le broker est tombé et que les commandes passent par HTTP, rouge quand l'appareil est injoignable.
Choisir comment les appareils parlent à Gladys
L'écran de configuration commence par Étape 1 — Mode de connexion, suivi de trois blocs. Gladys affiche tous les blocs en même temps : remplissez uniquement le bloc de l'option choisie, les autres sont ignorés et peuvent rester vides. L'état en haut de l'écran indique toujours l'option active et ce qu'il manque.
| Mode de connexion | À remplir | Il vous faut |
|---|---|---|
| Option 1 — Mon broker MQTT existant | bloc 1 | l'adresse et les identifiants |
| Option 2 — Broker dédié déployé par l'intégration | bloc 2 | rien (mot de passe facultatif) |
| Option 3 — Pas de MQTT, HTTP uniquement | bloc 3 | les adresses IP des appareils |
Option 1 — Mon broker MQTT existant
Par exemple le broker de l'intégration MQTT de Gladys, qui tourne déjà sur la machine Gladys (port 1883, avec l'utilisateur et le mot de passe affichés sur la page de cette intégration).
- Mode de connexion : Option 1 — Mon broker MQTT existant.
- Bloc 1 — URL du broker :
mqtt://<IP du broker>:1883— utilisez l'adresse IP du réseau local, paslocalhost(l'intégration tourne dans son propre conteneur). - Bloc 1 — Utilisateur du broker et Mot de passe du broker, puis enregistrez.
- Sur chaque appareil Tasmota : Configuration → MQTT, saisissez le même hôte, port, utilisateur et mot de passe.
Option 2 — Broker dédié déployé par l'intégration
- Mode de connexion : Option 2 — Broker dédié déployé par l'intégration.
- Bloc 2 — Mot de passe des appareils : facultatif, laissez-le vide pour en générer un.
Enregistrez : l'intégration démarre son propre conteneur Mosquitto ; le bloc 2 affiche
l'adresse et le port que les appareils doivent utiliser (utilisateur
tasmota). - Lancez l'action Option 2 — Obtenir la commande pour les appareils (saisissez l'adresse IP
de Gladys) : elle donne une ligne prête à coller, par exemple
Backlog MqttHost 192.168.1.10; MqttPort 41883; MqttUser tasmota; MqttPassword …. - Collez-la dans la Console de chaque appareil Tasmota. L'appareil redémarre et apparaît dans Gladys.
Topics MQTT (options 1 et 2)
Gardez %prefix%/%topic%/, la valeur par défaut de Tasmota, sauf si vous avez changé le
Full Topic de vos appareils en %topic%/%prefix%/.
Option 3 — Pas de MQTT, HTTP uniquement
- Mode de connexion : Option 3 — Pas de MQTT, HTTP uniquement.
- Bloc 3 — Adresses HTTP :
192.168.1.20, 192.168.1.30-45(ou utilisez l'action Scanner une plage d'IP). - Utilisateur web (
admin) et Mot de passe web : seulement si un mot de passe web est défini sur les appareils. Les appareils sont lus toutes les Intervalle de rafraîchissement HTTP secondes (30 par défaut).
Le bloc 3 fonctionne aussi avec les options 1 et 2, pour les quelques appareils qui n'utilisent pas MQTT. Un appareil trouvé en HTTP qui se connecte ensuite au broker passe en MQTT tout seul ; l'action Passer un appareil en MQTT lui envoie les réglages du broker pour vous.
Ajouter les appareils
Ouvrez l'onglet Découverte de l'intégration : les appareils trouvés y apparaissent, avec leurs fonctionnalités. Cliquez sur Ajouter, choisissez la pièce, c'est fini. Quand un appareil gagne une fonctionnalité (un capteur branché, un nouveau firmware), un bouton Mettre à jour apparaît.
Actions de l'écran de configuration
- Tester la connexion — état du broker et nombre d'appareils en ligne.
- Option 2 — Obtenir la commande pour les appareils — la ligne de console pour le broker dédié.
- Ajouter un appareil HTTP / Scanner une plage d'IP — trouver des appareils en HTTP (1024 adresses au plus).
- Identifier une lampe — la lampe clignote deux fois puis revient à son état. Les relais ne clignotent jamais (ils peuvent piloter un radiateur).
- Envoyer une commande — n'importe quelle commande Tasmota, la réponse s'affiche sous le bouton.
- Redémarrer un appareil.
- Passer un appareil en MQTT — envoie
MqttHost,MqttPort,MqttUser,MqttPassword.
Scènes
Dans la catégorie Intégrations de l'éditeur de scènes (Gladys 5.1 ou plus récent) :
| Déclencheur | Réglage Tasmota nécessaire | Variables |
|---|---|---|
| Bouton Tasmota appuyé | SetOption73 1 (boutons découplés des relais) | button, action |
| Entrée interrupteur Tasmota changée | SetOption114 1 (interrupteurs découplés des relais) | switch, action |
| Code RF reçu | un RF Bridge (RfReceived) | code, rf_key |
| Code IR reçu | un récepteur IR (IrReceived) | code, protocol |
| Appareil Tasmota en ligne / hors ligne | aucun (LWT en MQTT, échecs de lecture en HTTP) | status |
Chaque filtre est facultatif : laissé vide, il accepte tout. Lisez les valeurs dans les actions
suivantes avec {{triggerEvent.data.code}}, par exemple.
Actions : Envoyer une commande Tasmota (sorties answered et response), Allumer un relais
un moment (l'appareil le coupe lui-même, jusqu'à 360 s), Faire clignoter une lampe Tasmota,
Redémarrer un appareil Tasmota.
Les états eux-mêmes (un relais, une température…) sont des fonctionnalités d'appareil classiques : utilisez pour eux le déclencheur « État d'un appareil » et l'action « Contrôler un appareil » de Gladys.
Tableau de bord
- Appareils Tasmota — nombre d'appareils, en ligne et hors ligne, connexion au broker, état de chaque appareil, bouton Actualiser.
- Appareil Tasmota — choisissez un appareil : ses principales valeurs en direct, IP, firmware, signal Wi-Fi, durée de fonctionnement, et les boutons Basculer, Identifier (lampes) et Redémarrer.
- Énergie Tasmota — choisissez un appareil de mesure : courbe de puissance sur 24 heures, puissance, tension et courant en direct, énergie du jour, de la veille et totale.
Dépannage
- Rien dans Découverte (MQTT) : vérifiez que l'URL du broker utilise l'IP du réseau local, et que les appareils affichent « MQTT connected » dans leur console. Cliquez sur Scanner dans l'onglet Découverte : chaque appareil connu est réinterrogé.
- Un appareil demande un mot de passe (HTTP) : renseignez l'utilisateur et le mot de passe web dans la configuration, ou dans les champs des actions Ajouter / Scanner.
- Les boutons ne déclenchent pas les scènes : envoyez
SetOption73 1à l'appareil (etSetOption114 1pour les entrées interrupteur). - Logs : ouvrez les logs de l'intégration depuis Gladys ;
LOG_LEVEL=debugdonne tout le détail.
Paramètres de configuration
Voici les paramètres demandés par Tasmota dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Étape 1 — Choisissez comment vos appareils se connectent | section | Non | Option 1 : vous avez déjà un broker MQTT (par exemple celui de l'intégration MQTT de Gladys) : remplissez le bloc 1 avec son adresse et ses identifiants. Option 2 : vous n'avez pas de broker : l'intégration déploie un conteneur Mosquitto dédié, remplissez uniquement le bloc 2. Option 3 : pas de MQTT, les appareils sont lus en HTTP : remplissez uniquement le bloc 3. Les blocs des autres options sont ignorés, vous pouvez les laisser vides. |
| Mode de connexion | select | Oui | |
| Bloc 1 — Mon broker MQTT existant (option 1 uniquement) | section | Non | L'adresse et les identifiants de votre broker. Avec le broker de l'intégration MQTT de Gladys : mqtt://<IP de Gladys>:1883 et l'utilisateur et le mot de passe affichés sur la page de cette intégration. Utilisez l'adresse IP du réseau local, pas localhost : l'intégration tourne dans son propre conteneur. Vos appareils Tasmota doivent pointer vers le même broker (Configuration > MQTT sur chaque appareil). |
| URL du broker | string | Non | |
| Utilisateur du broker | string | Non | |
| Mot de passe du broker | secret | Non | |
| Bloc 2 — Broker dédié déployé par l'intégration (option 2 uniquement) | section | Non | Rien à installer : à l'enregistrement, l'intégration démarre son propre conteneur Mosquitto. Vos appareils se connectent à {{gladys_host}}, port {{port:mqtt}}, utilisateur tasmota, avec le mot de passe ci-dessous (laissez-le vide pour en générer un). Lancez ensuite l'action « Obtenir la commande pour les appareils » : elle donne la ligne à coller dans la console de chaque appareil Tasmota. |
| Mot de passe des appareils | secret | Non | Facultatif : laissez vide pour en générer un. |
| Topics MQTT (options 1 et 2) | section | Non | Gardez la valeur par défaut, sauf si vous avez modifié le Full Topic de vos appareils. |
| FullTopic Tasmota | select | Oui | |
| Bloc 3 — Appareils HTTP (option 3, facultatif avec les options 1 et 2) | section | Non | Appareils lus en HTTP, toutes les quelques secondes. Obligatoire avec l'option 3 ; avec les options 1 et 2, seulement pour les appareils qui n'utilisent pas MQTT. Listez leurs adresses (ou utilisez l'action « Scanner une plage d'IP »). Utilisateur et mot de passe web : seulement si un mot de passe web est défini sur les appareils. |
| Adresses HTTP | string | Non | IP, noms d'hôte ou plages, séparés par des virgules. |
| Utilisateur web | string | Non | |
| Mot de passe web | secret | Non | |
| Intervalle de rafraîchissement HTTP (s) | number | Non | Fréquence de lecture des appareils HTTP (les appareils MQTT envoient leurs changements). |
Comment installer Tasmota dans Gladys
- Dans Gladys, ouvrez Intégrations : Tasmota 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/gboulvin/gladys-tasmota:1.0.2), 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/gboulvin/Gladys-Tasmota.
Tasmota nécessite Gladys >=5.1.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
Tasmota 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 gboulvin, 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