Precompiled Micropython ESPNow Images for the ESP32 and ESP8266

NOTE: Do not use - ESPNow is now available in micropython by default.

This collection of espnow-enabled micropython images is no longer supported or necessary. ESPNow support has been available in production micropython images since the v1.21.0 release.

Please obtain ESPNow enabled micropython images from https://micropython.org/download?port=esp32.

If you really must...

A collection of pre-compiled, pre-v1.21.0 micropython images (including espnow support) for the esp32 and esp8266.

These are provided as a convenience for users until the ESPNow code is accepted into a Micropython release.

These images are compiled from the **espnow-g20*** branches at https://github.com/glenn20/micropython.

The Pull Request for ESPNow support is available at: https://github.com/micropython/micropython/pull/6515.

Documentation for the ESPNow module can be browsed at: https://micropython-glenn20.readthedocs.io/en/latest/library/espnow.html.

General micropython documentation at: https://docs.micropython.org/en/latest/reference/index.html.

Each folder contains the following firmware images:

firmware-esp32-GENERIC.bin: For the ESP32 GENERIC build target.
firmware-esp8266-GENERIC_1M.bin: For the ESP8266 GENERIC_1M build target (1MB RAM devices)
firmware-esp8266-GENERIC.bin: For the ESP8266 GENERIC build target (2+MB RAM devices)

These images are built following the instructions at https://github.com/micropython/micropython/blob/master/ports/esp32/README.md and https://github.com/micropython/micropython/blob/master/ports/esp8266/README.md.

Images can be written to the ESP32 and ESP8266 devices over usb using esptool.py (install using pip), eg, one of:

esptool.py --port /dev/ttyUSB0 --baud 115200 write_flash --flash_size=4MB --flash_mode=qio 0 firmware-esp8266-GENERIC_1M.bin

esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x1000 firmware-esp32-GENERIC.bin

esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 firmware-esp32-GENERIC_S2.bin

Micropython v1.20.0

20230427_espnow-g20-v1.20.0-2-gcc4c716f6:
- Branch espnow-g20-v1.20.0 patches applied against Micropython release v1.20.0 on 27 April 2023.
- API changes following PR review: (see espnow module docs):
  - Rename timeout config option to timeout_ms:
  - config(timeout=xx) -> config(timeout_ms=xx)
  - If timeout_ms < 0: disable timeout on wait for messages.
  - Rename ESPNow.on_recv() to ESPNow.irq():
  - Remove optional second argument to ESPNow.irq():
    - irq(callback[, arg]) -> irq(callback)
  - Rename espnow.ETH_ALEN to espnow.ADDR_LEN.
- I have been able to test images for the following boards:
  - esp32: GENERIC UM_TINYS2 UM_TINYS3 UM_FEATHERS2 UM_FEATHERS3 GENERIC_S2 GENERIC_S3
  - esp8266: GENERIC GENERIC_1M

Micropython v1.19.1

20220709_espnow-g20-v1.19.1-espnow-6-g44f65965b:
- Branch v1.19.1-espnow-6-g44f65965b patches applied against Micropython release v1.19.1.
- Fixup for callback methods: ESPNow.irq() and ESPNow.on_recv():
  - See docs at: https://micropython-glenn20.readthedocs.io/en/latest/library/espnow.html#callback-methods.
  - New tests in tools/multi_espnow/15_irq_test.py.

Micropython v1.18

20220423_espnow-g20-v1.18-14-g78cdcdfdc:
- Branch espnow-g20-v1.18 patches applied against Micropython release v1.18 on 23 April 2022.
- Includes: RSSI monitoring, asyncio support (aioespnow.py)
  - New implementation of RSSI monitoring (no change to user API)
  - RSSI of first message(s) from peer is no longer lost
  - Device table is updated on call to recv()/irecv(), so you must read the message out of the buffers before the rssi value is updated in e.peers (see docs). This also reduces the workload in the internal function (espnow_recv_cb()).
- ESP32 images are built with v4.2 IDF
  - If micropython.mem_info() was only showing ~64k RAM, this should be fixed
- ESP32S2 and ESP32C3 are built with v4.4 IDF.
- No new ESP8266 images as there are no differences from prior uploads.

Micropython v1.17

2021113_espnow-g20-v1.17-142-gbb9aac55a:
- Branch espnow-g20-dev applied against Micropython master (ff4f1f3a) on 13 November 2021.
- Includes builds for all of the new esp32 S2/S3/C3 targets. Warning - most of these builds are untested.

glenn20 / micropython-espnow-images