Flashing

spangap-demo is the bare platform with nothing on top: web interface, command line, settings, networking and the board’s hardware. There is an image for every supported board and a generic one for any other ESP32-S3.

From a browser

Open flashmon in a Chromium-based browser (desktop Chrome, Edge, Brave or Opera), plug your board in over USB, and click through. It detects which board you have and flashes the matching image — or, for a board it does not know, the generic image that fits the chip’s flash and PSRAM — then drops into a serial monitor.

After it boots

The device starts a WiFi access point whose name starts with spangap_. Connect to it and open https://spangap.local for the web interface. A board with a screen also shows a phone-like UI on the LCD.

To put the device on your own WiFi instead, type net add <ssid> <password> in the serial monitor (quote the password if it has spaces). You can, and should, set a password for the web interface from your browser or by typing passwd in the serial monitor. Setting a password also lets you log in to the device command line with ssh admin@spangap.local.

By hand, with esptool

Download an image zip from the catalogue and unpack it. Inside is a demo.esptool argfile naming every binary and the offset it belongs at, so the whole flash is one esptool invocation:

unzip spangap_hw-lilygo-tdeck_<stamp>.zip -d image
cd image
esptool.py --port /dev/ttyACM0 write_flash @demo.esptool

Building it yourself

To build it yourself, follow Getting started with spangap/spangap-demo in place of reticulous/reticulous.