-
Notifications
You must be signed in to change notification settings - Fork 334
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Use owner-based platform declaration
- Loading branch information
1 parent
7159a21
commit 891cc03
Showing
308 changed files
with
1,889 additions
and
342 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 |
Oops, something went wrong.