diff --git a/docs/zh_CN/about.rst b/docs/zh_CN/about.rst index af50eddfb6..cd9d257008 100644 --- a/docs/zh_CN/about.rst +++ b/docs/zh_CN/about.rst @@ -2,9 +2,24 @@ =========== :link_to_translation:`en:[English]` -本指南为 `乐鑫 `_ 公司 `ESP32 系列芯片 `_ 官方应用开发框架 `ESP-IDF `_ 的配套文档。 +.. only:: esp32 -ESP32 芯片是一款 2.4 GHz Wi-Fi 和蓝牙双模芯片，内置 1 或 2 个 32 位处理器，运算能力最高可达 600 DMIPS。 + 本指南为 `乐鑫 `_ 公司 `{IDF_TARGET_NAME} `_ 官方应用开发框架 `ESP-IDF `_ 的配套文档。 + + {IDF_TARGET_NAME} 芯片是一款 2.4 GHz Wi-Fi 和蓝牙双模芯片，内置 1 或 2 个 Xtensa® 32 位 LX6 处理器，运算能力最高可达 600 DMIPS。 + + +.. only:: esp32s2 + + 本指南为 {IDF_TARGET_NAME} 官方应用开发框架 `ESP-IDF `_ 的配套文档。 + + {IDF_TARGET_NAME} 是一款高集成 2.4 GHz Wi-Fi 系统级芯片，搭载 Xtensa® 32 位 LX7 单核处理器，运算能力最高可达 600 DMIPS。 + +.. only:: esp32c3 + + 本指南为 {IDF_TARGET_NAME} 官方应用开发框架 `ESP-IDF `_ 的配套文档。 + + {IDF_TARGET_NAME} 是一款低功耗芯片，支持 2.4 GHz Wi-Fi 和蓝牙，搭载 RISC-V RV32IMC 32 位单核处理器。 .. figure:: ../_static/about-doc.png :align: center @@ -13,4 +28,4 @@ ESP32 芯片是一款 2.4 GHz Wi-Fi 和蓝牙双模芯片，内置 1 或 2 个 3 乐鑫物联网综合开发框架 -ESP-IDF 即乐鑫物联网开发框架，可为在 Windows、Linux 和 macOS 系统平台上开发 ESP32 应用程序提供工具链、API、组件和工作流的支持。 +ESP-IDF 即乐鑫物联网开发框架，可为在 Windows、Linux 和 macOS 系统平台上开发 {IDF_TARGET_NAME} 应用程序提供工具链、API、组件和工作流程的支持。 diff --git a/docs/zh_CN/get-started-legacy/index.rst b/docs/zh_CN/get-started-legacy/index.rst index 4531e3eb1d..d34382d159 100644 --- a/docs/zh_CN/get-started-legacy/index.rst +++ b/docs/zh_CN/get-started-legacy/index.rst @@ -8,6 +8,8 @@ 本文档旨在指导用户搭建 ESP32 硬件开发的软件环境，通过一个简单的示例展示如何使用 ESP-IDF (Espressif IoT Development Framework) 配置菜单，并编译、下载固件至 ESP32 开发板等步骤。 + + .. include-build-file:: inc/version-note.inc 概述 @@ -16,7 +18,7 @@ ESP32 SoC 芯片支持以下功能： * 2.4 GHz Wi-Fi -* 蓝牙 4.2 +* 蓝牙 * 高性能双核 * 超低功耗协处理器 * 多种外设 @@ -32,7 +34,7 @@ ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、 * 一款 **ESP32** 开发板 * **USB 数据线** (A 转 Micro-B) -* PC（Windows、Linux 或 Mac OS） +* PC（Windows、Linux 或 macOS） 软件： @@ -53,8 +55,6 @@ ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、 ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit> ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit> ESP32-DevKit-S(-R) <../hw-reference/esp32/user-guide-devkits-r-v1.1> - - .. _get-started-step-by-step-legacy: 详细安装步骤 @@ -117,7 +117,7 @@ ESP32 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、 .. note:: - 在本文档中，Linux 和 MacOS 操作系统中 ESP-IDF 的默认安装路径为 ``~/esp``；Windows 操作系统的默认路径为 ``%userprofile%\esp``。您也可以将 ESP-IDF 安装在任何其他路径下，但请注意在使用命令行时进行相应替换。注意，ESP-IDF 不支持带有空格的路径。 + 在本文档中，Linux 和 macOS 操作系统中 ESP-IDF 的默认安装路径为 ``~/esp``；Windows 操作系统的默认路径为 ``%userprofile%\esp``。您也可以将 ESP-IDF 安装在任何其他路径下，但请注意在使用命令行时进行相应替换。注意，ESP-IDF 不支持带有空格的路径。 此外， 您也可以根据自身经验和实际需求，对环境进行个性化设置，而非使用预制工具链。此时，请前往 :ref:`get-started-customized-setup-legacy` 章节获取更多信息。 @@ -164,7 +164,7 @@ ESP-IDF 将下载至 ``~/esp/esp-idf``。 第四步：安装 Python 软件包 ========================== -ESP-IDF 所需的 Python 软件包位于 ``IDF_PATH/requirements.txt`` 中。您可以运行以下命令进行安装：您可以运行以下命令进行安装:: +ESP-IDF 所需的 Python 软件包位于 ``IDF_PATH/requirements.txt`` 中。您可以运行以下命令进行安装:: python -m pip install --user -r $IDF_PATH/requirements.txt @@ -177,6 +177,8 @@ ESP-IDF 所需的 Python 软件包位于 ``IDF_PATH/requirements.txt`` 中。您 .. _get-started-start-project-legacy: + + 第五步：开始创建工程 ===================== @@ -184,7 +186,7 @@ ESP-IDF 所需的 Python 软件包位于 ``IDF_PATH/requirements.txt`` 中。您 将 :example:`get-started/hello_world` 复制至您本地的 ``~/esp`` 目录下： -Linux 和 MacOS 操作系统 +Linux 和 macOS 操作系统 ~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: bash @@ -206,6 +208,8 @@ ESP-IDF 的 :idf:`examples` 目录下有一系列示例工程，都可以按照 ESP-IDF 编译系统不支持带有空格的路径。 + + .. _get-started-connect-legacy: 第六步：连接设备 @@ -217,7 +221,7 @@ ESP-IDF 的 :idf:`examples` 目录下有一系列示例工程，都可以按照 - **Windows 操作系统：** ``COM1`` 等 - **Linux 操作系统：** 以 ``/dev/tty`` 开始 -- **MacOS 操作系统：** 以 ``/dev/cu.`` 开始 +- **macOS 操作系统：** 以 ``/dev/cu.`` 开始 有关如何查看串口名称的详细信息，请见 :doc:`establish-serial-connection`。 @@ -233,7 +237,7 @@ ESP-IDF 的 :idf:`examples` 目录下有一系列示例工程，都可以按照 请进入 :ref:`get-started-start-project-legacy` 中提到的 ``hello_world`` 目录，并运行工程配置工具 ``menuconfig``。 -Linux 和 MacOS 操作系统 +Linux 和 macOS 操作系统 ~~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: bash @@ -285,37 +289,60 @@ Windows 操作系统 运行以上命令可以编译应用程序和所有 ESP-IDF 组件，接着生成 bootloader、分区表和应用程序二进制文件。接着，这些二进制文件将被烧录至 ESP32 开发板。 -如果一切顺利，您可在烧录完成后看到类似下方的打印信息（代表加载进程）。接着，开发板将会复位，应用程序 "hello_world" 开始启动。 -.. highlight:: none +烧录过程中可能遇到的问题 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -:: +如果在运行给定命令时出现如“连接失败”这样的错误，原因之一则可能是运行 ``esptool.py`` 出现错误。``esptool.py`` 是构建系统调用的程序，用于重置芯片、与 ROM 引导加载器交互以及烧录固件的工具。解决该问题的一个简单的方法就是按照以下步骤进行手动复位。如果问题仍未解决，请参考 `Troubleshooting `_ 获取更多信息。 - esptool.py v2.0-beta2 +``esptool.py`` 通过使 USB 转串口转接器芯片（如 FTDI 或 CP210x）的 DTR 和 RTS 控制线生效来自动复位 {IDF_TARGET_NAME}（请参考 :doc:`establish-serial-connection` 获取更多详细信息)。DTR 和 RTS 控制线又连接到 {IDF_TARGET_NAME} 的 ``GPIO0`` 和 ``CHIP_PU`` (EN) 管脚上，因此 DTR 和 RTS 的电压电平变化会使 {IDF_TARGET_NAME} 进入固件下载模式。相关示例可查看 ESP32 DevKitC 开发板的 `原理图 `_。 + +一般来说，使用官方的 esp-idf 开发板不会出现问题。但是，``esptool.py`` 在以下情况下不能自动重置硬件。 + +- 您的硬件没有连接到 ``GPIO0`` 和 ``CIHP_PU`` 的 DTR 和 RTS 控制线 +- DTR 和 RTS 控制线的配置方式不同 +- 根本没有这样的串行控制线路 + +根据您硬件的种类，也可以将您 {IDF_TARGET_NAME} 开发板手动设置成固件下载模式（复位）。 + +- 对于 Espressif 的开发板，您可以参考对应开发板的入门指南或用户指南。例如，可以通过按住 **Boot** 按钮 (``GPIO0``) 再按住 **EN** 按钮(``CHIP_PU``) 来手动复位 esp-idf 开发板。 +- 对于其他类型的硬件，可以尝试将 ``GPIO0`` 拉低。 + + +常规操作 +~~~~~~~~~~~~~~~~ + +如果一切顺利，您可在烧录完成后看到类似下方的打印信息。接着，开发板将会复位，应用程序 "hello_world" 开始启动。 + +.. code-block:: bash + + esptool.py v3.0-dev Flashing binaries to serial port /dev/ttyUSB0 (app at offset 0x10000)... - esptool.py v2.0-beta2 - Connecting........___ + esptool.py v3.0-dev + Serial port /dev/cu.SLAB_USBtoUART + Connecting........____ + Chip is ESP32D0WDQ6 (revision 1) + Features: WiFi, BT, Dual Core, Coding Scheme None + Crystal is 40MHz + MAC: 30:ae:a4:15:21:b4 Uploading stub... Running stub... Stub running... - Changing baud rate to 921600 - Changed. - Attaching SPI flash... Configuring flash size... Auto-detected Flash size: 4MB Flash params set to 0x0220 - Compressed 11616 bytes to 6695... - Wrote 11616 bytes (6695 compressed) at 0x00001000 in 0.1 seconds (effective 920.5 kbit/s)... + Compressed 26704 bytes to 15930... + Wrote 26704 bytes (15930 compressed) at 0x00001000 in 1.4 seconds (effective 151.9 kbit/s)... Hash of data verified. - Compressed 408096 bytes to 171625... - Wrote 408096 bytes (171625 compressed) at 0x00010000 in 3.9 seconds (effective 847.3 kbit/s)... + Compressed 147984 bytes to 77738... + Wrote 147984 bytes (77738 compressed) at 0x00010000 in 6.9 seconds (effective 172.7 kbit/s)... Hash of data verified. - Compressed 3072 bytes to 82... - Wrote 3072 bytes (82 compressed) at 0x00008000 in 0.0 seconds (effective 8297.4 kbit/s)... + Compressed 3072 bytes to 103... + Wrote 3072 bytes (103 compressed) at 0x00008000 in 0.0 seconds (effective 1607.9 kbit/s)... Hash of data verified. Leaving... - Hard resetting... + Hard resetting via RTS pin... 如果您希望使用 Eclipse IDE，而非 ``make`` 编译系统，请参考 :doc:`Eclipse guide `。 @@ -342,12 +369,12 @@ Windows 操作系统 此时，您就可以在启动日志和诊断日志之后，看到打印的 “Hello world!” 了。 -.. code-block:: none +.. code-block:: bash ... Hello world! + This is esp32 chip with 2 CPU cores, WiFi/BT/BLE, silicon revision 1, 4MB external flash Restarting in 10 seconds... - I (211) cpu_start: Starting scheduler on APP CPU. Restarting in 9 seconds... Restarting in 8 seconds... Restarting in 7 seconds... @@ -400,11 +427,13 @@ Windows 操作系统 * - ``MONITORBAUD`` - 覆盖监控时使用的串口速率。例：``make monitor MONITORBAUD=9600`` + .. note:: 您可导出环境变量（例：``export ESPPORT=/dev/ttyUSB1``）。在同一会话窗口中，如果未被同步覆盖，所有 ``make`` 命令均会使用导出的环境变量值。 + 更新 ESP-IDF ============= diff --git a/docs/zh_CN/get-started/index.rst b/docs/zh_CN/get-started/index.rst index c7687bb5b6..62d7bfcccf 100644 --- a/docs/zh_CN/get-started/index.rst +++ b/docs/zh_CN/get-started/index.rst @@ -2,11 +2,11 @@ 快速入门 *********** -{IDF_TARGET_CORE_NUM:default="2", esp32="2", esp32s2="1"} +{IDF_TARGET_CORE_NUM:default="2", esp32="2", esp32s2="1", esp32c3="1"} -{IDF_TARGET_FEATURES:default="WiFi/BT/BLE, silicon revision 1, 2MB external flash", esp32="WiFi/BT/BLE, silicon revision 1, 2MB external flash", esp32s2="WiFi, silicon revision 0, 2MB external flash"} +{IDF_TARGET_FEATURES:default="WiFi/BT/BLE, silicon revision 1, 2MB external flash", esp32="WiFi/BT/BLE, silicon revision 1, 2MB external flash", esp32s2="WiFi, silicon revision 0, 2MB external flash", esp32c3="WiFi/BLE, silicon revision 0, 2MB external flash"} -{IDF_TARGET_HEAP_SIZE:default="298968", esp32="298968", esp32s2="253900"} +{IDF_TARGET_HEAP_SIZE:default="298968", esp32="298968", esp32s2="253900", esp32c3="337332"} :link_to_translation:`en:[English]` @@ -25,7 +25,7 @@ * 2.4 GHz Wi-Fi * 蓝牙 - * 高性能双核 + * 高性能 Xtensa® 32 位 LX6 双核处理器 * 超低功耗协处理器 * 多种外设 @@ -34,12 +34,22 @@ ESP32-S2 SoC 芯片支持以下功能： * 2.4 GHz Wi-Fi - * 高性能单核 + * 高性能 Xtensa® 32 位 LX7 单核处理器 * 运行 RISC-V 或 FSM 内核的超低功耗协处理器 * 多种外设 * 内置安全硬件 * USB OTG 接口 +.. only:: esp32c3 + + ESP32-C3 SoC 芯片支持以下功能： + + * 2.4 GHz Wi-Fi + * 低能耗蓝牙 + * 高性能 32 位 RISC-V 单核处理器 + * 多种外设 + * 内置安全硬件 + {IDF_TARGET_NAME} 采用 40 nm 工艺制成，具有最佳的功耗性能、射频性能、稳定性、通用性和可靠性，适用于各种应用场景和不同功耗需求。 乐鑫为用户提供完整的软、硬件资源，进行 {IDF_TARGET_NAME} 硬件设备的开发。其中，乐鑫的软件开发环境 ESP-IDF 旨在协助用户快速开发物联网 (IoT) 应用，可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。 @@ -102,6 +112,12 @@ ESP32-S2-DevKitM-1(U) <../hw-reference/esp32s2/user-guide-devkitm-1-v1> ESP32-S2-Kaluga-Kit <../hw-reference/esp32s2/user-guide-esp32-s2-kaluga-1-kit> +.. only:: esp32c3 + + .. note:: + + 有关 ESP32-C3 的硬件指南尚未发布。 + .. _get-started-step-by-step: 详细安装步骤 @@ -167,7 +183,6 @@ .. _get-started-get-esp-idf: - 第二步：获取 ESP-IDF ================================= @@ -229,7 +244,6 @@ Linux 和 macOS 操作系统 cd ~/esp/esp-idf ./install.sh - 下载工具备选方案 ~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -259,7 +273,6 @@ Linux 和 macOS 操作系统 export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" ./install.sh - 自定义工具安装路径 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -269,6 +282,7 @@ Linux 和 macOS 操作系统 .. _get-started-set-up-env: + 第四步：设置环境变量 ======================================= @@ -355,6 +369,8 @@ ESP-IDF 的 :idf:`examples` 目录下有一系列示例工程，都可以按照 ESP-IDF 编译系统不支持带有空格的路径。 + + .. _get-started-connect: 第六步：连接设备 @@ -409,6 +425,8 @@ Windows 操作系统 :alt: 工程配置 — 主窗口 :figclass: align-center + 工程配置 — 主窗口 + 您可以通过此菜单设置项目的具体变量，包括 Wi-Fi 网络名称、密码和处理器速度等. ``hello_world`` 示例项目会以默认配置运行，因此可以跳过使用 ``menuconfig`` 进行项目配置这一步骤。 .. only:: esp32 @@ -423,10 +441,13 @@ Windows 操作系统 .. _get-started-build: + 第八步：编译工程 ========================= -请使用以下命令，编译烧录工程：:: +请使用以下命令，编译烧录工程： + +.. code-block:: batch idf.py build @@ -479,21 +500,22 @@ Windows 操作系统 烧录过程中可能遇到的问题 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -如果在运行给定命令时出现如“连接失败”这样的错误，原因之一则可能是运行 ``esptool.py`` 出现错误。``esptool.py`` 是编译系统调用的程序，用于重置芯片、与 ROM 引导加载器交互以及烧录固件的工具。解决该问题的一个简单的方法就是按照以下步骤进行手动复位。如果问题仍未解决，请参考 `Troubleshooting `_ 获取更多信息。 +{IDF_TARGET_STRAP_GPIO:default="GPIO0", esp32="GPIO0", esp32s2="GPIO0", esp32c3="GPIO9"} +如果在运行给定命令时出现如“连接失败”这样的错误，原因之一则可能是运行 ``esptool.py`` 出现错误。``esptool.py`` 是构建系统调用的程序，用于重置芯片、与 ROM 引导加载器交互以及烧录固件的工具。解决该问题的一个简单的方法就是按照以下步骤进行手动复位。如果问题仍未解决，请参考 `Troubleshooting `_ 获取更多信息。 -``esptool.py`` 通过使 USB 转串口转接器芯片（如 FTDI 或 CP210x）的 DTR 和 RTS 控制线生效来自动复位 {IDF_TARGET_NAME}（请参考 :doc:`establish-serial-connection` 获取更多详细信息)。DTR 和 RTS 控制线又连接到 {IDF_TARGET_NAME} 的 ``GPIO0`` 和 ``CHIP_PU`` (EN) 管脚上，因此 DTR 和 RTS 的电压水平变化会使 {IDF_TARGET_NAME} 进入固件下载模式。相关示例可查看 ESP32 DevKitC 开发板的 `原理图 `_。 +``esptool.py`` 通过使 USB 转串口转接器芯片（如 FTDI 或 CP210x）的 DTR 和 RTS 控制线生效来自动复位 {IDF_TARGET_NAME}（请参考 :doc:`establish-serial-connection` 获取更多详细信息)。DTR 和 RTS 控制线又连接到 {IDF_TARGET_NAME} 的 ``{IDF_TARGET_STRAP_GPIO}`` 和 ``CHIP_PU`` (EN) 管脚上，因此 DTR 和 RTS 的电压电平变化会使 {IDF_TARGET_NAME} 进入固件下载模式。相关示例可查看 ESP32 DevKitC 开发板的 `原理图 `_。 一般来说，使用官方的 esp-idf 开发板不会出现问题。但是，``esptool.py`` 在以下情况下不能自动重置硬件。 -- 您的硬件没有连接到 ``GPIO0`` 和 ``CIHP_PU`` 的 DTR 和 RTS 控制线。 +- 您的硬件没有连接到 ``{IDF_TARGET_STRAP_GPIO}`` 和 ``CIHP_PU`` 的 DTR 和 RTS 控制线。 - DTR 和 RTS 控制线的配置方式不同 - 根本没有这样的串行控制线路 根据您硬件的种类，也可以将您 {IDF_TARGET_NAME} 开发板手动设置成固件下载模式（复位）。 -- 对于 Espressif 的开发板，您可以参考对应开发板的入门指南或用户指南。例如，可以通过按住 **Boot** 按钮 (``GPIO0``) 再按住 **EN** 按钮(``CHIP_PU``) 来手动复位 esp-idf 开发板。 -- 对于其他类型的硬件，可以尝试将 ``GPIO0`` 拉低。 +- 对于 Espressif 的开发板，您可以参考对应开发板的入门指南或用户指南。例如，可以通过按住 **Boot** 按钮 (``{IDF_TARGET_STRAP_GPIO}``) 再按住 **EN** 按钮(``CHIP_PU``) 来手动复位 esp-idf 开发板。 +- 对于其他类型的硬件，可以尝试将 ``{IDF_TARGET_STRAP_GPIO}`` 拉低。 常规操作 @@ -581,6 +603,47 @@ Windows 操作系统 Hard resetting via RTS pin... Done +.. only:: esp32c3 + + .. code-block:: none + + ... + esptool.py --chip esp32c3 -p /dev/ttyUSB0 -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 80m --flash_size 2MB 0x8000 partition_table/partition-table.bin 0x0 bootloader/bootloader.bin 0x10000 hello-world.bin + esptool.py v3.0 + Serial port /dev/ttyUSB0 + Connecting.... + Chip is ESP32-C3 + Features: Wi-Fi + Crystal is 40MHz + MAC: 7c:df:a1:40:02:a4 + Uploading stub... + Running stub... + Stub running... + Changing baud rate to 460800 + Changed. + Configuring flash size... + Compressed 3072 bytes to 103... + Writing at 0x00008000... (100 %) + Wrote 3072 bytes (103 compressed) at 0x00008000 in 0.0 seconds (effective 4238.1 kbit/s)... + Hash of data verified. + Compressed 18960 bytes to 11311... + Writing at 0x00000000... (100 %) + Wrote 18960 bytes (11311 compressed) at 0x00000000 in 0.3 seconds (effective 584.9 kbit/s)... + Hash of data verified. + Compressed 145520 bytes to 71984... + Writing at 0x00010000... (20 %) + Writing at 0x00014000... (40 %) + Writing at 0x00018000... (60 %) + Writing at 0x0001c000... (80 %) + Writing at 0x00020000... (100 %) + Wrote 145520 bytes (71984 compressed) at 0x00010000 in 2.3 seconds (effective 504.4 kbit/s)... + Hash of data verified. + + Leaving... + Hard resetting via RTS pin... + Done + + 如果一切顺利，烧录完成后，开发板将会复位，应用程序 "hello_world" 开始运行。 如果您希望使用 Eclipse 或是 VS Code IDE，而非 ``idf.py``，请参考 :doc:`Eclipse 指南 `，以及 :doc:`VS Code 指南 `。 diff --git a/docs/zh_CN/get-started/linux-setup-scratch.rst b/docs/zh_CN/get-started/linux-setup-scratch.rst index 39f197e4f7..620b745932 100644 --- a/docs/zh_CN/get-started/linux-setup-scratch.rst +++ b/docs/zh_CN/get-started/linux-setup-scratch.rst @@ -28,7 +28,6 @@ sudo pacman -Sy --needed gcc git make ncurses flex bison gperf python-pyserial python-cryptography python-future python-pyparsing python-pyelftools cmake ninja ccache dfu-util libusb .. 注解:: - 使用 ESP-IDF 需要 CMake 3.5 或以上版本。较早的 Linux 发行版可能需要升级自身的软件源仓库，或开启 backports 套件库，或安装 "cmake3" 软件包（不是安装 "cmake")。 从源代码编译工具链 @@ -73,7 +72,6 @@ ./ct-ng build chmod -R u+w builds/{IDF_TARGET_TOOLCHAIN_PREFIX} - 编译得到的工具链会被保存至 ``~/esp/crosstool-NG/builds/{IDF_TARGET_TOOLCHAIN_PREFIX}``。 添加工具链到 PATH 环境变量 @@ -85,10 +83,12 @@ export PATH="$HOME/esp/{IDF_TARGET_TOOLCHAIN_PREFIX}/bin:$PATH" + .. 注解:: 如果您已将 ``/bin/bash`` 设置为登录 shell，且同时存在 ``.bash_profile`` 和 ``.profile`` 两个文件，则请更新 ``.bash_profile``。在 CentOS 环境下, ``alias`` 需要添加到 ``.bashrc`` 文件中。 + 退出并重新登录以使 ``.profile`` 的更改生效。运行以下命令来检查 ``PATH`` 设置是否正确:: printenv PATH @@ -100,7 +100,6 @@ 注意这里的 ``/home/user-name`` 应该替换成您安装的主路径。 - 停用 Python 2 ==================== diff --git a/docs/zh_CN/index.rst b/docs/zh_CN/index.rst index f86d12c8b3..892b9d29df 100644 --- a/docs/zh_CN/index.rst +++ b/docs/zh_CN/index.rst @@ -2,7 +2,7 @@ ESP-IDF 编程指南 ========================= :link_to_translation:`en:[English]` -这里是乐鑫 IoT 开发框架 (`esp-idf `_) 的文档中心。ESP-IDF 是 `ESP32 和 ESP32-S2 `_ 系列芯片的官方开发框架。 +这里是乐鑫 IoT 开发框架 (`esp-idf `_) 的文档中心。ESP-IDF 是 `ESP32、ESP32-S 和 ESP32-C `_ 系列芯片的官方开发框架。 .. only:: html @@ -12,8 +12,11 @@ ESP-IDF 编程指南 本文档仅包含针对 {IDF_TARGET_NAME} 芯片的 ESP-IDF 使用。 +.. only:: esp32c3 -ESP-IDF 是 `ESP32 `_ 芯片的官方开发框架。 + .. warning:: + + ESP32-C3 的相关文档尚未全部更新完毕。 ================== ================== ================== |快速入门|_ |API 参考|_ |H/W 参考|_ @@ -25,7 +28,6 @@ ESP-IDF 是 `ESP32 关于 Languages/语言 - 指南下载 - * :ref:`genindex` diff --git a/docs/zh_CN/resources.rst b/docs/zh_CN/resources.rst index 39fafda337..5ef0daa149 100644 --- a/docs/zh_CN/resources.rst +++ b/docs/zh_CN/resources.rst @@ -17,7 +17,7 @@ * 您可以通过 GitHub 的 `Issues `_ 版块提交 bug 或功能请求。在提交新 Issue 之前，请先查看现有的 `Issues `_。 -* 您可以在 `ESP32 IoT Solution `_ 库中找到基于 ESP-IDF 的 `解决方案 `_、`应用实例 `_、`组件和驱动 `_ 等内容。 +* 您可以在 `ESP IoT Solution `_ 库中找到基于 ESP-IDF 的 `解决方案 `_、`应用实例 `_、`组件和驱动 `_ 等内容。多数文档均提供中英文版本。 * 通过 Arduino 平台开发应用，请参考 `ESP32 Wi-Fi 芯片的 Arduino 内核 `_。 @@ -25,6 +25,6 @@ * 如果您有兴趣参与到 ESP-IDF 的开发, 请查阅 :doc:`contribute/index`。 -* 关于 ESP32 的其它信息，请查看官网 `文档 `_ 版块。 +* 关于 {IDF_TARGET_NAME} 的其它信息，请查看官网 `文档 `_ 版块。 * 关于本文档的 PDF 和 HTML 格式下载（最新版本和早期版本），请点击 `下载 `_。