Initial: knowledge base

components/esp32-h2_constraints.md

@@ -0,0 +1,54 @@
+# ESP32-H2 硬件约束与踩坑
+
+> **芯片：esp32-h2** | **类别：constraints** | **信源：** [Espressif 官方文档](https://docs.espressif.com)
+
+## 1. 无 WiFi ⚠️ 最易搞错
+- H2 **没有 WiFi 硬件**，仅 BLE 5.3 + Thread/Zigbee (802.15.4)
+- 需要 WiFi+Thread 组合 → 选 **ESP32-C6**
+
+## 2. Strapping 引脚与启动模式
+
+- **GPIO8** — 下载模式：GPIO8=1 且 GPIO9=0 → Joint Download Boot
+- **GPIO9** — SPI Boot 时=1；Download Boot 时需 GPIO8=1, GPIO9=0
+- **GPIO25** — JTAG 信号源选择
+
+### 启动模式选择
+
+- SPI Boot（正常） ：GPIO 电平=任意 , 1
+- Joint Download Boot (USB/UART) ：GPIO 电平=1 , 0
+
+### 固件下载接口
+
+- **UART0**: TXD0 / RXD0（默认引脚待模组确认）
+- **USB**: USB_D-=**GPIO12**, USB_D+=**GPIO13**
+
+> Hold time (t_H): >= **3 ms**（EN 拉高后 Strapping 值锁存）
+
+## 3. 主频限制
+最高 **96 MHz**，全系列最低。需要高性能 DSP/计算 → C6 (160MHz) 或 S3 (240MHz)
+
+## 3. GPIO 数量少
+- 芯片 19 GPIO
+- WROOM-07 模组仅 **3 个 GPIO**
+- 选模组时务必确认引出数量
+
+## 4. ADC 通道少
+仅 5 通道（GPIO1–5），无 ADC1/ADC2 区分，无 WiFi 所以无冲突
+
+## 5. Deep-sleep 唤醒限制
+- 只有 LP GPIO（GPIO8–14）可唤醒 Deep-sleep
+- GPIO0–7 只能唤醒 Light-sleep
+
+## 6. 供电
+- 3.0–3.6V, 推荐 3.3V
+- BLE+802.15.4 TX 峰值 ~60 mA（无 WiFi，供电要求低）
+- 纹波 <75 mVpp
+
+## 7. 常见踩坑
+- **选了 H2 发现没 WiFi**: H2 无 WiFi 射频
+  → 换 C6
+- **WROOM-07 只有 3 GPIO**: 微型模组未全部引出
+  → 换 WROOM-02C
+- **GPIO0 不能唤醒 Deep-sleep**: 只有 LP 引脚可唤醒
+  → 用 GPIO8–14
+