Pour intégrer un capteur Wi-Fi à Home Assistant sans dépendre du cloud, installer ESPHome sur un Raspberry Pi avec Docker est une solution efficace et moderne. Ce processus s’appuie sur l’utilisation d’un Raspberry Pi comme serveur local pour compiler les firmwares, tandis que l’ESP32 se charge de collecter les données via Wi-Fi. Voici ce que nous allons explorer ensemble :
- Les étapes d’installation d’ESPHome via Docker sur Raspberry Pi.
- La configuration d’un capteur Wi-Fi ESP32 équipé d’un DHT22 pour la température et l’humidité.
- La mise en place des communications sans fil et intégration avec Home Assistant.
Ce tutoriel vous fournit un guide clair et concis afin de maîtriser l’installation et la configuration de votre solution domotique, en valorisant les capacités de connexion sans cloud via ESPHome, la simplicité de l’environnement Docker, et la puissance du microcontrôleur ESP32.
A lire également : Guide complet : Installer Mosquitto MQTT en toute sécurité sur Raspberry Pi pour Home Assistant et vos capteurs
Table des matières
Installer ESPHome sur Raspberry Pi via Docker : une base solide pour la domotique locale
L’ESPHome s’appuie sur le Raspberry Pi pour héberger son interface et compiler les firmwares des capteurs ESP32 et ESP8266. Docker simplifie cette installation en isolant l’application et facilitant sa gestion.
Pour démarrer, vous devrez vous connecter en SSH à votre Raspberry Pi fonctionnant sous Raspberry Pi OS en 64 bits, et vous assurer que Docker et Docker Compose sont installés et opérationnels. Voici les étapes précises :
A voir aussi : Domotique simplifiée : créez votre système intelligent facilement avec Raspberry Pi
- Créer un répertoire dédié à ESPHome : mkdir -p ~/esphome/config
- Se placer dans ce répertoire : cd ~/esphome
- Éditer le fichier compose.yml avec votre éditeur préféré (nano, vim…) et insérer la configuration Docker suivante :
services: esphome: image: ghcr.io/esphome/esphome:stable volumes: - ./config:/config ports: - "6052:6052" restart: unless-stopped - Lancer le conteneur en arrière-plan avec docker compose up -d
- Contrôler le bon fonctionnement avec docker compose ps et afficher les logs récents via docker compose logs –tail=30 esphome
Cette installation garantit que votre Raspberry Pi devient un centre local centralisé capable de gérer plusieurs capteurs avec ESPHome. Une fois le service actif, ESPHome répondra sur http://IP_DU_PI:6052, où vous pourrez suivre et gérer vos appareils.
Configurer un capteur Wi-Fi ESP32 avec ESPHome : présentation du matériel et préparation
Le cœur de notre capteur Wi-Fi repose sur un microcontrôleur ESP32, reconnu pour sa compatibilité Wi-Fi 2,4 GHz et sa facilité d’intégration dans des projets DIY. Le modèle DHT22 permet de mesurer la température et l’humidité avec une bonne précision, idéale pour la domotique résidentielle.
Voici le matériel requis pour ce projet :
- Raspberry Pi sous Raspberry Pi OS 64 bits avec Docker
- ESP32 compatible USB
- Câble USB de données pour la programmation initiale
- Capteur DHT22 pour température et humidité
- Connexion Wi-Fi 2,4 GHz accessible
- Home Assistant pour la gestion finale (facultatif)
Dans votre configuration ESPHome, il conviendra de renseigner vos identifiants Wi-Fi dans un fichier secrets.yaml protégé :
wifi_ssid: "VotreWiFi" wifi_password: "MotDePasseWiFi"
Ce stockage séparé des secrets simplifie la sécurisation de vos informations.
Étapes de création et flashage du firmware ESPHome pour ESP32 avec DHT22
Vous allez configurer votre appareil dans ESPHome en sélectionnant la carte ESP32 et en ajoutant la configuration du DHT22 dans le fichier YAML. Le fichier doit comporter les éléments suivants :
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
logger:
api:
ota:
sensor:
- platform: dht
pin: GPIO4
model: DHT22
temperature:
name: "Température bureau"
humidity:
name: "Humidité bureau"
update_interval: 60s
Veillez à ne jamais appliquer une tension de 5V sur les broches GPIO de l’ESP32, ce qui peut l’endommager. Ce code permet la remontée automatique des données toutes les 60 secondes via Wi-Fi.
Pour flasher l’ESP32 :
- Connectez votre ESP32 à votre Raspberry Pi par câble USB
- Dans l’interface ESPHome, cliquez sur Install → Plug into this computer
- Surveillez les logs pour confirmer que le capteur se connecte au réseau Wi-Fi (ligne contenant WiFi connected)
Une fois la connexion établie, vous pourrez intégrer le capteur à Home Assistant via la découverte automatique accessible depuis Paramètres → Appareils et services.
Checklist essentielle pour valider son installation ESPHome sur Raspberry Pi et capteur ESP32
| Point de contrôle | Vérification |
|---|---|
| Conteneur Docker | Commande docker compose ps montre le service ESPHome actif |
| Réseau | Le Pi et l’ESP32 sont connectés au même réseau LAN 2,4 GHz |
| Connexion du capteur | Le capteur DHT22 est alimenté en 3,3 V, GND commun, GPIO correct |
| Affichage des mesures | Deux valeurs (température et humidité) apparaissent dans Home Assistant après une minute |
Résolution des problèmes fréquents lors de l’installation ESPHome et capteur Wi-Fi ESP32
Le port 6052 doit être accessible sur votre réseau pour communiquer avec ESPHome. En cas d’inaccessibilité, vérifiez l’adresse IP du Raspberry Pi, les règles de votre pare-feu local et inspectez les logs Docker pour identifier toute anomalie.
Si l’ESP32 ne se connecte pas au Wi-Fi, attention à bien utiliser un réseau 2,4 GHz et pas un réseau invité qui pourrait isoler votre appareil. Vérifiez également la saisie des identifiants dans le fichier ‘secrets.yaml’.
Lorsque les valeurs remontées affichent nan, cela signale généralement un problème d’alimentation ou un mauvais branchement du DHT22 (modèle ou GPIO erronés). Tenir compte de respecter un délai d’intervalle d’au moins 60 secondes entre chaque relevé permet d’assurer une mesure fiable.
Personnaliser et étendre ses capteurs ESPHome : variantes et conseils
Pour enrichir votre station météo, le capteur BME280 peut être intégré, ajoutant la mesure de pression atmosphérique via un bus I²C. Si vous multipliez les appareils, pensez à sauvegarder et versionner régulièrement vos fichiers de configuration ~/esphome/config en utilisant Git, assurant un suivi fiable et une restauration facile.
Pour toute expérience en électronique ou création domotique, nous vous recommandons de découvrir les bases Arduino avec le guide Premiers pas sur Arduino. Cette ressource enrichira grandement votre compréhension des microcontrôleurs et de leur programmation, indispensable pour évoluer dans ce domaine passionnant.