Hoofdstuk 10 van 14

Betrouwbaarheid, beveiliging en onderhoud

Maak je ESPHome-project betrouwbaar: denk aan veilige toestanden, netwerkuitval, OTA-updates, secrets, privacy en onderhoud.

Een ESP32 op een breadboard kan prima werken tijdens een demonstratie. Maar wanneer je het apparaat maandenlang in De Werkplaats wilt gebruiken, komen er andere vragen bij. Wat gebeurt er na een stroomstoring? Wat als wifi wegvalt? Kun je herstellen wanneer een update mislukt?

Denk aan de veilige toestand

Onze led is ongevaarlijk wanneer hij even onverwacht brandt. Bij een pomp, verwarming of elektrische vergrendeling is dat anders. Bepaal daarom vooraf wat de uitgang moet doen tijdens opstarten, reset en verbindingsverlies.

ESPHome-instellingen zoals restore_mode kunnen het gedrag na opstarten beïnvloeden. Maar instellingen in firmware zijn niet altijd voldoende: een GPIO kan tijdens het bootproces kort ongedefinieerd zijn. Voor kritieke toepassingen zijn een geschikte driver, veilige externe weerstanden en soms onafhankelijke hardwarebeveiligingen nodig.

Netwerk weg is niet hetzelfde als apparaat defect

Een ESP32 kan zijn lokale sensor blijven uitlezen wanneer Home Assistant onbereikbaar is. Een lokale on_press-actie kan eveneens blijven werken. De gegevens zijn dan alleen tijdelijk niet zichtbaar in Home Assistant.

Test dit bewust. Trek niet zomaar de netwerkkabel uit de hele installatie als andere systemen daardoor uitvallen. Schakel liever gecontroleerd het testnetwerk uit of blokkeer tijdelijk de verbinding van één testapparaat, en controleer wat je eigen ESP32 nog doet.

Updates via OTA

Na de eerste USB-installatie kun je een ESPHome-apparaat doorgaans draadloos bijwerken. Dat noemen we OTA. Zorg wel dat je weet waar het apparaat staat en dat je het zo nodig weer fysiek via USB kunt herstellen.

De officiële ESPHome-documentatie ondersteunt inmiddels OTA-encryptie die dezelfde sleutel kan gebruiken als de native API. Neem waar mogelijk de actuele door de wizard gemaakte beveiligingsinstellingen over. Vermijd oude internetvoorbeelden die alleen een onbeveiligde OTA-verbinding tonen.

Wijzig geen beveiligingssleutel zonder te begrijpen hoe de bestaande verbinding tijdens de overgang blijft werken. Maak vóór een belangrijke wijziging een kopie van de configuratie en de bijbehorende secrets.

Secrets en privacy

Bewaar wifi-wachtwoorden en encryptiesleutels niet in configuraties die je publiek deelt. De Device Builder kan gevoelige waarden onderbrengen in secrets.yaml en vanuit andere configuraties verwijzen met !secret.

Een lokale installatie betekent niet automatisch dat ieder risico is verdwenen. Apparaten binnen je eigen netwerk kunnen nog steeds verkeerd zijn geconfigureerd. Gebruik unieke sterke sleutels, zet geen onnodige services open en geef IoT-apparaten alleen de netwerktoegang die ze werkelijk nodig hebben.

Een project documenteren

Bewaar naast je YAML een klein overzicht: welk bord heb je gebruikt, welke GPIO hoort bij welke draad, wat is de voedingsspanning, welk I²C-adres heeft de sensor en welke versie werkte als laatste goed? Een foto van de schakeling kan later veel zoekwerk voorkomen.

Een goede projectback-up bestaat uit meer dan een kopie van een firmwarebestand. Bewaar juist de configuratie, benodigde secrets op een veilige plaats en je eigen aantekeningen.

Wat je uit dit hoofdstuk kunt meenemen

Een betrouwbaar ESPHome-project moet niet alleen onder ideale omstandigheden werken. Je hebt geleerd na te denken over opstartgedrag, herstel, netwerkverlies, OTA, beveiliging en documentatie. In het volgende hoofdstuk gebruiken we die inzichten om fouten gericht te onderzoeken.