Der ESP32 taucht nach einem Neustart nicht mehr im WLAN auf. Für die Fehlersuche brauchst du die Meldungen vom Start, bevor ESPHome das Netzwerk erreicht. Öffne dazu die serielle Ausgabe und löse den Neustart erst aus, wenn sie läuft.
1. Den richtigen Anschluss finden
Verbinde das Board mit einem USB-Datenkabel. Schau nach, welcher serielle Port beim Einstecken erscheint. Das kann unter Windows etwa COM3 sein, unter Linux beispielsweise /dev/ttyACM0 oder /dev/ttyUSB0. Die Namen sind Beispiele.
Wenn kein Port erscheint, prüfe zuerst Kabel und USB-Buchse. Je nach Board kommt die Logausgabe über eine USB-UART-Brücke, eine native USB-Schnittstelle oder einen separat herausgeführten UART. Welche Schnittstelle nutzbar ist, steht in der Board-Dokumentation. Schließe einen externen Adapter nur an, wenn Pinbelegung und Signalpegel zum Board passen.
2. Log öffnen, dann den Neustart auslösen
esphome logs geraet.yaml --device COM3Ersetze Dateiname und Port durch deine Werte. Schließe vorher andere serielle Monitore, die denselben Port belegen. Wenn der Logstream geöffnet ist und du das Gerät gefahrlos unterbrechen kannst, starte es über die Reset-Taste neu, sofern dein Board eine hat. Lass die Ausgabe bis zum erwarteten Start oder bis zum nächsten unerwarteten Neustart mitlaufen.
Bei manchen Boards kann schon das Öffnen der seriellen Schnittstelle einen Reset auslösen. Bei nativer USB-Verbindung kann der Port während eines Resets kurz verschwinden. Wenn die Verbindung abreißt, prüfe, ob der Port wieder erscheint. Für sehr frühe Meldungen kann ein vom Board unterstützter separater UART nötig sein.
3. Den Startablauf eingrenzen
- Der Start beginnt immer wieder von vorn. Sichere die Meldungen unmittelbar vor dem nächsten Neustart. Falls ein Reset-Grund oder ein Backtrace ausgegeben wird, nimm ihn in den Ausschnitt auf.
- Das Gerät startet weiter, bleibt aber offline. Suche nach Meldungen zum WLAN- oder Netzwerkaufbau. Ein Verbindungsfehler allein verrät noch nicht, warum die Verbindung ausbleibt.
- Die Konsole bleibt leer oder zeigt Zeichenmüll. Prüfe den Port und die konfigurierte Log-Schnittstelle. Für UART gilt:
logger.baud_rate: 0schaltet die Firmware-Logausgabe ab. Sind die Zeichen unlesbar, gleiche die Baudrate des Monitors mit der Firmware-Konfiguration ab.
Notiere zu deinem Mitschnitt Board-Modell, ESPHome-Version und Zeitpunkt des Resets. Entferne Schlüssel und WLAN-Zugangsdaten vor dem Teilen. Sobald das Gerät wieder erreichbar ist, kannst du mit dem Leitfaden zu Netzwerk- und seriellen Logs weiterprüfen.
[…] Zum Weiterlesen: ESPHome startet nicht: Boot-Logs über USB mitschneiden. […]