Flash firmware to your eSpa device directly from your browser

Select Your Device

ESP32

Select a device target to see available firmware

Available Releases

Loading releases...

Flash Custom Binary

Upload and flash locally-built firmware binaries directly from your computer.

Firmware Binary

SPIFFS Binary (Optional)

Firmware will be flashed to offset 0x0. SPIFFS (if provided) will be flashed to offset 0x290000. Make sure you select the correct chip family above before flashing.

Building from Source

Pre-built firmware binaries are available in the releases above. If you need to build custom firmware, you can compile from source using PlatformIO:

PlatformIO Build for esp32dev

Change the device target above to update these instructions

1. Clone and build firmware:

git clone
cd
pio run -e esp32dev

2. Build SPIFFS filesystem:

pio run -e esp32dev -t buildfs

3. Flash firmware and SPIFFS:

pio run -e esp32dev -t upload
pio run -e esp32dev -t uploadfs

The binaries will be located in .pio/build/esp32dev/firmware.bin and spiffs.bin. You can flash them using the "Flash Custom Binary" tab.

Release Details

How to Flash Firmware

Quick Start Guide

  1. 1
    Select Your Device

    Choose your device target from the dropdown menu. The chip family will be set automatically based on the hardware specification.

  2. 2
    Connect via USB

    Connect your ESP device to your computer using a USB cable. Make sure the cable supports data transfer (not just charging).

  3. 3
    Choose Firmware

    Browse the available releases and click "Flash" on the version you want to install.

  4. 4
    Select Serial Port

    Click "Connect" and select your device's serial port from the browser dialog. It usually appears as "USB Serial" or similar.

  5. 5
    Wait for Completion

    The flashing process will take 1-2 minutes. Don't disconnect your device until it's complete.

Browser Support

This tool requires WebSerial API support. Compatible browsers include:

  • Google Chrome (Desktop)
  • Microsoft Edge (Desktop)
  • Opera (Desktop)

Note: Mobile browsers and Firefox do not currently support WebSerial.

Troubleshooting

Device not detected?

Try a different USB cable or port. Some cables are charge-only and don't support data transfer.

Flashing failed?

Make sure you selected the correct device target. Press and hold the BOOT button on your device, then try again.

Need more help?

Visit espa.diy for documentation and community support.