Files
esp32vga/README.md
T
jimmyandClaude Opus 5.5 c307f08de8 Add ESP32-S3 VGA firmware with web interface
800x600 RGB332 VGA output for the XIAO ESP32S3 Plus, double buffered in
PSRAM. Includes content modes (test pattern, plasma, stars, clock,
Mandelbrot, message, images, Halloween, Haunting), a flash image gallery,
WiFi AP+STA web UI and OTA updates.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 22:05:32 +13:00

1.5 KiB
Raw 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.

cd vga_test
idf.py set-target esp32s3
idf.py build flash

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 run:

curl -X POST --data-binary @build/vga_test.bin http://<board-ip>/api/ota