From ad2719a2674755ff71ae8f846fd16ac1c168897b Mon Sep 17 00:00:00 2001 From: Felix <337477530+du13500@users.noreply.github.com> Date: Mon, 9 Nov 2026 13:05:58 +0100 Subject: [PATCH] =?UTF-8?q?Doku:=20Testplan=20auf=20v0.5.3=20gebracht,=20V?= =?UTF-8?q?ALIDATION.md=20aufgel=C3=B6st?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - TESTPLAN.md: aktueller Hardwaretest v0.5.3, dauerhafte Prüfungen, Speicherstand des letzten Builds, vollständige Liste der lokalen Tests - VALIDATION.md entfernt (Speicherzahlen jetzt im Testplan) - ROADMAP verweist für Gerätetests auf den Testplan Co-Authored-By: Claude Opus 5.5 --- ROADMAP.md | 8 +----- TESTPLAN.md | 74 ++++++++++++++++++++++++++++++++------------------- VALIDATION.md | 12 --------- 3 files changed, 48 insertions(+), 46 deletions(-) delete mode 100644 VALIDATION.md diff --git a/ROADMAP.md b/ROADMAP.md index 4f0e58d..747f62b 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -4,13 +4,7 @@ Stand: 09.11.2026. Erledigtes steht in [`CHANGELOG.md`](CHANGELOG.md). ## Nächste Prüfungen auf dem Gerät -- **v0.5.3-dev:** Menü und Auge-Symbol im Webinterface; 3-Tage-Vorhersage als eigene Ansicht (Migration der alten Einstellung); Radar-Optionen (Betreiber A/B/C, Geschwindigkeit, ▲▼, MIL), Filter mit Abfrage aller Flugzeuge im Radius (Dauer und freien Speicher im Log beobachten); Notfalldarstellung; neue Typenliste; Routen mit 4-stelligen ICAO-Codes (kleine Flugplätze statt „N/A“); **Sigma-Delta nachts bei 1–10 % gegen PWM vergleichen** (Aufblitzen, Fiepen, Helligkeitsstufen). Offene Beobachtung: easyJet ohne Kennzeichen und Route – mit dem neuen Log prüfen. -- **Flugradar:** Langzeittest über mehrere Tage mit Rotation; Anfragezähler „adsb.lol heute“ beobachten. adsb.lol nennt keine festen Zahlen (kostenlose Schlüssel: festes Budget pro Schlüssel, ohne Garantie); Budgetwerte (`src/RadarBudget.h`) anhand des Verbrauchs im adsb.lol-Dashboard prüfen. Freien Speicher während der Abfrage im Blick behalten (ca. 5 KB bei 4-KB-TLS-Puffer). -- **Wetter:** Exception 29 beim Programmwechsel ist seit den Speicherkorrekturen nicht wieder aufgetreten; im Langzeittest weiter beobachten. -- **Zeitzone, Sommerzeit, Nachtmodus:** gezielt prüfen, spätestens bei der Zeitumstellung Ende März. -- **Abfahrten:** zehn Abfahrten mit Seitenwechsel 5+5, Verhalten bei Verbindungsproblemen. -- **Helligkeit:** 300 Hz / 1023 Stufen bei 1 %; bei Fiepen oder Flimmern `BL_PWM_FREQ` in `src/main.cpp` anpassen. -- **Flug-Tracker** mit gültigem aviationstack-Schlüssel vollständig testen; Airline-Erholung nach fehlgeschlagenem Zusatzabruf prüfen. +Aktueller Hardwaretest und dauerhafte Prüfungen stehen in [`TESTPLAN.md`](TESTPLAN.md). ## Geplante Versionen diff --git a/TESTPLAN.md b/TESTPLAN.md index c9734c5..1a65b6a 100644 --- a/TESTPLAN.md +++ b/TESTPLAN.md @@ -1,48 +1,68 @@ -# Hardwaretest v0.4.14.5 +# Testplan -1. Bei 1 % Helligkeit Counter 9s → 10s, 99s → 100s sowie einen Wechsel zum nächsten Flugzeug beobachten. Aufblitzen dokumentieren; Normal- und Nachtmodus weiterhin prüfen. -2. Ortssuche und Kartenauswahl mehrfach bei Wetter und Radar, auch während Programmwechseln. Namen, Koordinaten und Speichern prüfen. -3. Browser offline schalten, Freitextsuche und Öffnen der Karte auslösen. Roter Text „Internetverbindung erforderlich“. Anschließend online erneut suchen. -4. Anbieterpause, echten Verbindungsfehler und erfolgreiche leere Radarantwort unterscheiden. Counter ein-/ausschalten und Einstellung nach Neustart prüfen. -5. Airline nach fehlgeschlagenem Zusatzabruf und späterer Erholung beobachten. Fehlende Routen dürfen weiterhin N/A bleiben. -6. System: Ortsdienst standardmäßig eingeklappt, Anbieterlinks unter Wartung öffnen. +Stand: v0.5.3-dev (09.11.2026). Dieser Plan wird mit jeder Version aktualisiert; frühere Pläne stehen in der Git-Historie, Änderungen in [`CHANGELOG.md`](CHANGELOG.md). -> Aktueller Stand: v0.4.14.5. Historische Angaben unten beziehen sich auf die jeweils genannten Builds. +## Hardwaretest v0.5.3-dev -# Testplan v0.4.13 +1. **Dimmverfahren:** Nachts bei 1–10 % unter *Anzeige → Dimmverfahren* zwischen Standard (PWM) und Sigma-Delta wechseln. Aufblitzen, Fiepen und saubere Helligkeitsstufen vergleichen; dabei auch Radar mit Abrufen und offenes Webinterface laufen lassen. +2. **Webinterface:** Menü hinter ☰ öffnen und schließen (Tippen daneben, Escape), Seitenname unter dem Titel; Auge-Symbol nur beim Tippen, nach dem Speichern wieder verdeckt und leer. +3. **3-Tage-Vorhersage:** nach dem Update als eigene Zeile unter „Wetter“ angehakt (wenn sie vorher aktiv war); eigene Dauer, ▶ Jetzt anzeigen; Wetter-Reiter ohne die alte Checkbox. Rotation in der Reihenfolge der Liste. +4. **Radar-Optionen:** Betreiber A/B/C bei einem Militärflug (z. B. RCH…), Geschwindigkeit in km/h und kt im Wechsel mit dem Kennzeichen, ▲▼ bei Steig-/Sinkflug, MIL-Markierung an und aus. +5. **Filter:** einzeln aktivieren (z. B. „am Boden“, „Hubschrauber“). Im Log Dauer und kleinsten freien Speicher der Radar-Zeile beobachten, im Status „… Flugzeuge geprüft“. Großen Radius (100 km) gegenprüfen. +6. **Routen:** Flüge zu kleinen Flugplätzen zeigen 4-stellige ICAO-Codes statt „N/A“; 3-stellige Routen unverändert. +7. **Log:** erfolgreiche Radarabrufe als eine Zeile; Zusatzabfragen mit „leer“ oder „übersprungen“. Offene Beobachtung: easyJet ohne Kennzeichen und Route – bei Auftreten Statuszeilen „Aktuelles Flugzeug“ und „Radar-Route“ sowie den Log sichern. +8. **Notfall** (nur falls zufällig zu sehen): Rufzeichen und Routenzeile rot, Route und „SQUAWK 7700“ im 3-s-Wechsel. -## Vorrangiger Hardwaretest +## Dauerhafte Prüfungen -1. Wetter: Dresden und New York direkt suchen, Treffer auswählen und speichern. Anschließend dasselbe im Flugradar testen. -2. Kartenpunkte bei ORD sowie am bisherigen Wetterstandort wählen. Ortsname und Koordinaten prüfen; mehrere Punkte nacheinander setzen. -3. Bei kontrollierter Ablehnung müssen Einstellungen weiterhin bedienbar sein. Manuelle Koordinaten und Anzeigename bleiben als Ausweichmöglichkeit verfügbar. Es darf kein Neustart erfolgen. -4. Ortsabfragen nach längerem Radar-Betrieb und nach Programmwechseln wiederholen. Bei jedem Fehler sofort Diagnose kopieren: Geo:Vorbereitung, Geo:Verbinden, Geo:Empfang und Geo:TLS-frei zeigen den erreichten Abschnitt. Heap-knapp vor Geo:Verbinden bedeutet Ablehnung vor dem Verbindungsaufbau; nach HTTP 200 bedeutet es Ablehnung während des Empfangs. Empfang:Fehler, Datei:Fehler und Antwort:ZuGross sind getrennte Fehler. -5. Bekannte Embraer E170/E175/E190/E195 und E2-Modelle prüfen. Der lesbare Name soll bei später eintreffenden Metadaten erhalten bleiben. Auch B38M und A21N prüfen. -6. VVO-Hinweis prüfen; Abfahrten, Radar, Wetter und Programmwechsel als kurzen Regressionstest laufen lassen. +- **Flugradar:** Langzeittest über mehrere Tage mit Rotation; Zähler „adsb.lol heute“ und Verbrauch im adsb.lol-Dashboard vergleichen (`src/RadarBudget.h`). Freien Speicher während der Abfrage im Blick behalten (ca. 5 KB bei 4-KB-TLS-Puffer). +- **Wetter:** Exception 29 beim Programmwechsel ist seit den Speicherkorrekturen nicht wieder aufgetreten; im Langzeittest weiter beobachten. +- **Zeitzone, Sommerzeit, Nachtmodus:** spätestens bei der Zeitumstellung Ende März prüfen. +- **Abfahrten:** zehn Abfahrten mit Seitenwechsel 5+5, Verhalten bei Verbindungsproblemen. +- **Flug-Tracker** mit gültigem aviationstack-Schlüssel vollständig testen. -HTTP 429 mit Pause und anschließender Erholung ist kein Neustart. Bei einer Exception den Log direkt nach dem Boot und die ELF-Datei des tatsächlich installierten Builds sichern. Gleicher Reset-Text und RTC-Marker in späteren Logs desselben Starts bedeuten keinen erneuten Absturz. Der RTC-Marker ist ein Hinweis, kein Ursachenbeweis. +**Bei Fehlern:** HTTP 429 mit Pause und anschließender Erholung ist kein Neustart. Nach einem Neustart sofort unter *System → Diagnose* den Log laden und die ELF-Datei des installierten Builds sichern (Begleitpaket des Builds). Gleicher Reset-Text und RTC-Marker in späteren Logs desselben Starts bedeuten keinen erneuten Absturz; der RTC-Marker ist ein Hinweis, kein Ursachenbeweis. -Die Ortsuche auch direkt nach erfolgreicher Kartenauflösung und im Wechselbetrieb Wetter/Radar prüfen. Ein kontrollierter Speicherabbruch ist kein erfolgreicher Funktionstest. Bei Reboot sofort Log und ELF sichern. +## Stand des letzten Builds + +v0.5.3-dev, GitHub Actions, PlatformIO mit ESP8266-Framework 3.1.2 und gepinnten Bibliotheken: + +| | belegt | von | Anteil | +| --- | --- | --- | --- | +| Statischer RAM | 52.144 Byte | 81.920 Byte | 63,7 % | +| Flash | 765.039 Byte | 1.044.464 Byte | 73,2 % | + +Zum Vergleich v0.4.14.5.1: 53.288 Byte RAM, 709.007 Byte Flash – feste Texte und Tabellen liegen inzwischen im Flash. ## Lokale Prüfungen -Im entpackten Versionsordner zunächst `pio pkg install -e smalltv_ultra` ausführen. Danach: +Dieselben Prüfungen führt der Workflow [`build.yml`](.github/workflows/build.yml) bei jedem Push aus. ```sh python3 tools/check.py -python3 tools/test_geo_transfer.py -python3 tools/test_network_json.py +python3 tools/webui_en.py >/dev/null && git diff --exit-code src/webui_en.h python3 tools/test_radar.py +python3 tools/test_motion.py python3 tools/test_policy.py +python3 tools/test_chunked.py +python3 tools/test_destinations.py python3 tools/test_display.py +python3 tools/test_brightness.py python3 tools/test_diagnostics.py python3 tools/test_enrichment.py -g++ -std=c++11 -Wall -Wextra -Werror tests/test_core.cpp -o /tmp/smalltv-test-core -/tmp/smalltv-test-core -npm ci --ignore-scripts -npx playwright install --with-deps webkit -npm run test:webui +g++ -std=c++11 -Wall -Wextra -Werror tests/test_core.cpp -o /tmp/pixelstop-core-test && /tmp/pixelstop-core-test +npm install --ignore-scripts && npx playwright install webkit && npm run test:webui +``` + +Nach `pio pkg install -e smalltv_ultra` (gepinntes ArduinoJson): + +```sh +python3 tools/test_network_json.py +python3 tools/test_radar_scan.py +python3 tools/test_airline_cache.py +python3 tools/test_vvo_response.py +python3 tools/test_geo_buffer.py pio run -e smalltv_ultra ``` -`test_geo_transfer.py` liest die echte `Stream::SendGenericPeekBuffer`-Routine aus dem installierten Arduino-ESP8266-Framework. Geprüft werden der ursprüngliche Null-Kapazitäts-Timeout, erfolgreicher Transfer, Größenlimit, Kurzschreiben, Transport-/Öffnungsfehler, Speichermangel vor und während des Empfangs sowie Aufräumen der temporären Datei. Netzwerk und Dateisystem werden dabei simuliert; das ersetzt keinen Hardwaretest. +Die Bilder im README erzeugt `python3 tools/render_screens.py docs/screens --frame --sheet` aus dem echten Displaycode. diff --git a/VALIDATION.md b/VALIDATION.md deleted file mode 100644 index b29b6b2..0000000 --- a/VALIDATION.md +++ /dev/null @@ -1,12 +0,0 @@ -# Validierung v0.4.14.5.1 - -- Firmwarebuild bestanden: PlatformIO 6.1.19, ESP8266-Framework 3.1.2, gepinnte Bibliotheken. -- Statischer RAM: 53.288 von 81.920 Bytes. Flash: 709.007 von 1.044.464 Bytes. -- ELF enthält die aktiv ausgewählte phasensynchrone Waveform-Implementierung. Rund 512 Byte zusätzlicher statischer RAM gegenüber v0.4.14.5. -- VVO-Test führt die Produktions-Abfragefunktion mit ArduinoJson aus: exakte unbediente Haltestelle, andere ServiceError-Meldungen, HTTP-Fehler, ungültiges JSON, erfolgreiche Abfahrten, leere Liste und Erholung. Nur die vereinbarte Antwort erhält den neuen Zustand. -- Displaytest prüft die graue zweiteilige Meldung, den neutralen Footer, ausbleibende Wiederholungs-Neuzeichnungen sowie den Wechsel zur bisherigen Fehleranzeige. -- Bestehende Tests für Helligkeit, Radar, Anbieterpausen, Airline-Cache, Diagnose, Display, JSON und Geo-Speicherschutz bleiben enthalten. - -## Hardwaregrenze - -Die Hardwareursache des Aufblitzens ist nicht nachgewiesen. Die alternative, im vorhandenen Framework enthaltene PWM ist ein begrenzter Versuch. Frequenz, Helligkeitswerte und die Prüfung unveränderter Werte bleiben erhalten. Bei 1 % Helligkeit Counterübergänge und neue Flugzeuge sowie den Nachtmodus prüfen. Radar- und Geo-Abruflogik wurden nicht geändert.