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

54 lines
1.7 KiB
Markdown
Raw Permalink 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. 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`.