Skip to content

Commit fbe7d3a

Browse files
fdcavalcantixiaoxiang781216
fdcavalcanti
authored and
xiaoxiang781216
committed
documentation: update Xtensa ESP32|S2|S3 toolchain version
Updates the instructions to install the ESP toolchain 14.2.0. Signed-off-by: Filipe Cavalcanti <[email protected]>
1 parent 1a5f051 commit fbe7d3a

File tree

3 files changed

+30
-51
lines changed

3 files changed

+30
-51
lines changed

‎Documentation/platforms/xtensa/esp32/index.rst‎

Lines changed: 10 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ ESP32 Toolchain
2020
===============
2121

2222
The toolchain used to build ESP32 firmware can be either downloaded or built from the sources.
23+
2324
It is **highly** recommended to use (download or build) the same toolchain version that is being
2425
used by the NuttX CI.
2526

@@ -33,20 +34,12 @@ check for the current compiler version being used. For instance:
3334
# Build image for tool required by ESP32 builds
3435
###############################################################################
3536
FROM nuttx-toolchain-base AS nuttx-toolchain-esp32
36-
# Download the latest ESP32 GCC toolchain prebuilt by Espressif
37-
RUN mkdir -p xtensa-esp32-elf-gcc && \
38-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
39-
| tar -C xtensa-esp32-elf-gcc --strip-components 1 -xJ
40-
41-
RUN mkdir -p xtensa-esp32s2-elf-gcc && \
42-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s2-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
43-
| tar -C xtensa-esp32s2-elf-gcc --strip-components 1 -xJ
44-
45-
RUN mkdir -p xtensa-esp32s3-elf-gcc && \
46-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s3-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
47-
| tar -C xtensa-esp32s3-elf-gcc --strip-components 1 -xJ
37+
# Download the latest ESP32, ESP32-S2 and ESP32-S3 GCC toolchain prebuilt by Espressif
38+
RUN mkdir -p xtensa-esp-elf-gcc && \
39+
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-x86_64-linux-gnu.tar.xz" \
40+
| tar -C xtensa-esp-elf-gcc --strip-components 1 -xJ
4841
49-
For ESP32, the toolchain version is based on GGC 12.2.0 (``xtensa-esp32-elf-12.2.0_20230208``)
42+
For ESP32, the toolchain version is based on GGC 14.2.0 (``xtensa-esp-elf-14.2.0_20241119``)
5043

5144
The prebuilt Toolchain (Recommended)
5245
------------------------------------
@@ -55,20 +48,20 @@ First, create a directory to hold the toolchain:
5548

5649
.. code-block:: console
5750
58-
$ mkdir -p /path/to/your/toolchain/xtensa-esp32-elf-gcc
51+
$ mkdir -p /path/to/your/toolchain/xtensa-esp-elf-gcc
5952
6053
Download and extract toolchain:
6154

6255
.. code-block:: console
6356
64-
$ curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
65-
| tar -C xtensa-esp32-elf-gcc --strip-components 1 -xJ
57+
$ curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-x86_64-linux-gnu.tar.xz" \
58+
| tar -C xtensa-esp-elf-gcc --strip-components 1 -xJ
6659
6760
Add the toolchain to your `PATH`:
6861

6962
.. code-block:: console
7063
71-
$ echo "export PATH=/path/to/your/toolchain/xtensa-esp32-elf-gcc/bin:$PATH" >> ~/.bashrc
64+
$ echo "export PATH=/path/to/your/toolchain/xtensa-esp-elf-gcc/bin:$PATH" >> ~/.bashrc
7265
7366
You can edit your shell's rc files if you don't use bash.
7467

‎Documentation/platforms/xtensa/esp32s2/index.rst‎

Lines changed: 10 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ ESP32-S2 Toolchain
1313
==================
1414

1515
The toolchain used to build ESP32-S2 firmware can be either downloaded or built from the sources.
16+
1617
It is **highly** recommended to use (download or build) the same toolchain version that is being
1718
used by the NuttX CI.
1819

@@ -26,20 +27,12 @@ check for the current compiler version being used. For instance:
2627
# Build image for tool required by ESP32 builds
2728
###############################################################################
2829
FROM nuttx-toolchain-base AS nuttx-toolchain-esp32
29-
# Download the latest ESP32 GCC toolchain prebuilt by Espressif
30-
RUN mkdir -p xtensa-esp32-elf-gcc && \
31-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
32-
| tar -C xtensa-esp32-elf-gcc --strip-components 1 -xJ
33-
34-
RUN mkdir -p xtensa-esp32s2-elf-gcc && \
35-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s2-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
36-
| tar -C xtensa-esp32s2-elf-gcc --strip-components 1 -xJ
37-
38-
RUN mkdir -p xtensa-esp32s3-elf-gcc && \
39-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s3-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
40-
| tar -C xtensa-esp32s3-elf-gcc --strip-components 1 -xJ
30+
# Download the latest ESP32, ESP32-S2 and ESP32-S3 GCC toolchain prebuilt by Espressif
31+
RUN mkdir -p xtensa-esp-elf-gcc && \
32+
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-x86_64-linux-gnu.tar.xz" \
33+
| tar -C xtensa-esp-elf-gcc --strip-components 1 -xJ
4134
42-
For ESP32-S2, the toolchain version is based on GGC 12.2.0 (``xtensa-esp32s2-elf-12.2.0_20230208``)
35+
For ESP32-S2, the toolchain version is based on GGC 14.2.0 (``xtensa-esp-elf-14.2.0_20241119``)
4336

4437
The prebuilt Toolchain (Recommended)
4538
------------------------------------
@@ -48,20 +41,20 @@ First, create a directory to hold the toolchain:
4841

4942
.. code-block:: console
5043
51-
$ mkdir -p /path/to/your/toolchain/xtensa-esp32s2-elf-gcc
44+
$ mkdir -p /path/to/your/toolchain/xtensa-esp-elf-gcc
5245
5346
Download and extract toolchain:
5447

5548
.. code-block:: console
5649
57-
$ curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s2-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
58-
| tar -C xtensa-esp32s2-elf-gcc --strip-components 1 -xJ
50+
$ curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-x86_64-linux-gnu.tar.xz" \
51+
| tar -C xtensa-esp-elf-gcc --strip-components 1 -xJ
5952
6053
Add the toolchain to your `PATH`:
6154

6255
.. code-block:: console
6356
64-
$ echo "export PATH=/path/to/your/toolchain/xtensa-esp32s2-elf-gcc/bin:$PATH" >> ~/.bashrc
57+
$ echo "export PATH=/path/to/your/toolchain/xtensa-esp-elf-gcc/bin:$PATH" >> ~/.bashrc
6558
6659
You can edit your shell's rc files if you don't use bash.
6760

‎Documentation/platforms/xtensa/esp32s3/index.rst‎

Lines changed: 10 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ ESP32-S3 Toolchain
2020
==================
2121

2222
The toolchain used to build ESP32-S3 firmware can be either downloaded or built from the sources.
23+
2324
It is **highly** recommended to use (download or build) the same toolchain version that is being
2425
used by the NuttX CI.
2526

@@ -33,20 +34,12 @@ check for the current compiler version being used. For instance:
3334
# Build image for tool required by ESP32 builds
3435
###############################################################################
3536
FROM nuttx-toolchain-base AS nuttx-toolchain-esp32
36-
# Download the latest ESP32 GCC toolchain prebuilt by Espressif
37-
RUN mkdir -p xtensa-esp32-elf-gcc && \
38-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
39-
| tar -C xtensa-esp32-elf-gcc --strip-components 1 -xJ
40-
41-
RUN mkdir -p xtensa-esp32s2-elf-gcc && \
42-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s2-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
43-
| tar -C xtensa-esp32s2-elf-gcc --strip-components 1 -xJ
44-
45-
RUN mkdir -p xtensa-esp32s3-elf-gcc && \
46-
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s3-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
47-
| tar -C xtensa-esp32s3-elf-gcc --strip-components 1 -xJ
37+
# Download the latest ESP32, ESP32-S2 and ESP32-S3 GCC toolchain prebuilt by Espressif
38+
RUN mkdir -p xtensa-esp-elf-gcc && \
39+
curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-x86_64-linux-gnu.tar.xz" \
40+
| tar -C xtensa-esp-elf-gcc --strip-components 1 -xJ
4841
49-
For ESP32-S3, the toolchain version is based on GGC 12.2.0 (``xtensa-esp32s3-elf-12.2.0_20230208``)
42+
For ESP32-S3, the toolchain version is based on GGC 14.2.0 (``xtensa-esp-elf-14.2.0_20241119``)
5043

5144
The prebuilt Toolchain (Recommended)
5245
------------------------------------
@@ -55,20 +48,20 @@ First, create a directory to hold the toolchain:
5548

5649
.. code-block:: console
5750
58-
$ mkdir -p /path/to/your/toolchain/xtensa-esp32s3-elf-gcc
51+
$ mkdir -p /path/to/your/toolchain/xtensa-esp-elf-gcc
5952
6053
Download and extract toolchain:
6154

6255
.. code-block:: console
6356
64-
$ curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-12.2.0_20230208/xtensa-esp32s3-elf-12.2.0_20230208-x86_64-linux-gnu.tar.xz" \
65-
| tar -C xtensa-esp32s3-elf-gcc --strip-components 1 -xJ
57+
$ curl -s -L "https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-x86_64-linux-gnu.tar.xz" \
58+
| tar -C xtensa-esp-elf-gcc --strip-components 1 -xJ
6659
6760
Add the toolchain to your `PATH`:
6861

6962
.. code-block:: console
7063
71-
$ echo "export PATH=/path/to/your/toolchain/xtensa-esp32s3-elf-gcc/bin:$PATH" >> ~/.bashrc
64+
$ echo "export PATH=/path/to/your/toolchain/xtensa-esp-elf-gcc/bin:$PATH" >> ~/.bashrc
7265
7366
You can edit your shell's rc files if you don't use bash.
7467

0 commit comments

Comments
 (0)