MQTT expliqué simplement : installez Mosquitto et envoyez des données depuis votre ESP32
Ce qu’est MQTT et pourquoi tout l’IoT l’utilise, comment installer le broker Mosquitto sous Windows ou Linux, et comment publier des données et recevoir des ordres avec un ESP32.
Leer en español →Certains liens de cet article sont des liens affiliés : si vous achetez via ces liens, BeInTech reçoit une petite commission sans surcoût pour vous. C’est ce qui fait vivre le blog.
Dès que l’on s’intéresse à l’IoT ou à la domotique, on entend parler de MQTT en permanence : Home Assistant, Zigbee2MQTT, Tasmota, ESPHome et presque tous les capteurs connectés l’utilisent. Dans ce guide, vous allez comprendre son fonctionnement en 5 minutes, monter votre propre serveur avec Mosquitto et faire en sorte qu’un ESP32 envoie des données et reçoive des ordres.
Qu’est-ce que MQTT (sans jargon)
MQTT est un protocole de messagerie très léger, conçu pour les petits appareils et les réseaux peu fiables. Il fonctionne comme un panneau d’affichage :
- Le broker est le panneau : un serveur qui reçoit tous les messages et les redistribue. Le plus utilisé est Mosquitto.
- Les appareils publient des messages sur un sujet (topic), par exemple
maison/salon/temperature. - Tous ceux qui sont abonnés à ce sujet reçoivent le message instantanément.
L’essentiel : l’émetteur et le récepteur ne se connaissent pas. Le capteur du salon ne sait pas si ses données sont lues par Home Assistant, une appli mobile ou un script Python. Il ne parle qu’au broker. C’est pour cela qu’il est si simple d’ajouter des appareils.
Les sujets (topics)
Les sujets sont des chemins séparés par des /, que vous organisez comme vous voulez :
maison/salon/temperature
maison/salon/humidite
maison/cuisine/lumiere/set
maison/cuisine/lumiere/etat
Lors de l’abonnement, vous pouvez utiliser des jokers :
+remplace un niveau :maison/+/temperaturereçoit la température de toutes les pièces.#remplace tout ce qui suit :maison/#reçoit absolument tout ce qui concerne la maison.
Trois notions que vous rencontrerez
- QoS (qualité de service) :
0= envoyé une fois sans vérification ;1= livraison garantie au moins une fois ;2= exactement une fois. Pour des capteurs, QoS 0 ou 1 suffit. - Retain (message retenu) : le broker garde le dernier message du sujet et le transmet à quiconque s’abonne plus tard. Pratique pour les états (la lumière est allumée).
- Last Will (dernière volonté) : un message que le broker publie automatiquement si l’appareil se déconnecte brutalement, par exemple
offline. Vous savez ainsi si un capteur est tombé.
Étape 1 : installez Mosquitto
Sous Linux ou Raspberry Pi
sudo apt update
sudo apt install mosquitto mosquitto-clients
sudo systemctl enable --now mosquitto
Sous Windows
Téléchargez l’installateur depuis le site officiel (mosquitto.org, rubrique Download) et installez-le avec les options par défaut. Il s’installe dans C:\Program Files\mosquitto en tant que service Windows.
Autorisez les connexions depuis le réseau
Depuis la version 2, Mosquitto n’accepte par sécurité que les connexions venant de l’ordinateur lui-même. Pour que l’ESP32 puisse se connecter, modifiez le fichier de configuration (/etc/mosquitto/conf.d/beintech.conf sous Linux, ou mosquitto.conf dans le dossier d’installation sous Windows) et ajoutez :
listener 1883
allow_anonymous true
Redémarrez le service (sudo systemctl restart mosquitto sous Linux, ou via Services sous Windows). Sous Windows, acceptez l’alerte du pare-feu ou ouvrez le port 1883 pour le réseau privé.
Cette configuration sert uniquement aux tests sur votre réseau local. Je vous explique plus bas comment ajouter un identifiant et un mot de passe. N’ouvrez jamais le port 1883 vers Internet sur votre box.
Étape 2 : vérifiez que tout fonctionne
Ouvrez deux terminaux. Dans le premier, abonnez-vous à tout ce qui concerne la maison :
mosquitto_sub -h localhost -t "maison/#" -v
Dans le second, publiez un message :
mosquitto_pub -h localhost -t "maison/salon/temperature" -m "21.5"
Le premier terminal affiche maison/salon/temperature 21.5. Votre broker fonctionne. Laissez le premier terminal ouvert : il vous servira à voir ce qu’envoie l’ESP32.
Notez aussi l’adresse IP de l’ordinateur qui héberge Mosquitto (commande ipconfig sous Windows, hostname -I sous Linux). Vous en aurez besoin pour l’ESP32.
Étape 3 : l’ESP32 publie des données
Nous reprenons le montage de la station météo avec BME280. Installez dans l’Arduino IDE la bibliothèque PubSubClient (de Nick O’Leary) depuis le Gestionnaire de bibliothèques.
Ce programme publie la température, l’humidité et la pression toutes les 30 secondes, et écoute des ordres pour allumer ou éteindre la LED de la carte :
#include <WiFi.h>
#include <PubSubClient.h>
#include <Wire.h>
#include <Adafruit_BME280.h>
const char* WIFI_SSID = "NOM_DE_VOTRE_WIFI";
const char* WIFI_PASS = "VOTRE_MOT_DE_PASSE";
const char* MQTT_SERVER = "192.168.1.10"; // IP de l'ordinateur avec Mosquitto
const int MQTT_PORT = 1883;
const char* CLIENT_ID = "esp32-salon";
const int LED_PIN = 2;
const uint8_t BME_ADDR = 0x76;
WiFiClient wifiClient;
PubSubClient mqtt(wifiClient);
Adafruit_BME280 bme;
unsigned long dernierEnvoi = 0;
// Appelee a chaque message recu sur un sujet auquel on est abonne
void messageRecu(char* topic, byte* payload, unsigned int length) {
String message;
for (unsigned int i = 0; i < length; i++) message += (char)payload[i];
Serial.printf("Recu [%s] : %s\n", topic, message.c_str());
if (String(topic) == "maison/salon/led/set") {
bool allumer = (message == "ON");
digitalWrite(LED_PIN, allumer ? HIGH : LOW);
mqtt.publish("maison/salon/led/etat", allumer ? "ON" : "OFF", true);
}
}
void connecterMQTT() {
while (!mqtt.connected()) {
Serial.print("Connexion MQTT... ");
// Derniere volonte : en cas de deconnexion brutale, le broker publie "offline"
if (mqtt.connect(CLIENT_ID, "maison/salon/etat", 1, true, "offline")) {
Serial.println("OK");
mqtt.publish("maison/salon/etat", "online", true);
mqtt.subscribe("maison/salon/led/set");
} else {
Serial.printf("echec (rc=%d). Nouvel essai dans 5 s\n", mqtt.state());
delay(5000);
}
}
}
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
if (!bme.begin(BME_ADDR)) {
Serial.println("BME280 introuvable");
while (true) delay(1000);
}
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASS);
while (WiFi.status() != WL_CONNECTED) delay(500);
Serial.print("Wi-Fi OK, IP : ");
Serial.println(WiFi.localIP());
mqtt.setServer(MQTT_SERVER, MQTT_PORT);
mqtt.setCallback(messageRecu);
}
void loop() {
if (!mqtt.connected()) connecterMQTT();
mqtt.loop(); // indispensable : traite les messages entrants et maintient la connexion
if (millis() - dernierEnvoi > 30000 || dernierEnvoi == 0) {
dernierEnvoi = millis();
char valeur[16];
snprintf(valeur, sizeof(valeur), "%.1f", bme.readTemperature());
mqtt.publish("maison/salon/temperature", valeur);
snprintf(valeur, sizeof(valeur), "%.1f", bme.readHumidity());
mqtt.publish("maison/salon/humidite", valeur);
snprintf(valeur, sizeof(valeur), "%.1f", bme.readPressure() / 100.0F);
mqtt.publish("maison/salon/pression", valeur);
Serial.println("Donnees publiees");
}
}
Modifiez l’IP dans MQTT_SERVER, téléversez le programme et regardez le terminal où tourne mosquitto_sub. Les données arrivent :
maison/salon/etat online
maison/salon/temperature 22.3
maison/salon/humidite 48.1
maison/salon/pression 1012.7
Étape 4 : pilotez l’ESP32 depuis l’ordinateur
Maintenant, dans l’autre sens. Depuis un terminal, envoyez :
mosquitto_pub -h localhost -t "maison/salon/led/set" -m "ON"
La LED de la carte s’allume, et l’ESP32 le confirme avec maison/salon/led/etat ON. Envoyez OFF pour l’éteindre. Remplacez la LED par un relais, et vous pilotez déjà une prise depuis le réseau.
Remarquez le principe : un sujet /set pour donner des ordres et un autre /etat pour indiquer l’état réel. C’est la convention utilisée par presque tout le monde, et celle qu’attend Home Assistant.
Étape 5 : protégez votre broker par mot de passe
Une fois que tout fonctionne, désactivez l’accès anonyme. Sous Linux :
sudo mosquitto_passwd -c /etc/mosquitto/passwd esp32
Un mot de passe vous sera demandé. Remplacez ensuite la configuration par :
listener 1883
allow_anonymous false
password_file /etc/mosquitto/passwd
Redémarrez Mosquitto et, dans le code de l’ESP32, connectez-vous avec l’identifiant et le mot de passe :
mqtt.connect(CLIENT_ID, "esp32", "VOTRE_MOT_DE_PASSE_MQTT",
"maison/salon/etat", 1, true, "offline");
Les outils en ligne de commande en auront aussi besoin : ajoutez -u esp32 -P VOTRE_MOT_DE_PASSE_MQTT à mosquitto_sub et mosquitto_pub.
Erreurs courantes
| Erreur | Cause probable |
|---|---|
rc=-2 sur l’ESP32 |
Le broker est injoignable : mauvaise IP, Mosquitto n’écoute qu’en local ou le pare-feu bloque le port 1883 |
rc=5 |
Identifiant ou mot de passe incorrect (ou allow_anonymous true manquant) |
| Connexions et déconnexions en boucle | Deux appareils avec le même CLIENT_ID : chacun doit avoir le sien |
| Les messages entrants n’arrivent pas | L’appel à mqtt.loop() manque dans loop() |
Et ensuite ?
Vous avez maintenant un vrai système IoT : des capteurs qui publient des données et des actionneurs qui obéissent aux ordres, le tout via votre propre broker. L’étape logique suivante est de relier cela à Home Assistant pour obtenir des graphiques, un tableau de bord sur mobile et des automatisations du type si l’humidité dépasse 70 %, allume le déshumidificateur.
Si vous voulez un serveur dédié pour Mosquitto et Home Assistant, toujours allumé et peu gourmand, le Raspberry Pi est l’option la plus populaire :
Raspberry Pi 5 (4 Go)
Suffisant pour faire tourner Mosquitto, Home Assistant et Zigbee2MQTT en même temps. Ajoutez une alimentation officielle et une bonne carte microSD ou un SSD.