AeroDial User Guide

Waveshare ESP32-S3 Touch LCD 2.1 · Firmware 0.0.179 · Build 179

AeroDial displays nearby aircraft and ships, airport weather, satellite positions and an optional map. Use the round touchscreen or the Web Console from a phone or computer.

AeroDial is an information display. Do not use it for navigation, flight safety, vessel safety, emergency response or operational decisions.

Before first-time setup

Have these ready:

ICAO is not the ticket code. Use EBBR, not BRU. Latitude must be from −90 to 90 and longitude from −180 to 180. West and south coordinates use a minus sign.

Recommended setup: use the touchscreen

This is the simplest and most reliable first-time setup.

  1. Power on. Connect USB-C power. The screen starts, the backlight fades in and a short buzzer test sounds.
  2. Start. On the WELCOME screen, tap the framed START button near the bottom.
  3. Select Wi-Fi. Wait for the scan to finish. Tap the left or right side to move through networks, then tap the center to select yours.
  4. Enter the password. Use the QWERTY keyboard. Select abc, ABC, 123 or #+= for different characters. Use the space bar or delete key as needed, then tap CONNECT. The password is visible while typing so it can be checked.
  5. Wait for connection. Do not press repeatedly while it connects. If it fails, check capitalization and symbols, then retry.
  6. Enter the home location. Tap the latitude or longitude field to select it. Enter both decimal values, using the minus key for west or south, then tap OK.
  7. Enter the METAR airport. Type the four-character ICAO code on the QWERTY keyboard and tap OK.
  8. Finish. AeroDial shows READY, opens the main menu and begins loading live data. Aircraft, ships and the map can take a few seconds to appear.
Nothing is erased by a failed connection. If setup cannot complete, AeroDial keeps the setup network available so you can try the Web Console method below.

Alternative setup: use a phone or computer

During first-time setup AeroDial creates a temporary network:

  1. Join AeroDial-Setup. Your phone may warn that this network has no internet; choose to stay connected.
  2. Open a browser and type http://192.168.4.1 exactly. If mobile data interferes, temporarily disable it.
  3. For a complete Web setup, first open Location and enter the home coordinates and radius, then open Device and enter the four-character METAR airport.
  4. In Device, enter the normal Wi-Fi name and password and choose Change network. Do this last because AeroDial-Setup closes after AeroDial connects.
  5. Reconnect your phone or computer to the same normal Wi-Fi. AeroDial finishes onboarding and opens the menu when all required details are valid.

If only Wi-Fi was configured from the browser, simply finish the location and ICAO prompts on the touchscreen. After setup, open Config → Web Console on the dial to see the current IP address and QR code.

Want to search by city? Complete the basic setup first. Then open the Web Console on the normal Wi-Fi, choose Location, search for a city, confirm the map point and save it.

Touchscreen navigation

The main menu contains Radar, METAR, Satellite and Config.

Radar and traffic

Radar shows aircraft and ships around the saved home location.

Aircraft detail cards and photos

The detail card can show flight or registration, aircraft type, route, altitude, speed, distance, direction and live status. AeroDial looks up an aircraft photo from Planespotters.net when one is available. Tap the photo to display a QR code for its source page; tap again to close it. Use BACK to return.

Radar settings

Labels can include flight, callsign, registration, type, altitude, speed, distance and route.

Map styles and colors

Choose Default Night, Mono Night, Mono Day or Default Day. The Web Console can also change aircraft, ground-aircraft, label, airport, sweep and ring colors. A new map is downloaded after changing location, radius, heading or map style, so the background may briefly disappear while it refreshes.

Track a particular aircraft

  1. Open the Web Console and choose Radar.
  2. Under Track aircraft or flight, enter one exact registration, flight number or callsign, such as OO-ABC, SN203 or BEL203.
  3. Tap outside the field to apply it. Spaces and separators are ignored when matching.

The matching aircraft receives a dedicated highlight and label. On the Waveshare model, the buzzer gives a double beep when the sweep reaches the tracked aircraft. If the sweep is hidden, AeroDial uses a periodic fallback beep while fresh matching traffic remains in range. Clear the tracking field to stop tracking alerts.

METAR weather

METAR shows weather for the selected airport.

Change the airport under Config → Airport ICAO or Web Console Device.

Satellite

Satellite shows the selected orbital object and its calculated position around Earth.

Config on the dial

Move left or right through these pages:

Confirmed settings remain saved after power is disconnected.

Using the Web Console

Your phone or computer must be on the same Wi-Fi network as AeroDial. On the dial open Config → Web Console, then scan the QR code or enter the displayed http:// address.

Remote screen control

The Web Console can switch the physical screen directly to Menu, Radar, Aircraft, METAR, Satellite or Settings. This changes only the screen being shown; it does not change the saved radar data.

The local IP address can change after reconnecting to Wi-Fi. If an old bookmark stops working, check Config → Web Console again.

Aircraft data sources

Select a provider under Config → Data Source or Web Console Feeds. Choices include AeroDial, Airplanes, FR24, Custom and Local, depending on the configured credentials and receiver.

Optional local ADS-B receiver

  1. Connect AeroDial and the tar1090/readsb receiver to the same network.
  2. Open Web Console Feeds → Local ADS-B receiver.
  3. Enter the receiver's full aircraft.json address and save it.
  4. Select the Local source.

Local ADS-B supplies aircraft data only. Maps, weather, ships, satellite data and aircraft photos still need internet access.

Wi-Fi after setup

AeroDial remembers successful networks and can try another remembered network if the active one is unavailable. Under Config → Wi-Fi, scan for a network or open the saved-network manager to review and forget entries.

If no remembered network works, AeroDial starts AeroDial-Setup. Join it and open http://192.168.4.1. Your location, airport and radar preferences are not erased.

Common messages

Quick troubleshooting

Wi-Fi will not connect

No aircraft, ships or map

Web Console will not open

If AeroDial does not respond, disconnect USB power, wait a few seconds and reconnect it.

Care and support

Support: osseilyh92@gmail.com · Instagram @h0ss310s

When requesting help, include the version shown under Config → Update and a short description, photo or video.