esp32-dev/components/esp32-c3_constraints.md

ESP32-C3 硬件约束与踩坑

芯片：esp32-c3 | 类别：constraints | 信源： Espressif 官方文档

1. Strapping 引脚方向与 D0WD 相反 ⚠️ 最危险的坑

• 进下载模式 — GPIO0 → GND（低电平）, GPIO8 → 3.3V（高电平）
• 正常 Boot ×GPIO0 高电平 — GPIO8 低电平

C3 正确设计： GPIO8 下拉 GND（默认低=正常启动）+ 按键接 3.3V（按下=进下载）

如果按 D0WD 习惯给 GPIO8 加上拉 + 按键到 GND → 每次 RESET 都进下载模式，根本启动不了！

2. GPIO2 不能接上拉 ⚠️ 量产必炸

GPIO2 上电瞬间决定 VDD_SPI 电压：

• GPIO2=LOW → VDD_SPI=3.3V ✅
• GPIO2=HIGH → VDD_SPI=1.8V ❌ Flash 读不出

GPIO2 绝对禁止： I2C SDA（开漏+上拉）、OneWire、任何带外部上拉的信号

3. C3 Strapping 全表

• GPIO2 (Pin5) — VDD_SPI 电压选择，需保持 LOW=3.3V。禁止接上拉！禁止做 I2C SDA！
• GPIO8 (Pin22) — ROM 打印开关 + 下载模式。HIGH=关闭打印, LOW=进下载。需上拉 3.3V，与 D0WD 方向相反
• GPIO9 (Pin23) — 启动模式选择。HIGH=SPI Boot, LOW=Download Boot。需上拉 + BOOT 键

4. USB-JTAG 约束

• GPIO18/19 默认 USB-JTAG，上电即启用
• 用作普通 GPIO 需固件重配 IO MUX
• 重配后 USB-JTAG 失效，只能 UART 烧录

5. RTC GPIO 唤醒限制

• ✅ Deep-sleep: GPIO0–5
• ✅ Light-sleep: GPIO0–11
• ❌ Deep-sleep: GPIO12–21

6. Flash 占用

GPIO12–17: QSPI Flash 占用（模组内部连接）

7. 供电

• 3.0–3.6V, 推荐 3.3V
• LDO ≥500 mA, 纹波 <75 mVpp
• WiFi TX 峰值 ~190 mA

8. 无硬件

❌ DAC, ❌ 触摸, ❌ ULP, ❌ 以太网

9. 常见踩坑

• C3 一直进下载模式: GPIO8 加了上拉 → GPIO8 下拉到 GND，按键接 3.3V
• GPIO2 做 I2C SDA 芯片不启动: GPIO2 被上拉 → Flash 1.8V → SDA 换到 GPIO1
• USB 烧录后 GPIO18/19 不能用: USB-JTAG 占用 → 固件中切换 IO MUX
• Deep-sleep 唤醒不了 GPIO12+: 只有 GPIO0–5 可唤醒 Deep-sleep → 用 GPIO0–5
• 嘉立创封装引脚与数据手册不一致: 封装厂商映射差异 → 以 EDA 标注为准