ESP Easy intègre plusieurs protocoles de communication par défaut dont plusieurs basées sur MQTT (Domoticz MQTT, OpenHAB MQTT et PiDome MQTT). Ces protocoles sont très axés “serveurs domotiques”. Si vous développé vos propres applications (domotique ou autres) avec Node-RED, nous allons voir comment communiquer avec des objets connectés développés avec des ESP8266 et ESP Easy. MQTT permet de communiquer de manière bi-directionnelle entre les deux plateformes. Cela va permettre de récupérer des mesures ou de connaître des états mais également piloter le GPIO des cartes ESP8266.
Sommaire
- 1 Configuration utilisée
- 2 Configuration ESP Easy
- 3 Domoticz, OpenHAB, PiDome : quelles différences ?
- 4 Modifier le masque de publication (Publish Template) :
- 5 La communication est-elle sécurisée ?
- 6 Créer son propre protocole
- 7 Récupérer et traiter les messages MQTT sous Node-RED
- 8 Piloter le GPIO depuis Node-RED (relai, led, Sonof…)
- 9 Un Dashboard Node-RED pour vos objets ESP Easy
- 10 Tous les capteurs et actionneurs compatibles avec ESP Easy
Configuration utilisée
Version ESP Easy utilisée : R120 (le tutoriel pour découvrir le framework)
Broker MQTT : Mosquitto (le tutoriel pour l’installation et les premiers pas)
 |
Module ESP8266 ESP-12. Par exemple Wemos D1 Mini |
 |
Alimentation 5/3A micro-usb |
 |
Capteur de température et d’humidité
DHT11 ou DHT22 |
 |
Ou Shield DHT22 pour Wemos D1 Mini |
Configuration ESP Easy
Donnez un nom à l’appareil (ici esp001). Ce sera “l’entête” du Topic.
Le device porte le nom DHT22. Deux variables sont publiées (temperature et humidity). Elles seront utilisées pour construire le Topic MQTT. Inutile mais obligatoire, il faut indiquer un IDX différent de 0. Sur le shield DHT22, on récupère les mesures sur le GPIO2.
Domoticz, OpenHAB, PiDome : quelles différences ?
ESPEasy nous propose dans la version R120 trois configurations MQTT différentes. Elles sont adaptées pour communiquer avec les logiciels domotiques Domoticz, OpenHAB et PiDome. La différence réside dans la forme des topics publiés et souscrits. Voici un tableau récapitulatif et un exemple publié par ESP Easy.
| Protocole | Forme du topic publié
(publish) |
Exemple |
| Domoticz MQTT | domoticz/in | domoticz/in {“idx”:1,”nvalue”:0,”svalue”:”22.00;38.40;0″} |
| OpenHAB MQTT | /%sysname%/%tskname%/%valname% | /esp001/DHT22/temperature 22.00 /esp001/DHT22/humidity 38.40 |
| PiDome MQTT | /hooks/devices/%id%/SensorData/%valname% | /hooks/devices/1/SensorData/temperature 22.00 /hooks/devices/1/SensorData/humidity 38.40 |
Comme vous pouvez le constater, il sera bien plus facile de traiter les messages basés sur le protocole OpenHAB MQTT ou PiDome MQTT car ESP Easy publie un topic pour chaque variable. Mais le plus facile à utiliser et sans contest OpenHAB MQTT qui identifie très clairement l’objet ESP Easy, le device et la variable.
Modifier le masque de publication (Publish Template) :
Si le masque ne vous convient pas our que vous souhaitez le standardiser pour le rendre identique à d’autres projets, rien ne nous empêche de modifier le masque. Pour cela, il suffit de vous rendre dans l’onglet Tools puis Advanced.
- Subscribe Template : masque du message en provenance du Broker MQTT, donc en provenance de Node-RED (ou autre)
- Publish Template : masque de publication des messages vers le broker MQTT
- Message Delay : c’est également ici que l’on va pouvoir régler la fréquence de publication des messages (en milli-secondes).
Attention toutefois. Les modifications apportées au Template ne sont pas enregistrées. Si vous changez pour n’importe quelle raison le protocole de communication, le Template créé sera ré-initialisé par celui par défaut d’ESP Easy. C’est dommage mais c’est bon à savoir.
La communication est-elle sécurisée ?
Absolument pas. Tous les messages sont envoyés en clair, aucune sécurité n’est prise en charge du coté d’ESP Easy. Ce n’est pas très gênant si l’objet est une sonde de température, par contre ça pourrait vite devenir un problème si c’est une commande d’ouverture de porte ou du portail de votre domicile ! Par contre, il est possible de sécuriser le Broker MQT, ESP Easy intégrant l’authentification par mot de passe.
Créer son propre protocole
Si décidément vous n’avez pas trouvé votre bonheur, (vous avez besoin de sécuriser la communication) vous pouvez suivre ce tutoriel et créer un nouveau protocole. C’est assez simple à faire en partant d’un module existant.
Récupérer et traiter les messages MQTT sous Node-RED
Pour ce tutoriel, j’ai donc opté pour le protocole OpenHAB qui est très facile à traiter sous Node-RED car les variables sont bien distincts. Node-RED gère nativement le protocole MQTT, il n’y a donc aucun plugin à installer. Faites une recherche dans les Nodes pour les trouver.
Si toutefois le module n’est pas dans la liste, allez vérifier que le Node est bien activé depuis le gestionnaire de palette (si besoin un tutoriel pour découvrir comment gérer les modules Node-RED).
Placez un noeud MQTT in sur le flow et ouvrez la fenêtre de configuration. Commencez par définir le serveur en cliquant sur le crayon à droite de server.
Si Node-RED et Mosquitto sont installés sur la même machine, indiquez localhost dans le champ sinon, indiquez l’adresse IP du Broker MQTT. Idem pour le port qui par défaut est 1883.
Validez. De retour à la fenêtre précédente, choisissez le serveur dans la liste puis indiquez le Topic. Ici, nous allons récupérer la température en provenance du DHT22 du Shield Wemos D1 Mini sur le topic /esp001/DHT22/temperature .
Remarque. Il ne faut pas oublier le ‘/’ au début du Topic
Conseil. Si vous avez beaucoup de topics, le mieux est de donner au Node le nom du topic.
Validez. Branchez un Node de Debug et publiez le flow. Ouvrez l’onglet Debug, les premières valeurs ne vont pas tarder à arriver (en fonction de la fréquence de publication configurée sur l’objet ESP Easy).
Et voilà !
Piloter le GPIO depuis Node-RED (relai, led, Sonof…)
C’est bien de pouvoir recevoir des données depuis un objet connecté ESP Easy, mais c’est encore mieux si on peut piloter le GPIO (entrées / sorties). Avec le protocole OpenHAB, ESP Easy attend un message de la forme /nom_device/commande.
Dans ce tutoriel, nous avions vu comment piloter le GPIO depuis Jeedom, on va appliquer la même méthode avec le protocole MQTT sous Node-RED.
Ajoutez un node MQTT out sur le flow et ouvrez la fenêtre de réglage. Choisissez le Broker sur lequel seront envoyés les messages. Le topic doit être de la forme /nom_device/gpio/numero_gpio . Le contenu du message devra être 1 (On) ou 0 (Off). On peut également piloter les sorties pwm. Dans ce cas, il suffit de remplacer gpio par pwm dans le topic précédent.
Il ne reste plus qu’à piloter la sortie. Pour ça, rien de mieux que de créer un Dashboard.
Remarque. Durant l’écriture de ce tutoriel, le GPIO ne répondait pas aux messages MQTT. Après avoir débranché la Wemos D1 Mini, tout est rentré dans l’autre. En fait le problème semble survenir lorsqu’on publie un message directement avec la commande mosquitto_pub.
Un Dashboard Node-RED pour vos objets ESP Easy
Dans les tutoriels précédents, nous avons vu comment créer un Dashboard à un projet Node-RED. C’est l’occasion de tester sur un objet ESP Easy. Ici, nous n’allons pas refaire les tutoriels précédents (partie 1 – ajouter un dashboard, partie 2 – ajouter des graphiques). Placez deux gauges et connectez chacune à un topic (température / humidité).
Placez ensuite un interrupteur (switch). Ouvrez les réglages et modifiez le type de sortie en numérique. Pour On payload, indiquez 1 et 0 pour Off payload. Reliez le switch au node MQTT out créé précédemment.
Voici le flow obtenu
Et le code du flow qu’il vous suffit d’importer
[{"id":"ead26598.68ece8","type":"mqtt in","z":"f725662f.6dde08","name":"/esp001/DHT22/temperature","topic":"/esp001/DHT22/temperature","qos":"2","broker":"f9d88ab3.7054b8","x":180,"y":100,"wires":[["fc102c9f.55303"]]},{"id":"fc102c9f.55303","type":"ui_gauge","z":"f725662f.6dde08","name":"Gauge : Température","group":"4a05f42b.44c96c","order":0,"width":0,"height":0,"gtype":"gage","title":"Température DHT22","label":"ESP Easy - MQTT","format":"{{value}}°C","min":0,"max":"50","colors":["#66ccff","#ff8000","#ca3838"],"x":440,"y":100,"wires":[]},{"id":"10194e45.fa8972","type":"mqtt in","z":"f725662f.6dde08","name":"/esp001/DHT22/humidity","topic":"/esp001/DHT22/humidity","qos":"2","broker":"f9d88ab3.7054b8","x":170,"y":160,"wires":[["3589c685.9054da"]]},{"id":"3589c685.9054da","type":"ui_gauge","z":"f725662f.6dde08","name":"Gauge : Humidité","group":"4a05f42b.44c96c","order":0,"width":0,"height":0,"gtype":"gage","title":"Humidité DHT22","label":"ESP Easy - MQTT","format":"{{value}}°C","min":0,"max":"50","colors":["#66ccff","#ff8000","#ca3838"],"x":450,"y":160,"wires":[]},{"id":"b722e79d.b0da18","type":"ui_switch","z":"f725662f.6dde08","name":"GPIO 12","label":"GPIO 12","group":"4a05f42b.44c96c","order":0,"width":0,"height":0,"passthru":true,"topic":"","style":"","onvalue":"1","onvalueType":"num","onicon":"","oncolor":"","offvalue":"0","offvalueType":"num","officon":"","offcolor":"","x":220,"y":220,"wires":[["16383035.ed5a3"]]},{"id":"16383035.ed5a3","type":"mqtt out","z":"f725662f.6dde08","name":"/esp001/gpio/12","topic":"/esp001/gpio/12","qos":"","retain":"","broker":"f9d88ab3.7054b8","x":460,"y":220,"wires":[]},{"id":"f9d88ab3.7054b8","type":"mqtt-broker","z":"","broker":"localhost","port":"1883","clientid":"","usetls":false,"compatmode":true,"keepalive":"60","cleansession":true,"willTopic":"","willQos":"0","willPayload":"","birthTopic":"","birthQos":"0","birthPayload":""},{"id":"4a05f42b.44c96c","type":"ui_group","z":"","name":"ESP Easy + MQTT + Node-RED","tab":"cc4c9cae.cfb85","order":1,"disp":true,"width":"6"},{"id":"cc4c9cae.cfb85","type":"ui_tab","z":"","name":"ESP Easy","icon":"dashboard"}]
Déployez le flow et ouvrez une nouvelle fenêtre dans le navigateur à l’adresse http://localhost:1880/ui
Et voilà, vous récupérez maintenant les mesures du DHT22 et vous pouvez activer ou désactiver le GPIO12 (broche D6 sur la Wemos D1 Mini) !
Tous les capteurs et actionneurs compatibles avec ESP Easy
AliExpress
AliExpress
AliExpress
AliExpress
Banggood
AliExpress
AliExpress
AliExpress
AliExpress
AliExpress
AliExpress
AliExpress
AliExpress
AliExpress
- Compiler et installer facilement ESP Easy R120 ou Mega v2 avec PlatformIO [MàJ]
- Le firmware ESP Easy Mega arrive sur ESP32, test sur la Wemos LoLin32 Lite, nouveautés du firmware
- #Hack : prise connectée SONOFF S20 pour en faire un super smart plug avec ESP Easy
- ESP Easy : flasher le firmware avec esptool.py sur ESP8266 (GitHub)
- Domoticz : script Lua pour créer un affichage déporté OLED avec ESP Easy
- ESP Easy (Rules) : consigne pour thermostat connecté (Jeedom, Domoticz, Node-RED…)
![#Guide : quel ESP32 choisir pour développer des objets connectés DIY en 2019 [MàJ]](https://projetsdiy.fr/wp-content/uploads/thumbs_dir/ttgo-esp32-wrover-camera-o7gpxzplpusdf084nslo7xmltq559mr775od541dg4.jpg)
Parfait, merci pour tes tutos. Faut que j’évite de bosser la nuit, j’ai mis du temps à trouver à quoi correspondait l’IP du controller, c’est doncl’IP où est installé Mosquitto, …. Par contre, une chose étonnante chez moi, avant d’avoir mis l’adresse de mon raspberry, j’avais dans device l’ensemble des infos de mon capteur DHT22 dont les valeurs, température et humidité, dès que j’ai rentré l’adresse du Raspberry où se trouve Mosquitto, là les valeurs sont passées à 0.00 …. pas bien grave, mais étonnant. J’aurais tout de même une question, après avoir flashé ma carte, j’ai donc perdu tout… Lire la suite »
Salut l’ami,
Je suis un peu de retour :), je souhaiterais simplement publié une mesure d’un capteur (DS18B20) sur un serveur MQTT. Mais il n’y a que des options de serveur domotique dans les protocoles. A tu une idée ou bien je n’aurais pas le choix de faire cela en arduino ?
Bravo, ton site à superbement bien évolué depuis 6 mois un an !
Bonjour visvic et merci beaucoup. Je suis content si le travail te plait :D. Effectivement ESP Easy publie les informations pour être “compris” par les principaux serveurs domotiques open source. Mais ce sont de simples messages MQTT. Il sont formatés pour être compatibles mais rien ne t’empêche d’aller les lire (et même en écrire). Ton code coté serveur va simplement mimer le serveur domotique. Tu peux aussi aller dans les options et modifier le masque de publication. En fait, quand on change de protocole domotique, c’est le masque qui change. Voilà, tu devrais pouvoir y arriver sans avoir besoin de… Lire la suite »
Hey,
yes du coup j’ai vue un peu en trifouillant, par contre je suis sur la V2.0 de ESP EASY et je ne trouve pas l’endroit ou modifier le masque d’envoi :/
Je suis en train également de tester la fonction sleep mode. Une fois au dodo il consomme tout de même 14mA. Sur des piles cela ne tiendra même pas une semaine ^^.
Apres il y a la fonction sommeil profond en arduino, mais j’ai la flemme de coder en ce moment :p
Bonjour,
J’utilise cette config depuis plusieurs semaines, avec bonheur, mais j’ai remarqué un manque de fiabilité du à des déconnexions. Je suis obligé de rebooter régulièrement l’esp8266 car il n’est plus joignable. Avez vous rencontré ce type de soucis, y a t’il un moyen de le rebooter automatiquement régulièrement ou d’éviter cela ?
Merci
Bonjour Gandolfi. Non je n’ai pas (encore) rencontré ce problème. Il n’y a pas de fonction pour redémarrer à intervalle régulier ESP Easy. Il faudrait modifier le code source pour ajouter un test et appeler la fonction ESP.restart() ou ESP.reset().
Merci. Apparemment les ESP8266 sont sensibles à l’alimentation. Cela vient peut etre de mon alim de plaque d’essai ou de la plaque.
https://fr.aliexpress.com/item/3-3V-5V-MB102-Breadboard-power-module-MB-102-830-points-Solderless-Prototype-Bread-board-kit/32712170104.html
– Je ne sais pas s’il existe des alim ou plaque plus fiables ?
– En général tu utilises quoi pour finaliser tes montages ?
– Je vais également regarder du coté des fonctions que tu m’as donné.
J’utilise un chargeur 5V 2A. Tout simplement un chargeur de téléphone ou tablette avec une sortie USB comme ceux-ci http://s.click.aliexpress.com/e/bYvBaiI Jamais aucun problème, surtout avec la Wemos facile à alimenter avec un cable micro usb.
Merci. je vais plutôt partir sur une alim de la wemos en usb et acheter un shield à fixer au dessus (les sondes consomment peu).
Apparemment c’est les cables qui baladent un peu sur la plaque d’essai.
– tu soudes tes composants à la fin ou tu les laisses en plaque d’essai ?
J’utilise principalement les shields wemos. Si j’ai des composants à souder, j’utilise le proto shield (http://s.click.aliexpress.com/e/ZBIea6miu)
Merci. je vais en commander.
Bonjour,
je n’arrive pas à récupérer les messages MQTT de l’ESP via Mosquitto
j’ai une erreur de connection “unable to connect (15)”
J’ai mis le protocol OpenHab mais par contre je ne sais pas quoi mettre comme @IP pour le contrôleur
pouvez vous m’aider SVP
Merci
Bonjour Tartoche. Pouvez vous me dire ou vous avez le message “unable to connect (15)”. C’est sur Node-RED ou sur l’ESP ? L’adresse IP est celle de la machine sur lequel le broker (serveur) Mosquitto est installé. J’imagine que c’est la même machine que Node-RED. Si vous utilisez un Raspberry Pi, ouvrez le Terminal et exécutez ifconfig pour récupérer l’adresse IP. POur savoir si mosquitto fonctionne exécutez sudo /etc/init.d/mosquitto status. Dites moi si tout fonctionne après ça. A très bientôt
Bonjour et merci de votre retour
L’erreur apparaissait sur Node-Red sous le node MQTT
Effectivement j’avais une erreur sur l’ESP avec l’adresse du broker Mosquitto qui est sur le RPI avec Node-Red
Tout est en ordre … il ne me reste plus qu’a pauffiné mon dashboard
Merci pour tout … les articles sont super !!
@bientôt
Bonjour, Merci. Ce tuto est vraiment très bien. Je ne connaissais pas le rôle du langage MQTT, ni jamais utilisé node-red. – Comment faire si je veux piloter un moteur à vitesse variable (pwd ?), un servomoteur, un relais (GPIO ?), une sonde de détection à ultra-sons, une webcam ……relié au Wemos ? Je sais que sous scratch il faut choisir une commande spécifique. – Je ne sais pas s’il y a des packs tout en un intégrant node-red, scratch ou autre avec le serveur MQTT inclus ? A terme j’essaye de me créer un système tout en un avec… Lire la suite »
J’ai réussi à piloter la led et à brancher un BMP280 et un DHT22. C’est nickel.
Par contre je n’arrive pa sà commander un servo. J’ai réalisé un slider et 3 boutons 0, 50 et 100 % mais on dirait qu’il y a des interférences. Le servo bouge tout seul puis il se bloque en forçant (un SG90).
Je l’ai branché sur le D5 (interférences alternés avec la diode bleu) et D6 (il bouge tout seul et se bloque).
tu as une idée ?
Bonjour Gandolfi. C’est assez difficile de te donner une piste sans avoir le code et le cablage. Je te propose d’essayer de faire le montage (courant de semaine). Bon dimanche
bonjour, tu as raison. je t’ai envoyé un mail avec le formulaire de contact. j’ai branché le servo (SG90) sur le port D5 de mon esp8266 (node MCU Lolin V3) https://fr.aliexpress.com/item/NodeMcu-Lua-WIFI-development-board-based-on-the-ESP8266-Internet-of-things/32338121965.html mon code node-red [ { “id”: “cc4a38d3.564d7”, “type”: “mqtt in”, “z”: “8d3b88e4.90cb1”, “name”: “/esp1/DHT22/DHT22TEMP”, “topic”: “/esp1/DHT22/DHT22TEMP”, “qos”: “2”, “broker”: “775d4b4d.eb8004”, “x”: 368, “y”: 208, “wires”: [ [ “ea184a5f.b1b1b8” ] ] }, { “id”: “ea184a5f.b1b1b8”, “type”: “ui_gauge”, “z”: “8d3b88e4.90cb1”, “name”: “Gauge : Température”, “group”: “973ca93b.e8d418”, “order”: 0, “width”: 0, “height”: 0, “gtype”: “gage”, “title”: “Température DHT22”, “label”: “ESP Easy – MQTT”, “format”: “{{value}}°C”, “min”: 0, “max”: “50”, “colors”: [ “#66ccff”,… Lire la suite »
bonjour,
Le tuto est très intéressant mais assez ardu avec tous les progammes à mettre en place.
Dans la console node-red j’ai “connection failed to broker mqtt://localhost:1883”
J’utilise mosquito. Mais quand je lance mosquito.exe il me fait “l’ordinal 341 est introuvable dans la bibliotheque de liens dynamiques”.
super ça marche.
je recommande cette page pour installer mosquitto
https://sivatechworld.wordpress.com/2015/06/11/step-by-step-installing-and-configuring-mosquitto-with-windows-7/
charger le “http://slproweb.com/download/Win32OpenSSL_Light-1_0_2k.exe”
le 1.10 n’est pas bon
Bonjour Gandolfi. Ah, je dois améliorer l’installation le tuto sur l’installation de Mosquitto sur Windows !. C’est vrai que sur mac et linux, c’est plus simple. Bonne journée.