Introduction

Les appareils exécutant le firmware Tasmota, conçu pour les microcontrôleurs ESP8266 et ESP32, utilisent couramment le protocole MQTT pour communiquer dans les écosystèmes domotiques. Cependant, les problèmes de connexion MQTT sont fréquents et peuvent perturber la communication. Ce guide explore les causes possibles et fournit des méthodes de résolution systématiques.

Fonctionnement de base de la connexion MQTT

MQTT permet aux appareils Tasmota d'envoyer des états et de recevoir des commandes via un serveur centralisé (broker). Dans le firmware, le délai entre les tentatives de reconnexion est défini par une constante dans le fichier source tasmota.h :

const uint8_t INTERVALLE_RECONNEXION = 15; // Secondes entre chaque tentative de reconnexion MQTT

Ce paramètre influence la réactivité de l'appareil en cas d'échec.

Classification des erreurs courantes

Les défaillances se manifestent principalement sous trois formes, chacune nécessitant une approche diagnostique distincte.

Échec de connexion (Timeout)

Si l'appareil ne parvient pas à établir une connexion TCP avec le broker, cela indique un problème réseau ou serveur. Vérifiez l'acccessibilité via la console Tasmota :

ping serveur-mqtt.example.com

Erreur d'authentification

Une configuration incorrecte des identifiants (nom d'utilisateur/mot de passe) entraîne un rejet par le broker. Contrôlez les paramètres dans l'interface web sous "Configuration" → "MQTT".

Problèmes de certificat TLS/SSL

Lorsque l'utilisation de TLS est activée, une incompatibilité des certificats peut bloquer la connexion. Cette fonctionnalité est activée via une directive dans tasmota_configurations.h :

#define ACTIVER_MQTT_TLS // Active TLS pour la connexion MQTT

Diagnostic des problèmes réseau

Les conditions réseau défavorables sont une cause majeure d'échec. Une vérification méthodique est nécessaire.

Qualité du signal WiFi

Un signal faible peut interrompre la communication. Interrogez l'état WiFi de l'appareil via la commande :

status 5

La sortie inclut des détails comme la puissance du signal (champ PuissanceWifi) et l'adresse IP.

Accessibilité des ports

Le broker MQTT écoute typiquement sur le port 1883 (non chiffré) ou 8883 (chiffré). Testez la connectivité avec un outil tel que netcat :

nc -zv serveur-mqtt.example.com 1883

Si le test échoue, vérifiez les règles de pare-feu ou les politiques réseau.

Paramétrage du serveur MQTT

Des erreurs de configuration côté serveur peuvent aussi causer des défaillances.

Précision de l'adresse et du port

Dans l'interface Tasmota, assurez-vous que les champs "Hôte MQTT" et "Port MQTT" sont corrects. Si un nom de domaine pose problème, essayez d'utiliser directement l'adresse IP du serveur.

Validation des identifiants

Confirmez que le nom d'utilisateur et le mot de passe correspondent aux attentes du broker. Certains serveurs comme Mosquitto permettent des connexions anonymes, mais l'authentification est recommandée pour la sécurité.

Limites de connexion

Certains brokers imposent des restrictions sur le nombre de connexions simultanées. Analysez les journaux serveur pour détecter d'éventuels rejets dus à ces limites.

Optimisation de la configuration Tasmota

Des ajustements sur l'appareil peuvent améliorer la stabilité de la connexion MQTT.

Ajustement des paramètres de reconnexion

Plusieurs commandes Tasmota permettent d'affiner le comportement de la connexion :

• SetOption140 1 : Active les sessions MQTT persistantes, utile pour maintenir les abonnements après une reconnexion.
• MqttTimeout 600 : Définit le délai d'attente pour une connexion MQTT à 600 millisecondes.

Mise à jour du firmware

Des versions récentes de Tasmota corrigent souvent des bugs liés à MQTT. Utilisez la commande suivante pour une mise à jour via OTA :

Upgrade 1

Dépannage avancé

Si les solutions précédentes échouent, des méthodes plus profondes peuvent être employées.

Analyse des journaux détaillés

Activez un niveau de journalisation élevé pour observer le processus de connexion MQTT :

LogLevel 4
MqttLog 4

Cherchez les lignes contenant "MQTT" dans les journaux. Par exemple, un message comme MQTT: Échec de connexion vers broker.exemple.com:1883, code retour -2. Nouvelle tentative dans 15 s indique un timeout.

Capture de trafic réseau

Outils comme Wireshark peuvent capturer les échanges entre l'appareil et le broker. Appliquez un filtre pour cibler le trafic MQTT :

tcp port 1883 or tcp port 8883

Réinitialisation de la configuration

En dernier recours, une réinitialisation aux paramètres d'usine peut résoudre des corruptions de configuration. Sauvegardez d'abord les paramètres actuels :

Backup
Reset 1

Reconfigurez ensuite les paramètres MQTT.

Scénarios typiques et solutions

Cas d'une vérification de certificat échouée

Symptôme : Avec TLS activé, les tentatives de connexion échouent répétitivement. Les journaux mentionnent une erreur de certificat.
Solution : Vérifiez la correspondance des certificats. Pour les tests, désactivez temporairement la vérification :

SetOption132 1

Cas d'une instabilité réseau

Symptôme : L'appareil se déconnecte fréquemment.
Solution : Améliorez la couverture WiFi ou activez le keep-alive MQTT :

SetOption3 1

Bonnes pratiques pour la prévention

• Maintenez le firmware Tasmota à jour et sauvegardez régulièrement la configuration.
• Surveillez l'état des connexions via des outils de monitoring.
• Utilisez des adresses IP fixes pour les appareils afin d'éviter les changements d'adressage.
• Configurez le broker MQTT avec des timeouts et des politiques de reconnexion adaptées.