Sync Docs platformio/platformio-core@44ef6e3

platformio · Aug 28, 2024 · 329223c · 329223c
1 parent 96e4f5b
commit 329223c
Show file tree

Hide file tree

Showing 908 changed files with 10,303 additions and 1,838 deletions.
diff --git a/en/latest/_sources/boards/espressif32/esp32-c6-devkitc-1.rst.txt b/en/latest/_sources/boards/espressif32/esp32-c6-devkitc-1.rst.txt
@@ -30,7 +30,7 @@ Platform :ref:`platform_espressif32`: ESP32 is a series of low-cost, low-power s
   * - **Flash**
     - 8MB
   * - **RAM**
-    - 512KB
+    - 320KB
   * - **Vendor**
     - `Espressif <https://docs.espressif.com/projects/espressif-esp-dev-kits/en/latest/esp32c6/esp32-c6-devkitc-1/index.html?utm_source=platformio.org&utm_medium=docs>`__
 

diff --git a/en/latest/_sources/boards/espressif32/esp32s3_powerfeather.rst.txt b/en/latest/_sources/boards/espressif32/esp32s3_powerfeather.rst.txt
@@ -0,0 +1,168 @@
+..  Copyright (c) 2014-present PlatformIO <[email protected]>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+.. _board_espressif32_esp32s3_powerfeather:
+
+ESP32-S3 PowerFeather
+=====================
+
+.. contents::
+
+Hardware
+--------
+
+Platform :ref:`platform_espressif32`: ESP32 is a series of low-cost, low-power system on a chip microcontrollers with integrated Wi-Fi and Bluetooth. ESP32 integrates an antenna switch, RF balun, power amplifier, low-noise receive amplifier, filters, and power management modules.
+
+.. list-table::
+
+  * - **Microcontroller**
+    - ESP32S3
+  * - **Frequency**
+    - 240MHz
+  * - **Flash**
+    - 8MB
+  * - **RAM**
+    - 320KB
+  * - **Vendor**
+    - `PowerFeather <https://powerfeather.dev/?utm_source=platformio.org&utm_medium=docs>`__
+
+
+Configuration
+-------------
+
+Please use ``esp32s3_powerfeather`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`:
+
+.. code-block:: ini
+
+  [env:esp32s3_powerfeather]
+  platform = espressif32
+  board = esp32s3_powerfeather
+
+You can override default ESP32-S3 PowerFeather settings per build environment using
+``board_***`` option, where ``***`` is a JSON object path from
+board manifest `esp32s3_powerfeather.json <https://github.com/platformio/platform-espressif32/blob/master/boards/esp32s3_powerfeather.json>`_. For example,
+``board_build.mcu``, ``board_build.f_cpu``, etc.
+
+.. code-block:: ini
+
+  [env:esp32s3_powerfeather]
+  platform = espressif32
+  board = esp32s3_powerfeather
+
+  ; change microcontroller
+  board_build.mcu = esp32s3
+
+  ; change MCU frequency
+  board_build.f_cpu = 240000000L
+
+
+Uploading
+---------
+ESP32-S3 PowerFeather supports the following uploading protocols:
+
+* ``cmsis-dap``
+* ``esp-bridge``
+* ``esp-builtin``
+* ``esp-prog``
+* ``espota``
+* ``esptool``
+* ``iot-bus-jtag``
+* ``jlink``
+* ``minimodule``
+* ``olimex-arm-usb-ocd``
+* ``olimex-arm-usb-ocd-h``
+* ``olimex-arm-usb-tiny-h``
+* ``olimex-jtag-tiny``
+* ``tumpa``
+
+Default protocol is ``esptool``
+
+You can change upload protocol using :ref:`projectconf_upload_protocol` option:
+
+.. code-block:: ini
+
+  [env:esp32s3_powerfeather]
+  platform = espressif32
+  board = esp32s3_powerfeather
+
+  upload_protocol = esptool
+
+Debugging
+---------
+
+:ref:`piodebug` - "1-click" solution for debugging with a zero configuration.
+
+.. warning::
+    You will need to install debug tool drivers depending on your system.
+    Please click on compatible debug tool below for the further
+    instructions and configuration information.
+
+You can switch between debugging :ref:`debugging_tools` using
+:ref:`projectconf_debug_tool` option in :ref:`projectconf`.
+
+ESP32-S3 PowerFeather does not have on-board debug probe and **IS NOT READY** for debugging. You will need to use/buy one of external probe listed below.
+
+.. list-table::
+  :header-rows:  1
+
+  * - Compatible Tools
+    - On-board
+    - Default
+  * - :ref:`debugging_tool_cmsis-dap`
+    - 
+    - Yes
+  * - ``esp-bridge``
+    - 
+    - 
+  * - ``esp-builtin``
+    - 
+    - 
+  * - :ref:`debugging_tool_esp-prog`
+    - 
+    - 
+  * - :ref:`debugging_tool_iot-bus-jtag`
+    - 
+    - 
+  * - :ref:`debugging_tool_jlink`
+    - 
+    - 
+  * - :ref:`debugging_tool_minimodule`
+    - 
+    - 
+  * - :ref:`debugging_tool_olimex-arm-usb-ocd`
+    - 
+    - 
+  * - :ref:`debugging_tool_olimex-arm-usb-ocd-h`
+    - 
+    - 
+  * - :ref:`debugging_tool_olimex-arm-usb-tiny-h`
+    - 
+    - 
+  * - :ref:`debugging_tool_olimex-jtag-tiny`
+    - 
+    - 
+  * - :ref:`debugging_tool_tumpa`
+    - 
+    - 
+
+Frameworks
+----------
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+
+    * - :ref:`framework_arduino`
+      - Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
+
+    * - :ref:`framework_espidf`
+      - Espressif IoT Development Framework. Official development framework for ESP32 chip
diff --git a/en/latest/_sources/boards/espressif32/m5stack-core-esp32-16M.rst.txt b/en/latest/_sources/boards/espressif32/m5stack-core-esp32-16M.rst.txt
@@ -0,0 +1,102 @@
+..  Copyright (c) 2014-present PlatformIO <[email protected]>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+.. _board_espressif32_m5stack-core-esp32-16M:
+
+M5Stack Core ESP32 16M
+======================
+
+.. contents::
+
+Hardware
+--------
+
+Platform :ref:`platform_espressif32`: ESP32 is a series of low-cost, low-power system on a chip microcontrollers with integrated Wi-Fi and Bluetooth. ESP32 integrates an antenna switch, RF balun, power amplifier, low-noise receive amplifier, filters, and power management modules.
+
+.. list-table::
+
+  * - **Microcontroller**
+    - ESP32
+  * - **Frequency**
+    - 240MHz
+  * - **Flash**
+    - 16MB
+  * - **RAM**
+    - 520KB
+  * - **Vendor**
+    - `M5Stack <http://www.m5stack.com?utm_source=platformio.org&utm_medium=docs>`__
+
+
+Configuration
+-------------
+
+Please use ``m5stack-core-esp32-16M`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`:
+
+.. code-block:: ini
+
+  [env:m5stack-core-esp32-16M]
+  platform = espressif32
+  board = m5stack-core-esp32-16M
+
+You can override default M5Stack Core ESP32 16M settings per build environment using
+``board_***`` option, where ``***`` is a JSON object path from
+board manifest `m5stack-core-esp32-16M.json <https://github.com/platformio/platform-espressif32/blob/master/boards/m5stack-core-esp32-16M.json>`_. For example,
+``board_build.mcu``, ``board_build.f_cpu``, etc.
+
+.. code-block:: ini
+
+  [env:m5stack-core-esp32-16M]
+  platform = espressif32
+  board = m5stack-core-esp32-16M
+
+  ; change microcontroller
+  board_build.mcu = esp32
+
+  ; change MCU frequency
+  board_build.f_cpu = 240000000L
+
+
+Uploading
+---------
+M5Stack Core ESP32 16M supports the following uploading protocols:
+
+* ``espota``
+* ``esptool``
+
+Default protocol is ``esptool``
+
+You can change upload protocol using :ref:`projectconf_upload_protocol` option:
+
+.. code-block:: ini
+
+  [env:m5stack-core-esp32-16M]
+  platform = espressif32
+  board = m5stack-core-esp32-16M
+
+  upload_protocol = esptool
+
+Debugging
+---------
+:ref:`piodebug` currently does not support M5Stack Core ESP32 16M board.
+
+Frameworks
+----------
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+
+    * - :ref:`framework_arduino`
+      - Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
+
+    * - :ref:`framework_espidf`
+      - Espressif IoT Development Framework. Official development framework for ESP32 chip