Open-Source-Projekt mit ESP32-S3 und GC9A01

Gizmo Sky Radar

Ein Live-Flugzeugradar für deinen Schreibtisch: ESP32-S3 und rundes Display zeigen die Flugzeuge um dich herum, eingerichtet per Smartphone.

  • Flugzeuge um dich herum, live
  • Rundes Display mit 25 Bildern pro Sekunde
  • Web-App und HTTP-API
Schwierigkeit
Fortgeschritten
Bauzeit
45 Min.
Löten
Etwas Löten
Das Gizmo Sky Radar in seinem weiß-orangen gedruckten Gehäuse, auf seinen Kufen nach hinten geneigt, mit dem leuchtenden Radar auf dem runden Display und aufgerichteter Antenne, und zerlegt in Gehäuseschale, rundes Display, XIAO ESP32-S3, Rückplatte, vier M3-Schrauben und Antenne.

Das Projekt im Überblick

Ein schneller Überblick über Hardware, Firmware und Verhalten dieses Builds.

Display

01

Ein rundes 1,28"-GC9A01-Display mit 240 × 240 Pixeln, mit Entfernungsringen, einem Kompass und einem kreisenden Strahl, gezeichnet mit etwa 25 Bildern pro Sekunde.

Flugzeuge live

02

Die Flugzeuge rund um deinen Standort, alle paar Sekunden von adsb.fi geladen, in Flugrichtung gedreht, nach Flughöhe eingefärbt und zwischen den Downloads flüssig in Bewegung.

HTTP-API

03

Eine kleine API (/api/aircraft, /api/config, /api/settings), die Skripte und andere Geräte direkt aufrufen können, und eine Markdown-Anleitung für KI-Agenten unter /llms.txt.

Einrichtung

04

Im Browser geflasht, beim ersten Start über einen Hotspot eingerichtet und in unterstützten Netzwerken lokal über gizmo-sky-radar.local erreichbar. Kein Code zum Anpassen und keine Zugangsdaten in der Firmware.

Überblick

Gizmo Sky Radar holt den Himmel über deinem Zuhause auf deinen Schreibtisch: ein kleines rundes Display, das die Flugzeuge um dich herum live zeigt, wie der Bildschirm eines echten Radars. Sieh den Linienflugzeugen beim Überflug zu, finde heraus, wohin sie fliegen, und bekomm die seltenen Notfälle mit, während sie passieren.

  • Die Flugzeuge um dich herum, live, auf einem runden 240 × 240-Display mit etwa 25 Bildern pro Sekunde
  • Flüssige Bewegung zwischen den Downloads, Farben nach Flughöhe und ein Spotlight auf das nächste Flugzeug
  • Eine in die Firmware integrierte Web-App, um Standort, Reichweite und Aussehen per Smartphone einzustellen
  • Eine kleine HTTP-API und eine Markdown-Anleitung, damit auch Skripte und KI-Agenten das Radar lesen können

So funktioniert es

Das Radar hält zwei Aufgaben getrennt, damit das Display nie auf das Netzwerk wartet.

SchrittWas passiert
LadenEin eigener Task lädt alle paar Sekunden die Flugzeuge rund um deinen Standort von adsb.fi und behält die nächsten.
VerfolgenZwischen zwei Downloads bewegt sich jedes Flugzeug mit seiner Geschwindigkeit über Grund auf seinem Kurs weiter, so gleitet es, statt zu springen.
ZeichnenDas Radar wird außerhalb des Bildschirms gezeichnet und in einem Rutsch ans Display geschickt, etwa 25-mal pro Sekunde, mit Strahl, Ringen und Beschriftungen.

Fällt das Internet aus, wartet das Radar vor jedem neuen Versuch etwas länger und zeigt auf dem Bildschirm an, wenn die Daten veralten.

Wofür es taugt

Gizmo Sky Radar macht aus ein paar Euro Hardware ein Fenster zum Himmel, auf das du den ganzen Tag blicken kannst. Es ist außerdem eine kompakte Vorlage für jedes ESP32-Projekt, das Live-Daten auf einem runden Display zeichnet.

  • Sieh auf einen Blick, welche Flugzeuge über dein Zuhause fliegen und wohin sie unterwegs sind.
  • Erkenne Notfälle und ungewöhnlichen Verkehr, während sie passieren.
  • Lerne, wie ADS-B, Koppelnavigation und flüssige Grafik auf einem Mikrocontroller zusammenspielen.

Die Web-App

Das siehst du auf dem Handy, sobald das Gerät in deinem WLAN ist.

Der Radar-Bildschirm der Web-App, mit dem Live-Radar, den Flugzeugen rund um den Standort nach Flughöhe eingefärbt und der Liste der nächsten.
Der Einstellungen-Bildschirm, mit Standort, Reichweite, Einheiten und den Optionen des Displays.
Der WLAN-Bildschirm, mit dem aktuellen Netzwerk und den Netzwerken in Reichweite.

Was du brauchst

Die Teile, die du vor dem Start besorgen solltest, und worauf du beim Kauf achten musst.

  • 1×

    Seeed Studio XIAO ESP32-S3

    Seine 8 MB PSRAM halten das Bild des Displays und die geladenen Flüge, deshalb braucht die Firmware ein Modul mit PSRAM.

  • 1×

    Rundes GC9A01-Display

    1,28", 240 × 240, mit SPI-Schnittstelle: das gängige Modul mit den Pins VCC, GND, DIN, CLK, CS, DC, RST und BL.

  • 1×

    U.FL-auf-RP-SMA-Pigtail

    Ein kurzes Kabel vom U.FL-Anschluss des XIAO zu einer RP-SMA-Einbaubuchse, die als Antennenmast durch die Rückplatte des Gehäuses geht.

  • 1×

    2,4-GHz-RP-SMA-Antenne

    Sie wird auf den Mast an der Rückseite des Gehäuses geschraubt und ersetzt die flache Antenne, die dem XIAO beiliegt.

  • 8×

    Jumperkabel

    Eins für jeden Pin des Displays.

  • 1×

    USB-C-Datenkabel

    Ein Datenkabel, kein reines Ladekabel, zum Flashen und zur Stromversorgung des XIAO.

Einrichtung

Mit diesen Schritten bringst du das Projekt zum Laufen, von der ersten lokalen Einrichtung bis zum ersten Upload oder zur Konfiguration.

  1. 01

    Schritt 1

    Verbinde das Display mit dem XIAO ESP32-S3

    Verbinde die acht Pins des runden GC9A01-Displays nach der Pinbelegung auf GitHub mit dem XIAO ESP32-S3, und steck den XIAO dann mit einem USB-Datenkabel an deinen Computer. Nimm Chrome oder Edge, damit der Browser-Flasher den seriellen Port findet.

  2. 02

    Schritt 2

    Flashe die fertige Firmware von dieser Seite

    Scroll zur Karte zum Flashen der Firmware, starte das Hochladen im Browser und warte, bis es fertig ist. Wenn der Flasher keine Verbindung bekommt, halt BOOT am XIAO gedrückt, drück kurz RESET, lass dann BOOT los und versuch es noch einmal. Danach drückst du RESET, um die neue Firmware zu starten.

  3. 03

    Schritt 3

    Verbinde das Radar mit deinem WLAN

    Beim ersten Start verbindest du dich mit dem Smartphone mit dem Hotspot Gizmo-Sky-Radar und wählst auf der Seite, die sich öffnet, dein Netzwerk. Das Display sagt dir, was zu tun ist, und das WLAN wird auf der Platine gespeichert, nie in der Firmware.

  4. 04

    Schritt 4

    Leg deinen Standort fest und beobachte den Himmel

    Sobald das Radar in deinem WLAN ist, öffne gizmo-sky-radar.local, geh zu Einstellungen und füg die Koordinaten deines Zuhauses aus einer beliebigen Karte ein. Die Flugzeuge um dich herum erscheinen auf dem Display und in der Web-App.

Häufige Fragen

Ein paar praktische Antworten dazu, wie das Projekt funktioniert, wie es eingerichtet wird und was du von der Hardware erwarten kannst.

Die Flugzeuge rund um einen Standort deiner Wahl, live: kleine Flugzeuge auf einem runden Radar, in Flugrichtung gedreht und nach Flughöhe eingefärbt, mit Rufzeichen und Flughöhe. Ein Spotlight zeigt nacheinander die nächsten mit Name, Typ, Geschwindigkeit, Entfernung und Richtung, und Notfälle blinken rot.

Quellcode

Gizmo Sky Radar auf GitHub ansehen

Im Repository findest du die Firmware, Hardware-Notizen und die Implementierungsdetails hinter diesem Build.

GitHub öffnen
Illustration zum OpenGizmo-Projekt auf GitHub
Open Source

Siehe auch

Weitere Open-Source-Builds mit dem ESP32 für dein nächstes Projekt.