Skip to content

Commit f7c1efc

Browse files
lucasssvazlucasssvaz
authored
docs(esp32p4): Add missing information and improve organization (#11081)
* docs(esp32p4): Add missing information and improve organization * docs(datasheets): Add missing datasheets * docs(readme): Reorder title * docs(typos): Fix typos
1 parent 2a3de9c commit f7c1efc

7 files changed

+97
-72
lines changed

‎README.md

+6-5
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Arduino core for the ESP32, ESP32-P4, ESP32-S2, ESP32-S3, ESP32-C3, ESP32-C6 and ESP32-H2
1+
# Arduino core for the ESP32, ESP32-C3, ESP32-C6, ESP32-H2, ESP32-P4, ESP32-S2 and ESP32-S3.
22

33
[![Build Status](https://img.shields.io/github/actions/workflow/status/espressif/arduino-esp32/push.yml?branch=master&event=push&label=Compilation%20Tests)](https://github.com/espressif/arduino-esp32/actions/workflows/push.yml?query=branch%3Amaster+event%3Apush)
44
[![Verbose Build Status](https://img.shields.io/github/actions/workflow/status/espressif/arduino-esp32/push.yml?branch=master&event=schedule&label=Compilation%20Tests%20(Verbose))](https://github.com/espressif/arduino-esp32/actions/workflows/push.yml?query=branch%3Amaster+event%3Aschedule)
@@ -67,16 +67,17 @@ Here are the ESP32 series supported by the Arduino-ESP32 project:
6767
| **SoC** | **Stable** | **Development** | **Datasheet** |
6868
|----------|:----------:|:---------------:|:-------------------------------------------------------------------------------------------------:|
6969
| ESP32 | Yes | Yes | [ESP32](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf) |
70-
| ESP32-S2 | Yes | Yes | [ESP32-S2](https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf) |
7170
| ESP32-C3 | Yes | Yes | [ESP32-C3](https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf) |
72-
| ESP32-S3 | Yes | Yes | [ESP32-S3](https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf) |
7371
| ESP32-C6 | Yes | Yes | [ESP32-C6](https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf) |
7472
| ESP32-H2 | Yes | Yes | [ESP32-H2](https://www.espressif.com/sites/default/files/documentation/esp32-h2_datasheet_en.pdf) |
7573
| ESP32-P4 | Yes | Yes | [ESP32-P4](https://www.espressif.com/sites/default/files/documentation/esp32-p4_datasheet_en.pdf) |
74+
| ESP32-S2 | Yes | Yes | [ESP32-S2](https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf) |
75+
| ESP32-S3 | Yes | Yes | [ESP32-S3](https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf) |
7676

7777
> [!NOTE]
78-
> ESP32-C2 is also supported by Arduino-ESP32 but requires rebuilding the static libraries. This is not trivial and requires a good understanding of the ESP-IDF
79-
> build system. For more information, see the [Lib Builder documentation](https://docs.espressif.com/projects/arduino-esp32/en/latest/lib_builder.html).
78+
> ESP32-C2 is also supported by Arduino-ESP32 but requires using Arduino as an ESP-IDF component or rebuilding the static libraries.
79+
> For more information, see the [Arduino as an ESP-IDF component documentation](https://docs.espressif.com/projects/arduino-esp32/en/latest/esp-idf_component.html) or the
80+
> [Lib Builder documentation](https://docs.espressif.com/projects/arduino-esp32/en/latest/lib_builder.html), respectively.
8081
8182
For more details visit the [supported chips](https://docs.espressif.com/projects/arduino-esp32/en/latest/getting_started.html#supported-soc-s) documentation page.
8283

‎docs/en/boards/boards.rst

+6-4
Original file line numberDiff line numberDiff line change
@@ -18,16 +18,18 @@ The ESP32 is divided by family:
1818

1919
* ESP32
2020
* Wi-Fi, BT and BLE 4
21-
* ESP32-S2
22-
* Wi-Fi only
23-
* ESP32-S3
24-
* Wi-Fi and BLE 5
2521
* ESP32-C3
2622
* Wi-Fi and BLE 5
2723
* ESP32-C6
2824
* Wi-Fi, BLE 5 and IEEE 802.15.4
2925
* ESP32-H2
3026
* BLE 5 and IEEE 802.15.4
27+
* ESP32-P4
28+
* 400 MHz Dual Core RISC-V CPU, 40 MHz ULP Co-processor, single-precision FPU and AI extensions.
29+
* ESP32-S2
30+
* Wi-Fi only
31+
* ESP32-S3
32+
* Wi-Fi and BLE 5
3133

3234
For each family, we have SoC variants with some differentiation. The differences are more about the embedded flash and its size and the number of the cores (dual or single).
3335

‎docs/en/common/datasheet.inc

+8-4
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,20 @@ Datasheet
22
---------
33

44
* `ESP32`_ (Datasheet)
5-
* `ESP32-S2`_ (Datasheet)
5+
* `ESP32-C2`_ (Datasheet)
66
* `ESP32-C3`_ (Datasheet)
7-
* `ESP32-S3`_ (Datasheet)
87
* `ESP32-C6`_ (Datasheet)
98
* `ESP32-H2`_ (Datasheet)
9+
* `ESP32-P4`_ (Datasheet)
10+
* `ESP32-S2`_ (Datasheet)
11+
* `ESP32-S3`_ (Datasheet)
1012

1113
.. _Espressif Product Selector: https://products.espressif.com/
1214
.. _ESP32: https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf
13-
.. _ESP32-S2: https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf
15+
.. _ESP32-C2: https://www.espressif.com/sites/default/files/documentation/esp8684_datasheet_en.pdf
1416
.. _ESP32-C3: https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf
15-
.. _ESP32-S3: https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf
1617
.. _ESP32-C6: https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf
1718
.. _ESP32-H2: https://www.espressif.com/sites/default/files/documentation/esp32-h2_datasheet_en.pdf
19+
.. _ESP32-P4: https://www.espressif.com/sites/default/files/documentation/esp32-p4_datasheet_en.pdf
20+
.. _ESP32-S2: https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf
21+
.. _ESP32-S3: https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf

‎docs/en/getting_started.rst

+6-5
Original file line numberDiff line numberDiff line change
@@ -38,17 +38,18 @@ Here are the ESP32 series supported by the Arduino-ESP32 project:
3838
SoC Stable Development Datasheet
3939
========== ====== =========== =================================
4040
ESP32 Yes Yes `ESP32`_
41-
ESP32-S2 Yes Yes `ESP32-S2`_
4241
ESP32-C3 Yes Yes `ESP32-C3`_
43-
ESP32-S3 Yes Yes `ESP32-S3`_
4442
ESP32-C6 Yes Yes `ESP32-C6`_
4543
ESP32-H2 Yes Yes `ESP32-H2`_
44+
ESP32-P4 Yes Yes `ESP32-P4`_
45+
ESP32-S2 Yes Yes `ESP32-S2`_
46+
ESP32-S3 Yes Yes `ESP32-S3`_
4647
========== ====== =========== =================================
4748

4849
.. note::
49-
ESP32-C2 is also supported by Arduino-ESP32 but requires rebuilding the static libraries.
50-
This is not trivial and requires a good understanding of the ESP-IDF build system.
51-
For more information, see the `Lib Builder documentation <lib_builder.html>`_.
50+
ESP32-C2 is also supported by Arduino-ESP32 but requires using Arduino as an ESP-IDF component or rebuilding the static libraries.
51+
For more information, see the `Arduino as an ESP-IDF component documentation <esp-idf_component.html>`_ or the
52+
`Lib Builder documentation <lib_builder.html>`_, respectively.
5253

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

‎docs/en/lib_builder.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -151,13 +151,13 @@ Set the build target(chip). ex. 'esp32s3'
151151
This build command will build for the ESP32-S3 target. You can specify other targets.
152152

153153
* esp32
154-
* esp32s2
155-
* esp32s3
156154
* esp32c2
157155
* esp32c3
158156
* esp32c6
159157
* esp32h2
160158
* esp32p4
159+
* esp32s2
160+
* esp32s3
161161

162162
Set Build Type
163163
^^^^^^^^^^^^^^

‎docs/en/libraries.rst

+57-49
Original file line numberDiff line numberDiff line change
@@ -9,60 +9,68 @@ Supported Peripherals
99

1010
Currently, the Arduino ESP32 supports the following peripherals with Arduino APIs.
1111

12-
+---------------+-------+-------+-------+-------+-------+-------+-------+
13-
| Peripheral | ESP32 | S2 | C3 | S3 | C6 | H2 | Notes |
14-
+===============+=======+=======+=======+=======+=======+=======+=======+
15-
| ADC | Yes | Yes | Yes | Yes | Yes | Yes | |
16-
+---------------+-------+-------+-------+-------+-------+-------+-------+
17-
| BT Classic | Yes | N/A | N/A | N/A | N/A | N/A | |
18-
+---------------+-------+-------+-------+-------+-------+-------+-------+
19-
| BLE | Yes | N/A | Yes | Yes | Yes | Yes | |
20-
+---------------+-------+-------+-------+-------+-------+-------+-------+
21-
| DAC | Yes | Yes | N/A | N/A | N/A | N/A | |
22-
+---------------+-------+-------+-------+-------+-------+-------+-------+
23-
| Ethernet | Yes | N/A | N/A | N/A | N/A | N/A | (*) |
24-
+---------------+-------+-------+-------+-------+-------+-------+-------+
25-
| GPIO | Yes | Yes | Yes | Yes | Yes | Yes | |
26-
+---------------+-------+-------+-------+-------+-------+-------+-------+
27-
| Hall Sensor | N/A | N/A | N/A | N/A | N/A | N/A | |
28-
+---------------+-------+-------+-------+-------+-------+-------+-------+
29-
| I2C | Yes | Yes | Yes | Yes | Yes | Yes | |
30-
+---------------+-------+-------+-------+-------+-------+-------+-------+
31-
| I2S | Yes | Yes | Yes | Yes | Yes | Yes | |
32-
+---------------+-------+-------+-------+-------+-------+-------+-------+
33-
| LEDC | Yes | Yes | Yes | Yes | Yes | Yes | |
34-
+---------------+-------+-------+-------+-------+-------+-------+-------+
35-
| Motor PWM | No | N/A | N/A | N/A | N/A | N/A | |
36-
+---------------+-------+-------+-------+-------+-------+-------+-------+
37-
| Pulse Counter | No | No | No | No | No | No | |
38-
+---------------+-------+-------+-------+-------+-------+-------+-------+
39-
| RMT | Yes | Yes | Yes | Yes | Yes | Yes | |
40-
+---------------+-------+-------+-------+-------+-------+-------+-------+
41-
| SDIO | No | No | No | No | No | No | |
42-
+---------------+-------+-------+-------+-------+-------+-------+-------+
43-
| SDMMC | Yes | N/A | N/A | Yes | N/A | N/A | |
44-
+---------------+-------+-------+-------+-------+-------+-------+-------+
45-
| Timer | Yes | Yes | Yes | Yes | Yes | Yes | |
46-
+---------------+-------+-------+-------+-------+-------+-------+-------+
47-
| Temp. Sensor | N/A | Yes | Yes | Yes | Yes | Yes | |
48-
+---------------+-------+-------+-------+-------+-------+-------+-------+
49-
| Touch | Yes | Yes | N/A | Yes | N/A | N/A | |
50-
+---------------+-------+-------+-------+-------+-------+-------+-------+
51-
| TWAI | No | No | No | No | No | No | |
52-
+---------------+-------+-------+-------+-------+-------+-------+-------+
53-
| UART | Yes | Yes | Yes | Yes | Yes | Yes | |
54-
+---------------+-------+-------+-------+-------+-------+-------+-------+
55-
| USB | N/A | Yes | Yes | Yes | Yes | Yes | (**) |
56-
+---------------+-------+-------+-------+-------+-------+-------+-------+
57-
| Wi-Fi | Yes | Yes | Yes | Yes | Yes | N/A | |
58-
+---------------+-------+-------+-------+-------+-------+-------+-------+
12+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
13+
| Peripheral | ESP32 | C3 | C6 | H2 | P4 | S2 | S3 | Notes |
14+
+===============+=======+=======+=======+=======+=======+=======+=======+=======+
15+
| ADC | Yes | Yes | Yes | Yes | Yes | Yes | Yes | (1) |
16+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
17+
| BT Classic | Yes | N/A | N/A | N/A | N/A | N/A | N/A | |
18+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
19+
| BLE | Yes | Yes | Yes | Yes | No | N/A | Yes | |
20+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
21+
| DAC | Yes | N/A | N/A | N/A | Yes | Yes | N/A | |
22+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
23+
| Ethernet | Yes | N/A | N/A | N/A | Yes | N/A | N/A | (2) |
24+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
25+
| GPIO | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
26+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
27+
| Hall Sensor | N/A | N/A | N/A | N/A | N/A | N/A | N/A | |
28+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
29+
| I2C | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
30+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
31+
| I2S | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
32+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
33+
| LEDC | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
34+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
35+
| MIPI | N/A | N/A | N/A | N/A | No | N/A | N/A | |
36+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
37+
| Motor PWM | No | N/A | N/A | N/A | N/A | N/A | N/A | |
38+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
39+
| MSPI | N/A | N/A | N/A | N/A | No | N/A | N/A | |
40+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
41+
| Pulse Counter | No | No | No | No | No | No | No | |
42+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
43+
| RMT | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
44+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
45+
| SDIO | No | No | No | No | No | No | No | |
46+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
47+
| SDMMC | Yes | N/A | N/A | N/A | N/A | N/A | Yes | |
48+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
49+
| Timer | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
50+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
51+
| Temp. Sensor | N/A | Yes | Yes | Yes | Yes | Yes | Yes | |
52+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
53+
| Touch | Yes | N/A | N/A | N/A | Yes | Yes | Yes | |
54+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
55+
| TWAI | No | No | No | No | No | No | No | |
56+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
57+
| UART | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
58+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
59+
| USB | N/A | Yes | Yes | Yes | Yes | Yes | Yes | (3) |
60+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
61+
| Wi-Fi | Yes | Yes | Yes | N/A | Yes | Yes | Yes | (4) |
62+
+---------------+-------+-------+-------+-------+-------+-------+-------+-------+
5963

6064
Notes
6165
^^^^^
6266

63-
(*) SPI Ethernet is supported by all ESP32 families and RMII only for ESP32.
67+
(1) ESP32-P4 calibration schemes not supported yet in IDF and ADC Continuous also lacks IDF support.
6468

65-
(**) ESP32-C3, C6, H2 only support USB CDC/JTAG
69+
(2) SPI Ethernet is supported by all ESP32 families and RMII only for ESP32 and ESP32-P4.
70+
71+
(3) ESP32-C3, C6, H2 only support USB CDC/JTAG
72+
73+
(4) ESP32-P4 only supports Wi-Fi through another SoC by using ``esp_hosted``.
6674

6775
.. note:: Some peripherals are not available for all ESP32 families. To see more details about it, see the corresponding SoC at `Product Selector <https://products.espressif.com>`_ page.
6876

‎package/package_esp32_index.template.json

+12-3
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,22 @@
2626
"name": "ESP32 Dev Board"
2727
},
2828
{
29-
"name": "ESP32-S2 Dev Board"
29+
"name": "ESP32-C3 Dev Board"
3030
},
3131
{
32-
"name": "ESP32-S3 Dev Board"
32+
"name": "ESP32-C6 Dev Board"
3333
},
3434
{
35-
"name": "ESP32-C3 Dev Board"
35+
"name": "ESP32-H2 Dev Board"
36+
},
37+
{
38+
"name": "ESP32-P4 Dev Board"
39+
},
40+
{
41+
"name": "ESP32-S2 Dev Board"
42+
},
43+
{
44+
"name": "ESP32-S3 Dev Board"
3645
},
3746
{
3847
"name": "Arduino Nano ESP32"

0 commit comments

Comments
 (0)