Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,6 @@ jobs:
- name: Quellen und Display prüfen
run: |
python3 tools/check.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
Expand All @@ -72,14 +71,16 @@ jobs:
- name: PlatformIO installieren
run: pip install platformio==6.1.19

- name: JSON- und Geo-Speicherschutz prüfen
- name: JSON-, Geo- und Netzwerk-Speicherschutz prüfen
run: |
pio pkg install -e smalltv_ultra
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
python3 tools/test_geo_transfer.py
python3 tools/test_network_guard.py

- name: ESP8266-Firmware bauen
run: |
Expand Down
35 changes: 35 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,40 @@
# Änderungen

## v0.5.4-dev

**Flugradar und adsb.lol**
- **Kontingent-Wächter:** Ein kostenloser adsb.lol-Schlüssel erlaubt 5 Anfragen pro 30 s, 20 pro Minute, 150 pro Stunde, 500 pro Tag, 2.000 pro Woche und 5.000 pro Monat; wiederholte 429 können ihn kosten. PixelStop zählt jede Anfrage in diesen Fenstern (UTC, feste Grenzen), plant mit Sicherheitsabstand und verteilt die Anfragen auf die Restzeit jedes Fensters – nur für die Zeit, in der das Radar angezeigt wird. Ohne Schlüssel gilt zusätzlich die bisherige Tagesgrenze. Ersetzt das bisherige Tagesbudget (`src/AdsbQuota.h`).
- **Zähler überstehen Neustarts** (RTC-Speicher) und Stromausfälle (Datei, höchstens alle 10 Minuten geschrieben).
- **Sparmodus:** Eine Routenabfrage bei adsb.lol ersetzt den nächsten Positionsabruf, statt übersprungen zu werden; sie hat Vorrang vor dem nächsten Positionsabruf.
- **Kleinstes Radar-Intervall 10 s** (5 s entfällt). Das gewählte Intervall ist ein Wunschwert; das tatsächliche steht im Status, ebenso der Verbrauch je Fenster.
- **Routenprüfung im Sinkflug:** Sinkt ein Flugzeug deutlich (mehr als 500 ft/min), tief (unter etwa 3.000 m) und nahe einem Flughafen, kann dieser nicht der Start sein (SKW4955 zeigte ORD>MKE statt LEX>ORD). Bewusst keine Regel für den Steigflug wegen Durchstartmanövern.
- **Log:** verworfene Routen mit Grund („verworfen:Anbieter/Position/Sinkflug/Rufzeichen“), ein Radarabruf ohne WLAN oder ohne Speicher steht als „kein WLAN“ bzw. „Heap-knapp“ statt „HTTP 0“ im Log.
- **Airline-Namen:** Markennamen nach Rufzeichen-Präfix haben Vorrang (z. B. KLM, SAS, SWISS, FedEx, UPS Airlines, Volaris, Envoy, SkyWest); andere lange Namen verlieren Zusätze wie „Airlines“ oder „Inc“, passen sie dann noch nicht, wechseln zwei Teile im 3-s-Takt, als letzte Lösung kleine Schrift (`src/AirlineName.h`).
- **Flugzeugtypen:** F-5, F-4, F-14, F-104, Rafale, Mirage 2000, Su-27, MiG-29 sowie Trainer, Privat- und Flugshow-Jets (L-39, L-159, Hawk, Alpha Jet, M-346, MiG-15/17/21, Hunter, P-51, Spitfire u. a.). Lange Typnamen ohne Tabelleneintrag werden allgemein auf „Hersteller Modell“ gekürzt (Northrop, Lockheed, Dassault, Gulfstream und weitere).

**Netz, Sicherheit, Stabilität**
- **Schutz gegen fremde Webseiten** ohne Passwort: Der Host muss den Würfel nennen (gegen DNS-Rebinding), Änderungen werden nur ohne fremden Origin angenommen (gegen CSRF). Gilt für alle POST-Anfragen, `/api/reboot` und ausdrücklich das **Firmware-Update**, das deshalb einen eigenen Handler hat. `curl` im Heimnetz funktioniert weiter.
- **WLAN-Namen** im Suchergebnis werden als Text dargestellt (ein präparierter Netzname konnte bisher HTML einschleusen); Leerzeichen am Ende bleiben erhalten und werden in der Liste als „␣“ sichtbar.
- **WLAN-Grundeinstellungen** (PHY-Modus, Sendeleistung) vor jeder Verbindung.
- **Nach Stromausfall:** Startet der Router langsamer, sucht der Setup-Hotspot jede Minute das gespeicherte WLAN – nicht, solange ein Gerät mit dem Hotspot verbunden ist – und startet bei Erfolg normal neu.
- **Rettungsmodus:** Nach drei Abstürzen in Folge startet PixelStop ohne Abrufe; Webinterface und Firmware-Update laufen, auf dem Display steht „RETTUNGSMODUS“. Ein normaler Neustart beendet ihn.
- **Netzwerk-Wächter:** 10 Minuten ohne eine einzige Antwort trotz Anfragen (oder ohne WLAN) führen zu einer neuen WLAN-Verbindung, 5 Minuten später zu einem Neustart mit erhaltenem RTC-Marker; nach solchen Neustarts verdoppelt sich die Wartezeit. WLAN-Abbrüche und Neuverbindungen stehen im Log, der Log endet mit dem aktuellen WLAN-Zustand.
- **Hostname** wird geprüft (a–z, 0–9, Bindestrich, 1–32 Zeichen).
- Startbildschirm „WLAN verbinden…“ auf Englisch, wenn Englisch eingestellt ist.

**Webinterface**
- **Reiter statt ☰-Menü:** Text-Reiter wie vor v0.5.3 direkt unter dem Titel, umbrechend statt wischend und mittig zentriert.
- **Komprimiert ausgeliefert:** Seite (60 → 19 KB) und englische Texte (20 → 8 KB) liegen gzip-komprimiert im Flash; während die Seite lädt, pausieren die Hintergrundabrufe. Die Seite steht jetzt in `src/webui.html`, `tools/webui_build.py` erzeugt `src/webui_html.h`.
- **Anzeigename bei Ortswechsel:** Nach einem Wechsel um mehr als 5 km fragt das Webinterface bei Wetter und Radar, ob der Anzeigename bleiben soll („Leeren“/„Behalten“).
- Statuswerte der Firmware erscheinen in der englischen Oberfläche übersetzt; Hinweis zu den adsb.lol-Grenzen aktualisiert.

**Anzeige**
- **„°C“ ohne Lücke:** Zahl und Einheit werden als Gruppe zentriert.

**Build und Doku**
- `test_geo_transfer.py` und `test_network_guard.py` laufen im Build; neue Tests für Kontingent, Schutz, Airline-Namen, Typen und Sinkflug-Regel.
- ROADMAP mit v0.5.5 (Ausweichquellen), v0.5.6 (Warnungen), Varianten, Kriterien für v1.0 und Veröffentlichung; CONTRIBUTING neu; Hinweise zu nicht-kommerzieller Nutzung der Datenquellen und zu HTTPS ohne Zertifikatsprüfung.

## v0.5.3.1-dev

- **Radar: Speicher zurückgeholt.** v0.5.3 belegte 748 Byte mehr festen Arbeitsspeicher als v0.5.2; während einer TLS-Abfrage blieben dadurch zeitweise nur ~4,3 KB frei, und die Antwort ließ sich nicht mehr einlesen („JSON:NoMemory“, Radar ohne Daten). Die Militär-Tabelle liegt jetzt im Flash, ebenso einige kurze Anzeigetexte.
Expand Down
74 changes: 26 additions & 48 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,43 @@
> Aktueller Stand: v0.4.14.5.1. Historische Angaben unten beziehen sich auf die jeweils genannten Builds.

# Mitmachen bei PixelStop

Danke für Fehlerberichte und Verbesserungsvorschläge. Dieses Projekt ist eine
eigenständige deutschsprachige Firmware auf Grundlage von smalltv-mod.
Danke für Fehlerberichte und Verbesserungsvorschläge. PixelStop ist eine eigenständige Firmware für den GeekMagic SmallTV-Ultra; Hardware- und Displaygrundlage stammen aus [smalltv-mod](https://github.com/giovi321/smalltv-mod).

## Unterstützte Hardware

## Unterstützte Hardware und Projektstruktur
Getestet: **GeekMagic SmallTV-Ultra mit ESP8266 / ESP-12F, 4 MB Flash und 240 × 240 Pixel ST7789**. Andere Geräte und Displayvarianten sind nicht getestet.

Getestetes Gerät: **GeekMagic SmallTV-Ultra mit ESP8266 / ESP-12F, 4 MB Flash
und 240 × 240 Pixel ST7789**. Andere Geräte und Displayvarianten sind nicht
getestet; Kompatibilität wird nicht zugesichert.
## Projektaufbau

Der aktuelle Quellstand liegt im Versionsarchiv
`pixelstop-v0.4.14.5.1.zip`. Vor Änderungen dieses Archiv entpacken.
Die noch vorhandenen Dateien des Ursprungsprojekts im Repository-Hauptverzeichnis
sind nicht der Quellstand dieses Versionsbuilds. Kein automatischer Fork-Sync.
| Ort | Inhalt |
| --- | --- |
| `src/main.cpp` | Ansichten, Einstellungen, Webserver, WLAN |
| `src/webui.html` | Webinterface (Deutsch); `tools/webui_en.py` enthält die englischen Texte, `tools/webui_build.py` packt beides gzip-komprimiert nach `src/webui_html.h` |
| `src/*.h` ohne Arduino-Abhängigkeit | Regeln, die auf dem Rechner getestet werden (z. B. `AdsbQuota.h`, `RoutePolicy.h`, `WebGuard.h`, `AirlineName.h`) |
| `tools/test_*.py`, `tests/` | Prüfungen; viele kompilieren den echten Firmwarecode mit Platzhaltern für Netzwerk und Display |
| `tools/render_screens.py` | Bilder für die README aus dem echten Displaycode |

Im entpackten Versionsordner:
## Bauen und prüfen

```sh
python3 tools/check.py
python3 tools/test_radar.py
python3 tools/test_display.py
g++ -std=c++11 -Wall -Wextra -Werror tests/test_core.cpp -o /tmp/smalltv-test-core
/tmp/smalltv-test-core
pio run -e smalltv_ultra
pio run -e smalltv_ultra # Firmware: .pio/build/smalltv_ultra/firmware.bin
python3 tools/webui_build.py # nach Änderungen am Webinterface
```

Der GitHub-Workflow `.github/workflows/build.yml` baut ausschließlich dieses
Versionsarchiv. Änderungen am Quellcode müssen auch im Archiv enthalten sein.
Die README ist die vollständige Benutzerdokumentation ohne Unterseiten.
Weitere Dateien im Quellarchiv dienen Entwicklung und Validierung.
Die separate README-ZIP bleibt Teil jeder Auslieferung.

## Fehler melden

Bitte Firmwareversion, Gerät, betroffenen Programmtyp, Schritte zur Reproduktion
und erwartetes/tatsächliches Verhalten nennen. Bei Layoutfehlern Browser und
Bildschirmgröße ergänzen. Fotos und bereinigte Buildlogs helfen.

Keine WLAN-Passwörter, API-Keys oder vollständigen privaten Konfigurationsdateien
veröffentlichen. Für öffentliche Credits ausschließlich `du13500` verwenden.
Alle Prüfungen stehen in [`TESTPLAN.md`](TESTPLAN.md) unter „Lokale Prüfungen“; der Workflow [`build.yml`](.github/workflows/build.yml) führt sie bei jedem Pull Request aus und baut die Firmware. Der Build scheitert, wenn der statische RAM über 51.600 Byte steigt (`tools/check_ram.py`) – während TLS-Abrufen bleiben sonst zu wenig Kilobyte frei.

## Änderungen beitragen

- Pixelstil und funktionierende Standardansichten erhalten.
- Neue Optionen mit kompatiblen Standardwerten versehen.
- Speicherbedarf, Watchdog, API-Abfragehäufigkeit und OTA-Größe beachten.
- Keine Flugrouten, Zeiten oder Statuswerte erfinden, wenn eine Quelle sie nicht liefert.
- Geeignete Prüfungen ausführen und Hardwaretests ehrlich kennzeichnen.
- README, Änderungsprotokoll und Testplan zum Verhalten aktualisieren.
- Den generierten Font über `tools/generate_font.py` ändern und neu erzeugen.

WireGuard, MQTT/Home Assistant und zusätzliche Hardwaretargets gehören nicht zum
zugesagten Funktionsumfang. Neue größere Ideen zunächst diskutieren.
- Pixelstil und funktionierende Standardansichten erhalten; neue Optionen mit kompatiblen Standardwerten.
- **Speicher:** feste Texte und Tabellen in den Flash (`PROGMEM`, `F()`, `PSTR()`), keine großen statischen Puffer.
- **Datenquellen schonen:** Grenzen und Bedingungen der Anbieter einhalten (adsb.lol-Kontingent in `src/AdsbQuota.h`), keine Routen, Zeiten oder Statuswerte erfinden.
- Neue Webtexte brauchen einen englischen Eintrag in `tools/webui_en.py`; `tools/check.py` meldet fehlende.
- Hardwaretests ehrlich kennzeichnen; README, `CHANGELOG.md` und `TESTPLAN.md` mit dem Verhalten aktualisieren.
- Größere Ideen zuerst in einem Issue besprechen.

## Lizenz und Datenquellen
## Fehler melden

Projektcode: [MIT](LICENSE). Für externe Daten, Bibliotheken und Dienste gelten
ihre jeweiligen Bedingungen; siehe [Datenquellen](THIRD_PARTY_SERVICES.md).
Bitte Firmwareversion, betroffene Ansicht, Schritte zum Nachstellen, erwartetes und tatsächliches Verhalten sowie den Log (*System → Diagnose*, notfalls `http://<IP>/api/log`) angeben. Fotos helfen. **Keine WLAN-Passwörter, API-Schlüssel oder vollständigen Konfigurationsdateien veröffentlichen.**

## Zusätzliche Prüfungen v0.4.14.5.1
## Lizenz und Datenquellen

Nach Installation der gepinnten Bibliotheken auch `python3 tools/test_airline_cache.py` und `python3 tools/test_brightness.py` ausführen. Die Tests verwenden die Produktionsfunktionen mit kontrollierten HTTP-Antworten beziehungsweise Zeit- und PWM-Werten. Der Browser-Test prüft Offlinefeedback, eingeklappte erweiterte Einstellungen und Anbieterinformationen. Ein bestandener Test ersetzt keine Messung am Display.
Projektcode: [MIT](LICENSE). Für Bibliotheken, Dienste und Daten gelten ihre eigenen Bedingungen, siehe [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) und [`THIRD_PARTY_SERVICES.md`](THIRD_PARTY_SERVICES.md). Die Datenquellen sind nur für nicht-kommerzielle Nutzung gedacht.
2 changes: 1 addition & 1 deletion LICENSE_REVIEW.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Lizenzprüfung für v0.4.13

Stand: 7. Oktober 2026. Eigener Projektcode und Dokumentation stehen ab v0.4.13 unter MIT. Herkunft und fremde Bedingungen werden getrennt dokumentiert. Die Entscheidung folgt dem Wunsch nach freier Nutzung unter Erhalt des Copyright- und Lizenzhinweises.
Stand: 7. Oktober 2026 (Dokument zur damaligen Lizenzentscheidung; aktuelle Bestandteile stehen in `THIRD_PARTY_NOTICES.md`). Eigener Projektcode und Dokumentation stehen ab v0.4.13 unter MIT. Herkunft und fremde Bedingungen werden getrennt dokumentiert. Die Entscheidung folgt dem Wunsch nach freier Nutzung unter Erhalt des Copyright- und Lizenzhinweises.

## CC0 und MIT

Expand Down
Loading
Loading