Open-source ESP32-S3 + GC9A01 project

Gizmo Sky Radar

A live plane radar for your desk, on an ESP32-S3 and a round display, showing the aircraft around you with a web app to set it up from your phone.

  • Live aircraft around you
  • Round display at 25 frames a second
  • Web app and HTTP API
Difficulty
Intermediate
Build time
45 min
Soldering
Some soldering
The Gizmo Sky Radar in its white and orange printed enclosure, leaning back on its skids with the radar lit on its round screen and its antenna up, and pulled apart into the shell, the round display, the XIAO ESP32-S3, the back plate, four M3 screws and the antenna.

Project snapshot

A quick overview of the hardware, firmware, and behavior behind this build.

Display

01

A 1.28" GC9A01 round display at 240 × 240, with range rings, a compass and a sweeping beam, drawn at about 25 frames a second.

Live aircraft

02

The aircraft around your location, downloaded from adsb.fi every few seconds, drawn turned to their track, colored by altitude, and moving smoothly between downloads.

HTTP API

03

A small API (/api/aircraft, /api/config, /api/settings) that scripts and other devices can call directly, and a Markdown guide for AI agents at /llms.txt.

Setup flow

04

Flashed from the browser, then set up from a hotspot on first boot, with local access through gizmo-sky-radar.local on supported networks. No code to edit and no credentials in the firmware.

Overview

Gizmo Sky Radar puts the sky above your home on your desk: a small round display that shows the aircraft around you, live, like a real radar screen. Watch the airliners pass overhead, see where they are going, and catch the rare emergency as it happens.

  • The aircraft around you, live, on a 240 × 240 round display at about 25 frames a second
  • Smooth motion between downloads, colors by altitude, and a spotlight on the nearest aircraft
  • A web app built into the firmware, to set the location, the range and the look from your phone
  • A small HTTP API and a Markdown guide, so scripts and AI agents can read the radar too

How it works

The radar keeps two jobs apart, so the display never waits for the network.

StepWhat happens
DownloadA task of its own downloads the aircraft around your location from adsb.fi every few seconds, and keeps the nearest ones.
TrackBetween two downloads, each aircraft moves on along its track at its ground speed, so it glides instead of jumping.
DrawThe radar is drawn off screen and pushed to the display in one go, about 25 times a second, with the sweep, the rings and the labels.

When the internet goes down, the radar waits a little longer before each new try, and says on screen when the data gets old.

Why it is useful

Gizmo Sky Radar turns a few euros of hardware into a window on the sky that you can glance at all day. It is also a compact template for any ESP32 project that draws live data on a round display.

  • See which planes pass over your home, and where they are heading, at a glance.
  • Spot emergencies and unusual traffic as they happen.
  • Learn how ADS-B, dead reckoning and smooth embedded graphics fit together.

The web app

What you see on your phone once the device is on your Wi-Fi.

The Radar screen of the web app, with the live radar, the aircraft around the location colored by altitude, and the list of the nearest ones.
The Settings screen, with the location, the range, the units and the display options.
The Wi-Fi screen, with the current network and the networks in range.

What you need

The parts to get before you start, and what to look for when you buy them.

  • 1×

    Seeed Studio XIAO ESP32-S3

    Its 8 MB of PSRAM hold the frame of the display and the downloaded flights, so the firmware needs a module that has it.

  • 1×

    GC9A01 round display

    1.28", 240 × 240, with an SPI interface: the common module with VCC, GND, DIN, CLK, CS, DC, RST and BL pins.

  • 1×

    U.FL to RP-SMA pigtail

    A short cable from the U.FL connector of the XIAO to an RP-SMA bulkhead jack, which goes through the back plate of the enclosure as the antenna mast.

  • 1×

    2.4 GHz RP-SMA antenna

    It screws onto the mast on the back of the enclosure, and replaces the flat antenna that comes with the XIAO.

  • 8×

    Jumper wires

    One for each pin of the display.

  • 1×

    USB-C data cable

    A data cable, not a charge-only one, to flash and power the XIAO.

Setup flow

Follow these steps to get the project running, from the first local setup to the initial upload or configuration.

  1. 01

    Step 1

    Wire the display to the XIAO ESP32-S3

    Connect the eight pins of the GC9A01 round display to the XIAO ESP32-S3, following the pinout on GitHub, then plug the XIAO into your computer with a data USB cable. Use Chrome or Edge, so the browser flasher can find its serial port.

  2. 02

    Step 2

    Flash the prebuilt firmware from this page

    Scroll down to the firmware flashing card, start the upload from the browser, and wait for it to complete. If the flasher can't connect, hold BOOT on the XIAO, press and release RESET, then release BOOT and try again. When it's done, press RESET to start the new firmware.

  3. 03

    Step 3

    Connect the radar to your Wi-Fi

    On the first boot, join the Gizmo-Sky-Radar hotspot with your phone, and pick your network on the page that opens. The display tells you what to do, and the Wi-Fi is saved on the board, never in the firmware.

  4. 04

    Step 4

    Set your location and watch the sky

    Once the radar joins your Wi-Fi, open gizmo-sky-radar.local, go to Settings and paste the coordinates of your home from any map. The aircraft around you appear on the display and in the web app.

Frequently asked questions

A few practical answers about how the project works, how it is configured, and what to expect from the hardware.

The aircraft around a location you choose, live: small airplanes on a round radar, turned to their track and colored by altitude, with their callsign and altitude. A spotlight cycles through the nearest ones with their name, type, speed, distance and direction, and emergencies blink in red.

Source code

View Gizmo Sky Radar on GitHub

Browse the repository for firmware, hardware notes, and the implementation details behind this build.

Open GitHub
OpenGizmo GitHub project illustration
Open source

See also

More open-source ESP32 builds you can make next.