5.1.1

Release Notes

• Added support for overriding reset operations via the project config file (#874)
• Updated approach to preparing proper binaries for debugging and uploading via debug tools (#872)
• Enabled the USB CDC peripheral for DFRobot Beetle ESP32-C3 by default (#888)
• Updated the variant field for LOLIN C3 Mini (#890)
• Updated specs for Denky D4 (#887)
• Fixed the value of the flash_mode field for ESP32-S3-DevKitC-1 (#867)
• Fixed a regression bug with build targets that don't run the platform build scripts (#883)

Configuration

To utilize this version, please navigate to your platformio.ini (Project Configuration File) and adjust the platform option as follows:

[env:my-esp32]
platform = espressif32 @ 5.1.1

For further exploration of configuration options for the espressif32 development platform, refer to the documentation.

Supported Frameworks

• Arduino - v2.0.4
• ESP-IDF - v4.4.1

5.1.0

Release Notes

• Added new boards:
  • Adafruit Feather ESP32-S3 TFT
  • Adafruit Feather ESP32-S3 No PSRAM
  • CNRS AW2ETH
  • Connaxio's Espoir
  • DFRobot Beetle ESP32-C3
  • DFRobot Firebeetle 2 ESP32-S3
  • Seeed Studio XIAO ESP32C3
  • WEMOS D1 R32
• Added support for Arduino v2.0.4 (release notes)
• Updated OpenOCD package to v0.11.0-esp32-20220706 (release notes)
• Arduino build flags now propagated to the global scope for mixed IDF/Arduino projects #848
• Fixed flash memory size for adafruit_feather_esp32s3 #836
• Minor fixes and improvements (#829, #853, #863)

Additional notes

• This release introduces an additional build step that merges all the primary binaries (partitions, bootloaders and the firmware itself) into a single image before debugging or uploading via debug probes. It's a required modification as the latest Arduino core v2.0.4 is shipped with prebuilt bootloaders that don't have proper default file headers anymore. This inconsistency results in bootloops if the firmware is flashed via OpenOCD because OpenOCD has no mechanisms to determine what flash memory settings were used. The only major side effect of this change is that the gaps (e.g. Non-volatile Storage section) between binaries may be erased while debugging or uploading via debug probes. In such cases, it's recommended to use uploading via serial port.
• The adafruit_feather_esp32s3 ID now corresponds to the Adafruit Feather ESP32-S3 2MB PSRAM board. For the No PSRAM variant please use adafruit_feather_esp32s3_nopsram.
• The adafruit_qtpy_esp32s3 board ID has been renamed to adafruit_qtpy_esp32s3_nopsram to match the board manifest content.
• The Arduino version for mixed IDF/Arduino project is locked to 2.0.3 due to linking errors.

Configuration

To utilize this version, please navigate to your platformio.ini (Project Configuration File) and adjust the platform option as follows:

[env:my-esp32]
platform = espressif32 @ 5.1.0

For further exploration of configuration options for the espressif32 development platform, refer to the documentation.

Supported Frameworks

• Arduino - v2.0.4
• ESP-IDF - v4.41

5.0.0

Release Notes

• Added support for the latest ESP-IDF v4.4.1 (release notes)
• Added ESP-based debug probes #828
• Fixed esp32_exception_decoder to handle a possible missing whitespace characters
• Minor fixes and improvements #830

Configuration

To utilize this version, please navigate to your platformio.ini (Project Configuration File) and adjust the platform option as follows:

[env:my-esp32]
platform = espressif32 @ 5.0.0

For further exploration of configuration options for the espressif32 development platform, refer to the documentation.

Supported Frameworks

• Arduino - v2.0.3
• ESP-IDF - v4.4.1

4.4.0

• Added compatibility with PIO Core 6.0
• Improved support for bare assembly programming

4.3.0

• Added new boards: Adafruit Feather ESP32-S3 No PSRAM, Adafruit Feather ESP32 V2, Adafruit QT Py ESP32, Adafruit QT Py ESP32-C3, Adafruit QT Py ESP32-S3, AirM2M CORE ESP32C3, Deneyap Kart 1A, Espressif ESP32-S3-DevKitC-1, Espressif ESP32-S3-Box, ESP32S3 CAM LCD, WEMOS LOLIN C3 Mini, WEMOS LOLIN S2 Mini, WEMOS LOLIN S2 PICO, Trueverit ESP32 Universal IoT Driver MK III, Unexpected Maker FeatherS3, Unexpected Maker PROS3, Unexpected Maker RMP, Unexpected Maker TinyS3, SQFMI Watchy v2.0
• Added support for Arduino v2.0.3 (release notes)
• Refactored processing of IDF linker fragments #760
• Fixed an issue with improper optimization level for IDF bootloader that caused bootloop in debug mode #739

4.2.0

• Added new boards:
  • Adafruit Feather ESP32-S2 TFT
  • Adafruit QT Py ESP32-S2
  • DPU ESP32
  • PyCom WiPy3
  • Wireless-Tag WT32-ETH01
• Added support for Arduino v2.0.2 (release notes)
• Updated esptoolpy to v3.3 (#770) (release notes)
• Added CMSIS-DAP as available debug probe (#771)
• Minor fixes and improvements

4.1.0

• Added new board TTGO T-OI PLUS RISC-V ESP32-C3
• Added support for Arduino v2.0.1 (#619) (release notes)
• Updated toolchain packages to v8.4.0-patch3

4.0.0

• Added new boards:
  • Adafruit FunHouse, Adafruit MagTag 2.9, Adafruit Metro ESP32-S2, ATMegaZero ESP32-S2, Deneyap Kart, Deneyap Mini, Denky32, Denky D4, Franzininho WiFi, Franzininho WiFi MSC, MakerAsia KB32-FT, microS2, SparkFun ESP32 MicroMod, SparkFun ESP32-S2 Thing Plus, Trueverit ESP32 Universal IoT Driver, Trueverit ESP32 Universal IoT Driver MK II, Unexpected Maker FeatherS2, Unexpected Maker FeatherS2 Neo, Unexpected Maker TinyS2, uPesy ESP32 Wroom DevKit, uPesy ESP32 Wrover DevKit
• Added support for Arduino v2.0.0 (#619, #652, #591) (release notes)
• Added support for LittleFS and FFat filesystems (#546, #570, #643)
• Updated OpenOCD package to v0.11.0-esp32-20220411 (release notes)
• Added a feature of uploading filesystem images via a debug tool (#177, #422)
• Fixed an issue with incorrect objcopy binary used for embedding external files (#714)
• Fixed an inconsistency with not used offset_address option when uploading via esptool (#538)
• Deprecated support for Simba and Pumbaa frameworks
• Minor fixes and improvements (#547, #603)

Dynamic toolchain configuration for upstream Arduino framework

The Arduino framework for ESP32 SoCs is being rapidly developed and sometimes depends on cutting-edge packages that are not available in the stable version of the development platform. For this reason, we added some user-friendly functionality that dynamically parses relevant toolchain versions directly from a remote source and configures the development platform accordingly. Please note that this new functionality may possibly affect only those who have manually overridden the framework-arduinoespressif32 package to point to a Github repository via the platform_packages option. In case you're experiencing any problems with this feature, you can disable it via the board_build.arduino.upstream_packages option in your platformio.ini file:

[env:ttgo-lora32-v21]
platform = espressif32
framework = arduino
board = ttgo-lora32-v21
platform_packages = 
    framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32.git

; Disable dynamic toolchain configuration for upstream Arduino packages
; board_build.arduino.upstream_packages = no

Notes on deprecating Simba and Pumbaa frameworks:

This release deprecates support for the Simba and Pumbaa frameworks. To keep projects based on these frameworks compilable please lock the platform version to v3.5.0 in your platformio.ini file:

[env:nano32]
platform = espressif32 @ ~3.5.0
framework = pumbaa
board = nano32

3.5.0

• Added new boards:
  • Franzininho WiFi
  • LionBit
• Updated ESP-IDF to v4.3.2 (release notes)
• Updated toolchains for ESP-IDF to v8.4.0r2-patch2
• Removed redundant PSRAM fix for M5 Stack Core2 (#676)

3.4.0

• Updated ESP-IDF to the latest 4.3.1 (release notes) (#635)
• Updated toolchains for ESP-IDF to v8.4.0 (#655)
• Fixed partition offset calculation process (#627)
• Fixed a regression with incorrect flash modes used for uploading (#584, #623, #630)
• Fixed an issue with incorrect command used for embedding plain files in IDF-based projects (#639)