ESP8266

Vendor: Espressif
Features: External Flash, WiFi
Source on GitHub: esp8266/ESP8266_GENERIC
More info: Website

The following are daily builds of the ESP8266 firmware. This will work on boards with at least 2MiB of flash. They have the latest features and bug fixes, WebREPL is not automatically started, and debugging is enabled by default.

For boards with 1MiB or 512kiB of flash, two variants are provided with reduced functionality. The 1MiB variant removes asyncio and FAT-filesystem support as well as some modules from micropython-lib. The 512kiB variant further removes all filesystem support, as well as framebuffer support, some Python language features, and has less detailed error messages.

Note: v1.12-334 and newer (including v1.13) require an ESP8266 module with 2MiB of flash or more, and use littlefs as the filesystem by default. When upgrading from older firmware please backup your files first, and either erase all flash before upgrading, or after upgrading execute vfs.VfsLfs2.mkfs(bdev).

OTA builds

Over-The-Air (OTA) builds of the ESP8266 firmware are also provided.

The first time you use this build you need to flash one of the "initial image" images using esptool.py as described above. After that, you can update the firmware over the air using the "OTA update" file in conjunction with the ota-client script from yaota8266. The "OTA update" files are digitally signed and will only work with the provided "initial image" files, and vice versa. (Note: this feature is work-in-progress.)

Installation instructions

Program your board using the esptool.py program as described the tutorial.

Firmware

Releases

v1.23.0 (2024-06-02) .bin / [.elf] / [.map] / [Release notes] (latest)
v1.22.2 (2024-02-22) .bin / [.elf] / [.map] / [Release notes]
v1.22.1 (2024-01-05) .bin / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .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-18) .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-11) .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]
v1.9.3 (2017-11-01) .bin / [.elf] / [.map] / [Release notes]
v1.9.2 (2017-08-23) .bin / [.elf] / [.map] / [Release notes]
v1.9.1 (2017-06-12) .bin / [.elf] / [.map] / [Release notes]
v1.9 (2017-05-26) .bin / [.elf] / [.map] / [Release notes]
v1.8.7 (2017-01-08) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.24.0-preview.409.g82e69df33 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.408.g05ac69329 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.407.g197becbdc (2024-10-09) .bin / [.elf] / [.map]
v1.24.0-preview.395.ge5eeaa7df (2024-10-09) .bin / [.elf] / [.map]
v1.23.0-5.g3613ad962 (2024-05-31) .bin / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (OTA compatible)

Releases

v1.23.0 (2024-06-02) .bin / [.elf] / [.map] / [Release notes] (latest)
v1.22.2 (2024-02-22) .bin / [.elf] / [.map] / [Release notes]
v1.22.1 (2024-01-05) .bin / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .bin / [.elf] / [.map] / [Release notes]
v1.20.0 (2023-04-26) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.19.1 (2022-06-18) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.18 (2022-01-17) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.13 (2020-09-02) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.12 (2019-12-20) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.11 (2019-05-29) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.10 (2019-01-25) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.9.4 (2018-05-11) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.9.3 (2017-11-01) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.9.2 (2017-08-23) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.9.1 (2017-06-11) .bin / [.elf] / [.map] / [.ota] / [Release notes]
v1.9 (2017-05-26) .bin / [.elf] / [.map] / [.ota] / [Release notes]

Preview builds

v1.24.0-preview.409.g82e69df33 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.408.g05ac69329 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.407.g197becbdc (2024-10-09) .bin / [.elf] / [.map]
v1.24.0-preview.395.ge5eeaa7df (2024-10-09) .bin / [.elf] / [.map]
v1.23.0-5.g3613ad962 (2024-05-31) .bin / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (512kiB flash)

Releases

v1.23.0 (2024-06-02) .bin / [.elf] / [.map] / [Release notes] (latest)
v1.22.2 (2024-02-22) .bin / [.elf] / [.map] / [Release notes]
v1.22.1 (2024-01-05) .bin / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .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-18) .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]
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]
v1.9.3 (2017-11-01) .bin / [.elf] / [.map] / [Release notes]
v1.9.2 (2017-08-23) .bin / [.elf] / [.map] / [Release notes]
v1.9.1 (2017-06-11) .bin / [.elf] / [.map] / [Release notes]
v1.9 (2017-05-26) .bin / [.elf] / [.map] / [Release notes]
v1.8.7 (2017-01-08) .bin / [.elf] / [.map] / [Release notes]

Preview builds

v1.24.0-preview.409.g82e69df33 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.408.g05ac69329 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.407.g197becbdc (2024-10-09) .bin / [.elf] / [.map]
v1.24.0-preview.395.ge5eeaa7df (2024-10-09) .bin / [.elf] / [.map]
v1.23.0-5.g3613ad962 (2024-05-31) .bin / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)

Firmware (1MiB flash)

Releases

v1.23.0 (2024-06-02) .bin / [.elf] / [.map] / [Release notes] (latest)
v1.22.2 (2024-02-22) .bin / [.elf] / [.map] / [Release notes]
v1.22.1 (2024-01-05) .bin / [.elf] / [.map] / [Release notes]
v1.22.0 (2023-12-27) .bin / [.elf] / [.map] / [Release notes]
v1.21.0 (2023-10-05) .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-18) .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]

Preview builds

v1.24.0-preview.409.g82e69df33 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.408.g05ac69329 (2024-10-10) .bin / [.elf] / [.map]
v1.24.0-preview.407.g197becbdc (2024-10-09) .bin / [.elf] / [.map]
v1.24.0-preview.395.ge5eeaa7df (2024-10-09) .bin / [.elf] / [.map]
v1.23.0-5.g3613ad962 (2024-05-31) .bin / [.elf] / [.map]
(These are automatic builds of the development branch for the next release)