Merge branch 'feature/esp32c5_mp_gpio_support_v5.3' into 'release/v5.3'

Feature/esp32c5 mp gpio support (v5.3)

See merge request espressif/esp-idf!30884

docs/zh_CN/api-reference/peripherals/gpio.rst

@@ -73,7 +73,9 @@ GPIO 驱动提供了一个函数 :cpp:func:`gpio_dump_io_configuration` 用来
 
 如果 IO 管脚通过 GPIO 交换矩阵连接到内部外设信号，输出信息打印中的外设信号 ID 定义可以在 :component_file:`soc/{IDF_TARGET_PATH_NAME}/include/soc/gpio_sig_map.h` 头文件中查看。``**RESERVED**`` 字样则表示此 IO 用于连接 SPI flash 或 PSRAM，强烈建议不要重新配置这些管脚用于其他功能。
 
-.. only:: esp32c3 or esp32c6 or esp32h2 or esp32p4 or esp32s2 or esp32s3
+请不要依赖技术参考手册中记录的 GPIO 默认配置状态，因为特殊用途的 GPIO 可能会在 app_main 之前被引导程序或应用程序启动阶段的代码更改。
+
+.. only:: esp32c3 or esp32c6 or esp32h2 or esp32p4 or esp32s2 or esp32s3 or esp32c5
 
     配置 USB PHY 管脚 为普通 GPIO 管脚
     ---------------------------------------

docs/zh_CN/api-reference/peripherals/gpio/esp32c5.inc

@@ -9,9 +9,7 @@
 
 .. gpio-summary
 
-当前的 GPIO 适用于 {IDF_TARGET_NAME} beta3 版本。{IDF_TARGET_NAME} MP 版本将会增加 2 个可用的 IO，并且一些引脚功能将会改变。{IDF_TARGET_NAME} MP 版本将会在以后更新。
-
-{IDF_TARGET_NAME} 芯片具有 27 个物理 GPIO 管脚（GPIO0 ~ GPIO26）。每个管脚都可用作一个通用 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} 芯片具有 29 个物理 GPIO 管脚（GPIO0 ~ GPIO28）。每个管脚都可用作一个通用 IO，或连接一个内部的外设信号。通过 GPIO 交换矩阵和 IO MUX，可配置外设模块的输入信号来源于任何的 IO 管脚，并且外设模块的输出信号也可连接到任意 IO 管脚。这些模块共同组成了芯片的 IO 控制。更多详细信息，请参阅 *{IDF_TARGET_NAME} 技术参考手册* > *IO MUX 和 GPIO 矩阵（GPIO、IO_MUX）* [`PDF <{IDF_TARGET_TRM_CN_URL}#iomuxgpio>`__]。
 
 下表提供了各管脚的详细信息，部分 GPIO 具有特殊的使用限制，具体可参考表中的注释列。
 
@@ -42,7 +40,7 @@
     * - GPIO3
       - ADC1_CH2
       - LP_GPIO3
-      - Strapping 管脚
+      -
 
     * - GPIO4
       - ADC1_CH3
@@ -57,7 +55,7 @@
     * - GPIO6
       - ADC1_CH5
       - LP_GPIO6
-      - Strapping 管脚
+      -
 
     * - GPIO7
       -
@@ -92,12 +90,12 @@
     * - GPIO13
       -
       -
-      -
+      - USB-JTAG
 
     * - GPIO14
       -
       -
-      -
+      - USB-JTAG
 
     * - GPIO15
       -
@@ -107,12 +105,12 @@
     * - GPIO16
       -
       -
-      -
+      - SPI0/1
 
     * - GPIO17
       -
       -
-      -
+      - SPI0/1
 
     * - GPIO18
       -
@@ -142,27 +140,37 @@
     * - GPIO23
       -
       -
-      - SPI0/1
+      -
 
     * - GPIO24
       -
       -
-      - SPI0/1
+      -
 
     * - GPIO25
       -
       -
-      - USB-JTAG
+      -
 
     * - GPIO26
       -
       -
-      - USB-JTAG
+      -
+
+    * - GPIO27
+      -
+      -
+      - Strapping 管脚
+
+    * - GPIO28
+      -
+      -
+      - Strapping 管脚
 
 .. note::
 
-    - Strapping 管脚：GPIO2、GPIO3、GPIO6 和 GPIO7 是 Strapping 管脚。更多信息请参考 `ESP32-C5 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
-    - SPI0/1：GPIO18 ~ GPIO24 通常用于 SPI flash，不推荐用于其他用途。
-    - USB-JTAG：GPIO25 和 GPIO26 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。
+    - Strapping 管脚：GPIO2、GPIO7、GPIO27 和 GPIO28 是 Strapping 管脚。更多信息请参考 `ESP32-C5 技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`_。
+    - SPI0/1：GPIO16 ~ GPIO22 通常用于 SPI flash，不推荐用于其他用途。
+    - USB-JTAG：GPIO13 和 GPIO14 默认用于 USB-JTAG。如果将它们配置为普通 GPIO，驱动程序将禁用 USB-JTAG 功能。
 
 ---