Initial commit: knowledge base

gpio/esp32-s3_gpio.md

@@ -0,0 +1,108 @@
+# ESP32-S3 GPIO 引脚映射
+> **芯片：esp32-s3** | **类别：gpio** | **信源：** [Espressif 官方文档](https://docs.espressif.com)
+
+## 系统引脚（System Pins）
+
+**EN (CHIP_PU)** [I, Pin 3 QFN56]
+: 芯片使能。高电平=正常工作，低电平=芯片关闭。
+: **禁止浮空！** 必须外部上拉到 VDD（典型 10kΩ）。
+
+**VDD** [P]
+: 芯片主供电 3.0-3.6V，推荐 3.3V，需 >=500mA。
+: VDD3P3_RTC / VDD3P3_CPU。
+
+**GND** [P]
+: 所有 GND 焊盘必须全部连接到电源地平面。
+
+**XTAL_P / XTAL_N** [-]
+: 40 MHz 外部高速晶振。**不可复用为 GPIO。**
+
+**LNA_IN** [I]
+: 射频天线输入端口（WiFi 4 + BLE 5.0）。**不可复用为 GPIO。**
+
+**XTAL_32K_P / XTAL_32K_N** [I/O]
+: 32.768 kHz RTC 晶振（可选），XTAL_32K_P=GPIO15, XTAL_32K_N=GPIO16。
+
+**USB_OTG_D- / USB_OTG_D+** [I/O, GPIO19/20]
+: USB OTG 全速 12 Mbps。用作普通 GPIO 需固件禁用 USB OTG。
+
+**USB_Serial_JTAG_D- / USB_Serial_JTAG_D+** [I/O]
+: USB Serial/JTAG 控制器，专用独立引脚（不占用 GPIO）。
+: S3 是唯一同时具备双 USB 控制器（OTG + Serial/JTAG）的芯片。
+
+> S3 无 DAC。Octal PSRAM 模组（S3R8/S3R8V）GPIO33-37 被 SPIIO4-SPIIO7 和 SPIDQS 占用。
+
+## Strapping 引脚（4个）
+
+- **GPIO0**：上电默认=Weak Pull-Up, 功能=0=Download Boot（与 GPIO46 联合）
+- **GPIO3**：上电默认=Floating, 功能=JTAG 信号源控制（需外部驱动）
+- **GPIO45**：上电默认=Weak Pull-Down, 功能=VDD_SPI 电压 0=1.8V, 1=3.3V
+- **GPIO46**：上电默认=Weak Pull-Down, 功能=Boot 模式 + ROM 日志控制
+
+### 启动模式
+- SPI Boot：GPIO0=1, GPIO46=任意
+- Joint Download Boot：GPIO0=0, GPIO46=0
+
+## ADC 映射
+
+### ADC1（WiFi 可用，10ch）
+
+- ADC1_CH0：GPIO=GPIO1, Touch=Touch1, RTC=RTC_GPIO1
+- ADC1_CH1：GPIO=GPIO2, Touch=Touch2, RTC=RTC_GPIO2
+- ADC1_CH2：GPIO=GPIO3, Touch=Touch3, RTC=RTC_GPIO3
+- ADC1_CH3：GPIO=GPIO4, Touch=Touch4, RTC=RTC_GPIO4
+- ADC1_CH4：GPIO=GPIO5, Touch=Touch5, RTC=RTC_GPIO5
+- ADC1_CH5：GPIO=GPIO6, Touch=Touch6, RTC=RTC_GPIO6
+- ADC1_CH6：GPIO=GPIO7, Touch=Touch7, RTC=RTC_GPIO7
+- ADC1_CH7：GPIO=GPIO8, Touch=Touch8, RTC=RTC_GPIO8
+- ADC1_CH8：GPIO=GPIO9, Touch=Touch9, RTC=RTC_GPIO9
+- ADC1_CH9：GPIO=GPIO10, Touch=Touch10, RTC=RTC_GPIO10
+
+### ADC2（WiFi 不可用，10ch）
+
+- ADC2_CH0：GPIO=GPIO11, Touch=Touch11, RTC=RTC_GPIO11
+- ADC2_CH1：GPIO=GPIO12, Touch=Touch12, RTC=RTC_GPIO12
+- ADC2_CH2：GPIO=GPIO13, Touch=Touch13, RTC=RTC_GPIO13
+- ADC2_CH3：GPIO=GPIO14, Touch=Touch14, RTC=RTC_GPIO14
+- ADC2_CH4：GPIO=GPIO15, RTC=RTC_GPIO15, 备注=XTAL_32K_P
+- ADC2_CH5：GPIO=GPIO16, RTC=RTC_GPIO16, 备注=XTAL_32K_N
+- ADC2_CH6：GPIO=GPIO17, RTC=RTC_GPIO17
+- ADC2_CH7：GPIO=GPIO18, RTC=RTC_GPIO18
+- ADC2_CH8：GPIO=GPIO19, RTC=RTC_GPIO19, 备注=USB_D-
+- ADC2_CH9：GPIO=GPIO20, RTC=RTC_GPIO20, 备注=USB_D+
+
+## GPIO 全功能表
+
+- GPIO0：RTC=RTC_GPIO0, 备注=⚡ Strapping
+- GPIO1–8：ADC=ADC1_CH0–7, Touch=Touch1–8, RTC=RTC, 备注=ADC1, 新手安全
+- GPIO9：ADC=ADC1_CH8, Touch=Touch9, RTC=RTC_GPIO9, 备注=FSPIHD 复用
+- GPIO10：ADC=ADC1_CH9, Touch=Touch10, RTC=RTC_GPIO10, 备注=FSPICS0 复用
+- GPIO11：ADC=ADC2_CH0, Touch=Touch11, RTC=RTC_GPIO11, 备注=FSPID 复用
+- GPIO12：ADC=ADC2_CH1, Touch=Touch12, RTC=RTC_GPIO12, 备注=FSPICLK 复用
+- GPIO13：ADC=ADC2_CH2, Touch=Touch13, RTC=RTC_GPIO13, 备注=FSPIQ 复用
+- GPIO14：ADC=ADC2_CH3, Touch=Touch14, RTC=RTC_GPIO14, 备注=FSPIWP 复用
+- GPIO15–18：ADC=ADC2_CH4–7, RTC=RTC, 备注=U0RTS/U0CTS/U1TXD/U1RXD
+- GPIO19：ADC=ADC2_CH8, RTC=RTC_GPIO19, USB=**USB_D-**, 备注=U1RTS
+- GPIO20：ADC=ADC2_CH9, RTC=RTC_GPIO20, USB=**USB_D+**, 备注=U1CTS
+- GPIO21：RTC=RTC_GPIO21
+- GPIO26–32：备注=🔒 SPI Flash/PSRAM
+- GPIO33–37：备注=🔒 Octal PSRAM（S3R8/S3R8V）
+- GPIO38：备注=FSPIWP
+- GPIO39：备注=MTCK (JTAG)
+- GPIO40：备注=MTDO (JTAG)
+- GPIO41：备注=MTDI (JTAG)
+- GPIO42：备注=MTMS (JTAG)
+- GPIO43：备注=U0TXD（烧录）
+- GPIO44：备注=U0RXD（烧录）
+- GPIO45：备注=⚡ Strapping
+- GPIO46：备注=⚡ Strapping
+- GPIO47–48：备注=SPICLK 差分，⚠️ 部分模组 1.8V
+
+## 新手安全 GPIO
+
+> **GPIO1–8, GPIO15–18, GPIO21, GPIO47, GPIO48**
+
+## 常用外设默认引脚
+- UART0 TX/RX：引脚=GPIO43 / GPIO44
+- USB OTG D-/D+：引脚=GPIO19 / GPIO20
+- JTAG TMS/TCK/TDI/TDO：引脚=GPIO42 / GPIO39 / GPIO41 / GPIO40