From 475f9b615605bd7839804090cb01edba3ff844ea Mon Sep 17 00:00:00 2001 From: Lv Xin Yue Date: Thu, 23 Apr 2026 12:10:11 +0800 Subject: [PATCH] docs(esp32): Updated wording to avoid misunderstanding --- .../api-reference/peripherals/sd_pullup_requirements.rst | 9 +++++++-- .../api-reference/peripherals/sd_pullup_requirements.rst | 7 ++++++- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/en/api-reference/peripherals/sd_pullup_requirements.rst b/docs/en/api-reference/peripherals/sd_pullup_requirements.rst index ee71488b857..8d02e946364 100644 --- a/docs/en/api-reference/peripherals/sd_pullup_requirements.rst +++ b/docs/en/api-reference/peripherals/sd_pullup_requirements.rst @@ -90,6 +90,11 @@ This section provides an overview of compatibility issues that might occur when - :ref:`sd_pull-up_no_pull-ups` - :ref:`strapping_conflicts_dat2` + - ESP32-WROVER-E Series, including ESP32-WROVER-E and ESP32-WROVER-IE + + - :ref:`sd_pull-up_no_pull-ups` + - :ref:`strapping_conflicts_dat2` + .. only:: esp32 @@ -306,9 +311,9 @@ No Pull-ups MTDI (GPIO12) is used as a bootstrapping pin to select the output voltage of an internal regulator (VDD_SDIO) which powers the flash chip. This pin has an internal pull-down, so, if left unconnected, it will read low level at startup, which leads to selecting the default 3.3 V operation. - All ESP32-WROVER modules, excluding ESP32-WROVER-B, use 1.8 V flash and have internal pull-ups on GPIO12. Other modules that use 3.3 V flash have no pull-ups on the GPIO12 pin, and this pin is slightly pulled down internally. + For ESP32 modules that use 1.8 V flash (such as ESP32-WROVER and ESP32-WROVER-I), they have pull-up resistors on GPIO12. For ESP32 modules that use 3.3 V flash, they have no pull-up resistors on GPIO12, and this pin is slightly pulled down internally. - When adding a pull-up to this pin for SD card operation, consider the following: + When adding a pull-up to GPIO12 for SD card operation, consider the following: - For boards that do not use the internal regulator (VDD_SDIO) to power flash, GPIO12 can be pulled high. - For boards using 1.8 V flash chips, GPIO12 needs to be pulled high at reset. This is fully compatible with the SD card operation. diff --git a/docs/zh_CN/api-reference/peripherals/sd_pullup_requirements.rst b/docs/zh_CN/api-reference/peripherals/sd_pullup_requirements.rst index bc2ac35e9cc..e9492d852f3 100644 --- a/docs/zh_CN/api-reference/peripherals/sd_pullup_requirements.rst +++ b/docs/zh_CN/api-reference/peripherals/sd_pullup_requirements.rst @@ -90,6 +90,11 @@ SD 上拉需求 - :ref:`sd_pull-up_no_pull-ups` - :ref:`strapping_conflicts_dat2` + - ESP32-WROVER-E 系列模组，包括 ESP32-WROVER-E 和 ESP32-WROVER-IE + + - :ref:`sd_pull-up_no_pull-ups` + - :ref:`strapping_conflicts_dat2` + .. only:: esp32 @@ -306,7 +311,7 @@ SD 上拉需求 MTDI (GPIO12) 为 strapping 管脚，用于选择内部调节器 (VDD_SDIO) 的输出电压，为 flash 芯片供电。该管脚带有内部下拉电阻，因此若处于未连接状态，MTDI 管脚将在启动时读取低电平，选择默认的 3.3 V 操作。 - 除 ESP32-WROVER-B 外的所有 ESP32-WROVER 模组都使用 1.8 V flash，并在 GPIO12 上有内部上拉电阻。使用 3.3 V flash 的其他模组在 GPIO12 管脚上没有上拉电阻，并在芯片内部 GPIO12 管脚默认使能弱下拉。 + 使用 1.8 V flash 的 ESP32 模组（如 ESP32-WROVER 和 ESP32-WROVER-I），在 GPIO12 上有上拉电阻。使用 3.3 V flash 的其他 ESP32 模组，在 GPIO12 上无上拉电阻，该管脚在芯片内部为弱下拉。 为 GPIO12 添加上拉电阻以进行 SD 卡操作时，请考虑以下事项：