The Arduino ESP32 pre-release version 3.0.0-aplha is based on the ESP-IDF v5.1 (release notes) and is major release supporting new version of ESP-IDF 5.1. This release introduce breaking changes and support for new SoCs, ESP32-H2 and ESP32-C6.

Known issues of this release

• If you are a Linux or MacOS user, it is mandatory to use Arduino IDE v2 or arduino-cli for the package installation. Arduino IDE v1 currently fails due to limitations related to archive compression.

Breaking changes of 3.0.0 Release

This version introduce breaking changes in this particular APIs:

• ADC
• BLE
• Hall Sensor (not supported)
• I2S
• LEDC
• RMT
• SigmaDelta
• Timer
• UART (HardwareSerial)

For more details please refer to Migration Guide from version 2.x to 3.0.

Major changes

• ESP-IDF v5.1 by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/7733
• Initial support for ESP32-H2
• Initial support for ESP32-C6 by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8337
• API drivers refactoring to support ESP-IDF v5.1 APIs
• Implementations of Peripheral Manager

APIs changes & updates

• ADC refactoring by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/7827
• TIMER refactoring by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/7904
• [Arduino Core 3.0.0] RMT IDF5.1 Refactoring #7994 by @SuGlider in https://github.com/espressif/arduino-esp32/pull/7994
• [Arduino Core 3.0.0] Fixes UART to work with any APB Freq by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8097
• LEDC Refactoring - Peripheral manager implemented by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8126
• TIMER - add timer_started flag, fix timerEnd() + timer HW test by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8135
• DAC - Added missing deinit of previous bus by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8180
• Update esp32-hal-rmt.c by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8216
• LEDC - Memory fix by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8264
• LEDC Fade implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8338
• ESP32-C6 Fixes Settings for RMT and UART source clock by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8340
• Fixes RMT filter & idle timing and setup by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8359
• SPI fix for C6 branch by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8367
• Removed duplicate TX1 define for ESP32H2 by @PilnyTomas in https://github.com/espressif/arduino-esp32/pull/8402
• Fixing UART1 pins for esp-idf-v5.1-libs by @petergjoel in https://github.com/espressif/arduino-esp32/pull/8477
• [ETH] Implement SPI support, multiple interfaces and more by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8575
• Analog Continuous mode API by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8715
• BLE upgrades by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8724

Peripheral Manager implementations

Description of Peripheral Manager is available here.

• TOUCH - Peripheral manager implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8129
• GPIO - Peripheral manager implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8179
• I2C - Peripheral manager implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8220
• SPI - Peripheral manager implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8255
• SPI - Peripheral manager fix by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8279
• SDMMC - Peripheral manager implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8289
• ETHERNET - Peripheral manager implementation by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8297
• Adds USB to Peripheral Manager - Arduino Core 3.0.0 by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8335
• Adds HardwareSerial to Peripheral Manager - Arduino 3.0.0 by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8328
• Enforces more consistency into Peripheral Manager by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8188
• 3.0.0 - UART Peripheral Manager + Detach UART pins on begin()/setPins() by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8719

Other changes

• Makes F_CPU generic for all SoC by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8007
• Fixes APLL/PLL with RTC Frequency by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8025
• Add workflow to build executables from python scripts by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8290
• Add checks for SOC defines by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8351
• Updated FreeRTOS names by @PilnyTomas in https://github.com/espressif/arduino-esp32/pull/8418
• MD5 memory leak fix by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8486
• Add support for custom panic handler by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8574
• HTTPClient - Fix case sensitiveness for header keys by @lucasssvaz in https://github.com/espressif/arduino-esp32/pull/8630
• Fix memory leak and undefined behavour in Updater.cpp (UpdaterClass) by @MathewHDYT in https://github.com/espressif/arduino-esp32/pull/8671
• Serial reorganization code for RS-485 Mode, Flow Control Mode and Serial Mode by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8718
• Add support for custom panic handler by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8711
• Add printf method with FlashStringHelper argument by @lucasssvaz in https://github.com/espressif/arduino-esp32/pull/8677
• WebServer: use MD5Builder instead of mbedtls by @Staars in https://github.com/espressif/arduino-esp32/pull/8667
• BT serial: SSP improvements, added missing events by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8723
• fix flash mode read out for C6 by @Jason2866 in https://github.com/espressif/arduino-esp32/pull/8517
• Update PlatformIO scripts for the upcoming 3.0 core by @valeros in https://github.com/espressif/arduino-esp32/pull/8183
• WiFiGeneric CrashFix 5.1-libs by @mrengineer7777 in https://github.com/espressif/arduino-esp32/pull/8044
• include ctime by @Jason2866 in https://github.com/espressif/arduino-esp32/pull/8722

Boards additions and updates

• Master5.1 s3 gpio48 and platform txt review by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8726
• Fix pin attachInterrupt(digitalPinToInterrupt(48)) on all S3 based SOCs by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8600
• added namino bianco board + other fix on menus by @a-sapuppo in https://github.com/espressif/arduino-esp32/pull/8730

Examples

• Adds missing pinMode by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8312
• fixes preprocessor test by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8485
• [All Arduino Cores] Adds HardwareSerial Example by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8095
• SD_MMC update by @PilnyTomas in https://github.com/espressif/arduino-esp32/pull/8298
• Add TFLite Micro examples by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8717

Documentation and CI

• [Docs] ADC and Timer API Update (+some docs fixes) by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/7906
• HW Testing - Pytest update by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8389
• HW Testing - ESP32-C6 + ESP32-H2 fixes by @P-R-O-C-H-Y in https://github.com/espressif/arduino-esp32/pull/8404
• Update README.md to add new SoCs by @SuGlider in https://github.com/espressif/arduino-esp32/pull/8727
• Add Arduino lib to arduino as IDF component by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8721
• Update of documentation link on readme.md for WifiClientSecure by @benlye in https://github.com/espressif/arduino-esp32/pull/8441
• Add Arduino lib to arduino as IDF component by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8721
• Update release script for 3.0.0 by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8728
• Print full chip report when log level is sufficient by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/8282
• Backport some fixes from esp-idf-v5.1 by @me-no-dev in https://github.com/espressif/arduino-esp32/pull/7762

Note: Due to merging development branch into master branch, the changelog does not include all the changes.

Full Changelog: https://github.com/espressif/arduino-esp32/compare/2.0.14...3.0.0-alpha1

New Contributors

• @MathewHDYT made their first contribution in https://github.com/espressif/arduino-esp32/pull/8671
• @benlye made their first contribution in https://github.com/espressif/arduino-esp32/pull/8441
• @Staars made their first contribution in https://github.com/espressif/arduino-esp32/pull/8667

Thanks for your contribution! 🎉