Problemen systematisch onderzoeken

Iedereen die met elektronica bouwt, krijgt vroeg of laat te maken met een apparaat dat niet doet wat je verwacht. Het verschil tussen vastlopen en verder komen is vaak niet de hoeveelheid kennis, maar de manier waarop je onderzoekt.

Begin bij wat je werkelijk weet

'ESPHome werkt niet' is geen bruikbare diagnose. 'De Device Builder kan firmware bouwen, maar ziet mijn ESP32 niet via USB' is al veel duidelijker. Nog specifieker is: 'Het voedingslampje brandt, maar mijn computer toont geen seriële poort.'

Probeer een probleem daarom altijd op te delen in losse lagen:

Voeding → USB en installatie → firmware → GPIO of sensor → wifi → API → Home Assistant → automatisering.

Controleer iedere laag voordat je naar de volgende gaat.

Voorbeeld: de led blijft uit

We verwachten dat de testled aangaat. Eerst controleren we of de gewenste schakelaar in Home Assistant echt aan staat. Als dat zo is, maar de led uitblijft, kan het probleem in de fysieke schakeling zitten.

Koppel de voeding los en volg daarna de keten: GPIO23, weerstand, anode, kathode en GND. Controleer ook of het fysieke bord echt de GPIO23 heeft die in de YAML staat. Pas daarna veranderen we iets.

Voorbeeld: de BME280 wordt niet gevonden

Bekijk de logs. Is er een I²C-adres zichtbaar? Zo niet, controleer de voeding en SDA/SCL. Is er wel een adres zichtbaar, vergelijk dit dan met address: in de configuratie. Vervang niet onmiddellijk de sensor én de USB-kabel én de hele YAML.

Als je na één wijziging opnieuw installeert, kun je vaststellen wat effect had. Dat kost soms iets meer tijd, maar levert bruikbare kennis op.

Voorbeeld: de sensor is online, maar Home Assistant ziet niets

'Online' in de Device Builder betekent niet automatisch dat Home Assistant via de native API verbonden is. Controleer of je in de ESPHome-integratie het juiste apparaat bekijkt. Onderzoek vervolgens IP-adres, firewall, API-verbinding en encryptiesleutel.

Bij meerdere netwerken of VLAN's is het zinvol afzonderlijk te controleren of mDNS-ontdekking werkt en of het IP-adres rechtstreeks bereikbaar is. Schakel je firewall niet volledig uit om een probleem te verbergen; maak uiteindelijk alleen de noodzakelijke verbindingen mogelijk.

Logboeken leren lezen

Gebruik Logs in de Device Builder om berichten van de ESP32 te bekijken. Let op de eerste concrete foutmelding, het moment waarop die verschijnt en of de fout na een herstart terugkomt.

Een melding over een onvindbare I²C-sensor is iets anders dan een WiFi-verbindingsfout. Een YAML-validatiefout ontstaat zelfs al voordat nieuwe firmware op de ESP32 staat. Iedere melding helpt ons de plek van het probleem kleiner te maken.

Een eenvoudig testverslag

Maak bij lastige problemen vier korte notities:

• Verwachting: wat had er moeten gebeuren?
• Waarneming: wat gebeurt er daadwerkelijk?
• Test: welk ene onderdeel of welke ene instelling verander ik?
• Conclusie: wat weet ik na deze test meer dan daarvoor?

Zo maak je van proberen een onderzoek. Ook wanneer je iemand anders of AI om hulp vraagt, zijn deze vier gegevens vaak waardevoller dan een lange omschrijving dat het apparaat 'gewoon niets doet'.

Wat je uit dit hoofdstuk kunt meenemen

Een fout is bruikbare informatie zodra je precies kunt beschrijven waar de verwachting afwijkt van de werkelijkheid. Door één ding tegelijk te veranderen, kun je oorzaken uitsluiten zonder steeds opnieuw te beginnen. In het volgende hoofdstuk combineren we onze kennis in één volledig project.