Présentation et documentation du plugin Tasmota pour Jeedom

Présentation

Le plugin Tasmota pour Jeedom permet de découvrir, configurer, superviser et piloter des appareils Tasmota et OpenBeken depuis une seule interface. Il prend en charge les appareils OpenBeken lorsque leurs topics MQTT tele/ et stat/ sont recopiés de manière compatible.

Il couvre la découverte réseau, la génération automatique des commandes, la gestion des groupes, la supervision de l’état des appareils et, pour les firmwares compatibles, des vues dédiées à OpenBeken.

Ce que fait le plugin

Découverte par ARP, Ping, mDNS/multicast et autodiscovery MQTT Tasmota.
Création automatique des équipements Jeedom.
Synchronisation manuelle via le bouton Sync et synchronisation périodique via cron.
Gestion des groupes pour piloter plusieurs appareils simultanément
Gestion des appareils en DHCP par adresse MAC : lorsqu’une IP change, le plugin tente de réaffecter la bonne IP au bon équipement.
Détection des collisions IP/MAC pour éviter de piloter un appareil à la place d’un autre.
Interface de santé et de supervision.
Assistant de commandes dynamique.

Détection automatique des capacités

Le plugin détecte automatiquement les capacités d’un équipement :

nombre de relais,
présence d’un dimmer,
couleur RGB,
température de blanc,
volet,
capteurs,
type de lumière,
firmware, chip, hardware et topic MQTT.

Cette détection sert ensuite à créer ou mettre à jour les commandes utiles, par exemple Power1, Power2, Dimmer, Color, ShutterPosition, énergie, capteurs, etc.

Commandes Tasmota et OpenBeken

Assistant de création de commandes basé sur un catalogue JSON.
Support des commandes info et action.
Gestion des arguments, de l’index [x], des valeurs dynamiques comme #select#, des unités, min/max, step, generic type et liens info/action.
Bouton de configuration avancée des commandes depuis la table Jeedom.
Raccourcis de console pour les commandes courantes.

Vue générale du plugin

Lors d’une découverte, il est possible de créer 1 équipement par Tasmota.

Il est ensuite possible d’affecter une image pour chaque équipement (géré par le core Jeedom, via Configuration de l’équipement.)

Découverte des appareils

4 méthodes de découverte possible. Les équipements déjà ajouté dans le plugin apparaissent en vert et cochés par défaut. Il est possible de ne découvrir et créer que les équipement en ligne via le bouton dans la configuration du plugin.

Page de configuration du plugin

Dans la page de configuration du plugin, vous pouvez définir :

les méthodes de découverte,
les plages réseau,
le mode MQTT,
le broker MQTT,
les options de création automatique,
l’intervalle de résolution IP,
les paramètres de sauvegarde planifiée,
la rétention des backups,
la vérification des versions Tasmota stable/development.

Vous pouvez laisser le plugin découvrir automatiquement les appareils (toutes les 30 min) et choisir les méthode de découverte, ou le faire manuellement ensuite.

Le champ Plage réseau permet de scanner les IP de ces plages.

Le plugin découvre tout seul les plugins MQTT disponibles sur votre Jeedom (MQTT Manager, jMQTT, MQTT) et les affiche, afin de vous laisser le choix de les sélectionner ou non. Si vous avez d’autres broker externes, il est possible de les entrer manuellement.

Vue groupe

Il est possible de créer des équipements de type groupe, afin d’y lister les appareils de même classe ou type. Cet équipement contient les même onglets que les équipements individuels, mais en condensé. Cela permet une meilleure visualisation, copier/coller facilement les configurations/options/règles/options/…, faire des sauvegardes par groupe, avoir des commandes action groupées.

Attention aux regroupement improbables qui peuvent causer des fonctionnements aléatoires : OpenBeken-Tasmota, ESP32-ESP8266.

Page Santé

Visualisation en tableau de tous les équipements.

Page Sauvegarde

Visualisation en tableau des sauvegardes disponibles pour chaque équipement.

Onglets OpenBeken

Les commandes et configuration OpenBeken étant différentes, ces onglets diffèrent aussi, mais disposent de la même architecture.

Le support OpenBeken inclut :

détection du firmware OpenBeken,
commandes OpenBeken adaptées,
assistant de template et de pins,
lecture/modification des flags,
export de template,
configuration MQTT compatible,
prise en compte des limites de l’API HTTP OpenBeken.

Onglets Tasmota

Certains onglets de ne sont pas disponibles lorsque votre appareil est un ESP8266.

Installation rapide

Installez le plugin dans Jeedom.
Activez-le dans la page de configuration.
Configurez la méthode de découverte réseau (ARP, IP, mDNS, MQTT). Configurez le ou les sous-réseau ainsi que le ou les broker MQTT.
Lancez une découverte depuis la page des équipements.
Sélectionnez et validez les équipements que vous voulez créer.
Vérifiez que les équipements sont créés automatiquement.

Configuration

Découverte réseau

Le plugin peut découvrir les appareils par plusieurs méthodes selon votre réseau :

Ping
ARP
mDNS / multicast
autodiscovery MQTT Tasmota

MQTT

Le plugin peut fonctionner avec :

MQTT Manager / mqtt2,
jMQTT,
une connexion directe à un broker MQTT.

Il inclut un diagnostic MQTT permettant de vérifier les brokers configurés, la connexion et les topics calculés pour l’équipement.

Interface

L’interface comprend des onglets spécialisés :

Console & Informations,
Réseau,
MQTT,
Commandes Tasmota / OpenBeken,
Firmware,
Règles,
Timers,
Fichiers,
SetOptions,
Flags OpenBeken,
Sauvegarde,
Modèles / Modules.

Les équipements hors ligne sont détectés rapidement et l’interface évite de relancer inutilement des requêtes lourdes tant que l’appareil reste indisponible.

OpenBeken

Quand un équipement OpenBeken est détecté, le plugin affiche des vues adaptées, dont la gestion des flags OpenBeken. A raison d’avoir coché la case dans la page Configure General/Flags “Flag 30 – [MQTT] Enable Tasmota TELE etc publishes (for ioBroker etc)”

Utilisation

Piloter plusieurs appareils

Les groupes permettent de regrouper des Tasmota ayant des caractéristiques communes.

Ils offrent :

une page Équipements avec état en ligne/hors ligne, IP, MAC, chip, firmware et liens vers les équipements,
des onglets en accordéon par appareil,
des actions groupées avec journal de progression,
relance uniquement des appareils en échec,
copie de configuration entre membres,
pilotage groupé des règles, timers, firmware, MQTT, réseau, commandes et fichiers. Attention à ne pas regrouper des équipements différents (OpenBeken ≠ Tasmota, ESP32 ≠ ESP8266), au risque de rencontrer des dérives de fonctionnement.

Fonctionnement des onglets

Onglet	Rôle principal	Ce qu’on y trouve	Remarques
Console & Informations	Lire l’état du périphérique et envoyer des commandes	Console interactive, informations système, réponses du firmware, actions de test	Très utile pour valider une commande avant de l’automatiser
Réseau	Vérifier et modifier la configuration réseau	IP, masque, passerelle, DNS, hostname, Wi-Fi, qualité du signal	Sur OpenBeken, certaines valeurs peuvent différer entre la page web du firmware et le statut remonté au plugin
MQTT	Configurer la liaison MQTT	Broker, port, identifiant client, topic de base, utilisateur, mot de passe, options d’envoi	Sur OpenBeken, le contenu affiché dépend du statut exposé par le firmware
Commandes Tasmota / OpenBeken	Envoyer des commandes brutes	Assistant de commandes, historique, recherche, retour des réponses	Le libellé s’adapte au firmware détecté
Firmware	Vérifier l’identification matérielle et logicielle	Version, type de puce, type de firmware, informations d’identification	Pratique pour diagnostiquer un appareil mal détecté
Règles	Gérer les règles natives du firmware	Rule1, Rule2, Rule3, activation, désactivation, mode Once	Non disponible sur certains firmwares OpenBeken
Timers	Gérer les minuteries du firmware	Timers, actions planifiées, état des déclenchements	Support dépendant du firmware
Fichiers	Gérer le système de fichiers embarqué	Lecture, écriture, suppression, téléversement	Utile pour les scripts, fichiers de configuration et assets
Options	Reproduire les SetOptions Tasmota	Options de comportement du firmware	Surtout pertinent pour Tasmota
Flags	Gérer les flags OpenBeken	Lecture et écriture des flags OpenBeken	Visible uniquement sur les firmwares compatibles
Sauvegarde	Sauvegarder et restaurer la configuration	Export, restauration, gestion des sauvegardes	Important avant toute modification lourde
Modèles / Modules	Modifier le modèle matériel	Choix du module, affectation des broches, personnalisation	Onglet avancé, à utiliser avec prudence

Détail des onglets

Console & Informations

Cet onglet sert de zone de contrôle et de lecture rapide. Il permet de tester une commande, de voir la réponse du firmware et de suivre des informations système sans quitter la fiche équipement.

Il est utile pour :

vérifier qu’un appareil répond bien,
tester une commande avant de la mettre dans un scénario,
lire les informations de base du firmware,
contrôler ce que le périphérique retourne réellement.

Réseau

L’onglet Réseau regroupe les paramètres réseau de l’équipement : adresse IP, masque, passerelle, DNS, nom d’hôte, Wi-Fi et état de connexion.

Sur Tasmota, les valeurs affichées correspondent généralement aux informations remontées par le firmware et restent cohérentes avec la page web intégrée.

Sur OpenBeken, il faut être plus vigilant : la page web du firmware et les informations de statut peuvent ne pas provenir exactement du même bloc de données. Cela peut créer des écarts visibles, notamment sur la passerelle et le DNS.

Si l’onglet Réseau affiche une passerelle ou un DNS différent de la page web OpenBeken, il faut considérer cela comme un point de vigilance firmware plutôt que comme une erreur de saisie dans Jeedom.

MQTT

L’onglet MQTT permet de gérer l’intégration du périphérique avec le broker MQTT : hôte, port, identifiant client, nom de base, utilisateur, mot de passe et paramètres de publication.

Cet onglet est important pour trois raisons :

il sert à vérifier que le plugin parle au bon broker,
il permet d’identifier le topic de base réellement utilisé,
il aide à diagnostiquer les équipements qui publient bien sur le réseau mais restent mal synchronisés dans Jeedom.

Sur OpenBeken, certains champs MQTT peuvent être plus difficiles à fiabiliser que sur Tasmota si le firmware renvoie des informations différentes entre sa page web et son statut interne. C’est particulièrement vrai lorsqu’une valeur semble correcte dans l’interface OpenBeken mais différente dans le bloc de statut lu par le plugin.

En pratique, si le broker, le topic ou le statut MQTT semblent incohérents, il faut comparer :

la page web du firmware,
le contenu affiché dans Jeedom,
le retour brut des commandes de diagnostic.

Commandes Tasmota / OpenBeken

Cet onglet est la console de commande avancée. Il sert à envoyer des commandes brutes au périphérique, à tester une syntaxe et à lire immédiatement le résultat renvoyé par le firmware.

Il permet notamment de :

lancer des commandes courtes,
enchaîner plusieurs instructions,
consulter l’historique,
filtrer les commandes disponibles,
vérifier le comportement d’un périphérique avant de l’intégrer dans un scénario.

Quand un appareil OpenBeken est détecté, le libellé devient Commandes OpenBeken pour garder une lecture cohérente avec le firmware.

Exemples courants :

Power1 ON
Status 0
Backlog cmd1; cmd2

Firmware

L’onglet Firmware permet :

d’afficher la version installée,
de récupérer les versions Tasmota stable et development en ligne,
de comparer la version installée avec le canal sélectionné,
d’indiquer si une mise à jour est disponible,
d’ouvrir le changelog ou les notes de version,
de choisir un firmware prédéfini compatible avec le chip détecté,
de basculer entre firmwares officiels stable et development,
d’utiliser les firmwares Jason2866 lorsque disponibles,
de flasher un équipement ou tout un groupe.

Règles

L’onglet Règles sert à lire et modifier les règles natives du firmware lorsqu’elles sont disponibles.

Il permet de gérer :

l’état de la règle,
la désactivation temporaire,
le mode Once,
le contenu de la règle elle-même.

Timers

L’onglet Timers permet de visualiser et modifier les minuteries internes du firmware.

Il est utile pour les automatisations simples qui doivent s’exécuter sans passer par Jeedom.

Fichiers

L’onglet Fichiers donne accès au système de fichiers du périphérique.

Il sert à :

lire un fichier,
éditer un fichier,
téléverser un contenu,
supprimer des fichiers inutiles,
préparer des scripts ou des configurations avancées.

Options

Cet onglet regroupe les options de comportement du firmware, de type SetOptions Tasmota.

Il permet d’activer ou de désactiver des fonctionnalités sans passer par des commandes brutes.

Flags OpenBeken

Cet onglet est spécifique aux appareils OpenBeken compatibles.

Il permet de lire et modifier les flags du firmware, avec une présentation inspirée des options Tasmota. C’est utile pour régler des comportements avancés sans passer par des commandes manuelles.

Sauvegarde

Le plugin propose :

sauvegarde manuelle de configuration Tasmota,
sauvegarde planifiée configurable,
rétention locale par appareil,
comparaison de sauvegardes,
décodage des sauvegardes Tasmota pour comparer les valeurs de configuration lorsque les fichiers diffèrent.

Modèles / Modules

Cet onglet permet de choisir ou modifier le modèle matériel de l’équipement.

Il s’adresse surtout aux utilisateurs avancés qui veulent ajuster le mapping des broches ou personnaliser la structure du module.

Notes importantes sur OpenBeken

OpenBeken ne présente pas toujours les mêmes blocs d’informations entre :

la page web du firmware,
les statuts internes,
et les données exploitées par l’intégration Jeedom.

Le cas le plus visible concerne la page Réseau et la configuration MQTT :

la page web peut afficher des valeurs correctes,
alors que le statut lu par le plugin peut montrer une passerelle ou un DNS différent,
ou un bloc MQTT qui ne reflète pas exactement la même structure.

Dans ce cas, la bonne approche consiste à comparer la page web OpenBeken, la console de commande et les données remontées dans Jeedom afin d’identifier la source de vérité réellement exposée par le firmware.