Tools: Make target-specific installation clearer in the getting started guide

Closes https://github.com/espressif/esp-idf/issues/8254
This commit is contained in:
Roland Dobai
2022-02-23 16:42:03 +01:00
parent 15ab3466fa
commit 7936a04c3e
2 changed files with 58 additions and 8 deletions

View File

@@ -125,7 +125,7 @@ Consult :doc:`/versions` for information about which ESP-IDF version to use in a
Step 3. Set up the tools Step 3. Set up the tools
======================== ========================
Aside from the ESP-IDF, you also need to install the tools used by ESP-IDF, such as the compiler, debugger, Python packages, etc. Aside from the ESP-IDF, you also need to install the tools used by ESP-IDF, such as the compiler, debugger, Python packages, etc, for projects supporting {IDF_TARGET_NAME}.
.. code-block:: bash .. code-block:: bash
@@ -139,9 +139,34 @@ or with Fish shell
cd ~/esp/esp-idf cd ~/esp/esp-idf
./install.fish {IDF_TARGET_PATH_NAME} ./install.fish {IDF_TARGET_PATH_NAME}
.. note:: The above commands install tools for {IDF_TARGET_NAME} only. If you intend to develop projects for more chip targets then you should list all of them and run for example:
To install tools for multiple targets you can specify those targets at once. For example: ``./install.sh esp32,esp32c3,esp32s3``.
To install tools for all supported targets, run the script without specifying targets ``./install.sh`` or use ``./install.sh all``. .. code-block:: bash
cd ~/esp/esp-idf
./install.sh esp32,esp32s2
or with Fish shell
.. code-block:: fish
cd ~/esp/esp-idf
./install.fish esp32,esp32s2
In order to install tools for all supported targets please run the following command:
.. code-block:: bash
cd ~/esp/esp-idf
./install.sh all
or with Fish shell
.. code-block:: fish
cd ~/esp/esp-idf
./install.fish all
Alternative File Downloads Alternative File Downloads
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@@ -125,7 +125,7 @@ ESP-IDF 将下载至 ``~/esp/esp-idf``。
第三步:设置工具 第三步:设置工具
================================= =================================
除了 ESP-IDF 本身,您还需要安装 ESP-IDF 使用的各种工具比如编译器、调试器、Python 包等。 除了 ESP-IDF 本身,您还需要为支持 {IDF_TARGET_NAME} 的项目安装 ESP-IDF 使用的各种工具比如编译器、调试器、Python 包等。
.. code-block:: bash .. code-block:: bash
@@ -139,9 +139,34 @@ ESP-IDF 将下载至 ``~/esp/esp-idf``。
cd ~/esp/esp-idf cd ~/esp/esp-idf
./install.fish {IDF_TARGET_PATH_NAME} ./install.fish {IDF_TARGET_PATH_NAME}
.. note:: 上述命令仅仅为 {IDF_TARGET_NAME} 安装所需工具。如果需要为多个目标芯片开发项目,则可以一次性指定多个目标,如下所示::
通过一次性指定多个目标,可为多个目标芯片同时安装工具,如运行 ``./install.sh esp32,esp32c3,esp32s3``
通过运行 ``./install.sh````./install.sh all`` 可一次性为所有支持的目标芯片安装工具。 .. code-block:: bash
cd ~/esp/esp-idf
./install.sh esp32,esp32s2
或使用 Fish shell
.. code-block:: fish
cd ~/esp/esp-idf
./install.fish esp32,esp32s2
如果需要一次性为所有支持的目标芯片安装工具,可以运行如下命令:
.. code-block:: bash
cd ~/esp/esp-idf
./install.sh all
或使用 Fish shell
.. code-block:: fish
cd ~/esp/esp-idf
./install.fish all
下载工具备选方案 下载工具备选方案
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~