WetterCube/Diagnose und Fehlersuche
Das /log lesen
Der Cube führt ab v1.9.0 ein kleines Protokoll im Speicher (die letzten 25 Einträge, neueste zuerst; nach einem Neustart leer). Es lässt sich im Browser öffnen:
- im Normalbetrieb:
http://wettercube.local/log(auch über „Log ansehen“ in der Firmware-Karte der Web-Oberfläche) - im Einrichtungsmodus (Handy am Netz „WetterCube-Setup“):
http://192.168.4.1/log
| Zeile im Kopf | Bedeutung |
|---|---|
| Version | installierte Firmware |
| Freier Heap | freier RAM: aktuell, tiefster Stand seit dem Start und größter zusammenhängender Block. Für HTTPS werden etwa 40–50 KB am Stück gebraucht |
| LVGL-Speicher | freier Speicher im LVGL-Pool (96 KB) |
| Uptime | Minuten seit dem Start |
| Letzter Neustart | Strom angeschlossen, Software-Neustart (z. B. nach Update), Absturz, Watchdog oder Brownout |
| WLAN beim Start | Dauer und Signalstärke oder der Fehlergrund (z. B. „Netzwerk nicht gefunden“, „Authentifizierung fehlgeschlagen“) |
| WLAN jetzt | Netzwerk, Signalstärke und IP-Adresse |
| Standort | Stadt mit Koordinaten (0,0000 heißt: noch nicht gefunden) |
| Letzter Wetter-/Pollen-Abruf OK | wie lange der letzte erfolgreiche Abruf her ist |
Darunter stehen die Ereignisse mit Uhrzeit (oder Sekunden seit dem Start, solange die Uhr noch nicht synchronisiert ist):
| Eintrag | Bedeutung |
|---|---|
[Boot] v1.9.0, Neustart: … |
Start mit Grund des Neustarts |
[WLAN] verbunden nach 3.2 s, Signal -61 dBm |
WLAN steht |
[WLAN] Start fehlgeschlagen: … |
WLAN nach 15 Sekunden nicht erreicht, mit Grund; danach öffnet sich das Portal |
[WLAN] Netzwerk gewechselt zu '…', Neustart |
WLAN-Wechsel über die Web-Oberfläche |
[Start] mDNS: …, [Start] Web-UI laeuft … |
Name und Web-Oberfläche sind erreichbar |
[Portal] Einrichtungsmodus offen … / Timeout, Neustart |
Einrichtungsportal an bzw. nach 3 Minuten beendet |
[Geo] Suche 'Berlin' / Gefunden: 52.5200, 13.4050 |
Stadt wurde gefunden |
[Geo] Fehlgeschlagen fuer '…': kein Treffer |
Stadtname nicht gefunden (Umlaute? Tippfehler?) |
[Geo] Fehlgeschlagen fuer '…': HTTP -1 |
keine Verbindung (kein Internet, TLS-Fehler, zu wenig Heap) |
[Wetter] OK: 18.2 C, 62%, WMO 3, UV 4.1 |
Wetter-Abruf erfolgreich |
[Wetter] Fehler: HTTP -1 (Heap 45000) |
Abruf fehlgeschlagen, mit freiem Heap |
[Wetter] JSON-Fehler: … |
die Antwort ließ sich nicht lesen |
[Pollen] OK … / [Luft] OK … |
Pollen- und Luftqualitätsdaten geladen |
[Pollen] Fehler: HTTP … / JSON-Fehler: … |
Abruf der Air-Quality-API fehlgeschlagen |
[Config] gespeichert / Standort geaendert: … |
Änderungen über die Web-Oberfläche |
[OTA] Pruefung: installiert …, verfuegbar … |
Versionsprüfung (siehe Updates) |
[OTA] Download startet …, … Bytes geschrieben, Neustart |
Update läuft bzw. ist fertig |
[OTA] Download-Fehler: HTTP …, Fehler: …, Update.begin fehlgeschlagen … |
Update fehlgeschlagen |
Serieller Monitor
Alle Log-Meldungen erscheinen zusätzlich im Seriellen Monitor. Er hilft, wenn der Cube nicht erreichbar ist: Cube per USB-C anschließen, in der Arduino IDE den Seriellen Monitor öffnen und 115200 Baud einstellen. Der Cube muss dafür USB CDC On Boot: Enabled haben (so sind die veröffentlichten Firmwares gebaut). Nach dem Öffnen den Cube einmal neu starten (Reset-Taste oder USB ab- und anstecken), damit die Meldungen vom Start an sichtbar sind.
Typische Probleme
| Problem | Ursache und Abhilfe |
|---|---|
| Cube zeigt „Portal: WetterCube-Setup“, obwohl das WLAN eingerichtet war | Das WLAN war beim Start 15 Sekunden lang nicht erreichbar (Router aus, falsches Passwort, nur 5-GHz-Netz). Der ESP32-C3 kann nur 2,4 GHz. Der Grund steht im /log (unter http://192.168.4.1/log) bei „WLAN beim Start“. Die Zugangsdaten bleiben gespeichert, nach 3 Minuten startet der Cube neu und versucht es erneut. Alternativ im Portal neu eintragen
|
| Aussetzer, Neustarts | Im /log „Letzter Neustart: BROWNOUT“? Dann ein anderes Netzteil und ein kurzes Kabel verwenden
|
| Stadt wird nicht gefunden | Umlaute weglassen (Munchen, Koln), Namen prüfen. Städtenamen mit Leerzeichen („Bad Schwartau“) funktionieren seit v1.7.3. Im Log steht bei [Geo] der Grund
|
| Uhrzeit zeigt falsche Zeit / Nachtmodus greift nicht | Die Zeit kommt per NTP und braucht Internet. Im /log prüfen, ob das WLAN verbunden ist
|
| Alle Werte stehen auf „--“ oder 0 | Der erste Wetter-Abruf läuft direkt nach dem Start. Im /log auf [Wetter] achten. Bei HTTP -1 Internet und Router prüfen, bei sehr niedrigem Heap neu starten
|
| Wetterwerte stehen still | Im Kopf des /log steht, wann der letzte Abruf erfolgreich war. Fehlschläge stehen mit Grund in den Einträgen
|
| Luftqualität immer grün | Behoben in v1.8.2 (zu kleiner JSON-Puffer). Wer noch eine ältere Version hat, aktualisiert per OTA |
| Pollen zeigen überall „Keine“ | Außerhalb der Pollensaison oder außerhalb Europas liefert Open-Meteo keine Pollendaten |
Web-Oberfläche unter wettercube.local nicht erreichbar |
mDNS wird nicht von jedem Netz/Gerät unterstützt (ältere Windows-Versionen brauchen Bonjour). Stattdessen die IP-Adresse vom Boot-Screen verwenden (5 Sekunden sichtbar, per Neustart erneut) oder im Router nachsehen |
| Update bricht mit „download error“ ab | GitHub Pages liefert die neue Firmware manchmal erst nach einigen Minuten. Kurz warten und wiederholen |
| Update: „begin failed“ | Der Cube hat keine Partitionstabelle mit zwei App-Slots. Einmal per USB oder Web-Installer neu aufspielen |
| Nach dem Update fragt der Cube wieder nach dem WLAN | Die Einstellungen liegen im NVS und bleiben bei einem Update normalerweise erhalten. Wurde die Partitionstabelle geändert oder der Flash gelöscht (Web-Installer löscht ihn), muss neu eingerichtet werden |
| Display bleibt schwarz | Nachtmodus aktiv (Taste drücken weckt für 15 s) oder Helligkeit zu niedrig. Wenn auch das nicht hilft, Verkabelung gemäß Hardware prüfen |
| Display zeigt falsche Farben | LV_COLOR_16_SWAP muss 0 sein (siehe Entwicklung)
|
| Sketch zu groß (beim Selbstbauen) | Partitionsschema Custom wählen (siehe Entwicklung) |