ESPHome permet de transformer un ESP32 peu coûteux en capteur ou actionneur parfaitement intégré à Home Assistant. L’intérêt principal est de pouvoir construire des équipements sur mesure tout en conservant les données et les automatisations dans le réseau local.
Ce guide s’inscrit dans notre parcours Home Assistant. Si vous n’avez pas encore installé la plateforme, commencez par notre guide pour débuter avec Home Assistant. Si vous êtes encore en train de choisir l’architecture globale de votre maison, consultez d’abord comment choisir sa solution domotique.

ESPHome et ESP32 : à quoi ça sert ?
L’ESP32 est un microcontrôleur disposant notamment du Wi-Fi et du Bluetooth. ESPHome ajoute une couche logicielle qui permet de décrire le comportement de l’appareil avec une configuration lisible, puis de l’intégrer directement dans Home Assistant.
- Capteur de température et d’humidité.
- Détecteur de présence ou de mouvement.
- Capteur de luminosité ou de qualité de l’air.
- Relais pour piloter un équipement.
- Multi-capteur regroupant plusieurs mesures dans un seul boîtier.
L’avantage est de ne pas dépendre d’une application propriétaire pour chaque capteur. Home Assistant reçoit directement les états et peut les utiliser dans ses automatisations.
1. Le matériel nécessaire
Pour un premier projet, il suffit généralement d’un ESP32, d’un câble USB adapté et d’un capteur compatible. Un modèle simple de température/humidité est idéal pour comprendre la logique avant de passer à des montages plus complexes.
Le câblage dépend du capteur. Vérifiez toujours sa tension d’alimentation et le brochage avant de le connecter au microcontrôleur. Un mauvais branchement peut endommager le module ou fausser les mesures.
2. Installer ESPHome
Dans une installation Home Assistant OS, ESPHome peut être ajouté comme module complémentaire. Cette méthode centralise la création des appareils, les journaux et les mises à jour dans l’environnement Home Assistant.
- Installez ESPHome depuis l’environnement Home Assistant.
- Créez un nouvel appareil.
- Sélectionnez la famille de carte correspondant à votre ESP32.
- Configurez le Wi-Fi du réseau local.
- Effectuez le premier flash par USB.
Après la première installation, les mises à jour peuvent généralement être envoyées en OTA, sans rebrancher physiquement le microcontrôleur.
3. Comprendre la configuration YAML
La configuration ESPHome décrit les composants de l’appareil : la carte utilisée, le réseau, les capteurs, les GPIO et les paramètres de mise à jour. Il n’est pas nécessaire d’être développeur, mais il faut respecter précisément la structure du fichier.
Pour un capteur de température, la configuration contient généralement la plateforme du capteur, la broche utilisée, un nom lisible et éventuellement la fréquence de mise à jour. Cette approche permet ensuite d’ajouter d’autres mesures au même ESP32.
4. Intégrer l’appareil à Home Assistant
Une fois connecté au réseau, l’appareil ESPHome est généralement détecté par Home Assistant. Après validation de l’intégration, ses capteurs et commandes apparaissent comme des entités classiques.
Vous pouvez alors utiliser une température, un niveau de luminosité ou un état de présence comme déclencheur d’automatisation, exactement comme avec un équipement commercial.
5. Exemple : créer un capteur d’ambiance
Un projet simple consiste à réunir température, humidité et luminosité. Les trois mesures remontent dans Home Assistant et peuvent ensuite servir à piloter chauffage, ventilation, volets ou éclairage.
- Température trop élevée : fermeture automatique des volets.
- Humidité élevée : activation d’une ventilation.
- Pièce sombre + présence détectée : allumage d’une lampe.
Cette logique complète bien un réseau Zigbee. Zigbee est pratique pour les petits capteurs sur batterie, tandis qu’ESPHome est excellent lorsque vous avez besoin d’un appareil personnalisé ou de plusieurs mesures spécifiques. Pour comprendre le premier cas, consultez notre guide Zigbee avec Home Assistant.
6. Concevoir un système réellement local
ESPHome est particulièrement intéressant lorsqu’on souhaite limiter la dépendance à des serveurs distants. Les appareils peuvent communiquer avec Home Assistant sur le réseau local et les automatisations restent pilotées par votre propre installation.
Cela ne dispense pas d’appliquer de bonnes pratiques : réseau Wi-Fi protégé, mots de passe solides, mises à jour régulières et sauvegardes de la configuration Home Assistant.
7. Quand choisir ESPHome plutôt qu’un produit du commerce ?
| Besoin | ESPHome | Produit prêt à l’emploi |
|---|---|---|
| Installation immédiate | Moyen | Excellent |
| Personnalisation | Excellente | Variable |
| Fonctionnement local | Excellent | Dépend du produit |
| Projet multi-capteurs | Excellent | Souvent limité |
| Compétences nécessaires | Un peu de configuration et câblage | Faibles |
ESPHome n’a donc pas vocation à remplacer tous les capteurs du marché. Il devient surtout intéressant lorsqu’un produit standard ne répond pas exactement au besoin, lorsque plusieurs mesures doivent être regroupées ou lorsque le fonctionnement local est prioritaire.
La suite du silo Home Assistant
Vous pouvez maintenant revenir au guide principal Home Assistant, approfondir le réseau avec Zigbee ou travailler sur l’hébergement avec notre tutoriel Home Assistant sur Raspberry Pi 5.
Questions fréquentes
ESPHome a-t-il besoin du cloud ?
Non pour le fonctionnement courant d’une installation locale avec Home Assistant. Certaines fonctions annexes peuvent toutefois dépendre des services que vous ajoutez vous-même.
Peut-on mettre plusieurs capteurs sur un seul ESP32 ?
Oui, dans les limites des GPIO disponibles, de l’alimentation et des composants pris en charge.
Faut-il savoir programmer ?
Pas nécessairement. Une compréhension de la configuration YAML et du câblage électronique suffit pour de nombreux projets simples.



0 commentaires
Une question ou une expérience à partager ? Participez à la discussion.
Soyez le premier à poser une question ou à partager votre expérience.