Dans le monde de la domotique DIY, l’ESP8266 est devenu un incontournable. Couplé au firmware ESPeasy, il permet de transformer un petit module Wi-Fi en capteur connecté ou en actionneur, le tout avec peu de lignes de code. Et lorsqu’on l’intègre avec Jeedom via le protocole MQTT, la magie opère : communication bidirectionnelle en temps réel, faible latence, fiabilité.

Ce tutoriel pas à pas vous guide dans l’intégration d’un ESP8266 sous ESPeasy avec Jeedom, en utilisant MQTT comme passerelle de communication.

Prérequis

Avant de commencer, voici le matériel et les logiciels nécessaires :

Matériel

  • Un module ESP8266 (type NodeMCU ou Wemos D1 mini)

  • Un câble micro USB

  • Un capteur (DHT22, DS18B20, etc. selon vos besoins)

  • Un serveur Jeedom (Raspberry Pi, mini PC, etc.)

Logiciels

  • Firmware ESPeasy (https://www.letscontrolit.com)

  • Mosquitto installé sur Jeedom (ou broker MQTT local)

  • Plugin MQTT ou JMQTT installé et configuré sur Jeedom

  • ESPEasy Flasher ou un outil de flash (ESPHome Flasher, etc.)

Étape 1 – Flasher ESPeasy sur votre ESP8266

  1. Téléchargez la dernière version d’ESPeasy sur le site officiel :
    https://www.letscontrolit.com/wiki/index.php/ESPEasy

  2. Branchez votre ESP8266 via USB à votre PC.

  3. Lancez ESP Easy Flasher, sélectionnez le port COM et le fichier .bin.

  4. Flashez le firmware.

  5. Une fois le flash terminé, redémarrez l’ESP. Il va créer un point Wi-Fi temporaire (SSID : ESP_Easy_XXXX).

  6. Connectez-vous à ce Wi-Fi, accédez à la page de configuration : 192.168.4.1.

  7. Entrez les paramètres de votre Wi-Fi domestique. L’ESP redémarre et se connecte à votre réseau.

Étape 2 – Configurer le firmware ESPeasy

  1. Accédez à l’interface Web d’ESPeasy depuis votre navigateur (adresse IP obtenue via votre box ou appli type Fing).

  2. Allez dans “Controllers” et ajoutez un nouveau contrôleur :

    • Type : OpenHAB MQTT

    • Enable : coché

    • Controller IP : IP de votre broker MQTT (souvent 127.0.0.1 sur Jeedom ou IP réseau du Raspberry)

    • Port : 1883 (par défaut)

    • Controller Subscribe : %sysname%/#

    • Controller Publish : %sysname%/%tskname%/%valname%

  3. Sauvegardez.

  4. Ensuite, configurez un device (dans l’onglet “Devices”) :

    • Choisissez le type de capteur branché (par ex. “DHT11/22” pour un capteur température/humidité)

    • Nommez le device

    • Configurez le GPIO utilisé

    • Activez le device

À ce stade, l’ESP8266 commence à publier les données sur le topic MQTT.

Étape 3 – Installer et configurer Mosquitto sur Jeedom

Si vous n’avez pas encore de broker MQTT, voici comment installer Mosquitto sur votre Jeedom (Debian) :

bash
sudo apt update
sudo apt install mosquitto mosquitto-clients

Le service se lance automatiquement sur le port 1883.

Vous pouvez tester avec cette commande :

bash
mosquitto_sub -v -t "#"

Cela affichera tous les messages MQTT circulant sur votre réseau. Allumez votre ESP et vous verrez les messages s’afficher.

Étape 4 – Configurer le plugin JMQTT dans Jeedom

  1. Depuis l’interface Jeedom, allez dans Plugins > Protocole domotique > JMQTT.

  2. Cliquez sur “Ajouter un broker” :

    • Nom : Mosquitto

    • Adresse IP : 127.0.0.1 (ou IP réseau du broker)

    • Port : 1883

    • QoS : 1

    • Aucun identifiant/mot de passe si non activé

  3. Activez la découverte automatique des topics.

  4. Redémarrez votre ESP ou déclenchez une lecture de capteur.

  5. Jeedom détecte automatiquement les topics MQTT publiés par l’ESP.

  6. Créez des commandes à partir des topics détectés (température, humidité, etc.)

Étape 5 – Créer un scénario ou dashboard

Maintenant que les données sont bien remontées dans Jeedom, vous pouvez :

  • Les afficher sur un dashboard

  • Créer des scénarios (ex : activer un relais si température > 30°C)

  • Historiser les données

  • Les envoyer vers un système externe (InfluxDB, Grafana, etc.)

Étape 6 – Interaction bidirectionnelle

L’un des gros avantages du MQTT est la communication bidirectionnelle.

Vous pouvez envoyer un message MQTT depuis Jeedom pour agir sur l’ESP (ex : activer un relais).
Pour cela :

  1. Ajoutez une commande action MQTT dans JMQTT.

  2. Le topic doit correspondre à un subscribe configuré dans ESPEasy (par défaut %sysname%/cmd).

  3. La valeur envoyée sera traitée par l’ESP (ex : gpio,12,1 pour allumer un relais sur GPIO12).

Conclusion

Grâce à ESPEasy et MQTT, votre ESP8266 devient un véritable périphérique domotique connecté à Jeedom. L’intégration est fluide, modulable et robuste. Que ce soit pour lire des capteurs ou piloter des actionneurs, cette solution DIY est idéale pour débuter dans l’univers de la maison intelligente.