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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 b_|MLLATq$db;}+G1_lOCS3j3^P6`_ 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 065b6468..39c5d22b 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