Initial commit: knowledge base

gpio/esp32-h2_gpio.md

@@ -0,0 +1,76 @@
+# ESP32-H2 GPIO 引脚映射
+> **芯片：esp32-h2** | **类别：gpio** | **信源：** [Espressif 官方文档](https://docs.espressif.com)
+> ⚠️ H2 模组 GPIO 数量差异大，选型务必确认
+## 系统引脚（System Pins）
+
+**EN (CHIP_PU)** [I, QFN32 待核实 Pin 号]
+: 芯片使能。高电平=正常工作，低电平=芯片关闭。
+: **禁止浮空！** 必须外部上拉到 VDD（典型 10kΩ）。
+
+**VDD** [P]
+: 芯片主供电 3.0-3.6V，推荐 3.3V，**仅需 >=250mA LDO**（无 WiFi 射频，峰值低）。
+: VDD3P3 单一供电域。
+
+**GND** [P]
+: 所有 GND 焊盘必须全部连接到电源地平面。
+
+**XTAL_P / XTAL_N** [-]
+: 40 MHz 外部高速晶振。**不可复用为 GPIO。**
+
+**ANT** [I]
+: 2.4GHz 射频天线输入（BLE 5.3 + 802.15.4 Thread/Zigbee）。**不可复用为 GPIO。**
+: **H2 无 WiFi 射频**，仅 BLE + 802.15.4。天线设计仅需考虑 2.4GHz 单频。
+
+**USB_D- / USB_D+** [I/O, GPIO12/13]
+: USB Serial/JTAG。
+
+> H2 全系列最低主频 96MHz，全系列最低功耗（峰值仅 ~60mA）。WROOM-07 模组仅 3 个 GPIO 引出务必注意。安全特性最强（含 Power Glitch Detector 电源毛刺检测）。
+
+## Strapping 引脚
+
+- GPIO8：功能=启动模式
+- GPIO9：功能=启动模式
+- GPIO25：功能=启动模式（待核实）
+
+## ADC 映射（5ch, 12-bit, 无 WiFi 冲突）
+
+- ADC1_CH0：GPIO=GPIO1
+- ADC1_CH1：GPIO=GPIO2
+- ADC1_CH2：GPIO=GPIO3
+- ADC1_CH3：GPIO=GPIO4
+- ADC1_CH4：GPIO=GPIO5
+
+## GPIO 功能分组
+
+### 数字引脚（仅 Light-sleep 可唤醒）
+
+- GPIO0：复用功能=XTAL_32K_P
+- GPIO1：复用功能=XTAL_32K_N, ADC1_CH0
+- GPIO2：复用功能=FSPIQ, ADC1_CH1
+- GPIO3：复用功能=JTAG_MTMS, ADC1_CH2
+- GPIO4：复用功能=JTAG_MTCK, ADC1_CH3
+- GPIO5：复用功能=JTAG_MTDI, ADC1_CH4
+- GPIO6：复用功能=FSPICLK
+- GPIO7：复用功能=FSPID
+
+### LP 引脚（所有功耗模式可用，可唤醒 Deep-sleep）
+
+- GPIO8：LP GPIO=LP_GPIO0, 复用功能=FSPICS0, ⚡ Strapping
+- GPIO9：LP GPIO=LP_GPIO1, 复用功能=FSPIHD, ⚡ Strapping
+- GPIO10：LP GPIO=LP_GPIO2, 复用功能=FSPIWP
+- GPIO11：LP GPIO=LP_GPIO3, 复用功能=VDD_SPI
+- GPIO12：LP GPIO=LP_GPIO4, 复用功能=USB_D-
+- GPIO13：LP GPIO=LP_GPIO5, 复用功能=USB_D+
+- GPIO14：LP GPIO=LP_GPIO6
+
+## Deep-sleep 唤醒限制
+
+- ✅ Deep-sleep：GPIO=GPIO8–14（LP 引脚）
+- ✅ Light-sleep：GPIO=GPIO0–14
+- ❌ Deep-sleep：GPIO=GPIO0–7, GPIO22–27
+
+## 新手安全 GPIO
+> **GPIO1–5（ADC）、GPIO10–11、GPIO14**
+
+## 模组 WROOM-07 注意
+⚠️ WROOM-07 仅引出 **3 个 GPIO**，如果 GPIO 不够用必须换 WROOM-02C。