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