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
11 changes: 6 additions & 5 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Repository auschecken
uses: actions/checkout@v4
uses: actions/checkout@v5

- name: Firmwareversion ermitteln
id: version
Expand All @@ -37,12 +37,12 @@ jobs:
fi

- name: Python einrichten
uses: actions/setup-python@v5
uses: actions/setup-python@v6
with:
python-version: '3.12'

- name: Node einrichten
uses: actions/setup-node@v4
uses: actions/setup-node@v5
with:
node-version: '22'

Expand Down Expand Up @@ -76,6 +76,7 @@ jobs:
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
Expand Down Expand Up @@ -103,15 +104,15 @@ jobs:

- name: Firmware hochladen
if: always()
uses: actions/upload-artifact@v4
uses: actions/upload-artifact@v6
with:
name: pixelstop-v${{ steps.version.outputs.version }}-firmware
path: dist/firmware/
if-no-files-found: warn

- name: Begleitpaket hochladen
if: always()
uses: actions/upload-artifact@v4
uses: actions/upload-artifact@v6
with:
name: pixelstop-v${{ steps.version.outputs.version }}-begleitpaket
path: dist/begleitpaket/
Expand Down
18 changes: 18 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,25 @@
# Änderungen

## v0.5.3-dev

- **Webinterface-Menü:** Die wischbare Reiterleiste ist ersetzt durch ein Menü hinter der Taste ☰ (ausklappend wie beim RavestickBoard). Unter dem Titel steht die aktuelle Seite.
- **Auge-Symbol** an WLAN-Passwort und API-Keys: zeigt die gerade getippte Eingabe. Gespeicherte Werte werden weiterhin nie an den Browser zurückgeschickt.
- **3-Tage-Vorhersage als eigene Ansicht** in der Rotation, direkt unter „Wetter“, mit eigener Dauer und ▶. Der feste 8-s-Wechsel in der Wetteransicht entfällt; der Wetter-Reiter weist auf die neue Ansicht hin. Wer die Vorhersage bisher eingeschaltet hatte, findet die neue Zeile nach dem Update angehakt. Die Rotation folgt jetzt der Reihenfolge der Liste (Flug-Tracker vor Uhr).
- **Flugzeugtypen:** eine einzige Tabelle im Flash mit 232 Typen weltweit (Airliner aller Varianten, Regionaljets, Frachter, Business-Jets, allgemeine Luftfahrt, Hubschrauber, Militär, Russland/GUS). Mit Hersteller, solange es in 18 Zeichen passt; ein Code ergibt genau einen Text; unbekannte Codes erscheinen als Code.
- **Radar-Optionen** im Flugradar-Reiter: Betreiber als Name zum Rufzeichen (Standard), Oberbegriff oder beides (für bekannte Militär-Rufzeichen, z. B. „US Air Force / AMC“); Geschwindigkeit in km/h oder Knoten im Wechsel mit dem Kennzeichen; ▲▼ für Steig-/Sinkflug ab 300 ft/min; „MIL“ neben dem Rufzeichen für Militär.
- **4-stellige Flughafencodes:** Routen zu Flugplätzen ohne IATA-Code wurden bisher komplett verworfen („N/A“), weil adsb.lol dort den ICAO-Code liefert. Jetzt gelten 3 Buchstaben (IATA) oder 4 Zeichen (ICAO, Buchstabe am Anfang, Ziffern erlaubt); adsbdb und aviationstack nutzen den ICAO-Code als Ersatz. Das „>“ bleibt fest in der Mitte: 3-stellige Routen sehen pixelgenau aus wie bisher, 4-stellige wachsen nach außen.
- **Notfälle:** Bei Squawk 7500/7600/7700 sind Rufzeichen und Routenzeile rot; in der Routenzeile wechseln Route und „SQUAWK 7700“ alle 3 s (ohne Route steht der Squawk dauerhaft).
- **Filter:** Hubschrauber, Kleinflugzeuge, Segler/Ballone/Ultraleicht/Drohnen und Flugzeuge am Boden ausblendbar. Mit Filter fragt PixelStop alle Flugzeuge im Radius ab und liest sie einzeln ein (`src/RadarScan.h`), damit der Speicherbedarf nicht mit der Zahl der Flugzeuge wächst.
- **Diagnose:** Erfolgreiche Radarabrufe stehen als eine Zeile im Log (mit dem kleinsten freien Speicher während des Abrufs), Fehler weiter mit allen Schritten; der Log reicht damit etwa fünfmal so lange. Zusatzabfragen melden „leer“ (keine Daten zum Flugzeug) oder „übersprungen“ mit Grund. Im Status: aktuelles Flugzeug und Zahl der geprüften Flugzeuge.
- **Dimmverfahren (Test):** Unter „Anzeige“ wählbar zwischen Standard (PWM) und Sigma-Delta. Sigma-Delta nutzt einen eigenen Baustein des Chips und soll das gelegentliche Aufblitzen bei geringer Helligkeit beseitigen.
- **README:** aufklappbare „Mehr Beispiele“ mit realistischen Daten unter der Galerie; neuer Abschnitt „Flugradar: Darstellung und Einstellungen“ mit Beispielen aus dem Battlestar-Galactica-Universum (Quelle „DRADIS“), der Notfall als GIF mit sechs Bildern aus dem echten Displaycode; der Renderer kann den Quellnamen in der Fußzeile dafür setzen.
- Workflow-Bausteine auf Node-24-Versionen (checkout v5, setup-node v5, setup-python v6, upload-artifact v6).

## v0.5.2-dev

Auf Hardware bestätigt: Weiterrechnen von Entfernung und Höhe, Statuspunkt, Meldung bei „Jetzt anzeigen“, adsb.lol-Schlüssel.


- **Radar weitergerechnet:** Entfernung und Höhe werden zwischen zwei Abrufen jede Sekunde aus Geschwindigkeit über Grund, Kurs und Steig-/Sinkrate fortgeschrieben (`src/RadarMotion.h`). Jeder echte Abruf setzt die Werte neu. Die Höhe folgt der Steigrate höchstens 45 s, die Position höchstens bis kurz nach dem nächsten erwarteten Abruf (mindestens 1, höchstens 4 Minuten); danach bleiben die Werte stehen. Am Boden wird nicht gerechnet. Die auswählbaren Abrufintervalle bleiben unverändert.
- **Statuspunkt in der Radar-Fußzeile:** kurz weiß bei neuen Daten, grün im normalen Takt, gelb bei überfälligem oder fehlgeschlagenem Abruf und bei Anbieterpausen, grau, wenn die Werte stehen. Text und Sekundenzähler rücken dafür 10 Pixel nach rechts.
- **„Jetzt anzeigen“:** Die Meldung nennt jetzt die Anzeigedauer, z. B. „Wird für 30 s angezeigt · danach geht die Rotation weiter“; ist nur eine Ansicht aktiv, bleibt sie bis zum nächsten Speichern stehen.
Expand Down
55 changes: 48 additions & 7 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@
Bought as a small Wi-Fi cube with a rather modest stock firmware – and from day one with the plan to turn it into something of my own.

[![Build](https://github.com/du13500/pixelstop/actions/workflows/build.yml/badge.svg)](https://github.com/du13500/pixelstop/actions/workflows/build.yml)
![Version](https://img.shields.io/badge/version-v0.5.2--dev-orange)
![Version](https://img.shields.io/badge/version-v0.5.3--dev-orange)
![Hardware](https://img.shields.io/badge/hardware-ESP8266%20%C2%B7%20SmallTV--Ultra-blue)
![Hardware test](https://img.shields.io/badge/hardware%20test-v0.5.2%20pending-yellow)
![Hardware test](https://img.shields.io/badge/hardware%20test-v0.5.3%20pending-yellow)
![Hobby project](https://img.shields.io/badge/hobby%20project-non--commercial-lightgrey)
![License](https://img.shields.io/badge/license-MIT-green)
![Mission](https://img.shields.io/badge/mission-Know%20before%20you%20go-ff5d56)
Expand All @@ -25,8 +25,9 @@ The cube shows, in rotation or permanently:
| View | What you see |
| --- | --- |
| **Departures** | Live departures of a stop of Verkehrsverbund Oberelbe (VVO, Dresden region): line, destination, minutes, delays and cancellations; up to ten departures on two pages, filter by mode of transport |
| **Weather** | Current temperature, day/night weather icon, high and low, chance of rain, sunrise and sunset, alternating with a 3-day forecast; °C or °F |
| **Flight radar** | The nearest aircraft within the chosen radius: callsign, airline, route, type, registration, distance and altitude |
| **Weather** | Current temperature, day/night weather icon, high and low, chance of rain, sunrise and sunset; °C or °F |
| **3-day forecast** | Weekday, weather icon, high/low and rain for the next three days, as a view of its own in the rotation |
| **Flight radar** | The nearest aircraft within the chosen radius: callsign, airline, route, type, registration, distance and altitude; optionally speed, ▲▼ for climb/descent, military marking and filters (e.g. hide helicopters). Emergencies (squawk 7500/7600/7700) appear in red |
| **Clock** | Time and date with a selectable time zone |
| **Flight tracker** | One specific flight with scheduled and actual times and live altitude (your own aviationstack key required) |
| **Countdown 1–4** | Four independent timers with their own title and colours – in days, hours or minutes |
Expand All @@ -40,17 +41,36 @@ Plus night mode, brightness down to 1 %, place search with a map, Greek and Cyri
| <img src="docs/screens/en/abfahrten.png" width="260" alt="Departures"><br><sub><b>Departures</b> · Dresden Hauptbahnhof with a delay (yellow) and a cancellation (✕)</sub> | <img src="docs/screens/en/wetter.png" width="260" alt="Weather"><br><sub><b>Weather</b> · Brooklyn in °F</sub> | <img src="docs/screens/en/flugradar.png" width="260" alt="Flight radar"><br><sub><b>Flight radar</b> · Emirates A380 from Dubai to Frankfurt</sub> |
| <img src="docs/screens/en/flugtracker.png" width="260" alt="Flight tracker"><br><sub><b>Flight tracker</b> · one flight with scheduled and actual times</sub> | <img src="docs/screens/en/vorhersage.png" width="260" alt="3-day forecast"><br><sub><b>Forecast</b> · the next three days</sub> | <img src="docs/screens/en/countdown-tage.png" width="260" alt="Countdown"><br><sub><b>Countdown</b> · in days or as a timer</sub> |

## Status: v0.5.2-dev
### More examples

<details><summary><b>Departures & weather</b></summary>

| | |
| :---: | :---: |
| <img src="docs/screens/en/abfahrten-ziele.png" width="260" alt="Departures S-Bahnhof Reick"><br><sub><b>Destinations</b> · town of the stop dropped, “Meißen T.” abbreviated</sub> | <img src="docs/screens/en/wetter-nacht.png" width="260" alt="Weather at night"><br><sub><b>Weather</b> · Dresden at night in °C</sub> |

</details>

<details><summary><b>Clock & countdown</b></summary>

| | |
| :---: | :---: |
| <img src="docs/screens/en/uhr.png" width="260" alt="Clock"><br><sub><b>Clock</b> · with date</sub> | <img src="docs/screens/en/countdown-timer.png" width="260" alt="Countdown as timer"><br><sub><b>Countdown</b> · as a minute timer</sub> |

</details>

## Status: v0.5.3-dev

| Area | Status |
| --- | --- |
| Departures (VVO), weather, clock, countdowns | ✅ stable in daily use |
| Flight radar over HTTP/1.1, pauses on rejected requests | ✅ confirmed on hardware (v0.4.14.7) |
| Radar only while visible, daily budget without a key | ✅ running on hardware (v0.4.14.8), long-term observation ongoing |
| Backlight at 1 % without flashes | ✅ much improved (v0.4.14.6) |
| Backlight at 1 % without flashes | ⚠️ occasional flashes, sigma-delta test running (v0.5.3) |
| German/English language switch, abbreviated destinations | ✅ confirmed on hardware (v0.5.0) |
| 3-day forecast, tidier web interface, “Show now”, town of the stop | ✅ confirmed on hardware (v0.5.1) |
| Radar: distance and altitude continued between requests, status dot | ⏳ hardware test pending |
| Radar: distance and altitude continued between requests, status dot | ✅ confirmed on hardware (v0.5.2) |
| Radar options and filters, 232 aircraft types, menu, forecast as a view, sigma-delta dimming | ⏳ hardware test pending |
| Flight tracker with your own aviationstack key | ⏳ not fully tested on hardware |

All changes are listed in [`CHANGELOG.md`](CHANGELOG.md) (German), open checks in [`ROADMAP.md`](ROADMAP.md).
Expand Down Expand Up @@ -134,6 +154,27 @@ All ways are listed at [adsb.lol/mmb](https://www.adsb.lol/mmb). If adsb.lol rej
| 🟡 yellow | update overdue, failed or provider pause; values are estimated |
| ⚫ grey | no data for too long; distance and altitude stand still |

### Flight radar: display and settings

The **Flight radar** tab lets you adjust the view:

- **Operator:** name of the callsign (default), branch, or both, e.g. “US Air Force / AMC” – for known military callsigns.
- **Speed** in km/h or knots, alternating with the registration every 3 seconds.
- **▲▼** between distance and altitude when climbing or descending faster than 300 ft/min.
- **MIL** next to the callsign for military aircraft.
- **Hide:** helicopters, light aircraft, gliders/balloons/ultralights/drones, aircraft on the ground.
- **Always on:** emergencies (squawk 7500/7600/7700) with a red callsign and a red route line in which the route and “SQUAWK 7700” alternate every 3 s; airports with 3-letter IATA or 4-character ICAO codes.

For illustration, a view from Galactica’s CIC:

| | |
| :---: | :---: |
| <img src="docs/screens/en/radar-colone.png" width="260" alt="COLONE"><br><sub><b>Speed</b> alternating with the registration, 4-character codes, “N/A” when the data has no altitude</sub> | <img src="docs/screens/en/radar-apollo.png" width="260" alt="APOLLO"><br><sub><b>MIL</b> marking, operator as “branch / unit”</sub> |

<p align="center"><img src="docs/screens/en/radar-karma.gif" width="260" alt="KARMA"><br><sub><b>Emergency</b> · callsign and route line in red; route and “SQUAWK 7700” alternate every 3 s, with ▼ while descending, distance, altitude and age running on, custom display name in the header</sub></p>

<sub>Fictional sample data inspired by Battlestar Galactica, not affiliated with the rights holders. For these images the footer source reads “DRADIS” instead of “ADSB.LOL”; everything else is unchanged firmware output.</sub>

## Plans

- **More regions:** departures not only from VVO but selectable per transport association or Germany-wide (planned for v0.6.0).
Expand Down
Loading
Loading