+8
日增长
+72
周增长
+226
月增长
17,735
stars
7,943
forks
492
watchers
4,550
prs
7,766
issues
94
releases
README
Arduino core for the ESP32 family of SoCs  Need help or have a question? Join the chat at Discord or open a new Discussion Contents - Development Status - Development Planning - Documentation - Supported Chips - Decoding exceptions - Issue/Bug report template - Contributing Development Status Latest Stable Release Latest Development Release Development Planning Our Development is fully tracked on this public Roadmap 🎉 For even more information you can join our Monthly Community Meetings 🔔. Documentation You can use the Arduino-ESP32 Online Documentation to get all information about this project. --- Migration guide from version 2.x to 3.x is available here. --- APIs compatibility with ESP8266 and Arduino-CORE (Arduino.cc) is explained here. --- Getting Started Installing (Windows, Linux and macOS) Libraries Arduino as an ESP-IDF component FAQ Troubleshooting Supported Chips Here are the ESP32 series supported by the Arduino-ESP32 project: | SoC | Stable | Development | Datasheet | |----------|:----------:|:---------------:|:-------------------------------------------------------------------------------------------------:| | ESP32 | Yes | Yes | ESP32 | | ESP32-C3 | Yes | Yes | ESP32-C3 | | ESP32-C5 | Yes | Yes | ESP32-C5 | | ESP32-C6 | Yes | Yes | ESP32-C6 | | ESP32-H2 | Yes | Yes | ESP32-H2 | | ESP32-P4 | Yes | Yes | ESP32-P4 | | ESP32-S2 | Yes | Yes | ESP32-S2 | | ESP32-S3 | Yes | Yes | ESP32-S3 | [!NOTE] ESP32-C2 and ESP32-C61 are also supported by Arduino-ESP32 but require using Arduino as an ESP-IDF component or rebuilding the static libraries. For more information, see the Arduino as an ESP-IDF component documentation or the Lib Builder documentation, respectively. For more details visit the supported chips documentation page. Decoding exceptions You can use EspExceptionDecoder to get meaningful call trace. Issue/Bug report template Before reporting an issue, make sure you've searched for similar one that was already created. Also make sure to go through all the issues labeled as Type: For reference. Finally, if you are sure no one else had the issue, follow the Issue template or Feature request template while reporting any new Issue. External libraries compilation test We have set-up CI testing for external libraries for ESP32 Arduino core. You can check test results in the file LIBRARIES_TEST. For more information and how to add your library to the test see external library testing in the documentation. Contributing We welcome contributions to the Arduino ESP32 project! See contributing
Top issues
#6563Investigate supporting power management in arduino-esp32 (DFS + tickless idle)26 comments · 2022-04-11#10670vendorRequestCallback not working in USBVendor.ino example17 comments · 2024-12-02#9721Add support for Low Power core of the ESP32C617 comments · 2024-05-29#13102USBCDC: make the "connected" (DTR) requirement for notifyState()/write() configurable16 comments · 2026-11-10#12246please add an usb library for touchscreen or touchtap15 comments · 2026-01-15#8107USB stops working after Windows host computer sleep15 comments · 2023-04-22#9486Implement OpenThread in Arduino13 comments · 2024-04-11#10836ESP32-S3 - Arduino v3.1 - USBCDC Hangs and misses chunks of data for for large serial transmits12 comments · 2025-01-09
Discussions
#13118ESP32-C6 Deep-sleep: detecting both transitions on two GPIO inputs and periodic timer wake-up1 comments · 2026-11-13#13075Pinscope: reach an ESP32 Arduino sketch’s web server from anywhere, with logs, crash reports and OTA0 comments · 2026-11-04#13074Decoding ESP32 crashes in Arduino IDE 2 without a plugin0 comments · 2026-11-04#13057Three 3.x migration traps that cost a compile (FS namespace, NTPClient, DNS cache lock)0 comments · 2026-11-02#13053ESP32-S3 IR Transmission for Haier KFR-35GW/07ZJL23A-DS AC Not Working1 comments · 2026-10-30#13028Core 3.3.12 vs 2.0.17: UDP over W5500 is 2–5x later on ESP32-S3 — is lwIP core locking the cause?2 comments · 2026-10-26#13025ESP32 + a browser-based Harness: ordering takeaway on an iPhone0 comments · 2026-10-25#12959Arduino progmem 2d array1 comments · 2026-09-30
Latest release
ESP32 Arduino Release 3.3.12 based on ESP-IDF v5.5.5 3.3.12 2026-09-18What's Changed fix(webserver): Harden security and fix hangs by @lucasssvaz in https://github.com/espressif/arduino-esp32/pull/12794 ci(upload): Optimize scripts and upload test by @lucasssvaz in https://github.com/espressif/arduino-esp32/pull/12773 build(deps): bump cryptography from 48.0.1 to 50.0.0 in /tests by @dependabot[bot] in https://github.com/espressif/arduino-esp32/pull/12804 docs(compatibility): Add notes on ESP8266 compatibility by @lucasssvaz in https://github.com/espressif/arduino-esp32/pull/12802 docs(adc): Correct attenuation enum names to match the Arduino API by @R