SonosESP Controller

Web Firmware Installer

v0.1.0
Support me on Ko-fi

Hardware Requirement: Seeed Studio reTerminal D1001 (800×1280 MIPI DSI, GSL3670 Touch, ESP32-P4 + ESP32-C6)

Hardware Specifications

Microcontroller ESP32-P4
Display 800×1280 MIPI DSI
Touch GSL3670 I2C
Flash 16 MB
PSRAM OPI

Installation Steps

  1. Pre-configure WiFi (optional) Enter SSID + password in the WiFi section below — credentials are embedded in the flash image
  2. Connect Device Plug ESP32-P4 via USB-C
  3. Flash Firmware Click button below (Web Serial) or use esptool.py
  4. Configure WiFi if skipped Use the on-screen keyboard after first boot

Requires Chrome, Edge, or Opera — ESP32-P4 support is experimental

After installation completes, unplug and replug your device to reboot.

WiFi Configuration (Optional)

Enter credentials before flashing. The installer embeds them into the firmware image so the device connects to your network on first boot — no touchscreen setup needed.

Enter SSID above — download and flash at 0x9000 alongside the firmware, or use Web Serial to flash everything at once.

Manual Flash with esptool.py

Use this method if the Web Serial button above does not work. Download the three firmware files, install esptool, then run the flash command.

1 — Download firmware files
bootloader.bin partitions.bin firmware.bin
2 — Install esptool
pip install esptool
3 — Flash (Linux / macOS — adjust --port as needed)
esptool.py --chip esp32p4 --port /dev/ttyACM0 --baud 460800 \ write_flash \ 0x2000 bootloader.bin \ 0x8000 partitions.bin \ 0x10000 firmware.bin
3 — Flash (Windows — adjust COM port as needed)
esptool.py --chip esp32p4 --port COM3 --baud 460800 ^ write_flash ^ 0x2000 bootloader.bin ^ 0x8000 partitions.bin ^ 0x10000 firmware.bin

The reTerminal D1001 USB-C port exposes the ESP32-P4 via the ESP32-C6 USB bridge. Hold the BOOT button while plugging in if the port is not detected automatically.