Accueil / Domotique / ESP Easy : utiliser des objets connectés DIY avec Jeedom

ESP Easy : utiliser des objets connectés DIY avec Jeedom

Nous continuons notre série d’article sur le firmware ESP Easy. Dans cet article, nous allons apprendre comment intégrer des projets à base d’ESP8266 dans Jeedom. Il est possible de récupérer des mesures en provenance de sondes (température, humidité, luminosité…) et de commander des actionneurs, par exemple un relai. Il n’y a rien de très compliqué pour intégrer des objets DIY à base d’ESP Easy dans Jeedom, juste quelques astuces non documentées…

Ce tutoriel a été réalisé avec la version 2.4.4 de Jeedom.

Matériel nécessaire

Pour réaliser ce tutoriel, j’ai utilisé le projet précédent utilisé pour créer un baromètre virtuel BME280 sous Domoticz. Pour ce tutoriel, on utilisera uniquement le BMP180 pour récupérer la mesure de pression atmosphérique et la température ainsi qu’un shield relai qui sera piloter à l’aide d’un bouton virtuel sous Jeedom.

esp8266 Wemos D1 mini Wemos D1 Mini ou autre ESP8266 ESP-12
BMP180 Capteur de pression atmosphérique

BMP180

wemos d1 mini relai shield Shield relai pour Wemos D1 Mini

10A – 250VAC ou 10A – 30VDC

oled ssd1306 ecran i2c Ecran OLED monochrome 168×64 pixels 0.96″ (optionnel)

SSD1306

jumper dupont Jumper Dupont (optionnel)
breadboard Breadboard (optionnel)


espeasy + dht22 + ssd1306 + bmp180

Composant Broches Repérage Arduino Equivalence ESP8266 (Wemos D1 mini)
DHT22 VCC 5V 5V
GND GND G
Data GPIO-14 G5
BMP180 VCC 5V 5V
GND GND G
SDA GPIO-4 D2
SCK GPIO-5 D1
OLED SSD1306 0.96 » VCC 5V 5V
GND GND G
SDA GPIO-4 D2
SCK GPIO-5 D1
Led activité WiFi Pole + GPIO-12 D6
Pole – GND G

Préparer Jeedom

Pour accéder à tous les réglages, le mieux est d’activer le mode expert avant de commencer.

jeedom mode expert

Configuration réseau interne de Jeedom

Avant de pouvoir utiliser le plugin ESPeasy, il faut configurer l’adresse IP de l’accès interne. Sans cela, le module ne pourra pas fonctionner et pire encore aucun message d’erreur n’indique qu’il faut le faire.

Dans le premier champ, indiquez l’adresse IP de votre box domotique. Par exemple 192.168.1.24. Ne changez pas le port (80 par défaut) sauf si vous avez mis en place un redirection de port (lire cet article pour savoir comment faire). Sauvegardez la configuration et actualisez la page. Vous devez avoir le statut OK avant d’aller plus loin.

 jeedom acces interne adresse ip

Installer le plugin Virtuel

Installez le plugin Virtuel qui nous servira a créer un bouton de commande virtuel pour activer/désactiver le relai.

Installer et configurer le plugin ESP Easy

Maintenant, allez dans la gestion des plugins et installez le plugin ESPeasy qui se trouve dans la section Protocole domotique. Ce plugin est gratuit.

jeedom protocole domotique espeasy esp8266

Après installation, activez le et lancez l’installation des dépendances en appuyant sur Relancer. L’opération dure quelques minutes (c’est fonction de votre équipement). Pendant ce temps, vous pouvez configurer votre ESP8266.

Configurer la communication avec Jeedom sur l’ESP8266

Le firmware ESP Easy ne prend pas en charge nativement le support de Jeedom. Ce n’est pas un problème, on va simplement utiliser le protocole générique HTTP.

jeedom configuration esp easy

Dans la configuration du plugin, ont dispose de tout ce qu’il nous faut :

  • IP Contrôleur à saisir dans ESPEasy. C’est l’adresse IP renseignée dans l’accès interne précédemment. Si le champ est vide, c’est qu’il y a un problème dans la configuration.
  • Port Contrôleur : c’est le 8121
  • Publish template : définit le masque d’envoi des données à Jeedom

Accédez à l’interface de configuration d’ESP Easy et allez sur la page Config :

  • Protocol : choisissez Generic HTTP
  • Locate Controller : choisissez Use IP address
  • Controller IP : indiquez l’adresse IP de la box Jeedom
  • Controller Port : indiquez 8121
  • Enregistrez avec submit

jeedom esp easy protocol generic

Allez ensuite sur la page Tools puis sur Advanced. Dans le champ Publish Template collez

device=%sysname%&taskid=%id%&cmd=%valname%&value=%value%


jeedom esp easy publish template

Enregistrez avec submit.

Inclusion des objets ESP Easy

Maintenant les dépendances devraient être installées (statut OK vert). Lancez le démon et ouvrez le log Espeasy_node. Si tout est correctement configuré, vous devriez commencer à recevoir les premiers messages de l’ESP8266.

 jeedom espeasy log Espeasy_node

Remarque. Le délai de réception du premier message va dépendre du délai d’actualisation des mesures. Pour mettre au point la configuration, mettez un délai de quelques secondes (par exemple 5) dans le champ Delay du Device sur ESP Easy.

Dès que vous recevez vos premiers messages, vous pouvez sortir de la configuration du plugin ESPeasy.

Appuyez sur le bouton vert Mode inclusion. En fonction du délai de publication, Jeedom va détecter les nouveaux objets et les ajouter à la liste Mes espeasy. Chaque objet va prendre le nom qui lui a été attribué dans le champ Name de la page Config. Cliquez sur Mode inclusion pour terminer l’inclusion.

jeedom espeasy inclusion

Cliquez sur l’icône de l’objet pour terminer la configuration :

  • Attribuez un objet parent
  • Choisissez une catégorie
  • Cochez Activer et visible
  • Si votre objet peut être associé à une catégorie précise, choisissez là dans la liste de choix.

 jeedom espeasy objet configuration

Allez ensuite dans l’onglet Commandes. On y trouve une commande d’information (Pressure et Temperature). Renommez en français les noms des commandes et indiquez l’unité de mesure. Vous pouvez également activer l’historique des mesures.

jeedom espeasy onglet commandes

Sauvegardez la configuration et allez sur le dashboard pour voir les mesures envoyées par votre baromètre numérique.

 jeedom espeasy dashboard bmp180

Piloter un relai ESP Easy depuis Jeedom

Vous l’avez sans doute remarqué mais il n’y a pas de Subscribe Template. Pour piloter des actionneurs, il va donc falloir utiliser une URL (comme sur Domoticz d’ailleurs). Dans cet exemple, nous allons activer/désactiver un relai relié au GPIO 16 (broche D0 de la Wemos D1 Mini).

Retournez dans la configuration de l’objet ESPeasy et allez à l’onglet Commandes puis cliquez sur Ajouter une commande d’action. Faites le deux fois pour ajouter deux commandes.

Dans la première ligne créée, donnez le nom ON. Dans le champ Task et Variable collez gpio,16,1. Dans la seconde ligne, donnez le nom OFF et collez gpio,16,0.

Désactivez l’affichage des deux commandes et sauvegardez.

Dans le champ valeur, le plugin a automatiquement créé l’URL de commande reconnue par ESP Easy.

jeedom espeasy commandes action relai

Vous pouvez tester que le relai s’active et se désactive en appuyant sur Tester.

Créer un bouton de commande virtuel

Allez dans Plugins -> Programmation -> Virtuel puis appuyer sur Ajouter.

Choisissez un objet parent, une catégorie, activez et rendez le visible. Allez dans l’onglet Commandes et ajoutez 2 commandes virtuelles.

 jeedom espeasy bouton virtuel configure

Pour la première, indiquez le nom ON. Dans le champ valeur (champ du haut), cliquez sur Rechercher équipement. Recherchez la commande pour activer le relai (ON) comme sur cette photo d’écran. Faites de même pour la commande d’extinction du relai (OFF). Vous pouvez tester que les commandes fonctionnent bien à l’aide du bouton Tester.

 jeedom espeasy virtuel selection commande equipement

Sauvegardez et allez sur le dashboard.

 jeedom plugin espeasy dashboard bouton virtuel

Vous pouvez maintenant piloter vos relais depuis Jeedom, faire des mesures en tout genre, etc… sans aucune programmation grâce à ESP Easy.