# 嵌入式专属查询系统 — 知识库总索引 > 文件总数：**55 个 .md** | 最后审查：2026-07-27 | 编码：全部 UTF-8 > 信源：espressif.com 官方文档 (Datasheet/TRM) + 实战踩坑积累 --- ## 命名规则（新增文件必须遵守） ``` 芯片手册类： {芯片型号}_{类别}.md 芯片型号： esp32 / esp32-s2 / esp32-s3 / esp32-c2 / esp32-c3 / esp32-c5 / esp32-c6 / esp32-h2 / esp32-p4 类 别： specs（规格） / gpio（引脚） / constraints（约束） / peripherals（外设） 跨系列参考： platforms_{主题}.md 或 {主题描述}.md 例：platforms_esp32-pins.md / electrical-constraints.md / protocol-quick-ref.md 踩坑记录： {芯片或主题}_trap.md 或 {芯片}_fail_log.md 或 {芯片}_basics.md 例：esp32-c3_pin_trap.md / mosfet_trap.md / esp32_fail_log.md 对比文档： {芯片}_compare_{对比对象}.md 例：esp32_compare_d0wd-vs-s3.md 第三方库： {库名}_README.md 例：lvgl_README.md / waveshare_README.md PCB/通用： pcb_{主题}.md 或 {主题描述}.md 例：pcb_rules_v2.md / common-devices.md ``` **规则：** - 全部小写英文 + 数字 + 连字符 `-` 或下划线 `_` - 芯片型号与类别之间用 `_` 分隔（如 `esp32-s3_gpio.md`） - 芯片型号内部用 `-`（如 `esp32-s3`） - 不允许中文文件名、空格、大写字母 - 新增文件前先查 INDEX.md 避免重复 --- ## 一、ESP32 全系列芯片手册（9 系列 × 4 文件 = 36 文件） ### ESP32（经典双核 IoT 旗舰，2016） - [esp32_specs.md](esp32_specs.md)：内容=完整规格：双核 LX6 240MHz, 520KB SRAM, WiFi4+BT Classic, 34 GPIO - [esp32_gpio.md](esp32_gpio.md)：内容=引脚映射：ADC 18ch, DAC 2ch, 仅输入GPIO34-39, Strapping GPIO0/2/5/12/15 - [esp32_constraints.md](esp32_constraints.md)：内容=硬件约束：ADC2/WiFi冲突, GPIO12 Flash电压陷阱(禁止上拉), Flash GPIO6-11 - [esp32_peripherals.md](esp32_peripherals.md)：内容=外设：4 SPI, 2 I2C, 3 UART, 2 I2S, 1 CAN, 16 LEDC, 霍尔传感器 ### ESP32-S2（单核 USB IoT，2019） - [esp32-s2_specs.md](esp32-s2_specs.md)：内容=完整规格：单核 LX7 240MHz, 320KB SRAM, WiFi4, **无蓝牙**, USB OTG - [esp32-s2_gpio.md](esp32-s2_gpio.md)：内容=引脚映射：ADC 20ch, DAC 2ch, USB_D-/D+ GPIO19/20, 43 GPIO - [esp32-s2_constraints.md](esp32-s2_constraints.md)：内容=硬件约束：无蓝牙, ADC2/WiFi冲突, 仅3个Strapping, GPIO46仅输入 - [esp32-s2_peripherals.md](esp32-s2_peripherals.md)：内容=外设：4 SPI, 2 I2C, 2 UART, LCD i80, DVP Camera, USB OTG ### ESP32-S3（双核 AI/IoT，2020） - [esp32-s3_specs.md](esp32-s3_specs.md)：内容=完整规格：双核 LX7 240MHz, 512KB SRAM, BLE5, AI向量指令, Octal PSRAM - [esp32-s3_gpio.md](esp32-s3_gpio.md)：内容=引脚映射：ADC 20ch, 45 GPIO, USB双控制器, Octal PSRAM GPIO33-37占用 - [esp32-s3_constraints.md](esp32-s3_constraints.md)：内容=硬件约束：ADC2/WiFi冲突, Octal PSRAM引脚占用, 无DAC - [esp32-s3_peripherals.md](esp32-s3_peripherals.md)：内容=外设：LCD RGB/i80, DVP Camera, AI SIMD, 2 CAN, GDMA 5TX+5RX - [esp32-s3_basics.md](esp32-s3_basics.md)：内容=ESP32-S3 基础知识：Strapping, USB, ADC, 供电, 开发板选型 ### ESP32-C2（RISC-V 极致低成本，2022） - [esp32-c2_specs.md](esp32-c2_specs.md)：内容=完整规格：单核 RISC-V 120MHz, 272KB SRAM, WiFi4+BLE5, SiP仅14 GPIO可用 - [esp32-c2_gpio.md](esp32-c2_gpio.md)：内容=引脚映射：ADC 5ch, USB-JTAG GPIO18/19, Flash GPIO11-17, 仅2个Strapping - [esp32-c2_constraints.md](esp32-c2_constraints.md)：内容=硬件约束：**无通用SPI！仅1个UART！无I2S！** GPIO极度有限 - [esp32-c2_peripherals.md](esp32-c2_peripherals.md)：内容=外设：精简外设, C2 vs C3 对比表 ### ESP32-C3（RISC-V 低成本 IoT，2020） - [esp32-c3_specs.md](esp32-c3_specs.md)：内容=完整规格：单核 RISC-V 160MHz, 400KB SRAM, WiFi4+BLE5, 22 GPIO - [esp32-c3_gpio.md](esp32-c3_gpio.md)：内容=引脚映射：ADC 6ch, USB-JTAG GPIO18/19, Strapping GPIO2/8/9, Flash GPIO12-17 - [esp32-c3_constraints.md](esp32-c3_constraints.md)：内容=硬件约束：**GPIO2禁止上拉！GPIO8方向与D0WD相反！** 无ADC/WiFi冲突 - [esp32-c3_peripherals.md](esp32-c3_peripherals.md)：内容=外设：3 SPI, 1 I2C, 2 UART, 1 I2S, 1 CAN, GDMA 3TX+3RX - [esp32-c3_pin_trap.md](esp32-c3_pin_trap.md)：内容=⚠️ ESP32-C3 引脚映射踩坑实录：GPIO2/VDD_SPI变砖, GPIO8下载方向, 嘉立创封装差异 ### ESP32-C5（RISC-V 双频 WiFi6，2024） - [esp32-c5_specs.md](esp32-c5_specs.md)：内容=完整规格：单核 RISC-V **240MHz**, 384KB SRAM, **双频WiFi6(2.4+5GHz)**, BLE5 - [esp32-c5_gpio.md](esp32-c5_gpio.md)：内容=引脚映射：ADC 6ch, 芯片29 GPIO / 模组22 GPIO, GPIO13/14 40mA驱动 - [esp32-c5_constraints.md](esp32-c5_constraints.md)：内容=硬件约束：双频天线设计挑战, CAN FD×2, 5GHz PCB走线阻抗 - [esp32-c5_peripherals.md](esp32-c5_peripherals.md)：内容=外设：CAN FD×2, 3 UART, C5 vs C6 对比表 ### ESP32-C6（RISC-V WiFi6 + Thread，2023） - [esp32-c6_specs.md](esp32-c6_specs.md)：内容=完整规格：单核 RISC-V 160MHz, 512KB SRAM, WiFi6, BLE5.3, Thread/Zigbee - [esp32-c6_gpio.md](esp32-c6_gpio.md)：内容=引脚映射：ADC 7ch, 30 GPIO, USB-JTAG GPIO12/13, LP GPIO 8-21 - [esp32-c6_constraints.md](esp32-c6_constraints.md)：内容=硬件约束：无ADC/WiFi冲突, WiFi6仅20MHz/1T1R, LP CPU 20MHz - [esp32-c6_peripherals.md](esp32-c6_peripherals.md)：内容=外设：3 UART(含LP), 2 CAN, SDIO 2.0, PARLIO, ETM ### ESP32-H2（RISC-V Thread/Zigbee 无WiFi，2023） - [esp32-h2_specs.md](esp32-h2_specs.md)：内容=完整规格：单核 RISC-V 96MHz, 320KB SRAM, **无WiFi**, BLE5.3+Thread/Zigbee - [esp32-h2_gpio.md](esp32-h2_gpio.md)：内容=引脚映射：ADC 5ch, 19 GPIO, LP引脚仅GPIO8-14可唤醒Deep-sleep - [esp32-h2_constraints.md](esp32-h2_constraints.md)：内容=硬件约束：无WiFi, 全系列最低主频96MHz, WROOM-07仅3个GPIO - [esp32-h2_peripherals.md](esp32-h2_peripherals.md)：内容=外设：安全最强(Power Glitch Detector), 低功耗, BLE+802.15.4 ### ESP32-P4（RISC-V 高性能应用处理器，2023） - [esp32-p4_specs.md](esp32-p4_specs.md)：内容=完整规格：双核 RISC-V **400MHz**, 768KB SRAM, 16/32MB PSRAM, **无无线** - [esp32-p4_gpio.md](esp32-p4_gpio.md)：内容=引脚映射：55 GPIO, ADC 8ch GPIO16-23, Touch 14ch GPIO2-15, MIPI CSI/DSI - [esp32-p4_constraints.md](esp32-p4_constraints.md)：内容=硬件约束：无无线需外挂协处理器, 400MHz散热, 多电源域, PRELIMINARY - [esp32-p4_peripherals.md](esp32-p4_peripherals.md)：内容=外设：H264, JPEG, MIPI, 以太网, USB HS, I3C, 2D-DMA, 最强外设 --- ## 二、跨系列参考资料（10 文件） - [platforms_esp32-pins.md](platforms_esp32-pins.md)：内容=ESP32 GPIO 完整引脚参考：34引脚全表, ADC/DAC/Touch/RTC映射, 变体对比 - [platforms_esp32-specifics.md](platforms_esp32-specifics.md)：内容=ESP32 深度参考：MMU/堆分配, Strapping深入, ADC2/WiFi冲突, RTC/DeepSleep - [esp32_compare_d0wd-vs-s3.md](esp32_compare_d0wd-vs-s3.md)：内容=ESP32-D0WD vs ESP32-S3 选型对比踩坑：USB, 烧录, PSRAM差异 - [electrical-constraints.md](electrical-constraints.md)：内容=电气约束通用规范 - [common-devices.md](common-devices.md)：内容=常用器件参考 - [protocol-quick-ref.md](protocol-quick-ref.md)：内容=通信协议快速参考 - [pcb_rules_v2.md](pcb_rules_v2.md)：内容=PCB 设计规范 v2 - [lvgl_README.md](lvgl_README.md)：内容=LVGL 图形库参考 - [waveshare_README.md](waveshare_README.md)：内容=Waveshare 微雪电子模块参考 --- ## 三、实战踩坑记录（6 文件） - [esp32_fail_log.md](esp32_fail_log.md)：内容=ESP32 翻车全记录：从面包板到V5.1投板的所有踩坑，按时间排序 - [esp32-c3_pin_trap.md](esp32-c3_pin_trap.md)：内容=ESP32-C3 引脚踩坑：GPIO2/VDD_SPI变砖, GPIO8下载方向, 嘉立创封装差异 - [mosfet_trap.md](mosfet_trap.md)：内容=MOSFET 选型与驱动踩坑 - [cap_select_trap.md](cap_select_trap.md)：内容=电容选型踩坑 - [smt_order_trap.md](smt_order_trap.md)：内容=SMT 贴片下单踩坑 - [pcb_4layer_trap.md](pcb_4layer_trap.md)：内容=PCB 四层板设计踩坑 - [verify_flow_trap.md](verify_flow_trap.md)：内容=验证流程踩坑 - [model_confuse_trap.md](model_confuse_trap.md)：内容=AI 模型混淆踩坑 --- ## 四、芯片选型速查 ### 按无线需求选 - WiFi + 经典蓝牙 (BR/EDR)：推荐芯片=**ESP32** - WiFi + BLE：推荐芯片=ESP32-S3 / C3 / C2 - WiFi + BLE + Thread/Zigbee：推荐芯片=**ESP32-C6** - 双频 WiFi (2.4+5GHz) + BLE：推荐芯片=**ESP32-C5** - USB OTG + WiFi：推荐芯片=ESP32-S2 / S3 - 仅 BLE + Thread/Zigbee (无WiFi)：推荐芯片=**ESP32-H2** - 高性能多媒体 (无无线)：推荐芯片=**ESP32-P4** - 极致低成本 BLE+WiFi：推荐芯片=**ESP32-C2** ### 按性能选 - 最高 CPU 性能：推荐=ESP32-P4 (400MHz 双核 RISC-V) - AI/ML 推理：推荐=ESP32-S3 (向量指令) - 最大 GPIO：推荐=ESP32-P4 (55) / ESP32-S3 (45) - 最低功耗：推荐=ESP32-H2 (7µA Deep-sleep, 无WiFi) - 最小封装：推荐=ESP32-C2 (QFN24 4×4mm) ### 按外设选 - 最多 SPI：推荐=ESP32-P4 (5) - CAN FD：推荐=ESP32-C5 (×2) - 以太网 MAC：推荐=ESP32-P4 - MIPI CSI/DSI：推荐=ESP32-P4 - H264 编码：推荐=ESP32-P4 - DAC 输出：推荐=ESP32 / ESP32-S2 - 霍尔传感器：推荐=ESP32（仅此一家） - 电容触摸：推荐=ESP32 / S2 / S3 / P4 --- ## 五、常见踩坑速查 - GPIO12 上拉 → Flash 变砖：芯片=ESP32, 查阅=[esp32_constraints.md](esp32_constraints.md) - GPIO2 做 I2C SDA → VDD_SPI 变砖：芯片=ESP32-C3, 查阅=[esp32-c3_pin_trap.md](esp32-c3_pin_trap.md) - GPIO8 下载方向与 D0WD 相反：芯片=ESP32-C3, 查阅=[esp32-c3_pin_trap.md](esp32-c3_pin_trap.md) - ADC2 开启 WiFi 后读数噪音：芯片=ESP32/S2/S3, 查阅=各 constraints.md - Octal PSRAM 占用 GPIO33-37：芯片=ESP32-S3, 查阅=[esp32-s3_constraints.md](esp32-s3_constraints.md) - C2 没有通用 SPI：芯片=ESP32-C2, 查阅=[esp32-c2_constraints.md](esp32-c2_constraints.md) - H2 没有 WiFi：芯片=ESP32-H2, 查阅=[esp32-h2_specs.md](esp32-h2_specs.md) - P4 没有无线：芯片=ESP32-P4, 查阅=[esp32-p4_specs.md](esp32-p4_specs.md) - S2 没有蓝牙：芯片=ESP32-S2, 查阅=[esp32-s2_specs.md](esp32-s2_specs.md) - WROOM-07 仅 3 个 GPIO：芯片=ESP32-H2, 查阅=[esp32-h2_gpio.md](esp32-h2_gpio.md)