ESPHome installeren en je eerste ESP32 voorbereiden
Installeer de ESPHome Device Builder, maak je eerste apparaat aan en bereid je ESP32 voor met een eerste installatie via USB.
Voordat een ESP32 onze opdrachten kan uitvoeren, moet er firmware op het bord komen. Hiervoor maken we eerst een configuratie in de Device Builder. Daarna installeren we die voor het eerst via USB.
Kies hoe je ESPHome wilt gebruiken
Als Home Assistant OS wordt gebruikt, open je in Home Assistant Instellingen → Apps en installeer je ESPHome Device Builder. Start de app en kies Open Web UI. Sommige versies of vertalingen tonen nog de term add-on. De huidige officiële documentatie gebruikt app.
Zonder Home Assistant kun je de ESPHome Device Builder als desktopapp
installeren via https://esphome.io/install/. Start de app
en open de bijbehorende gebruikersomgeving. De stappen voor een
configuratie zijn verder vergelijkbaar.
Draait Home Assistant als Container, dan is de Home Assistant-appwinkel niet beschikbaar. Gebruik in dat geval de zelfstandige Device Builder, bijvoorbeeld in een aparte container of op je computer.
Een nieuw apparaat aanmaken
Open de Device Builder en kies Create device. De huidige configuratiewizard biedt onder meer New Device Setup, Import from File en Empty Configuration. Voor onze eerste ESP32 kiezen we de begeleide nieuwe apparaatconfiguratie.
Geef het apparaat een herkenbare naam, bijvoorbeeld
werkplaats-oefening. Kies het correcte bord of een passende
algemene ESP32-borddefinitie. Controleer zorgvuldig of je niet per
ongeluk een ESP32-C3, S3 of ander model kiest.
Vul de wifi-instellingen in wanneer daarom wordt gevraagd. Laat de wizard de benodigde basisconfiguratie en beveiligingssleutels aanmaken. Neem bestaande, automatisch gegenereerde instellingen over in plaats van ze zomaar te vervangen door willekeurige voorbeelden van internet.
De eerste installatie via USB
Sluit het ESP32-ontwikkelbord met een USB-datakabel aan. Kies binnen de Device Builder Install en vervolgens een installatiemethode die past bij waar de ESP32 fysiek is aangesloten. Een ESP32 die aan je Windows-computer hangt, is niet automatisch via USB zichtbaar voor een Device Builder die op een andere Home Assistant-server draait.
Afhankelijk van je opstelling gebruikt de Device Builder rechtstreekse USB-toegang, een browserinstallatie of een gedownload firmwarebestand. Volg het getoonde installatievenster en de officiële aanwijzingen voor jouw gekozen transport.
Na installatie start de ESP32 opnieuw op en probeert hij verbinding te maken met wifi. Open Logs om te zien wat het apparaat meldt. Een succesvolle firmware-installatie bewijst nog niet dat wifi correct is ingesteld; die twee dingen controleren we afzonderlijk.
Het verschil tussen opslaan en installeren
Dit is misschien wel de belangrijkste gewoonte bij ESPHome. Als je de YAML bewerkt en op Save klikt, verandert de firmware op de ESP32 nog niet. Je hebt alleen het configuratiebestand aangepast.
Pas met Install wordt de configuratie gecontroleerd, omgezet in firmware en naar het apparaat verstuurd. Bij latere wijzigingen kan dit meestal draadloos gebeuren via OTA: Over-The-Air.
Voorspel nu wat er gebeurt wanneer je alleen de naam in de YAML wijzigt en opslaat, zonder opnieuw te installeren. De ESP32 blijft de eerder geïnstalleerde firmware uitvoeren. Controleer dit met de logs of het gedrag van het apparaat.
Wanneer het bord niet wordt gevonden
Begin bij de eenvoudigste vragen. Ontvangt de ESP32 voeding? Gebruik je een USB-datakabel? Is de gekozen USB-poort werkelijk de ESP32? Maakt je browser of computer de seriële verbinding beschikbaar? Werkt dezelfde kabel rechtstreeks op de computer in plaats van via een hub?
Bij sommige ontwikkelborden moet je tijdens het begin van het flashen de knop BOOT ingedrukt houden. Doe dit pas nadat je de normale procedure hebt geprobeerd en de foutmelding daar aanleiding toe geeft.
Verander niet tegelijk van kabel, USB-poort, bordtype en installatieprocedure. Eén gerichte test vertelt veel meer.
Wat je uit dit hoofdstuk kunt meenemen
Je weet waar de Device Builder voor dient, hoe je een basisconfiguratie aanmaakt en waarom de eerste installatie via USB een aparte stap is. Opslaan en installeren zijn niet hetzelfde. In het volgende hoofdstuk voegen we onze eerste eigen functie toe: een led die we vanuit ESPHome kunnen besturen.