Skip to content

Supported Boards

Łukasz Nowak edited this page Aug 2, 2026 · 2 revisions

Supported Boards

Five boards run esp32flight. The 800x480 family shares a single auto-detecting binary; the 7B and the Tab5 have dedicated builds because their panels differ.

Board Screen Flash file Notes
Waveshare ESP32-S3-Touch-LCD-7 7" 800x480 esp32flight-vX.Y.Z-full.bin The original target, best tested
Waveshare ESP32-S3-Touch-LCD-4.3 / 4.3B 4.3" 800x480 esp32flight-vX.Y.Z-8mb-full.bin Same electronics, smaller panel, 8 MB flash module
Guition JC8048W550 5" 800x480 esp32flight-vX.Y.Z-guition-full.bin Budget option (~$20)
Waveshare ESP32-S3-Touch-LCD-7B 7" 1024x600 esp32flight-vX.Y.Z-7b-full.bin Sharper panel, real brightness control
M5Stack Tab5 5" 1280x720 esp32flight-vX.Y.Z-tab5-full.bin ESP32-P4, portable form factor

The browser flasher has one button per board and picks the right files for you. The -ota.bin files are for updating an already-running device from its web panel; see Updating.

Waveshare ESP32-S3-Touch-LCD-7

ESP32-S3 N16R8 (16 MB flash, 8 MB PSRAM), 800x480 RGB LCD (ST7262), GT911 capacitive touch. Powered over USB-C.

  • All 1329 airline logos, all country flags, airports and runways are bundled in flash.
  • Recommended printable case: Waveshare 7inch display case on Printables.
  • The panel has no PWM backlight control; brightness is effectively on/off (night mode dims the UI colors instead).

Waveshare ESP32-S3-Touch-LCD-4.3 and 4.3B

The same electronics and pinout as the 7" board in a smaller panel. Most units ship with an 8 MB flash module (WROOM-1 N8R8), so they take the -8mb build: it bundles the ~330 most common airline logos and fetches the rest on demand from the esp32flight-logos repo.

If your 4.3 unit happens to have 16 MB flash (check with esptool.py flash_id), the standard build works too and bundles everything.

Guition JC8048W550

A 5" 800x480 board of the same ESP32-S3 class with GT911 touch, usually the cheapest way to run esp32flight. Support came from a community-contributed pinout. Detected automatically at boot by the same binary family, but flash the -guition file: the touch controller orientation differs from the Waveshare boards.

Waveshare ESP32-S3-Touch-LCD-7B

The higher-resolution 7" variant: 1024x600 (ST7262 panel, GT911 touch) with a CH32V003 helper microcontroller that gives it something the rest of the family lacks, true PWM backlight brightness.

  • Needs its own build (-7b files); the 800x480 binary shows a scrambled picture on it.
  • At 60% more pixels the UI is somewhat less smooth than on 800x480 boards; rendering optimizations are planned.

M5Stack Tab5

A very different animal: ESP32-P4 (not S3), 5" 1280x720 IPS panel, battery-powered portable form factor.

  • Needs the -tab5 build; this is a different chip family, so it is flashed with --chip esp32p4 and the bootloader sits at 0x2000 (the browser flasher handles this for you).
  • Wi-Fi is provided by an on-board C6 co-processor.

Something else?

Boards not listed here will not work out of the box: RGB panel timings, touch controllers and helper chips differ. If you want to try porting, main/waveshare_rgb_lcd_port.c contains all board definitions and the issues are a good place to ask. Community pinouts have been merged before.

Clone this wiki locally