Getting Started

############### Getting Started ###############

About Arduino ESP32

Welcome to the Arduino ESP32 support documentation! Here you will find important information on how to use the project.

First Things First

.. note:: Before continuing, we must be clear that this project is supported by Espressif Systems_ and the community. Everyone is more than welcome to contribute back to this project.

ESP32 is a single 2.4 GHz Wi-Fi-and-Bluetooth SoC (System On a Chip) designed by Espressif Systems_.

ESP32 is designed for mobile, wearable electronics, and Internet-of-Things (IoT) applications. It features all the state-of-the-art characteristics of low-power chips, including fine-grained clock gating, multiple power modes,and dynamic power scaling. For instance, in a low-power IoT sensor hub application scenario, ESP32 is woken-up periodically and only when a specified condition is detected. Low-duty cycle is used to minimize the amount of energy that the chip expends.

The output of the power amplifier is also adjustable, thus contributing to an optimal trade-off between communication range, data rate and power consumption.

The ESP32 series is available as a chip or module.

.. _supported_socs:

Supported SoC's

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 <esp-idf_component.html>_ or the Lib Builder documentation <lib_builder.html>_, respectively.

See Boards <boards/boards.html>_ for more details about ESP32 development boards.

Arduino Core Reference

This documentation is built on the ESP32 and we are not going to cover the common Arduino API. To see the Arduino reference documentation, please consider reading the official documentation.

Arduino Official Documentation: Arduino Reference_.

Supported Operating Systems

+-------------------+-------------------+-------------------+ | |windows-logo| | |linux-logo| | |macOS-logo| | +-------------------+-------------------+-------------------+ | Windows | Linux | macOS | +-------------------+-------------------+-------------------+

.. |windows-logo| image:: ../_static/logo_windows.png .. |linux-logo| image:: ../_static/logo_linux.png .. |macOS-logo| image:: ../_static/logo_macos.png

Supported IDEs

Here is the list of supported IDE for Arduino ESP32 support integration.

+-------------------+ | |arduino-logo| | +-------------------+ | Arduino IDE | +-------------------+

.. |arduino-logo| image:: ../_static/logo_arduino.png

See Installing Guides <installing.html>_ for more details on how to install the Arduino ESP32 support.

Support

This is an open project and it's supported by the community. Fell free to ask for help in one of the community channels.

Community

The Arduino community is huge! You can find a lot of useful content on the Internet. Here are some community channels where you may find information and ask for some help, if needed.

• ESP32 Forum_: Official Espressif Forum.
• ESP32 Forum - Arduino_: Official Espressif Forum for Arduino related discussions.
• ESP32 Forum - Hardware_: Official Espressif Forum for Hardware related discussions.
• Espressif Developer Portal_: Official Espressif Developer Portal with tutorials, examples, workshops, and more.
• Arduino Core for Espressif (Discord)_: Official Espressif Discord channel for the Arduino Core.
• Espressif MCUs (Discord)_
• ESP32 on Reddit_

Issues Reporting

Before opening a new issue, please read this:

Be sure to search for a similar reported issue. This avoids duplicating or creating noise in the GitHub Issues reporting. We also have the troubleshooting guide to save your time on the most common issues reported by users.

For more details about creating new Issue, see the Issue Template <https://github.com/espressif/arduino-esp32/blob/master/.github/ISSUE_TEMPLATE/Issue-report.yml>_.

If you have any new idea, see the Feature request Template <https://github.com/espressif/arduino-esp32/blob/master/.github/ISSUE_TEMPLATE/Feature-request.yml>_.

First Steps

Here are the first steps to get the Arduino ESP32 support running.

To install Arduino-ESP32, please see the dedicated section on the Installation guide. We recommend you install it using the boards manager.

.. toctree:: :maxdepth: 2

How to Install <installing>
Development Boards <boards/boards>

Examples

After installing the toolchain into your environment, you will be able to see all the dedicated examples for the ESP32. These examples are located in the examples menu or inside each library folder.

https://github.com/espressif/arduino-esp32/tree/master/libraries

There is also a list of examples <https://techtutorialsx.com/category/esp32/>_ managed outside of Espressif, so check them out.

.. include:: common/datasheet.inc

Resources

.. _Espressif Systems: https://www.espressif.com .. _Espressif Product Selector: https://products.espressif.com/ .. _Espressif Developer Portal: https://developer.espressif.com/ .. _Arduino.cc: https://www.arduino.cc/en/Main/Software .. _Arduino Reference: https://www.arduino.cc/reference/en/ .. _ESP32 Forum: https://esp32.com .. _ESP32 Forum - Arduino: https://esp32.com/viewforum.php?f=19 .. _ESP32 Forum - Hardware: https://esp32.com/viewforum.php?f=12 .. _Arduino Core for Espressif (Discord): https://discord.gg/8xY6e9crwv .. _Adafruit (Discord): https://discord.gg/adafruit .. _Espressif MCUs (Discord): https://discord.com/invite/XqnZPbF .. _ESP32 on Reddit: https://www.reddit.com/r/esp32