 |
 |
Nous continuons aujourd’hui le tutoriel consacré à l’échange de données entre Domoticz et un ESP8266 par requête HTTP (TCP/IP) et plus particulièrement comment piloter le GPIO depuis Domoticz. Dans l’article précédent, nous avons mis en place l’envoi de données depuis un ESP8266 vers Domoticz. Dans cet article, nous allons mettre en place la communication dans l’autre sens. L’API JSON de Domoticz est une porte d’entrée polyvalente qui permet de mettre à jour des appareils, récupérer des données et réaliser des opérations sur le système domotique. Par contre, cette interface n’est pas bi-directionnelle. On va devoir utiliser un système de requêtes HTTP classique. qui seront récupérées par un petit serveur Web qui fonctionne sur l’ESP8266.
Sommaire
Matériel utilisé
Nous allons reprendre le même montage que le tutoriel précédent. Cette fois, ce montage va permettre d’intégrer un ESP8266. Pour la partie sonde, vous pouvez utiliser un DHT11 ou un DHT22. Rapide à mettre en oeuvre grâce à la librairie DHT.h d’Adafruit. On pourra également ajouter un BMP180 qui permettra de créer un baromètre sur Domoticz. Pour le pilotage du GPIO, vous pouvez utiliser une simple LED ou un relai.
 |
Module ESP8266 ESP-12. Par exemple Wemos D1 Mini |
 |
Alimentation 5V/3A micro-usb |
 |
Capteur de pression atmosphérique |
 |
Capteur de température et d’humidité
DHT11 ou DHT22 |
 |
Shield DHT22 ou DHT11 pour Wemos D1 Mini
Le capteur est connecté à la broche D4 (GPIO2) |
 |
Shield relai (250VAC/10A ou 30VDC/10A) pour Wemos D1 Mini.
Le relai est accessible depuis la broche D1 (GPIO5) |
 |
Led (visualiser l’activation / désactivation du GPIO ) |
 |
Résistance 220Ω |
 |
Jumper Dupont |
 |
Breadboard |
Circuit
| Composant | Broches | Broche ESP8266 (Wemos D1 mini) |
| DHT22 (shield Wemos D1 Mini) | VCC | 3V3 |
| GND | G | |
| Data | D4 | |
| BMP180 | VCC | 3V3 |
| GND | G | |
| SDA | D2 | |
| SCK | D3 | |
| Led GPIO D7 | Pole + | D7 |
| Pole – | G | |
| Shield relai Wemos D1 Mini | D1 |
Changer les broches du bus I2C de l’ESP8266
Avant d’aller plus loin, vous avez du remarquer que la carte relai de Wemos utilise la broche D1. La broche D1 est partagée avec le broche SCK du bus I2C. Il va donc falloir déplacer la broche du bus I2C pour pouvoir utiliser le shield relai en même temps. Pour cela, on utilise la librairie Wire.h
Déclarez la librairie en début de programme
|
1 |
#include <Wire.h> |
Dans le setup() ; mais avant le d’initialiser l’objet BMP180 avec la commande bmp.begin() ; on déclare la initialise le bus I2C en indiquant les nouvelles broches. Comme d’habitude, inutile de chercher les broches équivalentes de l’Arduino, on indique directement les broches de l’ESP8266, la conversion se ferra automatiquement. Ici, j’ai déplacé par broche D1 (SCK) sur la broche D3, ce qui donne
|
1 |
Wire.begin(D2,D3); |
C’est tout, vous pouvez maintenant déplacer le bus I2C sur les broches que vous voulez.
Piloter le GPIO de l’ESP8266 depuis Domoticz
Nous allons maintenant piloter le GPIO de l’ESP8266 depuis Domoticz. Vous pouvez également faire des demandes complexes en intégrant des requêtes HTTP dans vos scripts Lua. Ici, nous allons simplement activer le relai du shield relai pour Wemos D1 mini. Pour moins de 8€, vous pouvez réaliser une lampe connectée ou un simulateur de présence à l’aide d’un scénario.
Code Arduino / ESP8266
Pour recevoir des commandes depuis Domoticz, on va ajouter une partie serveur au code Arduino précédent. Ajoutez la librairie ESP8266WebServer au code précédent et créer un server écoutant sur le port 80.
|
1 2 |
#include <ESP8266WebServer.h> ESP8266WebServer server ( 80 ); |
Dans le startup ajouter une route sur /gpio après que la connexion au réseau Wi-Fi. Ce serveur sera simplement à l’écoute des appels sur une page /gpio. Chaque appel sur cette page déclenchera l’execution de la fonction updateGpio().
|
1 2 |
server.on("/gpio", updateGpio); server.begin(); |
La fonction updateGpio() décode l’URL et met à jour l’état du GPIO correspondant. La fonction server.arg(“id”) permet de récupérer l’identifiant du GPIO etserver.arg(“etat”), l’état de ce dernier.
Remarque. On pourrait être tenté de répondre à Domoticz en lui demandant de changer l’état du switch ( /json.htm?type=command¶m=switchlight&idx=99&switchcmd=On) mais cela provoque une boucle infinie ! C’est un peu dommage.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
void updateGpio(){ Serial.println("Update GPIO command from DOMOTICZ : "); for ( int i = 0 ; i < server.args(); i++ ) { Serial.print(server.argName(i)); Serial.println(server.arg(i)); } String gpio = server.arg("id"); int etat = server.arg("etat").toInt(); int pin = D1; if ( gpio == "D1" ) { pin = D1; } else if ( gpio == "D7" ) { pin = D7; } else if ( gpio == "D8" ) { pin = D8; } else { pin = D1; } Serial.print("Update GPIO "); Serial.println(pin); if ( etat == 1 ) { digitalWrite(pin, HIGH); Serial.println("GPIO updated : On"); } else if ( etat == 0 ) { digitalWrite(pin, LOW); Serial.println("GPIO updated : Off"); } else { Serial.println("Bad Led Value !"); } } |
Voici le code Arduino complet qu’il vous suffit de téléverser après avoir modifié vos paramètres :
- ssid et mot de passe WiFi
- Adresse IP du serveur Domoticz (host) et le port s’il est différent de 8080
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 |
#include <ESP8266WebServer.h> #include <ESP8266WiFi.h> #include <ESP8266HTTPClient.h> #include <DHT.h> #include <Adafruit_BMP085.h> #include <Wire.h> #define DHTTYPE DHT22 // DHT type (DHT11, DHT22) #define DHTPIN D4 // Broche du DHT / DHT Pin const char* ssid = "XXXXXXXX"; const char* password = "XXXXXXXX"; const char* host = "XXX.XXX.XXX.XXX"; const int port = 8080; const int watchdog = 60000; // Fréquence d'envoi des données à Domoticz - Frequency of sending data to Domoticz unsigned long previousMillis = millis(); const uint8_t GPIOPIN[5] = {D1,D5,D6,D7,D8}; // Led DHT dht(DHTPIN, DHTTYPE); Adafruit_BMP085 bmp; ESP8266WebServer server ( 80 ); HTTPClient http; void updateGpio(){ Serial.println("Update GPIO command from DOMOTICZ : "); for ( int i = 0 ; i < server.args(); i++ ) { Serial.print(server.argName(i)); Serial.println(server.arg(i)); } String gpio = server.arg("id"); String token = server.arg("token"); if ( token != "123abCde" ) { Serial.println("Not authentified "); return; } int etat = server.arg("etat").toInt(); int pin = D1; if ( gpio == "D1" ) { pin = D1; } else if ( gpio == "D7" ) { pin = D7; } else if ( gpio == "D8" ) { pin = D8; } else { pin = D1; } Serial.print("Update GPIO "); Serial.println(pin); if ( etat == 1 ) { digitalWrite(pin, HIGH); Serial.println("GPIO updated : On"); } else if ( etat == 0 ) { digitalWrite(pin, LOW); Serial.println("GPIO updated : Off"); } else { Serial.println("Bad Led Value !"); } } void setup() { Serial.begin(115200); delay(10); Wire.begin(D2,D3); if ( !bmp.begin() ) { Serial.println("BMP180 KO!"); while (1); } else { Serial.println("BMP180 OK"); } Serial.setDebugOutput(true); Serial.println("Connecting Wifi..."); WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } for ( int x = 0 ; x < 5 ; x++ ) { pinMode(GPIOPIN[x], OUTPUT); } Serial.println(""); Serial.println("WiFi connected"); Serial.println("IP address: "); Serial.print(WiFi.localIP()); server.on("/gpio", updateGpio); server.begin(); } int value = 0; void loop() { server.handleClient(); unsigned long currentMillis = millis(); if ( currentMillis - previousMillis > watchdog ) { previousMillis = currentMillis; if(WiFi.status() != WL_CONNECTED) { Serial.println("WiFi not connected !"); } else { Serial.println("Send data to Domoticz"); float t = dht.readTemperature(); float h = dht.readHumidity(); float pa = bmp.readPressure() / 100.0F; if ( isnan(t) || isnan(h) ) { Serial.println("DHT KO"); } else { int hum_stat; int bar_for = 0; if ( h > 70 ) { hum_stat = 3; } else if ( h < 30 ) { hum_stat = 2; } else if ( h >= 30 & h <= 45 ) { hum_stat = 0; } else if ( h > 45 & h <= 70 ) { hum_stat = 1; } if ( pa > 1030 ) { bar_for = 1; } else if ( pa > 1010 & pa <= 1030 ) { bar_for = 2; } else if ( pa > 990 & pa <= 1010 ) { bar_for = 3; } else if ( pa > 970 & pa < 990 ) { bar_for = 4; } String url = "/json.htm?type=command¶m=udevice&idx=12&nvalue=0&svalue="; url += String(t); url += ";"; url += String(h); url += ";"; url += String(hum_stat); url += ";"; url += String(pa);url += ";"; url += String(bar_for); sendToDomoticz(url); } } } } void sendToDomoticz(String url){ Serial.print("connecting to "); Serial.println(host); Serial.print("Requesting URL: "); Serial.println(url); http.begin(host,port,url); int httpCode = http.GET(); if (httpCode) { if (httpCode == 200) { String payload = http.getString(); Serial.println("Domoticz response "); Serial.println(payload); } } Serial.println("closing connection"); http.end(); } |
Configuration Domoticz : créer un interrupteur virtuel
Retournez dans le matériel pour ajouter un nouveau capteur virtuel.
Remarque. Donnez lui un nom sans espaces ni caractères spéciaux ou accentués si vous voulez créer un script en Lua.
Piloter le GPIO à l’aide d’une action
Pour allumer, éteindre une lampe sans aucune autre condition, le plus facile et le plus rapide est de configurer une action en fonction de l’état de l’interrupteur. Allez à l’onglet Interrupteurs et ouvrez l’appareil en édition.
Dans le champ Action On, collez l’URL suivante en remplaçant IP_ESP8266 par la votre
|
1 |
http://IP_ESP8266/gpio?id=D1&etat=1&token=123abCde |
Pour l’état Off, on mettra donc simplement l’état à 0.
|
1 |
http://IP_ESP8266/gpio?id=D1&etat=0&token=123abCde |
Enregistrez.
Piloter le GPIO à l’aide d’un script Lua
L’autre manière de procéder et de créer un script Lua. C’est un peu plus long à mettre en place, mais on a toute la puissance du language à notre disposition. Si vous ne connaissez pas les scripts Lua, vous pouvez commencer par ce tutoriel.
Connectez-vous à votre serveur Domoticz en SSH et placez vous dans le répertoire des scripts Lua
|
1 |
cd ~/domoticz/scripts/lua |
On va créer u script qui se déclenche à chaque changement d’état de l’interrupteur. Par convention, le fichier devra donc porter le nom script_device_nomDuDevice.lua, ce qui donne
|
1 |
sudo nano script_device_GPIO_D1.lua |
Collez ce code Lua. Modifiez l’adresse IP de votre ESP8266 dans la variable baseurlESP8266. Le script test la valeur de l’appareil RelayD1. Si elle est égale à On, on complète l’url en indiquant l’id=D1 avec l’état à 1, 0 dans le cas contraire. Vous pouvez mettre l’état à On, ON, ALLUME…il faudra simplement tester la valeur de la variable dans le code Arduino.
|
1 2 3 4 5 6 7 8 9 10 11 |
baseurlESP8266 = "http://192.168.1.22/gpio?" commandArray = {} print ("Update Wemos D1 Mini Relay shield (Pin D1)") if (otherdevices['RelayD1'] == 'On') then commandArray['OpenURL'] = baseurlESP8266..'id=D1&etat=1&token=123abCd' else commandArray['OpenURL'] = baseurlESP8266..'id=D1&etat=0&token=123abCd' end return commandArray |
Sécuriser la communication
Il est possible d’améliorer la sécurité des échanges entre Domoticz et l’ESP8266. Vous avez certainement remarqué que l’envoi de données à Domoticz se fait sans la moindre authentification. Si on considère que le serveur domotique n’est jamais exposé à internet et que le réseau Wi-Fi est bien sécurisé, cela ne pose pas trop de problème. Par contre si vous voulez rendre accessible Domoticz depuis internet, il va falloir améliorer ça. Ici, nous n’irons pas jusqu’à chiffrer les échanges, c’est possible mais sort du cadre de ce tutoriel.
Réseaux locaux (pas d’identifiant ni mot de passe)
Dans la majorité des cas, vos objets connectés à base d’ESP8266 devrait se trouver sur le même réseau que le serveur Domoticz. Dans ce cas, le plus facile est d’ajouter les adresses IP de vos objets connectés à la liste des appareils autorisés à utiliser l’API dans autorisation. Pour cela, allez dans les réglages puis Paramètres et complétez le champ Réseaux.
Remarque. Dans ce cas, il est préférable d’attribuer une adresse IP fixe à l’ESP8266 car en cas de panne du routeur, l’adresse IP de ce dernier pourrait changer, et par conséquent ne plus fonctionner.
Authentification par utilisateur et mot de passe (code Arduino)
Si vous avez protégé l’accès de votre Domoticz par un identifiant et un mot de passe, il vous suffit de modifier la variable host
La variable host prendra alors la forme
|
1 |
username:password@domoticz-ip |
Remarque. Cette protection ne fonctionne que dans le sens ESP8266 vers Domoticz. Si vous voulez sécuriser le pilotage du GPIO, il faudra par exemple intégrer une clé publique qu’il suffira de vérifier dans le code Arduino.
Ajouter un token (jeton) dans la requête HTTP
Ces deux méthodes de sécurisation ne fonctionnent que dans le sens ESP8266 vers Domoticz. Il n’est pas (encore) possible de crypter le serveur web de l’ESP8266. Pour sécuriser les commandes, le plus simple est d’ajouter un clé publique ou un jeton qu’il suffira de tester dans le code Arduino. C’est une sécurisation assez basique mais c’est toujours mieux que rien.
|
1 2 3 4 5 |
String token = server.arg("token"); if ( token != "123abCde" ) { Serial.println("Not authentified "); return; } |
Voilà, vous pouvez maintenant envoyer des données, l’états de capteurs et piloter le GPIO de l’ESP8266 depuis un serveur Domoticz. La prochaine fois, nous verrons comment faire pour Jeedom.
- Publier la concentration en CO2 d’un capteur MH-Z19 vers Domoticz, code Arduino compatible ESP32/ESP8266
- Projet MicroPython, publier le taux de CO2 avec un capteur MH-Z19 vers Domoticz (ESP32/ESP8266)
- Projet MicroPython ESP32, lire la température sur plusieurs sondes DS18B20 et publier les mesures vers Domoticz
- Mesure de température DS18B20, code Arduino compatible ESP8266 et ESP32, publication sur Domoticz en HTTP
- #Hack : module Sonoff 4CH pro, compiler le firmware Espurna (Partie 2)
- Piloter le GPIO de l’ESP8266 (Serveur Web) depuis Domoticz en TCP/IP sans fil – Partie 2
![Installer Grafana sur macOS et Raspbian pour Raspberry Pi. Exemple de dashboard pour objet connecté MySensors avec Node-RED et InfluxDB [Màj]](https://projetsdiy.fr/wp-content/uploads/thumbs_dir/grafana-graph-dashboard-mysensors-dht22-temperature-humidite-n7zj2mkdgwvr63r7zh077tlqpiac4l7nkydpa8bifo.png)
