add CN translation for index.rst in get started section for MR10616

This commit is contained in:
daiziyan
2020-12-03 15:26:17 +08:00
committed by Angus Gratton
parent 3efc9f3a04
commit 0f3595b1e8

View File

@@ -10,6 +10,8 @@
:link_to_translation:`en:[English]` :link_to_translation:`en:[English]`
.. 请保证 README.md 文件与该文件保持同步
本文档旨在指导用户搭建 {IDF_TARGET_NAME} 硬件开发的软件环境,通过一个简单的示例展示如何使用 ESP-IDF (Espressif IoT Development Framework) 配置菜单,并编译、下载固件至 {IDF_TARGET_NAME} 开发板等步骤。 本文档旨在指导用户搭建 {IDF_TARGET_NAME} 硬件开发的软件环境,通过一个简单的示例展示如何使用 ESP-IDF (Espressif IoT Development Framework) 配置菜单,并编译、下载固件至 {IDF_TARGET_NAME} 开发板等步骤。
.. include-build-file:: inc/version-note.inc .. include-build-file:: inc/version-note.inc
@@ -17,7 +19,7 @@
概述 概述
============ ============
.. only:esp32 .. only:: esp32
ESP32 SoC 芯片支持以下功能: ESP32 SoC 芯片支持以下功能:
@@ -27,7 +29,7 @@
* 超低功耗协处理器 * 超低功耗协处理器
* 多种外设 * 多种外设
.. only:esp32s2 .. only:: esp32s2
ESP32-S2 SoC 芯片支持以下功能: ESP32-S2 SoC 芯片支持以下功能:
@@ -225,6 +227,37 @@ Linux 和 macOS 操作系统
cd ~/esp/esp-idf cd ~/esp/esp-idf
./install.sh ./install.sh
下载工具备选方案
~~~~~~~~~~~~~~~~~~~~~~~~~~
ESP-IDF 工具安装器会下载 Github 发布版本中附带的一些工具,如果访问 Github 较为缓慢,则可以设置一个环境变量,实现优先选择 Espressif 的下载服务器进行 Github 资源下载。
.. 注解:: 该设置只影响从 Github 发布版本中下载的单个工具,它并不会改变访问任何 Git 仓库的 URL。
Windows 操作系统
-----------------
如果希望在运行 ESP-IDF 工具安装器或在使用命令行安装工具时优先选择 Espressif 下载服务器,可通过以下方式设置:打开系统控制面板,然后点击高级设置,添加一个新的环境变量(类型为用户或系统都可以,名称为 ``IDF_GITHUB_ASSETS``,值为 ``dl.espressif.com/github_assets``),最后点击确定。
如果在添加新的环境变量前命令行窗口或 ESP-IDF 工具安装器窗口已经打开,请关闭这些窗口后重新打开。
当设置好这个新的环境变量后ESP-IDF 工具安装器以及命令行安装程序将会优先选择 Espressif 下载服务器。
.. 在 ESP-IDF 工具安装器的二进制文件更新后(导入复选框),这段需要重新更新
Linux 和 macOS 操作系统
--------------------------
要在安装工具时优先选择 Espressif 下载服务器,请在运行 ``install.sh`` 时使用以下命令:
.. code-block:: bash
cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"
./install.sh
自定义工具安装路径 自定义工具安装路径
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -649,4 +682,4 @@ Windows 操作系统
:esp32: ../get-started-legacy/index :esp32: ../get-started-legacy/index
.. _Stable version: https://docs.espressif.com/projects/esp-idf/zh_CN/stable/ .. _Stable version: https://docs.espressif.com/projects/esp-idf/zh_CN/stable/
.. _Releases page: https://github.com/espressif/esp-idf/releases .. _Releases page: https://github.com/espressif/esp-idf/releases