Files
jimmyandClaude Opus 5.5 9f84330b91 Move project to repo root and add Makefile
The Makefile wraps the build, USB and WiFi flashing, the serial monitor
and font generation, with toolchain paths that can be overridden.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 12:45:11 +13:00

1.7 KiB
Raw Permalink Blame History

esp32vga

800×600 VGA output with a web interface for the Seeed XIAO ESP32S3 Plus (16 MB flash, 8 MB PSRAM). It uses 8-bit colour (RGB332) from the LCD_CAM peripheral, with double buffering in PSRAM.

Content modes include a test pattern, plasma, starfield, clock, Mandelbrot, text messages, images (uploaded and dithered in the browser, with a 15-slot gallery in flash), a Halloween scene and "Haunting", a black-background mode for projecting onto fabric.

Wiring

XIAO pin GPIO Signal Resistor VGA pin
D0 1 Blue bit 0 820 Ω 3
D1 2 Blue bit 1 430 Ω 3
D2 3 Green bit 0 2 kΩ 2
D3 4 Green bit 1 1 kΩ 2
D4 5 Green bit 2 510 Ω 2
D5 6 Red bit 0 2 kΩ 1
D6 43 Red bit 1 1 kΩ 1
D7 44 Red bit 2 510 Ω 1
D8 7 HSYNC 100 Ω 13
D9 8 VSYNC 100 Ω 14

Ground goes to VGA pin 5 and pins 6–8, and VGA pin 9 (+5 V) is left unconnected.

Build and flash

You need ESP-IDF 5.4 or later. The paths at the top of the Makefile point at the toolchain to use; override them if yours are elsewhere.

make            # build
make flash      # flash over USB (PORT=/dev/ttyACM0)
make ota        # flash over WiFi (BOARD=<board-ip>)
make monitor    # serial console
make font       # regenerate main/font_data.h
make clean

The serial console is on the USB-Serial-JTAG port, because GPIO 43/44 carry colour bits.

Web interface

The board starts its own access point, ESP32-VGA (password esp32vga). You can also give it your home WiFi details in Settings. Open its IP address in a browser.

To update the firmware over WiFi, use the page's Settings section or make ota.