Je ESP32 koppelen aan Home Assistant

Nu de ESP32 temperatuur, luchtvochtigheid en luchtdruk meet, willen we die waarden gemakkelijker kunnen bekijken. Daarvoor gebruiken we Home Assistant. De ESP32 blijft meten; Home Assistant laat de resultaten zien en kan ze later gebruiken in automatiseringen.

De native API

ESPHome heeft een eigen netwerkverbinding voor communicatie met Home Assistant: de native API. Via die verbinding kan Home Assistant toestanden en meetwaarden ontvangen en opdrachten naar het apparaat sturen.

De configuratiewizard maakt normaal gesproken een api:-sectie aan, bij voorkeur met een encryptiesleutel. Bewaar die sleutel zorgvuldig en laat de gegenereerde configuratie staan. Zet beveiliging niet uit omdat dat bij een eerste verbindingsprobleem gemakkelijker lijkt.

Home Assistant en de Device Builder vervullen hierbij verschillende rollen. De Device Builder maakt firmware. De ESPHome-integratie binnen Home Assistant praat met het apparaat dat die firmware uitvoert. Het ene kan dus werken terwijl het andere tijdelijk niet bereikbaar is.

Het apparaat toevoegen

Open Home Assistant en ga naar Instellingen → Apparaten en diensten. Soms wordt de ESP32 automatisch ontdekt. Kies dan de aangeboden ESPHome-integratie en volg de stappen.

Verschijnt hij niet, kies dan Integratie toevoegen en zoek naar ESPHome. Geef de hostnaam of het IP-adres van de ESP32 op. Afhankelijk van de configuratie kan Home Assistant om de encryptiesleutel vragen. Gebruik de sleutel die bij deze specifieke ESP32 hoort.

Automatische ontdekking gebruikt in veel netwerken mDNS. Wanneer de ESP32 in een apart IoT-VLAN zit, werkt ontdekking niet altijd tussen de netwerken. Een handmatige verbinding via het IP-adres kan dan uitkomst bieden, mits de router of firewall de vereiste verbinding toestaat.

De entiteiten terugvinden

Een apparaat is in Home Assistant bijvoorbeeld onze complete ESP32. Een entiteit is één functie of meetwaarde van dat apparaat, zoals de temperatuur, luchtvochtigheid, drukknop of ledschakelaar.

Open het apparaat en controleer of de verwachte entiteiten aanwezig zijn. Zet de led aan en uit. Druk op de knop. Kijk of temperatuur en luchtvochtigheid veranderen. Op deze manier testen we de volledige keten van hardware tot Home Assistant.

Maak de proef niet groter dan nodig

Lukt de koppeling niet? Controleer eerst of de ESP32 in de Device Builder als online verschijnt en of de logs wifi-verbinding melden. Controleer vervolgens of Home Assistant het adres kan bereiken, of de API beschikbaar is en of de juiste encryptiesleutel is opgegeven.

Open niet onnodig poorten naar internet. Voor onze toepassing is communicatie binnen het eigen netwerk voldoende.

Wat je uit dit hoofdstuk kunt meenemen

Je weet wat de native API doet, hoe een apparaat en een entiteit verschillen en hoe je een ESPHome-apparaat aan Home Assistant koppelt. De metingen zijn nu bruikbaar voor andere toepassingen. In het volgende hoofdstuk maken we daar een eenvoudige automatisering van.