Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-09-22 13:01:16 +03:00
Code Issues Packages Projects Releases Wiki Activity

docs(gpio): removed strapping description in programming guide

Browse Source 
Closes https://github.com/espressif/esp-idf/issues/18969
This commit is contained in:
Chen Chen
2026-08-24 17:36:44 +08:00
parent ae2088092e
commit 26a8308400
26 changed files with 146 additions and 792 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/en/api-reference/peripherals/gpio/esp32.inc
View File

@@ -25,8 +25,7 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO0
- ADC2_CH1
- RTC_GPIO11
- Strapping pin
-
* - GPIO1
-
-
@@ -35,8 +34,7 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO2
- ADC2_CH2
- RTC_GPIO12
- Strapping pin
-
* - GPIO3
-
-
@@ -46,12 +44,10 @@ The table below provides more information on pin usage, and please note the comm
- ADC2_CH0
- RTC_GPIO10
-
* - GPIO5
-
-
- Strapping pin
-
* - GPIO6
-
-
@@ -85,7 +81,7 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO12
- ADC2_CH5
- RTC_GPIO15
- Strapping pin; JTAG
- JTAG
* - GPIO13
- ADC2_CH4
@@ -100,7 +96,7 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO15
- ADC2_CH3
- RTC_GPIO13
- Strapping pin; JTAG
- JTAG
* - GPIO16
-
@@ -116,52 +112,42 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO19
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO25
- ADC2_CH8
- RTC_GPIO6
-
* - GPIO26
- ADC2_CH9
- RTC_GPIO7
-
* - GPIO27
- ADC2_CH7
- RTC_GPIO17
-
* - GPIO32
- ADC1_CH4
- RTC_GPIO9
-
* - GPIO33
- ADC1_CH5
- RTC_GPIO8
-
* - GPIO34
- ADC1_CH6
- RTC_GPIO4
@@ -194,7 +180,7 @@ The table below provides more information on pin usage, and please note the comm
.. note::
- Strapping pin: GPIO0, GPIO2, GPIO5, GPIO12 (MTDI), and GPIO15 (MTDO) are strapping pins. For more information, please refer to `ESP32 datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO6-11 and GPIO16-17 are usually connected to the SPI flash and PSRAM integrated on the module and therefore should not be used for other purposes.
- JTAG: GPIO12-15 are usually used for inline debug.
- GPI: GPIO34-39 can only be set as input mode and do not have software-enabled pullup or pulldown functions.

17
docs/en/api-reference/peripherals/gpio/esp32c2.inc
View File

@@ -9,7 +9,7 @@
.. gpio-summary
The {IDF_TARGET_NAME} chip features 21 physical GPIO pins (GPIO0 ~ GPIO20). For chip variants with an SiP flash built in, GPIO11 ~ GPIO17 are dedicated to connecting the SiP flash; therefore, only 14 GPIO pins are available.
The {IDF_TARGET_NAME} chip features 21 physical GPIO pins (GPIO0 ~ GPIO20). For chip variants with an SiP flash built in, GPIO11 ~ GPIO17 are not led out; therefore, only 14 GPIO pins are available.
Each pin can be used as a general-purpose I/O, or to be connected to an internal peripheral signal. Through GPIO matrix and IO MUX, peripheral input signals can be from any IO pins, and peripheral output signals can be routed to any IO pins. Together these modules provide highly configurable I/O. For more details, see *{IDF_TARGET_NAME} Technical Reference Manual* > *IO MUX and GPIO Matrix (GPIO, IO_MUX)* [`PDF <{IDF_TARGET_TRM_EN_URL}#iomuxgpio>`__].
@@ -50,27 +50,21 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO6
-
-
* - GPIO7
-
-
* - GPIO8
-
- Strapping pin
-
* - GPIO9
-
- Strapping pin
-
* - GPIO10
-
-
* - GPIO11
-
-
* - GPIO12
-
- SPI0/1
@@ -98,18 +92,15 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO18
-
-
* - GPIO19
-
-
* - GPIO20
-
-
.. note::
- Strapping pin: GPIO8 and GPIO9 are strapping pins. For more information, please refer to `ESP8684 datasheet <https://www.espressif.com/sites/default/files/documentation/esp8684_datasheet_en.pdf>`_.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO12-17 are usually used for SPI flash and not recommended for other uses.
- RTC: GPIO0-5 can be used to wake up the chip from Deep-sleep mode. Other GPIOs can only wake up the chip from Light-sleep mode. For more information, please refer to Section :ref:`Wakeup Sources<api-reference-wakeup-source>`.

16
docs/en/api-reference/peripherals/gpio/esp32c3.inc
View File

@@ -31,7 +31,7 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO2
- ADC1_CH2
- Strapping pin；RTC
- RTC
* - GPIO3
- ADC1_CH3
@@ -48,27 +48,21 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO6
-
-
* - GPIO7
-
-
* - GPIO8
-
- Strapping pin
-
* - GPIO9
-
- Strapping pin
-
* - GPIO10
-
-
* - GPIO11
-
-
* - GPIO12
-
- SPI0/1
@@ -104,14 +98,12 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO20
-
-
* - GPIO21
-
-
.. note::
- Strapping pin: GPIO2, GPIO8 and GPIO9 are strapping pins. For more information, please refer to `ESP32-C3 Datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO12 ~ GPIO17 are usually used for SPI flash and are not recommended for other uses.
- USB-JTAG: GPIO18 and GPIO19 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- RTC: GPIO0 ~ GPIO5 can be used to wake up the chip from Deep-sleep mode. Other GPIOs can only wake up the chip from Light-sleep mode. For more information, please refer to Section :ref:`Wakeup Sources<api-reference-wakeup-source>`.

36
docs/en/api-reference/peripherals/gpio/esp32c5.inc
View File

@@ -26,67 +26,54 @@ The table below provides more information on pin usage, and please note the comm
-
- LP_GPIO0
-
* - GPIO1
- ADC1_CH0
- LP_GPIO1
-
* - GPIO2
- ADC1_CH1
- LP_GPIO2
- Strapping pin
-
* - GPIO3
- ADC1_CH2
- LP_GPIO3
-
* - GPIO4
- ADC1_CH3
- LP_GPIO4
-
* - GPIO5
- ADC1_CH4
- LP_GPIO5
-
* - GPIO6
- ADC1_CH5
- LP_GPIO6
-
* - GPIO7
-
-
- Strapping pin
-
* - GPIO8
-
-
-
* - GPIO9
-
-
-
* - GPIO10
-
-
-
* - GPIO11
-
-
-
* - GPIO12
-
-
-
* - GPIO13
-
-
@@ -101,7 +88,6 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO16
-
-
@@ -141,36 +127,30 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
- Strapping pin
-
* - GPIO26
-
-
-
* - GPIO27
-
-
- Strapping pin
-
* - GPIO28
-
-
- Strapping pin
-
.. note::
- Strapping pin: GPIO2, GPIO7, GPIO25, GPIO27, and GPIO28 are strapping pins. For more information, please refer to `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
- SPI0/1: GPIO16 ~ GPIO22 are usually used for SPI flash and PSRAM, they're not recommended for other uses.
- USB-JTAG: GPIO13 and GPIO14 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO16 ~ GPIO22 are usually used for SPI flash and PSRAM, they're not recommended for other uses.
- USB-JTAG: GPIO13 and GPIO14 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
---

40
docs/en/api-reference/peripherals/gpio/esp32c6.inc
View File

@@ -26,62 +26,50 @@ The table below provides more information on pin usage, and please note the comm
- ADC1_CH0
- LP_GPIO0
-
* - GPIO1
- ADC1_CH1
- LP_GPIO1
-
* - GPIO2
- ADC1_CH2
- LP_GPIO2
-
* - GPIO3
- ADC1_CH3
- LP_GPIO3
-
* - GPIO4
- ADC1_CH4
- LP_GPIO4
- Strapping pin
-
* - GPIO5
- ADC1_CH5
- LP_GPIO5
- Strapping pin
-
* - GPIO6
- ADC1_CH6
- LP_GPIO6
-
* - GPIO7
-
- LP_GPIO7
-
* - GPIO8
-
-
- Strapping pin
-
* - GPIO9
-
-
- Strapping pin
-
* - GPIO10
-
-
-
* - GPIO11
-
-
-
* - GPIO12
-
-
@@ -96,52 +84,42 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO15
-
-
- Strapping pin
-
* - GPIO16
-
-
-
* - GPIO17
-
-
-
* - GPIO18
-
-
-
* - GPIO19
-
-
-
* - GPIO20
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
@@ -179,10 +157,10 @@ The table below provides more information on pin usage, and please note the comm
.. note::
- Strapping pin: GPIO4, GPIO5, GPIO8, GPIO9, and GPIO15 are strapping pins. For more information, please refer to `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
- SPI0/1: GPIO24 ~ GPIO30 are usually used for SPI flash and not recommended for other uses.
- USB-JTAG: GPIO12 and GPIO13 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- For chip variants with an SiP flash built in, GPIO24 ~ GPIO30 are dedicated to connecting the SiP flash; GPIO10 ~ GPIO11 are not led out to any chip pins; therefore, only the remaining 22 GPIO pins are available.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO24 ~ GPIO30 are usually used for SPI flash and not recommended for other uses.
- USB-JTAG: GPIO12 and GPIO13 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- For chip variants with an SiP flash built in, the SPI0/1 pins and GPIO10 ~ GPIO11 are not led out; therefore, only the remaining 22 GPIO pins are available.
- For chip variants without an in-package flash, GPIO14 is not led out to any chip pins.
---

27
docs/en/api-reference/peripherals/gpio/esp32c61.inc
View File

@@ -26,62 +26,50 @@ The table below provides more information on pin usage, and please note the comm
-
- LP_GPIO0
-
* - GPIO1
- ADC1_CH0
- LP_GPIO1
-
* - GPIO2
-
- LP_GPIO2
-
* - GPIO3
- ADC1_CH1
- LP_GPIO3
-
* - GPIO4
- ADC1_CH2
- LP_GPIO4
-
* - GPIO5
- ADC1_CH3
- LP_GPIO5
-
* - GPIO6
-
- LP_GPIO6
-
* - GPIO7
-
-
-
* - GPIO8
-
-
-
* - GPIO9
-
-
-
* - GPIO10
-
-
-
* - GPIO11
-
-
-
* - GPIO12
-
-
@@ -116,7 +104,6 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO19
-
-
@@ -136,46 +123,38 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
-
* - GPIO27
-
-
-
* - GPIO28
-
-
-
* - GPIO29
-
-
-
.. note::
- Some pins are used as strapping pins, which can be used to select in which boot mode to load the chip, etc.. The details can be found in `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_ > ``Strapping Pins``.
- SPI0/1: GPIO14 ~ GPIO17 and GPIO19 ~ GPIO21 are usually used for SPI flash and PSRAM, they're not recommended for other uses.
- USB-JTAG: GPIO12 and GPIO13 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO14 ~ GPIO17 and GPIO19 ~ GPIO21 are usually used for SPI flash and PSRAM, they're not recommended for other uses.
- USB-JTAG: GPIO12 and GPIO13 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
---

29
docs/en/api-reference/peripherals/gpio/esp32h2.inc
View File

@@ -24,42 +24,35 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO0
-
-
* - GPIO1
- ADC1_CH0
-
* - GPIO2
- ADC1_CH1
- Strapping pin
-
* - GPIO3
- ADC1_CH2
- Strapping pin
-
* - GPIO4
- ADC1_CH3
-
* - GPIO5
- ADC1_CH4
-
* - GPIO6
-
-
* - GPIO7
-
- RTC
* - GPIO8
-
- Strapping pin, RTC
- RTC
* - GPIO9
-
- Strapping pin, RTC
- RTC
* - GPIO10
- ANA_CMPR_CH0 reference voltage
@@ -112,19 +105,15 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO22
-
-
* - GPIO23
-
-
* - GPIO24
-
-
* - GPIO25
-
- Strapping pin
-
* - GPIO26
-
- USB-JTAG
@@ -135,10 +124,10 @@ The table below provides more information on pin usage, and please note the comm
.. note::
- Strapping pin: GPIO2, GPIO3, GPIO8, GPIO9, and GPIO25 are strapping pins. For more information, please refer to `ESP32H2 datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_.
- SPI0/1: GPIO15-21 are usually used for SPI flash and not recommended for other uses.
- USB-Serial-JTAG: GPIO 26 and 27 are used by USB-Serial-JTAG by default. In order to use them as GPIOs, USB-Serial-JTAG will be disabled by the drivers.
- For chip variants with an SiP flash built in, GPIO15–GPIO21 are dedicated to connecting the SiP flash and are not fan-out to the external pins. In addition, GPIO6–GPIO7 are also not fan-out to the external pins. In conclusion, only GPIO0–GPIO5, GPIO8–GPIO14, GPIO22–GPIO27 are available to users.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO15-21 are usually used for SPI flash and not recommended for other uses.
- USB-Serial-JTAG: GPIO 26 and 27 are used by USB-Serial-JTAG by default. In order to use them as GPIOs, USB-Serial-JTAG will be disabled by the drivers.
- For chip variants with an SiP flash built in, the SPI0/1 pins and GPIO6–GPIO7 are not led out. In conclusion, only GPIO0–GPIO5, GPIO8–GPIO14, GPIO22–GPIO27 are available to users.
- RTC: GPIO7–GPIO14 can be used to wake up the chip from Deep-sleep mode. Note that although GPIO7 is an RTC GPIO, it cannot be used for external wake-up since it is not led out. Other GPIOs can only wake up the chip from Light-sleep mode. For more information, please refer to Section :ref:`Wakeup Sources <api-reference-wakeup-source>`.
---

29
docs/en/api-reference/peripherals/gpio/esp32h21.inc
View File

@@ -26,87 +26,70 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO1
- ADC1_CH0
-
-
* - GPIO2
- ADC1_CH1
-
-
* - GPIO3
- ADC1_CH2
-
-
* - GPIO4
- ADC1_CH3
-
-
* - GPIO5
- ADC1_CH4
- LP_GPIO0
-
* - GPIO6
-
- LP_GPIO1
-
* - GPIO7
-
- LP_GPIO2
-
* - GPIO8
-
- LP_GPIO3
- Strapping pin
-
* - GPIO9
-
- LP_GPIO4
-
* - GPIO10
-
- LP_GPIO5
-
* - GPIO11
-
- LP_GPIO6
-
* - GPIO12
-
-
-
* - GPIO13
-
-
- Strapping pin
-
* - GPIO14
-
-
- Strapping pin
-
* - GPIO15
-
-
-
* - GPIO16
-
-
-
* - GPIO17
-
-
@@ -154,8 +137,8 @@ The table below provides more information on pin usage, and please note the comm
.. note::
- Strapping pin: GPIO8, GPIO13, and GPIO14 are strapping pins. For more information, please refer to `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
- SPI0/1: GPIO19 ~ GPIO25 are usually used for SPI flash and not recommended for other uses.
- USB-JTAG: GPIO17 and GPIO18 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO19 ~ GPIO25 are usually used for SPI flash and not recommended for other uses.
- USB-JTAG: GPIO17 and GPIO18 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
---

43
docs/en/api-reference/peripherals/gpio/esp32h4.inc
View File

@@ -26,32 +26,26 @@ The table below provides more information on pin usage, and please note the comm
-
- LP_GPIO0
-
* - GPIO1
-
- LP_GPIO1
-
* - GPIO2
-
- LP_GPIO2
-
* - GPIO3
-
- LP_GPIO3
-
* - GPIO4
-
- LP_GPIO4
-
* - GPIO5
-
- LP_GPIO5
-
* - GPIO6
-
-
@@ -101,131 +95,106 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO16
-
-
-
* - GPIO17
-
-
- Strapping pin
-
* - GPIO18
-
-
-
* - GPIO19
-
-
-
* - GPIO20
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
-
* - GPIO27
-
-
-
* - GPIO28
- ADC1_CH0
-
-
* - GPIO29
- ADC1_CH1
-
-
* - GPIO30
- ADC1_CH2
-
-
* - GPIO31
- ADC1_CH3
-
-
* - GPIO32
- ADC1_CH4
-
-
* - GPIO33
-
-
-
* - GPIO34
-
-
-
* - GPIO35
-
-
-
* - GPIO36
-
-
- Strapping pin
-
* - GPIO37
-
-
- Strapping pin
-
* - GPIO38
-
-
-
* - GPIO39
-
-
-
.. note::
- Strapping pin: GPIO17, GPIO36, and GPIO37 are strapping pins. For more information, please refer to `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
- SPI0/1: GPIO6 ~ GPIO12 are usually used for SPI flash and PSRAM. These pins are not recommended for other uses.
- USB-JTAG: GPIO13 and GPIO14 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO6 ~ GPIO12 are usually used for SPI flash and PSRAM. These pins are not recommended for other uses.
- USB-JTAG: GPIO13 and GPIO14 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
---

69
docs/en/api-reference/peripherals/gpio/esp32p4.inc
View File

@@ -26,280 +26,225 @@ The table below provides more information on pin usage, and please note the comm
-
- LP_GPIO0
-
* - GPIO1
-
- LP_GPIO1
-
* - GPIO2
- TOUCH0
- LP_GPIO2
-
* - GPIO3
- TOUCH1
- LP_GPIO3
-
* - GPIO4
- TOUCH2
- LP_GPIO4
-
* - GPIO5
- TOUCH3
- LP_GPIO5
-
* - GPIO6
- TOUCH4
- LP_GPIO6
-
* - GPIO7
- TOUCH5
- LP_GPIO7
-
* - GPIO8
- TOUCH6
- LP_GPIO8
-
* - GPIO9
- TOUCH7
- LP_GPIO9
-
* - GPIO10
- TOUCH8
- LP_GPIO10
-
* - GPIO11
- TOUCH9
- LP_GPIO11
-
* - GPIO12
- TOUCH10
- LP_GPIO12
-
* - GPIO13
- TOUCH11
- LP_GPIO13
-
* - GPIO14
- TOUCH12
- LP_GPIO14
-
* - GPIO15
- TOUCH13
- LP_GPIO15
-
* - GPIO16
- ADC1_CH0
-
-
* - GPIO17
- ADC1_CH1
-
-
* - GPIO18
- ADC1_CH2
-
-
* - GPIO19
- ADC1_CH3
-
-
* - GPIO20
- ADC1_CH4
-
-
* - GPIO21
- ADC1_CH5
-
-
* - GPIO22
- ADC1_CH6
-
-
* - GPIO23
- ADC1_CH7
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
-
* - GPIO27
-
-
-
* - GPIO28
-
-
-
* - GPIO29
-
-
-
* - GPIO30
-
-
-
* - GPIO31
-
-
-
* - GPIO32
-
-
-
* - GPIO33
-
-
-
* - GPIO34
-
-
- Strapping pin
-
* - GPIO35
-
-
- Strapping pin
-
* - GPIO36
-
-
- Strapping pin
-
* - GPIO37
-
-
- Strapping pin
-
* - GPIO38
-
-
- Strapping pin
-
* - GPIO39
-
-
-
* - GPIO40
-
-
-
* - GPIO41
-
-
-
* - GPIO42
-
-
-
* - GPIO43
-
-
-
* - GPIO44
-
-
-
* - GPIO45
-
-
-
* - GPIO46
-
-
-
* - GPIO47
-
-
-
* - GPIO48
-
-
-
* - GPIO49
- ADC2_CH0
-
-
* - GPIO50
- ADC2_CH1
-
-
* - GPIO51
- ADC2_CH2, ANA_CMPR_CH0 reference voltage
-
-
* - GPIO52
- ADC2_CH3, ANA_CMPR_CH0 input (non-inverting)
-
-
* - GPIO53
- ADC2_CH4, ANA_CMPR_CH1 reference voltage
-
-
* - GPIO54
- ADC2_CH5, ANA_CMPR_CH1 input (non-inverting)
-
-
.. note::
- Strapping pin: GPIO34, GPIO35, GPIO36, GPIO37, and GPIO38 are strapping pins. For more information, please refer to `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
- USB-JTAG: GPIO24 and GPIO25 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- USB-JTAG: GPIO24 and GPIO25 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.
---

39
docs/en/api-reference/peripherals/gpio/esp32s2.inc
View File

@@ -25,113 +25,91 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO0
-
- RTC_GPIO0
- Strapping pin
-
* - GPIO1
- ADC1_CH0
- RTC_GPIO1
-
* - GPIO2
- ADC1_CH1
- RTC_GPIO2
-
* - GPIO3
- ADC1_CH2
- RTC_GPIO3
-
* - GPIO4
- ADC1_CH3
- RTC_GPIO4
-
* - GPIO5
- ADC1_CH4
- RTC_GPIO5
-
* - GPIO6
- ADC1_CH5
- RTC_GPIO6
-
* - GPIO7
- ADC1_CH6
- RTC_GPIO7
-
* - GPIO8
- ADC1_CH7
- RTC_GPIO8
-
* - GPIO9
- ADC1_CH8
- RTC_GPIO9
-
* - GPIO10
- ADC1_CH9
- RTC_GPIO10
-
* - GPIO11
- ADC2_CH0
- RTC_GPIO11
-
* - GPIO12
- ADC2_CH1
- RTC_GPIO12
-
* - GPIO13
- ADC2_CH2
- RTC_GPIO13
-
* - GPIO14
- ADC2_CH3
- RTC_GPIO14
-
* - GPIO15
- ADC2_CH4
- RTC_GPIO15
-
* - GPIO16
- ADC2_CH5
- RTC_GPIO16
-
* - GPIO17
- ADC2_CH6
- RTC_GPIO17
-
* - GPIO18
- ADC2_CH7
- RTC_GPIO18
-
* - GPIO19
- ADC2_CH8
- RTC_GPIO19
-
* - GPIO20
- ADC2_CH9
- RTC_GPIO20
-
* - GPIO21
-
- RTC_GPIO21
-
* - GPIO26
-
-
@@ -171,32 +149,26 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO34
-
-
-
* - GPIO35
-
-
-
* - GPIO36
-
-
-
* - GPIO37
-
-
-
* - GPIO38
-
-
-
* - GPIO39
-
-
@@ -221,25 +193,22 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO44
-
-
-
* - GPIO45
-
-
- Strapping pin
-
* - GPIO46
-
-
- GPI；Strapping pin
- GPI
.. note::
- Strapping pin: GPIO0, GPIO45 and GPIO46 are strapping pins. For more information, please refer to `ESP32-S2 datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO26-32 are usually used for SPI flash and PSRAM and not recommended for other uses.
- JTAG: GPIO39-42 are usually used for inline debug.
- GPI: GPIO46 is fixed to pull-down and is input only.

41
docs/en/api-reference/peripherals/gpio/esp32s3.inc
View File

@@ -25,98 +25,79 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO0
-
- RTC_GPIO0
- Strapping pin
-
* - GPIO1
- ADC1_CH0
- RTC_GPIO1
-
* - GPIO2
- ADC1_CH1
- RTC_GPIO2
-
* - GPIO3
- ADC1_CH2
- RTC_GPIO3
- Strapping pin
-
* - GPIO4
- ADC1_CH3
- RTC_GPIO4
-
* - GPIO5
- ADC1_CH4
- RTC_GPIO5
-
* - GPIO6
- ADC1_CH5
- RTC_GPIO6
-
* - GPIO7
- ADC1_CH6
- RTC_GPIO7
-
* - GPIO8
- ADC1_CH7
- RTC_GPIO8
-
* - GPIO9
- ADC1_CH8
- RTC_GPIO9
-
* - GPIO10
- ADC1_CH9
- RTC_GPIO10
-
* - GPIO11
- ADC2_CH0
- RTC_GPIO11
-
* - GPIO12
- ADC2_CH1
- RTC_GPIO12
-
* - GPIO13
- ADC2_CH2
- RTC_GPIO13
-
* - GPIO14
- ADC2_CH3
- RTC_GPIO14
-
* - GPIO15
- ADC2_CH4
- RTC_GPIO15
-
* - GPIO16
- ADC2_CH5
- RTC_GPIO16
-
* - GPIO17
- ADC2_CH6
- RTC_GPIO17
-
* - GPIO18
- ADC2_CH7
- RTC_GPIO18
-
* - GPIO19
- ADC2_CH8
- RTC_GPIO19
@@ -131,7 +112,6 @@ The table below provides more information on pin usage, and please note the comm
-
- RTC_GPIO21
-
* - GPIO26
-
-
@@ -196,60 +176,49 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO39
-
-
-
* - GPIO40
-
-
-
* - GPIO41
-
-
-
* - GPIO42
-
-
-
* - GPIO43
-
-
-
* - GPIO44
-
-
-
* - GPIO45
-
-
- Strapping pin
-
* - GPIO46
-
-
- Strapping pin
-
* - GPIO47
-
-
-
* - GPIO48
-
-
-
.. Note::
- Strapping pin: GPIO0, GPIO3, GPIO45 and GPIO46 are strapping pins. For more information, please refer to `ESP32-S3 datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO26 ~ GPIO32 are usually used for SPI flash and PSRAM and not recommended for other uses. When using Octal flash or Octal PSRAM or both, GPIO33 ~ GPIO37 are connected to SPIIO4 ~ SPIIO7 and SPIDQS. Therefore, on boards embedded with ESP32-S3R8 / ESP32-S3R8V chip, GPIO33 ~ GPIO37 are also not recommended for other uses.
- USB-JTAG: GPIO19 and GPIO20 are used by USB-JTAG by default. If they are reconfigured to operate as normal GPIOs, USB-JTAG functionality will be disabled.

68
docs/en/api-reference/peripherals/gpio/esp32s31.inc
View File

@@ -26,132 +26,106 @@ The table below provides more information on pin usage, and please note the comm
-
- LP_GPIO0
-
* - GPIO1
-
- LP_GPIO1
-
* - GPIO2
-
- LP_GPIO2
-
* - GPIO3
-
- LP_GPIO3
-
* - GPIO4
- DAC0
- LP_GPIO4
-
* - GPIO5
- DAC1
- LP_GPIO5
-
* - GPIO6
- TOUCH0
- LP_GPIO6
-
* - GPIO7
- TOUCH1
- LP_GPIO7
-
* - GPIO8
- TOUCH2
-
-
* - GPIO9
- TOUCH3
-
-
* - GPIO10
- TOUCH4
-
-
* - GPIO11
- TOUCH5
-
-
* - GPIO12
- TOUCH6
-
-
* - GPIO13
- TOUCH7
-
-
* - GPIO14
- TOUCH8
-
-
* - GPIO15
- TOUCH9
-
-
* - GPIO16
- TOUCH10
-
-
* - GPIO17
- TOUCH11
-
-
* - GPIO18
- TOUCH12
-
-
* - GPIO19
- TOUCH13
-
-
* - GPIO20
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
@@ -186,122 +160,98 @@ The table below provides more information on pin usage, and please note the comm
-
-
-
* - GPIO34
-
-
-
* - GPIO35
-
-
-
* - GPIO36
-
-
- Strapping pin
-
* - GPIO37
-
-
- Strapping pin
-
* - GPIO38
-
-
- Strapping pin
-
* - GPIO39
-
-
- Strapping pin
-
* - GPIO40
-
-
- Strapping pin
-
* - GPIO42
- ADC1_CH0_N
-
-
* - GPIO43
- ADC1_CH0_P
-
-
* - GPIO44
- ADC1_CH1_N
-
-
* - GPIO45
- ADC1_CH1_P
-
-
* - GPIO46
- ADC1_CH2_N
-
-
* - GPIO47
- ADC1_CH2_P
-
-
* - GPIO48
- ADC1_CH3_N
-
-
* - GPIO49
- ADC1_CH3_P
-
-
* - GPIO50
- ADC2_CH0_N
-
-
* - GPIO51
- ADC2_CH0_P
-
-
* - GPIO52
- ADC2_CH1_N
-
-
* - GPIO53
- ADC2_CH1_P
-
-
* - GPIO54
- ADC2_CH2_N
-
-
* - GPIO55
- ADC2_CH2_P
-
-
* - GPIO56
- ADC2_CH3_N
-
-
* - GPIO57
- ADC2_CH3_P
-
-
* - GPIO58
-
-
@@ -315,16 +265,14 @@ The table below provides more information on pin usage, and please note the comm
* - GPIO60
-
-
- Strapping pin
-
* - GPIO61
-
-
- Strapping pin
-
.. note::
- Strapping pin: GPIO36 ~ GPIO40, GPIO60 ~ GPIO61 are strapping pins. For more information, please refer to `{IDF_TARGET_NAME} datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`_.
- Strapping pin: Some pins are used as strapping pins. For more information, please refer to *{IDF_TARGET_NAME} datasheet* > *Boot Configurations* [`PDF <{IDF_TARGET_DATASHEET_EN_URL}#cd-pins-strap>`__].
- SPI0/1: GPIO26 ~ GPIO32 are usually used for SPI flash, they're not recommended for other uses.
---

26
docs/zh_CN/api-reference/peripherals/gpio/esp32.inc
View File

@@ -25,8 +25,7 @@
* - GPIO0
- ADC2_CH1
- RTC_GPIO11
- Strapping 管脚
-
* - GPIO1
-
-
@@ -35,8 +34,7 @@
* - GPIO2
- ADC2_CH2
- RTC_GPIO12
- Strapping 管脚
-
* - GPIO3
-
-
@@ -46,12 +44,10 @@
- ADC2_CH0
- RTC_GPIO10
-
* - GPIO5
-
-
- Strapping 管脚
-
* - GPIO6
-
-
@@ -85,7 +81,7 @@
* - GPIO12
- ADC2_CH5
- RTC_GPIO15
- Strapping 管脚；JTAG
- JTAG
* - GPIO13
- ADC2_CH4
@@ -100,7 +96,7 @@
* - GPIO15
- ADC2_CH3
- RTC_GPIO13
- Strapping 管脚；JTAG
- JTAG
* - GPIO16
-
@@ -116,52 +112,42 @@
-
-
-
* - GPIO19
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO25
- ADC2_CH8
- RTC_GPIO6
-
* - GPIO26
- ADC2_CH9
- RTC_GPIO7
-
* - GPIO27
- ADC2_CH7
- RTC_GPIO17
-
* - GPIO32
- ADC1_CH4
- RTC_GPIO9
-
* - GPIO33
- ADC1_CH5
- RTC_GPIO8
-
* - GPIO34
- ADC1_CH6
- RTC_GPIO4
@@ -194,7 +180,7 @@
.. note::
- Strapping 管脚：GPIO0、GPIO2、GPIO5、GPIO12 (MTDI) 和 GPIO15 (MTDO) 是 Strapping 管脚。更多信息请参考 `ESP32 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO6-11 和 GPIO16-17 通常连接到模组内集成的 SPI flash 和 PSRAM，因此不能用于其他用途。
- JTAG：GPIO12-15 通常用于在线调试。
- GPI：GPIO34-39 只能设置为输入模式，不具备软件使能的上拉或下拉功能。

17
docs/zh_CN/api-reference/peripherals/gpio/esp32c2.inc
View File

@@ -9,7 +9,7 @@
.. gpio-summary
{IDF_TARGET_NAME} 芯片具有 21 个物理 GPIO 管脚（GPIO0 ~ GPIO20）。对于内置 SiP flash 的芯片型号，GPIO11 ~ GPIO17 专门用于连接 SiP flash。因此，对于这类芯片只有 14 个 GPIO 管脚可用。
{IDF_TARGET_NAME} 芯片具有 21 个物理 GPIO 管脚（GPIO0 ~ GPIO20）。对于内置 SiP flash 的芯片型号，GPIO11 ~ GPIO17 未引出至芯片管脚。因此，对于这类芯片只有 14 个 GPIO 管脚可用。
每个管脚都可用作一个通用 IO，或连接一个内部的外设 信号。通过 GPIO 交换矩阵和 IO MUX，可配置外设模块的输入信号来源于任何的 IO 管脚，并且外设模块的输 出信号也可连接到任意 IO 管脚。这些模块共同组成了芯片的 IO 控制。更多详细信息，请参阅 *{IDF_TARGET_NAME} 技术参考手册* > *IO MUX 和 GPIO 矩阵（GPIO、IO_MUX）* [`PDF <{IDF_TARGET_TRM_CN_URL}#iomuxgpio>`__]。
@@ -50,27 +50,21 @@
* - GPIO6
-
-
* - GPIO7
-
-
* - GPIO8
-
- Strapping 管脚
-
* - GPIO9
-
- Strapping 管脚
-
* - GPIO10
-
-
* - GPIO11
-
-
* - GPIO12
-
- SPI0/1
@@ -98,18 +92,15 @@
* - GPIO18
-
-
* - GPIO19
-
-
* - GPIO20
-
-
.. note::
- Strapping 管脚：GPIO8 和 GPIO9 是 Strapping 管脚。更多信息请参考 `ESP8684 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO12-17 通常用于 SPI flash，不推荐用于其他用途。
- RTC：GPIO0-5 可用于将芯片从 Deep-sleep 模式中唤醒，其他 GPIO 仅能将芯片从 Light-sleep 模式中唤醒。更多信息请参考 :ref:`唤醒源<api-reference-wakeup-source>` 章节。

16
docs/zh_CN/api-reference/peripherals/gpio/esp32c3.inc
View File

@@ -31,7 +31,7 @@
* - GPIO2
- ADC1_CH2
- Strapping 管脚；RTC
- RTC
* - GPIO3
- ADC1_CH3
@@ -48,27 +48,21 @@
* - GPIO6
-
-
* - GPIO7
-
-
* - GPIO8
-
- Strapping 管脚
-
* - GPIO9
-
- Strapping 管脚
-
* - GPIO10
-
-
* - GPIO11
-
-
* - GPIO12
-
- SPI0/1
@@ -104,14 +98,12 @@
* - GPIO20
-
-
* - GPIO21
-
-
.. note::
- Strapping 管脚：GPIO2、GPIO8、和 GPIO9 是 Strapping 管脚。更多信息请参考 `ESP32-C3 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO12 ~ GPIO17 通常用于 SPI flash，不推荐用于其他用途。
- USB-JTAG：GPIO18 和 GPIO19 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。
- RTC：GPIO0 ~ GPIO5 可用于将芯片从 Deep-sleep 模式中唤醒，其他 GPIO 仅能将芯片从 Light-sleep 模式中唤醒。更多信息请参考 :ref:`唤醒源<api-reference-wakeup-source>` 章节。

32
docs/zh_CN/api-reference/peripherals/gpio/esp32c5.inc
View File

@@ -26,67 +26,54 @@
-
- LP_GPIO0
-
* - GPIO1
- ADC1_CH0
- LP_GPIO1
-
* - GPIO2
- ADC1_CH1
- LP_GPIO2
- Strapping 管脚
-
* - GPIO3
- ADC1_CH2
- LP_GPIO3
-
* - GPIO4
- ADC1_CH3
- LP_GPIO4
-
* - GPIO5
- ADC1_CH4
- LP_GPIO5
-
* - GPIO6
- ADC1_CH5
- LP_GPIO6
-
* - GPIO7
-
-
- Strapping 管脚
-
* - GPIO8
-
-
-
* - GPIO9
-
-
-
* - GPIO10
-
-
-
* - GPIO11
-
-
-
* - GPIO12
-
-
-
* - GPIO13
-
-
@@ -101,7 +88,6 @@
-
-
-
* - GPIO16
-
-
@@ -141,35 +127,29 @@
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
- Strapping 管脚
-
* - GPIO26
-
-
-
* - GPIO27
-
-
- Strapping 管脚
-
* - GPIO28
-
-
- Strapping 管脚
-
.. note::
- Strapping 管脚：GPIO2、GPIO7、GPIO25、GPIO27 和 GPIO28 是 Strapping 管脚。更多信息请参考 `ESP32-C5 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO16 ~ GPIO22 通常用于 SPI flash 和 PSRAM，不推荐用于其他用途。
- USB-JTAG：GPIO13 和 GPIO14 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。

36
docs/zh_CN/api-reference/peripherals/gpio/esp32c6.inc
View File

@@ -26,62 +26,50 @@
- ADC1_CH0
- LP_GPIO0
-
* - GPIO1
- ADC1_CH1
- LP_GPIO1
-
* - GPIO2
- ADC1_CH2
- LP_GPIO2
-
* - GPIO3
- ADC1_CH3
- LP_GPIO3
-
* - GPIO4
- ADC1_CH4
- LP_GPIO4
- Strapping 管脚
-
* - GPIO5
- ADC1_CH5
- LP_GPIO5
- Strapping 管脚
-
* - GPIO6
- ADC1_CH6
- LP_GPIO6
-
* - GPIO7
-
- LP_GPIO7
-
* - GPIO8
-
-
- Strapping 管脚
-
* - GPIO9
-
-
- Strapping 管脚
-
* - GPIO10
-
-
-
* - GPIO11
-
-
-
* - GPIO12
-
-
@@ -96,52 +84,42 @@
-
-
-
* - GPIO15
-
-
- Strapping 管脚
-
* - GPIO16
-
-
-
* - GPIO17
-
-
-
* - GPIO18
-
-
-
* - GPIO19
-
-
-
* - GPIO20
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
@@ -179,10 +157,10 @@
.. note::
- Strapping 管脚：GPIO4、GPIO5、GPIO8、GPIO9 和 GPIO15 是 Strapping 管脚。更多信息请参考 `ESP32-C6 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO24 ～ GPIO30 通常用于 SPI flash，不推荐用于其他用途。
- USB-JTAG：GPIO12 和 GPIO13 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。
- 对于内置 SiP flash 的芯片型号，GPIO24 ~ GPIO30 专门用于连接 SiP flash; 且 GPIO10 ~ GPIO11 未引出至芯片管脚。因此，对于这类芯片只有 22 个 GPIO 管脚可用。
- 对于内置 SiP flash 的芯片型号，SPI0/1 管脚以及 GPIO10 ~ GPIO11 未引出至芯片管脚。因此，对于这类芯片只有 22 个 GPIO 管脚可用。
- 对于无内置 SiP flash 的芯片型号，则 GPIO14 未引出至芯片管脚。
---

23
docs/zh_CN/api-reference/peripherals/gpio/esp32c61.inc
View File

@@ -26,62 +26,50 @@
-
- LP_GPIO0
-
* - GPIO1
- ADC1_CH0
- LP_GPIO1
-
* - GPIO2
-
- LP_GPIO2
-
* - GPIO3
- ADC1_CH1
- LP_GPIO3
-
* - GPIO4
- ADC1_CH2
- LP_GPIO4
-
* - GPIO5
- ADC1_CH3
- LP_GPIO5
-
* - GPIO6
- ADC1_CH5
- LP_GPIO6
-
* - GPIO7
-
-
-
* - GPIO8
-
-
-
* - GPIO9
-
-
-
* - GPIO10
-
-
-
* - GPIO11
-
-
-
* - GPIO12
-
-
@@ -116,7 +104,6 @@
-
-
-
* - GPIO19
-
-
@@ -136,45 +123,37 @@
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
-
* - GPIO27
-
-
-
* - GPIO28
-
-
-
* - GPIO29
-
-
-
.. note::
- 其中一些管脚被用作 Strapping 管脚，可用于选择加载芯片的启动模式等。详细信息请见 `ESP32-C61 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_ > ``Strapping 管脚``。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO14 ~ GPIO17 和 GPIO19 ~ GPIO21 通常用于 SPI flash 和 PSRAM，不推荐用于其他用途。
- USB-JTAG：GPIO12 和 GPIO13 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。

29
docs/zh_CN/api-reference/peripherals/gpio/esp32h2.inc
View File

@@ -9,9 +9,7 @@
.. gpio-summary
{IDF_TARGET_NAME} 芯片具有 28 个物理 GPIO 管脚（GPIO0 ~ GPIO27）。
每个管脚都可用作一个通用 IO，或连接一个内部的外设信号。通过 GPIO 交换矩阵和 IO MUX，可配置外设模块的输入信号来源于任何的 IO 管脚，并且外设模块的输出信号也可连接到任意 IO 管脚。这些模块共同组成了芯片的 IO 控制。更多详细信息，请参阅 *{IDF_TARGET_NAME} 技术参考手册* > *IO MUX 和 GPIO 矩阵（GPIO、IO_MUX）* [`PDF <{IDF_TARGET_TRM_CN_URL}#iomuxgpio>`__]。
{IDF_TARGET_NAME} 芯片具有 28 个物理 GPIO 管脚（GPIO0 ~ GPIO27）。每个管脚都可用作一个通用 IO，或连接一个内部的外设信号。通过 GPIO 交换矩阵和 IO MUX，可配置外设模块的输入信号来源于任何的 IO 管脚，并且外设模块的输出信号也可连接到任意 IO 管脚。这些模块共同组成了芯片的 IO 控制。更多详细信息，请参阅 *{IDF_TARGET_NAME} 技术参考手册* > *IO MUX 和 GPIO 矩阵（GPIO、IO_MUX）* [`PDF <{IDF_TARGET_TRM_CN_URL}#iomuxgpio>`__]。
下表提供了各管脚的详细信息，部分 GPIO 具有特殊的使用限制，具体可参考表中的注释列。
@@ -26,42 +24,35 @@
* - GPIO0
-
-
* - GPIO1
- ADC1_CH0
-
* - GPIO2
- ADC1_CH1
- Strapping 管脚
-
* - GPIO3
- ADC1_CH2
- Strapping 管脚
-
* - GPIO4
- ADC1_CH3
-
* - GPIO5
- ADC1_CH4
-
* - GPIO6
-
-
* - GPIO7
-
- RTC
* - GPIO8
-
- Strapping 管脚，RTC
- RTC
* - GPIO9
-
- Strapping 管脚，RTC
- RTC
* - GPIO10
- ANA_CMPR_CH0 外部参考电压
@@ -114,19 +105,15 @@
* - GPIO22
-
-
* - GPIO23
-
-
* - GPIO24
-
-
* - GPIO25
-
- Strapping 管脚
-
* - GPIO26
-
- USB-JTAG
@@ -137,10 +124,10 @@
.. note::
- Strapping 管脚： GPIO2、GPIO3、GPIO8、GPIO9 和 GPIO25 是 Strapping 管脚。更多信息请参考 `ESP32-H2 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1: GPIO15-21 通常用于 SPI flash, 不推荐用于其他用途。
- USB-Serial-JTAG: GPIO26 和 GPIO27 默认用于 USB-Serial-JTAG。用做 GPIO 时驱动程序将禁用 USB-Serial-JTAG。
- 对于合封了 flash 的芯片型号， GPIO15–GPIO21 专门用于连接该 flash, 并未引出至芯片管脚。且 GPIO6–GPIO7 也未引出至芯片管脚，用户不可用。用户可配置使用其他剩余的 19 个 GPIO 管脚, 编号为: GPIO0–GPIO5、GPIO8–GPIO14、GPIO22–GPIO27。
- 对于合封了 flash 的芯片型号，SPI0/1 管脚以及 GPIO6–GPIO7 未引出至芯片管脚。用户可配置使用其他剩余的 19 个 GPIO 管脚, 编号为: GPIO0–GPIO5、GPIO8–GPIO14、GPIO22–GPIO27。
- RTC：GPIO7–GPIO14 可用于将芯片从 Deep-sleep 模式中唤。请注意，虽然 GPIO7 是一个 RTC GPIO，但由于未引出，无法用于外部唤醒。其他 GPIO 仅能将芯片从 Light-sleep 模式中唤醒。更多信息请参考 :ref:`唤醒源 <api-reference-wakeup-source>` 章节。
---

25
docs/zh_CN/api-reference/peripherals/gpio/esp32h21.inc
View File

@@ -26,87 +26,70 @@
-
-
-
* - GPIO1
- ADC1_CH0
-
-
* - GPIO2
- ADC1_CH1
-
-
* - GPIO3
- ADC1_CH2
-
-
* - GPIO4
- ADC1_CH3
-
-
* - GPIO5
- ADC1_CH4
- LP_GPIO0
-
* - GPIO6
-
- LP_GPIO1
-
* - GPIO7
-
- LP_GPIO2
-
* - GPIO8
-
- LP_GPIO3
- Strapping 管脚
-
* - GPIO9
-
- LP_GPIO4
-
* - GPIO10
-
- LP_GPIO5
-
* - GPIO11
-
- LP_GPIO6
-
* - GPIO12
-
-
-
* - GPIO13
-
-
- Strapping 管脚
-
* - GPIO14
-
-
- Strapping 管脚
-
* - GPIO15
-
-
-
* - GPIO16
-
-
-
* - GPIO17
-
-
@@ -154,7 +137,7 @@
.. note::
- Strapping 管脚：GPIO8、GPIO13 和 GPIO14 是 Strapping 管脚。更多信息请参考 `ESP32-H21 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO19 ~ GPIO25 通常用于 SPI flash，不推荐用于其他用途。
- USB-JTAG：GPIO17 和 GPIO18 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。

39
docs/zh_CN/api-reference/peripherals/gpio/esp32h4.inc
View File

@@ -26,32 +26,26 @@
-
- LP_GPIO0
-
* - GPIO1
-
- LP_GPIO1
-
* - GPIO2
-
- LP_GPIO2
-
* - GPIO3
-
- LP_GPIO3
-
* - GPIO4
-
- LP_GPIO4
-
* - GPIO5
-
- LP_GPIO5
-
* - GPIO6
-
-
@@ -101,130 +95,105 @@
-
-
-
* - GPIO16
-
-
-
* - GPIO17
-
-
- Strapping 管脚
-
* - GPIO18
-
-
-
* - GPIO19
-
-
-
* - GPIO20
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
-
* - GPIO27
-
-
-
* - GPIO28
- ADC1_CH0
-
-
* - GPIO29
- ADC1_CH1
-
-
* - GPIO30
- ADC1_CH2
-
-
* - GPIO31
- ADC1_CH3
-
-
* - GPIO32
- ADC1_CH4
-
-
* - GPIO33
-
-
-
* - GPIO34
-
-
-
* - GPIO35
-
-
-
* - GPIO36
-
-
- Strapping 管脚
-
* - GPIO37
-
-
- Strapping 管脚
-
* - GPIO38
-
-
-
* - GPIO39
-
-
-
.. note::
- Strapping 管脚：GPIO17、GPIO36 和 GPIO37 是 Strapping 管脚。更多信息请参考 `{IDF_TARGET_NAME} 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO6 ~ GPIO12 通常用于 SPI flash 和 PSRAM，不推荐用于其他用途。
- USB-JTAG：GPIO13 和 GPIO14 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。

67
docs/zh_CN/api-reference/peripherals/gpio/esp32p4.inc
View File

@@ -26,280 +26,225 @@
-
- LP_GPIO0
-
* - GPIO1
-
- LP_GPIO1
-
* - GPIO2
- TOUCH0
- LP_GPIO2
-
* - GPIO3
- TOUCH1
- LP_GPIO3
-
* - GPIO4
- TOUCH2
- LP_GPIO4
-
* - GPIO5
- TOUCH3
- LP_GPIO5
-
* - GPIO6
- TOUCH4
- LP_GPIO6
-
* - GPIO7
- TOUCH5
- LP_GPIO7
-
* - GPIO8
- TOUCH6
- LP_GPIO8
-
* - GPIO9
- TOUCH7
- LP_GPIO9
-
* - GPIO10
- TOUCH8
- LP_GPIO10
-
* - GPIO11
- TOUCH9
- LP_GPIO11
-
* - GPIO12
- TOUCH10
- LP_GPIO12
-
* - GPIO13
- TOUCH11
- LP_GPIO13
-
* - GPIO14
- TOUCH12
- LP_GPIO14
-
* - GPIO15
- TOUCH13
- LP_GPIO15
-
* - GPIO16
- ADC1_CH0
-
-
* - GPIO17
- ADC1_CH1
-
-
* - GPIO18
- ADC1_CH2
-
-
* - GPIO19
- ADC1_CH3
-
-
* - GPIO20
- ADC1_CH4
-
-
* - GPIO21
- ADC1_CH5
-
-
* - GPIO22
- ADC1_CH6
-
-
* - GPIO23
- ADC1_CH7
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
-
* - GPIO27
-
-
-
* - GPIO28
-
-
-
* - GPIO29
-
-
-
* - GPIO30
-
-
-
* - GPIO31
-
-
-
* - GPIO32
-
-
-
* - GPIO33
-
-
-
* - GPIO34
-
-
- Strapping 管脚
-
* - GPIO35
-
-
- Strapping 管脚
-
* - GPIO36
-
-
- Strapping 管脚
-
* - GPIO37
-
-
- Strapping 管脚
-
* - GPIO38
-
-
- Strapping 管脚
-
* - GPIO39
-
-
-
* - GPIO40
-
-
-
* - GPIO41
-
-
-
* - GPIO42
-
-
-
* - GPIO43
-
-
-
* - GPIO44
-
-
-
* - GPIO45
-
-
-
* - GPIO46
-
-
-
* - GPIO47
-
-
-
* - GPIO48
-
-
-
* - GPIO49
- ADC2_CH0
-
-
* - GPIO50
- ADC2_CH1
-
-
* - GPIO51
- ADC2_CH2，ANA_CMPR_CH0 外部参考电压
-
-
* - GPIO52
- ADC2_CH3，ANA_CMPR_CH0 同相输入
-
-
* - GPIO53
- ADC2_CH4，ANA_CMPR_CH1 外部参考电压
-
-
* - GPIO54
- ADC2_CH5，ANA_CMPR_CH1 同相输入
-
-
.. note::
- Strapping 管脚：GPIO34, GPIO35、GPIO36、GPIO37 和 GPIO38 是 Strapping 管脚。更多信息请参考 `ESP32-P4 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- USB-JTAG：GPIO24 和 GPIO25 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。
---

39
docs/zh_CN/api-reference/peripherals/gpio/esp32s2.inc
View File

@@ -25,113 +25,91 @@
* - GPIO0
-
- RTC_GPIO0
- Strapping 管脚
-
* - GPIO1
- ADC1_CH0
- RTC_GPIO1
-
* - GPIO2
- ADC1_CH1
- RTC_GPIO2
-
* - GPIO3
- ADC1_CH2
- RTC_GPIO3
-
* - GPIO4
- ADC1_CH3
- RTC_GPIO4
-
* - GPIO5
- ADC1_CH4
- RTC_GPIO5
-
* - GPIO6
- ADC1_CH5
- RTC_GPIO6
-
* - GPIO7
- ADC1_CH6
- RTC_GPIO7
-
* - GPIO8
- ADC1_CH7
- RTC_GPIO8
-
* - GPIO9
- ADC1_CH8
- RTC_GPIO9
-
* - GPIO10
- ADC1_CH9
- RTC_GPIO10
-
* - GPIO11
- ADC2_CH0
- RTC_GPIO11
-
* - GPIO12
- ADC2_CH1
- RTC_GPIO12
-
* - GPIO13
- ADC2_CH2
- RTC_GPIO13
-
* - GPIO14
- ADC2_CH3
- RTC_GPIO14
-
* - GPIO15
- ADC2_CH4
- RTC_GPIO15
-
* - GPIO16
- ADC2_CH5
- RTC_GPIO16
-
* - GPIO17
- ADC2_CH6
- RTC_GPIO17
-
* - GPIO18
- ADC2_CH7
- RTC_GPIO18
-
* - GPIO19
- ADC2_CH8
- RTC_GPIO19
-
* - GPIO20
- ADC2_CH9
- RTC_GPIO20
-
* - GPIO21
-
- RTC_GPIO21
-
* - GPIO26
-
-
@@ -171,32 +149,26 @@
-
-
-
* - GPIO34
-
-
-
* - GPIO35
-
-
-
* - GPIO36
-
-
-
* - GPIO37
-
-
-
* - GPIO38
-
-
-
* - GPIO39
-
-
@@ -221,25 +193,22 @@
-
-
-
* - GPIO44
-
-
-
* - GPIO45
-
-
- Strapping 管脚
-
* - GPIO46
-
-
- GPI；Strapping 管脚
- GPI
.. note::
- Strapping 管脚：GPIO0、GPIO45、和 GPIO46 是 Strapping 管脚。更多信息请参考 `ESP32-S2 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO26-32 通常用于 SPI flash 和 PSRAM，不推荐用于其他用途。
- JTAG：GPIO39-42 通常用于在线调试。
- GPI：GPIO46 固定为下拉，只能设置为输入模式。

41
docs/zh_CN/api-reference/peripherals/gpio/esp32s3.inc
View File

@@ -25,98 +25,79 @@
* - GPIO0
-
- RTC_GPIO0
- Strapping 管脚
-
* - GPIO1
- ADC1_CH0
- RTC_GPIO1
-
* - GPIO2
- ADC1_CH1
- RTC_GPIO2
-
* - GPIO3
- ADC1_CH2
- RTC_GPIO3
- Strapping 管脚
-
* - GPIO4
- ADC1_CH3
- RTC_GPIO4
-
* - GPIO5
- ADC1_CH4
- RTC_GPIO5
-
* - GPIO6
- ADC1_CH5
- RTC_GPIO6
-
* - GPIO7
- ADC1_CH6
- RTC_GPIO7
-
* - GPIO8
- ADC1_CH7
- RTC_GPIO8
-
* - GPIO9
- ADC1_CH8
- RTC_GPIO9
-
* - GPIO10
- ADC1_CH9
- RTC_GPIO10
-
* - GPIO11
- ADC2_CH0
- RTC_GPIO11
-
* - GPIO12
- ADC2_CH1
- RTC_GPIO12
-
* - GPIO13
- ADC2_CH2
- RTC_GPIO13
-
* - GPIO14
- ADC2_CH3
- RTC_GPIO14
-
* - GPIO15
- ADC2_CH4
- RTC_GPIO15
-
* - GPIO16
- ADC2_CH5
- RTC_GPIO16
-
* - GPIO17
- ADC2_CH6
- RTC_GPIO17
-
* - GPIO18
- ADC2_CH7
- RTC_GPIO18
-
* - GPIO19
- ADC2_CH8
- RTC_GPIO19
@@ -131,7 +112,6 @@
-
- RTC_GPIO21
-
* - GPIO26
-
-
@@ -196,60 +176,49 @@
-
-
-
* - GPIO39
-
-
-
* - GPIO40
-
-
-
* - GPIO41
-
-
-
* - GPIO42
-
-
-
* - GPIO43
-
-
-
* - GPIO44
-
-
-
* - GPIO45
-
-
- Strapping 管脚
-
* - GPIO46
-
-
- Strapping 管脚
-
* - GPIO47
-
-
-
* - GPIO48
-
-
-
.. Note::
- Strapping 管脚：GPIO0、GPIO3、GPIO45 和 GPIO46 是 Strapping 管脚。更多信息请参考 `ESP32-S3 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO26 ~ GPIO32 通常用于 SPI flash 和 PSRAM，不推荐用于其他用途。当使用八线 flash 或八线 PSRAM 或同时使用两者时，GPIO33 ~ GPIO37 会连接到 SPIIO4 ~ SPIIO7 和 SPIDQS。因此，对于内嵌 ESP32-S3R8 或 ESP32-S3R8V 芯片的开发板，GPIO33 ~ GPIO37 也不推荐用于其他用途。
- USB-JTAG：GPIO19 和 GPIO20 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。

68
docs/zh_CN/api-reference/peripherals/gpio/esp32s31.inc
View File

@@ -26,132 +26,106 @@
-
- LP_GPIO0
-
* - GPIO1
-
- LP_GPIO1
-
* - GPIO2
-
- LP_GPIO2
-
* - GPIO3
-
- LP_GPIO3
-
* - GPIO4
- DAC0
- LP_GPIO4
-
* - GPIO5
- DAC1
- LP_GPIO5
-
* - GPIO6
- TOUCH0
- LP_GPIO6
-
* - GPIO7
- TOUCH1
- LP_GPIO7
-
* - GPIO8
- TOUCH2
-
-
* - GPIO9
- TOUCH3
-
-
* - GPIO10
- TOUCH4
-
-
* - GPIO11
- TOUCH5
-
-
* - GPIO12
- TOUCH6
-
-
* - GPIO13
- TOUCH7
-
-
* - GPIO14
- TOUCH8
-
-
* - GPIO15
- TOUCH9
-
-
* - GPIO16
- TOUCH10
-
-
* - GPIO17
- TOUCH11
-
-
* - GPIO18
- TOUCH12
-
-
* - GPIO19
- TOUCH13
-
-
* - GPIO20
-
-
-
* - GPIO21
-
-
-
* - GPIO22
-
-
-
* - GPIO23
-
-
-
* - GPIO24
-
-
-
* - GPIO25
-
-
-
* - GPIO26
-
-
@@ -186,122 +160,98 @@
-
-
-
* - GPIO34
-
-
-
* - GPIO35
-
-
-
* - GPIO36
-
-
- Strapping 管脚
-
* - GPIO37
-
-
- Strapping 管脚
-
* - GPIO38
-
-
- Strapping 管脚
-
* - GPIO39
-
-
- Strapping 管脚
-
* - GPIO40
-
-
- Strapping 管脚
-
* - GPIO42
- ADC1_CH0_N
-
-
* - GPIO43
- ADC1_CH0_P
-
-
* - GPIO44
- ADC1_CH1_N
-
-
* - GPIO45
- ADC1_CH1_P
-
-
* - GPIO46
- ADC1_CH2_N
-
-
* - GPIO47
- ADC1_CH2_P
-
-
* - GPIO48
- ADC1_CH3_N
-
-
* - GPIO49
- ADC1_CH3_P
-
-
* - GPIO50
- ADC2_CH0_N
-
-
* - GPIO51
- ADC2_CH0_P
-
-
* - GPIO52
- ADC2_CH1_N
-
-
* - GPIO53
- ADC2_CH1_P
-
-
* - GPIO54
- ADC2_CH2_N
-
-
* - GPIO55
- ADC2_CH2_P
-
-
* - GPIO56
- ADC2_CH3_N
-
-
* - GPIO57
- ADC2_CH3_P
-
-
* - GPIO58
-
-
@@ -315,16 +265,14 @@
* - GPIO60
-
-
- Strapping 管脚
-
* - GPIO61
-
-
- Strapping 管脚
-
.. note::
- Strapping 管脚：GPIO36 ~ GPIO40、GPIO60 ~ GPIO61 是 Strapping 管脚。更多信息请参考 `{IDF_TARGET_NAME} 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
- Strapping 管脚：部分管脚被用作 Strapping 管脚。更多信息请参阅 *{IDF_TARGET_NAME} 技术规格书* > *启动配置项* [`PDF <{IDF_TARGET_DATASHEET_CN_URL}#cd-pins-strap>`__]。
- SPI0/1：GPIO26 ~ GPIO32 通常用于 SPI flash，不推荐用于其他用途。
---