# Arduino core for the ESP32, ESP32-S2, ESP32-S3, ESP32-C3, ESP32-C6 and ESP32-H2

![Build Status]( [![External Libraries Test](]( [![Hardware Tests](](

### Need help or have a question? Join the chat at [Gitter]( or [open a new Discussion](

## Contents

  - [Development Status](#development-status)
  - [Development Planning](#development-planning)
  - [Documentation](#documentation)
  - [Supported Chips](#supported-chips)
  - [Decoding exceptions](#decoding-exceptions)
  - [Issue/Bug report template](#issuebug-report-template)
  - [Contributing](#contributing)

### Development Status

Latest Stable Release  [![Release Version](]( [![Release Date](]( [![Downloads](](

Latest Development Release  [![Release Version](]( [![Release Date](]( [![Downloads](](

### 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 ( 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-S2 |     Yes    |       Yes       | [ESP32-S2]( |
| ESP32-C3 |     Yes    |       Yes       | [ESP32-C3]( |
| ESP32-S3 |     Yes    |       Yes       | [ESP32-S3]( |
| ESP32-C6 |     No     |       Yes       | [ESP32-C6]( |
| ESP32-H2 |     No     |       Yes       | [ESP32-H2]( |

> [!NOTE]
> ESP32-C2 is also supported by Arduino-ESP32 but requires rebuilding the static libraries. This is not trivial and requires a good understanding of the ESP-IDF
> build system. For more information, see the [Lib Builder documentation](

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]( in the documentation for more information on how to contribute to the project.

> We would like to have this repository in a polite and friendly atmosphere, so please be kind and respectful to others. For more details, look at [Code of Conduct](


License: LGPL-2.1

To add this component to your project, run: add-dependency "espressif/arduino-esp32^3.0.0-rc3"

or download archive


  • Archive size
    Archive size: 1.22 MB
  • Downloaded in total
    Downloaded in total 5.5k times
  • Downloaded this version
    This version: 211 times


espressif/arduino-esp32 version: 3.0.0-rc3