From d1f0d6c0fca417ed1fb97c0c06441d083c8dd38f Mon Sep 17 00:00:00 2001 From: Pedro Minatel Date: Mon, 28 Feb 2022 13:06:28 +0000 Subject: [PATCH] Added more details about PlatformIO (#5540) * Added more details about PlatformIO * Fixed typo --- docs/source/_static/logo_arduino.png | Bin 0 -> 23036 bytes docs/source/_static/logo_pio.png | Bin 0 -> 25979 bytes docs/source/getting_started.rst | 14 ++++ docs/source/installing.rst | 101 +++++++++++++++++++++------ 4 files changed, 93 insertions(+), 22 deletions(-) create mode 100644 docs/source/_static/logo_arduino.png create mode 100644 docs/source/_static/logo_pio.png diff --git a/docs/source/_static/logo_arduino.png b/docs/source/_static/logo_arduino.png new file mode 100644 index 0000000000000000000000000000000000000000..a3a7cd942e9060840384db4a41a044a3e70e7fd4 GIT binary patch literal 23036 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 P00000NkvXXu0mjf!giQ& literal 0 HcmV?d00001 diff --git a/docs/source/_static/logo_pio.png b/docs/source/_static/logo_pio.png new file mode 100644 index 0000000000000000000000000000000000000000..a64c156396481be375fd126891d10c7e9d395488 GIT binary patch literal 25979 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 z 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 u-4oHfQ(EkSuz*$f~g|xf?0000`_ for more details on how to install the Arduino ESP32 support. Support diff --git a/docs/source/installing.rst b/docs/source/installing.rst index 065b64687..39c5d22b6 100644 --- a/docs/source/installing.rst +++ b/docs/source/installing.rst @@ -7,13 +7,18 @@ This guide will show how to install the Arduino-ESP32 support. Before Installing ----------------- -We recommend you install the support using the Boards Manager, but other options are available depending on your operating system. +We recommend you install the support using your favorite IDE, but other options are available depending on your operating system. To install Arduino-ESP32 support, you can use one of the following options. -Installing using Boards Manager -------------------------------- +Installing using Arduino IDE +---------------------------- -This is the preferred and easiest way to install Arduino-ESP32. +.. figure:: _static/logo_arduino.png + :align: center + :width: 200 + :figclass: align-center + +This is the way to install Arduino-ESP32 directly from the Arduino IDE. .. note:: For overview of SoC's support, take a look on `Supported Soc's table `_ where you can find if the particular chip is under stable or development release. @@ -58,8 +63,70 @@ To start the installation process using the Boards Managaer, follow these steps: - Restart Arduino IDE. -Windows -------- +Installing using PlatformIO +--------------------------- + +.. figure:: _static/logo_pio.png + :align: center + :width: 200 + :figclass: align-center + +PlatformIO is one of most popular embedded development tool. Currently, it supports Arduino ESP32 and ESP-IDF from Espressif (other platforms are also supported). + +To install PIO, you can follow this Getting Started, provided by PIO at `docs.platformio.org`_. + +To test the latest Arduino ESP32, you need to change your project *platform.ini* accordingly. + +- Start a new project and select one of the available board. You can change after by changing the *platform.ini* file. + +- For ESP32 + +.. code-block:: bash + + [env:arduino-esp32] + platform = https://github.com/platformio/platform-espressif32.git#feature/arduino-upstream + board = esp32dev + framework = arduino + platform_packages = + framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32#master + +- For ESP32-S2 (ESP32-S2-Saola-1 board) + +.. code-block:: bash + + [env:arduino-esp32s2] + platform = https://github.com/platformio/platform-espressif32.git#feature/arduino-upstream + board = esp32-s2-saola-1 + framework = arduino + platform_packages = + framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32#master + +- For ESP32-C3 (ESP32-S3-DevKitM-1 board) + +.. code-block:: bash + + [env:arduino-esp32c3] + platform = https://github.com/platformio/platform-espressif32.git#feature/arduino-upstream + board = esp32-c3-devkitm-1 + framework = arduino + platform_packages = + framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32#master + +Now you're able to use the latest Arduino ESP32 support directly from Espressif GitHub repository. + +To get more information about PlatformIO, see the following links: + +- `PlatformIO Core (CLI) `_ + +- `PlatformIO Home `_ + +- `Tutorials and Examples `_ + +- `Library Management `_ + + +Windows (manual installation) +----------------------------- .. warning:: Arduino ESP32 core v2.x.x cannot be used on Windows 8.x x86 (32 bits), Windows 7 or earlier. The Windows 32 bits OS is no longer supported by this toolchain. @@ -150,6 +217,11 @@ How to update to the latest code Linux ----- +.. figure:: _static/logo_linux.png + :align: center + :width: 200 + :figclass: align-center + Debian/Ubuntu ************* @@ -263,20 +335,5 @@ Where ``~/Documents/Arduino`` represents your sketch book location as per "Ardui - Restart Arduino IDE. -PlatformIO ----------- - -- `What is PlatformIO? `_ - -- `PlatformIO IDE `_ - -- `PlatformIO Core `_ - -- `Advanced usage `_: Custom settings, uploading to SPIFFS, Over-the-Air (OTA), staging version - -- `Integration with Cloud and Standalone IDEs `_: Cloud9, Codeanywhere, Eclipse Che (Codenvy), Atom, CLion, Eclipse, Emacs, NetBeans, Qt Creator, Sublime Text, VIM, Visual Studio, and VSCode - -- `Project Examples `_ - - .. _Arduino.cc: https://www.arduino.cc/en/Main/Software +.. _docs.platformio.org: https://docs.platformio.org/en/latest/integration/ide/pioide.html -- GitLab