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

54 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```