ESPHome Home Assistant is een krachtige combinatie voor iedereen die zelf slimme sensoren en apparaten wil bouwen. Met een betaalbare microcontroller zoals een ESP32 kun je bijvoorbeeld temperatuur meten, Bluetooth-apparaten doorgeven, verlichting bedienen of zelf een aanwezigheidssensor bouwen.
ESPHome gebruikt configuratiebestanden in YAML en genereert daar automatisch firmware voor je microcontroller uit. Je hoeft daardoor voor veel projecten zelf geen C++ te programmeren. Apparaten met ESPHome kunnen vervolgens rechtstreeks en lokaal met Home Assistant communiceren.
In deze handleiding bekijken we hoe ESPHome werkt, hoe je ESPHome Device Builder installeert en hoe je jouw eerste ESP32 toevoegt aan Home Assistant.
Wat is ESPHome?
ESPHome is een systeem waarmee je microcontrollers kunt veranderen in zelf configureerbare smart-homeapparaten.
Je beschrijft in een YAML-bestand welke hardware aanwezig is en wat deze moet doen. ESPHome compileert die configuratie vervolgens tot firmware voor de microcontroller.
ESPHome ondersteunt niet alleen ESP32 en ESP8266, maar ook diverse andere microcontrollerplatforms. Voor beginners is een ESP32 echter een logische keuze dankzij de combinatie van wifi, Bluetooth, prijs en brede ondersteuning.
Wat kun je met ESPHome?
De mogelijkheden zijn enorm. Met ESPHome Home Assistant kun je bijvoorbeeld zelf maken:
- Temperatuur- en luchtvochtigheidssensoren
- Bewegingssensoren
- Aanwezigheidssensoren
- Bluetooth Proxies
- Energiemeters
- Slimme schakelaars
- Relaismodules
- Lichtsensoren
- Waterniveausensoren
- Displays
- Deur- en raamsensoren
Je kunt ESPHome ook gebruiken om bestaande compatibele hardware van aangepaste firmware te voorzien.
Een interessant voordeel is dat je een apparaat precies kunt aanpassen aan je eigen woning. Je bent niet beperkt tot de functies die een fabrikant in een kant-en-klaar product heeft ingebouwd.
Waarom ESPHome combineren met Home Assistant?
De belangrijkste reden is de sterke lokale integratie.
Home Assistant communiceert via de native ESPHome API rechtstreeks met ESPHome-apparaten. Daarbij houdt Home Assistant een verbinding met het apparaat in stand, waardoor wijzigingen vrijwel direct kunnen worden doorgegeven in plaats van voortdurend gegevens op te vragen.
Dat maakt ESPHome interessant voor automatiseringen.
Een temperatuursensor kan bijvoorbeeld direct een nieuwe temperatuur doorgeven, waarna Home Assistant de verwarming kan aansturen.
Andere voordelen zijn:
- Lokale communicatie
- Veel vrijheid
- Geen verplicht cloudaccount
- Zeer veel ondersteunde sensoren
- Goede integratie met Home Assistant
- OTA-updates
- Geschikt voor goedkope hardware
- Grote open-sourcecommunity
Wat heb je nodig?
Voor je eerste project heb je niet veel nodig.
Denk aan:
- Werkende Home Assistant-installatie
- ESPHome Device Builder
- Compatibele microcontroller, bijvoorbeeld ESP32
- Geschikte USB-datakabel
- Wifi-netwerk
- Computer of Home Assistant-machine
- Sensor of ander component voor je eerste project
Let op: controleer altijd de spanning, pinbezetting en specificaties van je specifieke ESP32-board en aangesloten componenten. Verkeerd aansluiten kan hardware beschadigen.
Begin als beginner bij voorkeur met laagspanningsprojecten. Ga niet experimenteren met 230V-netspanning als je niet over de benodigde kennis beschikt.
ESPHome Device Builder installeren
Voor Home Assistant OS is ESPHome Device Builder de eenvoudigste manier om te beginnen. De officiële documentatie biedt hiervoor een Home Assistant-app.
Ga in Home Assistant naar:
Instellingen → Apps
Zoek naar:
ESPHome Device Builder
Installeer de app en start deze vervolgens.
Open daarna de webinterface.
Gebruik je Home Assistant Container? Dan heb je niet dezelfde app-omgeving. ESPHome Device Builder kan in dat geval bijvoorbeeld afzonderlijk via Docker worden uitgevoerd.
Een ESP32 toevoegen
Open ESPHome Device Builder.
Kies vervolgens voor het maken van een nieuw apparaat. Voor beginners is New Device Setup de meest logische optie. De wizard helpt je onder andere met de platform-, board- en wifi-configuratie.
Geef je apparaat een duidelijke naam, bijvoorbeeld:
temperatuursensor-woonkamer
Gebruik voor ieder ESPHome-apparaat een unieke naam. Dubbele namen kunnen problemen veroorzaken met ontdekking en verbindingen in Home Assistant.
Je eerste ESPHome-apparaat configureren
ESPHome gebruikt YAML voor de configuratie.
Een basisconfiguratie bevat onder andere informatie over:
- Het apparaat
- De gebruikte microcontroller
- Wifi
- Logging
- API-verbinding
- OTA-updates
De wizard kan een groot deel van deze basis automatisch voor je aanmaken.
Daarna voeg je zelf componenten toe.
Dat is precies waar ESPHome krachtig wordt: één ESP32 kan afhankelijk van het project meerdere sensoren en functies combineren.
Eerste installatie via USB
Bij een nieuwe microcontroller moet ESPHome-firmware eerst op het apparaat worden geïnstalleerd.
De officiële ESPHome Getting Started-handleiding gaat voor de eerste installatie uit van een USB-verbinding. Nadat de firmware eenmaal is geïnstalleerd en het apparaat met je netwerk is verbonden, kunnen volgende updates draadloos worden uitgevoerd.
Gebruik hiervoor een USB-datakabel.
Dat laatste is belangrijk: sommige USB-kabels zijn alleen bedoeld om apparaten op te laden en hebben geen dataverbinding.
Volg tijdens het flashen de aanwijzingen van ESPHome Device Builder.
ESPHome toevoegen aan Home Assistant
Zodra de ESP32 verbinding heeft gemaakt met je wifi-netwerk, kan Home Assistant het ESPHome-apparaat automatisch ontdekken wanneer je netwerk dit ondersteunt.
Verschijnt het apparaat niet automatisch?
Ga dan naar:
Instellingen → Apparaten & diensten → Integratie toevoegen
Zoek naar:
ESPHome
Vul vervolgens de hostnaam of het IP-adres van je apparaat in.
De standaardpoort van de native ESPHome API is 6053.
Na het toevoegen verschijnen de beschikbare sensoren, schakelaars en andere entiteiten in Home Assistant.
Je eerste sensor maken
Nu wordt het interessant.
Stel dat je een compatibele temperatuursensor op je ESP32 aansluit. Je voegt daarvoor de juiste componentconfiguratie toe aan het YAML-bestand.
ESPHome weet vervolgens:
- Welk type sensor wordt gebruikt
- Op welke pinnen deze is aangesloten
- Welke meetwaarden beschikbaar zijn
- Welke naam de sensor krijgt
Na het opslaan moet de nieuwe configuratie opnieuw naar de ESP32 worden geïnstalleerd.
Zodra het apparaat opnieuw online komt, kan de nieuwe sensor via de ESPHome-integratie beschikbaar worden in Home Assistant.
Daarna kun je de meetwaarde gebruiken op een dashboard of in een automatisering.
ESPHome draadloos updaten via OTA
OTA staat voor Over The Air.
Nadat de eerste firmware via USB is geïnstalleerd, hoef je voor normale configuratiewijzigingen niet telkens met een USB-kabel naar de ESP32.
Je past bijvoorbeeld een sensor aan in ESPHome Device Builder en kiest vervolgens opnieuw voor installeren.
ESPHome compileert de nieuwe firmware en stuurt deze via je netwerk naar het apparaat. De officiële Getting Started-documentatie beschrijft dit als de normale werkwijze na de eerste installatie.
Dat is vooral handig wanneer een ESP32 uiteindelijk op een moeilijk bereikbare plaats hangt.
ESPHome versus kant-en-klare smart-homeapparaten
ESPHome is niet voor iedereen automatisch beter.
Een kant-en-klare sensor is meestal eenvoudiger. Je haalt hem uit de verpakking, koppelt hem en bent klaar.
ESPHome vraagt meer werk.
| Eigenschap | ESPHome | Kant-en-klaar |
|---|---|---|
| Installatie | Meer werk | Meestal eenvoudig |
| Aanpasbaarheid | Zeer groot | Beperkter |
| Zelfbouw | Ja | Meestal niet |
| Programmeerkennis | Beperkt nodig | Niet nodig |
| YAML | Vaak wel | Nee |
| Lokale werking | Sterk uitgangspunt | Verschilt per product |
| Repareren/aanpassen | Vaak mogelijk | Verschilt |
ESPHome is vooral interessant wanneer bestaande producten niet precies doen wat je wilt.
Is ESPHome geschikt voor beginners?
Ja, mits je eenvoudig begint.
Je hoeft geen ervaren programmeur te zijn. ESPHome neemt veel technisch werk uit handen en de Device Builder helpt bij het maken, beheren en installeren van configuraties.
Je moet wel bereid zijn iets te leren over:
- YAML
- GPIO-pinnen
- Voedingsspanning
- Sensoren
- USB-flashing
- Basisnetwerken
Begin daarom niet direct met een ingewikkeld project met tien sensoren.
Maak eerst één ESP32 werkend en voeg daarna één eenvoudige sensor toe.
Leuke ESPHome-projecten
Heb je de basis onder de knie? Dan zijn er veel interessante vervolgprojecten.
ESP32 temperatuursensor
Een uitstekend beginnersproject. Meet temperatuur en eventueel luchtvochtigheid en toon de waarden rechtstreeks in Home Assistant.
Bluetooth Proxy
Een ESP32 kan als Bluetooth Proxy worden gebruikt om het Bluetooth-bereik van Home Assistant uit te breiden. Home Assistant ondersteunt hiervoor ESPHome-apparaten met Bluetooth Proxy-functionaliteit.
Aanwezigheidssensor
Combineer een ESP32 met een geschikte aanwezigheidssensor om nauwkeuriger te detecteren of iemand zich in een kamer bevindt.
Energie- en P1-projecten
ESPHome kan ook interessant zijn voor energiebeheer. In Home Assistant 2026.5 werd bijvoorbeeld ondersteuning toegevoegd waarmee seriële poorten via ESPHome over het netwerk beschikbaar kunnen worden gemaakt, met P1-energiemeters als een van de genoemde toepassingen.
Slimme displays
Combineer een ESP32 met een klein display om bijvoorbeeld temperatuur, energieverbruik of andere Home Assistant-informatie weer te geven.
Veelvoorkomende problemen
ESP32 wordt niet via USB gevonden
Controleer eerst de kabel. Gebruik een USB-kabel die daadwerkelijk data ondersteunt.
Probeer daarna:
- Andere USB-poort
- Andere kabel
- Computer opnieuw aansluiten
- Controleren of drivers nodig zijn
ESPHome-apparaat blijft offline
Controleer:
- Wifi-naam en wachtwoord
- Wifi-bereik
- Of het apparaat voeding krijgt
- ESPHome-logs
- Netwerkconfiguratie
Home Assistant ontdekt het apparaat niet
Automatische ontdekking is onder andere afhankelijk van je netwerk en mDNS. Je kunt het ESPHome-apparaat ook handmatig toevoegen met de hostnaam of het IP-adres.
OTA-update mislukt
Controleer of het ESPHome-apparaat online is en vanaf Home Assistant bereikbaar is.
Wanneer draadloos updaten niet meer lukt, kun je het apparaat indien nodig opnieuw fysiek aansluiten.
Configuratie compileert niet
Controleer de foutmelding in ESPHome Device Builder.
Gebruik ook de Validate-functie om je configuratie te controleren. De Device Builder biedt daarnaast Clean Build Files, wat volgens de ESPHome-documentatie regelmatig kan helpen bij compileerproblemen.
Tips voor ESPHome Home Assistant
Geef ieder apparaat een duidelijke en unieke naam. Daardoor blijft je installatie overzichtelijk wanneer je later tien of twintig ESPHome-apparaten hebt.
Bewaar daarnaast je configuraties goed. Onder Home Assistant worden de Device Builder-configuraties in de ESPHome-map binnen je Home Assistant-configuratie opgeslagen.
Andere praktische tips:
- Begin met één eenvoudig project
- Noteer welke GPIO-pinnen je gebruikt
- Controleer altijd de documentatie van je board
- Maak regelmatig Home Assistant-back-ups
- Werk ESPHome regelmatig bij
- Test een project voordat je het definitief monteert
- Gebruik behuizingen die geschikt zijn voor de toepassing
Veelgestelde vragen over ESPHome Home Assistant
Wat is ESPHome?
ESPHome is een systeem waarmee je via YAML firmware kunt genereren voor ondersteunde microcontrollers. Daarmee kun je bijvoorbeeld zelf sensoren, schakelaars en andere smart-homeapparaten bouwen.
Werkt ESPHome rechtstreeks met Home Assistant?
Ja. ESPHome heeft een native API waarmee apparaten rechtstreeks met Home Assistant kunnen communiceren.
Heb ik MQTT nodig voor ESPHome?
Nee. Voor de normale ESPHome Home Assistant-integratie is MQTT niet nodig. Home Assistant kan rechtstreeks via de native ESPHome API communiceren.
Heb ik programmeerkennis nodig?
Niet per se. Je configureert ESPHome voornamelijk via YAML. Basiskennis van elektronica en configuratie helpt wel wanneer je zelf sensoren en componenten aansluit.
Wat is beter: ESP32 of ESP8266?
Voor nieuwe projecten is een ESP32 vaak de aantrekkelijkere keuze vanwege de extra mogelijkheden en Bluetooth-ondersteuning. Wel hangt de beste keuze af van het project.
Kan ik ESPHome zonder Home Assistant gebruiken?
Ja. ESPHome is niet uitsluitend afhankelijk van Home Assistant. De combinatie met Home Assistant is echter populair vanwege de directe integratie en lokale communicatie.
Kan ik ESPHome draadloos updaten?
Ja. Nadat de eerste firmware is geïnstalleerd en OTA correct is geconfigureerd, kunnen volgende firmware-updates via het netwerk worden uitgevoerd.
Werkt ESPHome lokaal?
Ja. Via de native API kunnen ESPHome en Home Assistant lokaal met elkaar communiceren. Voor bepaalde externe functies of updates kan uiteraard wel internet nodig zijn.
Gerelateerde artikelen
Wat is Home Assistant? De complete gids voor een slim en lokaal smart home
Home Assistant installeren: stap voor stap handleiding
Home Assistant op een oude laptop installeren: stap voor stap
De 10 beste Home Assistant integraties die iedereen zou moeten gebruiken
HACS installeren in Home Assistant: complete handleiding voor beginners
Alles over Home Assistant
Conclusie
ESPHome Home Assistant is vooral interessant wanneer je verder wilt gaan dan kant-en-klare smart-homeapparaten. Met een ESP32 en ESPHome kun je relatief voordelig zelf sensoren en apparaten bouwen die rechtstreeks en lokaal met Home Assistant communiceren.
De eerste installatie vraagt wat meer aandacht: je moet ESPHome Device Builder installeren, een microcontroller configureren en de eerste firmware naar het apparaat schrijven. Daarna wordt het een stuk eenvoudiger dankzij draadloze OTA-updates.
Begin met een klein project, bijvoorbeeld één temperatuur- of contactsensor. Zodra je begrijpt hoe ESPHome, YAML en Home Assistant samenwerken, kun je steeds uitgebreidere apparaten bouwen.
Daarmee is ESPHome niet alleen een handige Home Assistant-integratie, maar ook de basis voor een compleet nieuw DIY-gedeelte binnen je smart home.