ESP32 / WROOM

Vendor: Espressif
Features: BLE, External Flash, WiFi
Source on GitHub: esp32/ESP32_GENERIC
More info: Website

The following files are firmware that should work on most ESP32-based boards with 4MiB of flash, including WROOM WROVER, SOLO, PICO, and MINI modules.

If your board is based on a WROVER module, or otherwise has SPIRAM (also known as PSRAM), then use the "spiram" variant.

The "d2wd" variant is for ESP32-D2WD chips (with 2MiB flash), and "unicore" is for single-core ESP32 chips (e.g. the "SOLO" modules). The "ota" variant sets up the partition table to allow for Over-the-Air updates.

Installation instructions

Program your board using the esptool.py program, found here.

If you are putting MicroPython on your board for the first time then you should first erase the entire flash using:

esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash

From then on program the firmware starting at address 0x1000:

esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x1000 esp32-20190125-v1.10.bin

Firmware

Releases

v1.22.2 (2024-02-22) .bin / [.app-bin] / [.elf] / [.map] / [Release notes] (latest)
v1.22.1 (2024-01-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.20.0 (2023-04-26) .bin / [.elf] / [.map] / [Release notes]
v1.19.1 (2022-06-18) .bin / [.elf] / [.map] / [Release notes]
v1.18 (2022-01-17) .bin / [.elf] / [.map] / [Release notes]
v1.17 (2021-09-02) .bin / [.elf] / [.map] / [Release notes]
v1.16 (2021-06-23) .bin / [.elf] / [.map] / [Release notes]
v1.15 (2021-04-18) .bin / [.elf] / [.map] / [Release notes]
v1.14 (2021-02-02) .bin / [.elf] / [.map] / [Release notes]
v1.13 (2020-09-02) .bin / [.elf] / [.map] / [Release notes]
v1.12 (2019-12-20) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.23.0-preview.161.g4f7d0df9b (2024-02-24) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.155.g2962e2416 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.154.g31e131bd7 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.148.g0c7ccb880 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (ESP32 Unicore)

Releases

v1.22.2 (2024-02-22) .bin / [.app-bin] / [.elf] / [.map] / [Release notes] (latest)
v1.22.1 (2024-01-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.20.0 (2023-04-26) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.23.0-preview.161.g4f7d0df9b (2024-02-24) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.155.g2962e2416 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.154.g31e131bd7 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.148.g0c7ccb880 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (Support for OTA)

Releases

v1.22.2 (2024-02-22) .bin / [.app-bin] / [.elf] / [.map] / [Release notes] (latest)
v1.22.1 (2024-01-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.20.0 (2023-04-26) .bin / [.elf] / [.map] / [Release notes]
v1.19.1 (2022-06-18) .bin / [.elf] / [.map] / [Release notes]
v1.18 (2022-01-17) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.23.0-preview.161.g4f7d0df9b (2024-02-24) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.155.g2962e2416 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.154.g31e131bd7 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.148.g0c7ccb880 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (ESP32 D2WD)

Releases

v1.22.2 (2024-02-22) .bin / [.app-bin] / [.elf] / [.map] / [Release notes] (latest)
v1.22.1 (2024-01-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.20.0 (2023-04-26) .bin / [.elf] / [.map] / [Release notes]
v1.19.1 (2022-06-18) .bin / [.elf] / [.map] / [Release notes]
v1.18 (2022-01-17) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.23.0-preview.161.g4f7d0df9b (2024-02-24) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.155.g2962e2416 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.154.g31e131bd7 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.148.g0c7ccb880 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (Support for SPIRAM / WROVER)

Releases

v1.22.2 (2024-02-22) .bin / [.app-bin] / [.elf] / [.map] / [Release notes] (latest)
v1.22.1 (2024-01-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .bin / [.app-bin] / [.elf] / [.map] / [Release notes]
v1.20.0 (2023-04-26) .bin / [.elf] / [.map] / [Release notes]
v1.19.1 (2022-06-18) .bin / [.elf] / [.map] / [Release notes]
v1.18 (2022-01-17) .bin / [.elf] / [.map] / [Release notes]
v1.17 (2021-09-02) .bin / [.elf] / [.map] / [Release notes]
v1.16 (2021-06-23) .bin / [.elf] / [.map] / [Release notes]
v1.15 (2021-04-18) .bin / [.elf] / [.map] / [Release notes]
v1.14 (2021-02-02) .bin / [.elf] / [.map] / [Release notes]
v1.13 (2020-09-02) .bin / [.elf] / [.map] / [Release notes]
v1.12 (2019-12-20) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.23.0-preview.161.g4f7d0df9b (2024-02-24) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.155.g2962e2416 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.154.g31e131bd7 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
v1.23.0-preview.148.g0c7ccb880 (2024-02-20) .bin / [.app-bin] / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (Compiled with IDF 3.x)

Releases

v1.14 (2021-02-02) .bin / [.elf] / [.map] / [Release notes] (latest)
v1.13 (2020-09-02) .bin / [.elf] / [.map] / [Release notes]
v1.12 (2019-12-20) .bin / [.elf] / [.map] / [Release notes]
v1.11 (2019-05-29) .bin / [.elf] / [.map] / [Release notes]
v1.10 (2019-01-25) .bin / [.elf] / [.map] / [Release notes]
v1.9.4 (2018-05-11) .bin / [.elf] / [.map] / [Release notes]