gpio: Add support for esp32h2

2025-08-10 04:43:33 +00:00 · 2023-01-10 18:22:19 +08:00
parent dcf3fcaec6
commit 4c8fdc31f9
26 changed files with 556 additions and 299 deletions
--- a/docs/en/api-reference/peripherals/gpio/esp32h2.inc
+++ b/docs/en/api-reference/peripherals/gpio/esp32h2.inc
@@ -9,22 +9,135 @@

 .. gpio-summary

-The {IDF_TARGET_NAME} chip features X physical GPIO pins (GPIOX ~ GPIOX). 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>`__].
+The {IDF_TARGET_NAME} chip features 28 physical GPIO pins (GPIO0 ~ GPIO27). 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>`__].

 The table below provides more information on pin usage, and please note the comments in the table for GPIOs with restrictions.

 .. list-table::
    :header-rows: 1
-    :widths: 8 12 12 20
+    :widths: 8 12 20

    * - GPIO
      - Analog Function
-      - LP GPIO
      - Comments

    * - GPIO0
      -
      -
+
+    * - GPIO1
+      - ADC1_CH0
      -

+    * - GPIO2
+      - ADC1_CH1
+      - Strapping pin
+
+    * - GPIO3
+      - ADC1_CH2
+      - Strapping pin
+
+    * - GPIO4
+      - ADC1_CH3
+      -
+
+    * - GPIO5
+      - ADC1_CH4
+      -
+
+    * - GPIO6
+      -
+      -
+
+    * - GPIO7
+      -
+      -
+
+    * - GPIO8
+      -
+      - Strapping pin
+
+    * - GPIO9
+      -
+      - Strapping pin
+
+    * - GPIO10
+      -
+      -
+
+    * - GPIO11
+      -
+      -
+
+    * - GPIO12
+      -
+      -
+
+    * - GPIO13
+      -
+      -
+
+    * - GPIO14
+      -
+      -
+
+    * - GPIO15
+      -
+      - SPI0/1
+
+    * - GPIO16
+      -
+      - SPI0/1
+
+    * - GPIO17
+      -
+      - SPI0/1
+
+    * - GPIO18
+      -
+      - SPI0/1
+
+    * - GPIO19
+      -
+      - SPI0/1
+
+    * - GPIO20
+      -
+      - SPI0/1
+
+    * - GPIO21
+      -
+      - SPI0/1
+
+    * - GPIO22
+      -
+      -
+
+    * - GPIO23
+      -
+      -
+
+    * - GPIO24
+      -
+      -
+
+    * - GPIO25
+      -
+      - Strapping pin
+
+    * - GPIO26
+      -
+      - USB-JTAG
+
+    * - GPIO27
+      -
+      - USB-JTAG
+
+.. note::
+
+    - Strapping pin: GPIO2, GPIO3, GPIO8, GPIO9, and GPIO25 are strapping pins. For more infomation, please refer to `ESP32H2 datasheet <https://www.espressif.com/sites/default/files/documentation/esp32h2_datasheet_en.pdf>`_.
+	  - SPI0/1: GPIO15-21 are usually used for SPI flash and not recommended for other uses.
+	  - USB-JTAG: GPIO 26 and 27 are used by USB-JTAG by default. In order to use them as GPIOs, USB-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; therefore, only the remaining 21 GPIO pins are available.
+
 ---