feat(gpio): add gpio support on ESP32C5

2025-08-09 12:35:28 +00:00 · 2024-02-20 14:57:25 +08:00
parent ce4b49ae37
commit 3ac736bc95
27 changed files with 696 additions and 3323 deletions
--- a/docs/en/api-reference/peripherals/gpio/esp32c5.inc
+++ b/docs/en/api-reference/peripherals/gpio/esp32c5.inc
@@ -9,6 +9,161 @@

 .. gpio-summary

-    To be updated for C5
+Current GPIO is for {IDF_TARGET_NAME} beta3 version. {IDF_TARGET_NAME} MP version would have 2 more available IOs, and some pin functions are changed. The {IDF_TARGET_NAME} MP version will be updated later.
+
+The {IDF_TARGET_NAME} chip features 27 physical GPIO pins (GPIO0 ~ GPIO26). 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
+
+    * - GPIO
+      - Analog Function
+      - LP GPIO
+      - Comments
+
+    * - GPIO0
+      - LP_GPIO0
+      -
+      -
+
+    * - GPIO1
+      - ADC1_CH0
+      - LP_GPIO1
+      -
+
+    * - GPIO2
+      - ADC1_CH1
+      - LP_GPIO2
+      - Strapping pin
+
+    * - GPIO3
+      - ADC1_CH2
+      - LP_GPIO3
+      - Strapping pin
+
+    * - GPIO4
+      - ADC1_CH3
+      - LP_GPIO4
+      -
+
+    * - GPIO5
+      - ADC1_CH4
+      - LP_GPIO5
+      -
+
+    * - GPIO6
+      - ADC1_CH5
+      - LP_GPIO6
+      - Strapping pin
+
+    * - GPIO7
+      -
+      - LP_GPIO7
+      - Strapping pin
+
+    * - GPIO8
+      -
+      -
+      -
+
+    * - GPIO9
+      -
+      -
+      -
+
+    * - GPIO10
+      -
+      -
+      -
+
+    * - GPIO11
+      -
+      -
+      -
+
+    * - GPIO12
+      -
+      -
+      -
+
+    * - GPIO13
+      -
+      -
+      -
+
+    * - GPIO14
+      -
+      -
+      -
+
+    * - GPIO15
+      -
+      -
+      -
+
+    * - GPIO16
+      -
+      -
+      -
+
+    * - GPIO17
+      -
+      -
+      -
+
+    * - GPIO18
+      -
+      -
+      - SPI0/1
+
+    * - GPIO19
+      -
+      -
+      - SPI0/1
+
+    * - GPIO20
+      -
+      -
+      - SPI0/1
+
+    * - GPIO21
+      -
+      -
+      - SPI0/1
+
+    * - GPIO22
+      -
+      -
+      - SPI0/1
+
+    * - GPIO23
+      -
+      -
+      - SPI0/1
+
+    * - GPIO24
+      -
+      -
+      - SPI0/1
+
+    * - GPIO25
+      -
+      -
+      - USB-JTAG
+
+    * - GPIO26
+      -
+      -
+      - USB-JTAG
+
+
+.. note::
+
+    - Strapping pin: GPIO2, GPIO3, GPIO6, and GPIO7 are strapping pins. For more infomation, please refer to `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
+	  - SPI0/1: GPIO18-24 are usually used for SPI flash and not recommended for other uses.
+	  - USB-JTAG: GPIO 25 and 26 are used by USB-JTAG by default. In order to use them as GPIOs, USB-JTAG will be disabled by the drivers.

 ---