10 KiB
10 KiB
嵌入式专属查询系统 — 知识库总索引
文件总数: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:内容=完整规格:双核 LX6 240MHz, 520KB SRAM, WiFi4+BT Classic, 34 GPIO
- esp32_gpio.md:内容=引脚映射:ADC 18ch, DAC 2ch, 仅输入GPIO34-39, Strapping GPIO0/2/5/12/15
- esp32_constraints.md:内容=硬件约束:ADC2/WiFi冲突, GPIO12 Flash电压陷阱(禁止上拉), Flash GPIO6-11
- esp32_peripherals.md:内容=外设:4 SPI, 2 I2C, 3 UART, 2 I2S, 1 CAN, 16 LEDC, 霍尔传感器
ESP32-S2(单核 USB IoT,2019)
- esp32-s2_specs.md:内容=完整规格:单核 LX7 240MHz, 320KB SRAM, WiFi4, 无蓝牙, USB OTG
- esp32-s2_gpio.md:内容=引脚映射:ADC 20ch, DAC 2ch, USB_D-/D+ GPIO19/20, 43 GPIO
- esp32-s2_constraints.md:内容=硬件约束:无蓝牙, ADC2/WiFi冲突, 仅3个Strapping, GPIO46仅输入
- 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:内容=完整规格:双核 LX7 240MHz, 512KB SRAM, BLE5, AI向量指令, Octal PSRAM
- esp32-s3_gpio.md:内容=引脚映射:ADC 20ch, 45 GPIO, USB双控制器, Octal PSRAM GPIO33-37占用
- esp32-s3_constraints.md:内容=硬件约束:ADC2/WiFi冲突, Octal PSRAM引脚占用, 无DAC
- esp32-s3_peripherals.md:内容=外设:LCD RGB/i80, DVP Camera, AI SIMD, 2 CAN, GDMA 5TX+5RX
- esp32-s3_basics.md:内容=ESP32-S3 基础知识:Strapping, USB, ADC, 供电, 开发板选型
ESP32-C2(RISC-V 极致低成本,2022)
- esp32-c2_specs.md:内容=完整规格:单核 RISC-V 120MHz, 272KB SRAM, WiFi4+BLE5, SiP仅14 GPIO可用
- esp32-c2_gpio.md:内容=引脚映射:ADC 5ch, USB-JTAG GPIO18/19, Flash GPIO11-17, 仅2个Strapping
- esp32-c2_constraints.md:内容=硬件约束:无通用SPI!仅1个UART!无I2S! GPIO极度有限
- esp32-c2_peripherals.md:内容=外设:精简外设, C2 vs C3 对比表
ESP32-C3(RISC-V 低成本 IoT,2020)
- esp32-c3_specs.md:内容=完整规格:单核 RISC-V 160MHz, 400KB SRAM, WiFi4+BLE5, 22 GPIO
- esp32-c3_gpio.md:内容=引脚映射:ADC 6ch, USB-JTAG GPIO18/19, Strapping GPIO2/8/9, Flash GPIO12-17
- esp32-c3_constraints.md:内容=硬件约束:GPIO2禁止上拉!GPIO8方向与D0WD相反! 无ADC/WiFi冲突
- esp32-c3_peripherals.md:内容=外设:3 SPI, 1 I2C, 2 UART, 1 I2S, 1 CAN, GDMA 3TX+3RX
- esp32-c3_pin_trap.md:内容=⚠️ ESP32-C3 引脚映射踩坑实录:GPIO2/VDD_SPI变砖, GPIO8下载方向, 嘉立创封装差异
ESP32-C5(RISC-V 双频 WiFi6,2024)
- esp32-c5_specs.md:内容=完整规格:单核 RISC-V 240MHz, 384KB SRAM, 双频WiFi6(2.4+5GHz), BLE5
- esp32-c5_gpio.md:内容=引脚映射:ADC 6ch, 芯片29 GPIO / 模组22 GPIO, GPIO13/14 40mA驱动
- esp32-c5_constraints.md:内容=硬件约束:双频天线设计挑战, CAN FD×2, 5GHz PCB走线阻抗
- esp32-c5_peripherals.md:内容=外设:CAN FD×2, 3 UART, C5 vs C6 对比表
ESP32-C6(RISC-V WiFi6 + Thread,2023)
- esp32-c6_specs.md:内容=完整规格:单核 RISC-V 160MHz, 512KB SRAM, WiFi6, BLE5.3, Thread/Zigbee
- esp32-c6_gpio.md:内容=引脚映射:ADC 7ch, 30 GPIO, USB-JTAG GPIO12/13, LP GPIO 8-21
- esp32-c6_constraints.md:内容=硬件约束:无ADC/WiFi冲突, WiFi6仅20MHz/1T1R, LP CPU 20MHz
- 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:内容=完整规格:单核 RISC-V 96MHz, 320KB SRAM, 无WiFi, BLE5.3+Thread/Zigbee
- esp32-h2_gpio.md:内容=引脚映射:ADC 5ch, 19 GPIO, LP引脚仅GPIO8-14可唤醒Deep-sleep
- esp32-h2_constraints.md:内容=硬件约束:无WiFi, 全系列最低主频96MHz, WROOM-07仅3个GPIO
- esp32-h2_peripherals.md:内容=外设:安全最强(Power Glitch Detector), 低功耗, BLE+802.15.4
ESP32-P4(RISC-V 高性能应用处理器,2023)
- esp32-p4_specs.md:内容=完整规格:双核 RISC-V 400MHz, 768KB SRAM, 16/32MB PSRAM, 无无线
- esp32-p4_gpio.md:内容=引脚映射:55 GPIO, ADC 8ch GPIO16-23, Touch 14ch GPIO2-15, MIPI CSI/DSI
- esp32-p4_constraints.md:内容=硬件约束:无无线需外挂协处理器, 400MHz散热, 多电源域, PRELIMINARY
- esp32-p4_peripherals.md:内容=外设:H264, JPEG, MIPI, 以太网, USB HS, I3C, 2D-DMA, 最强外设
二、跨系列参考资料(10 文件)
- platforms_esp32-pins.md:内容=ESP32 GPIO 完整引脚参考:34引脚全表, ADC/DAC/Touch/RTC映射, 变体对比
- platforms_esp32-specifics.md:内容=ESP32 深度参考:MMU/堆分配, Strapping深入, ADC2/WiFi冲突, RTC/DeepSleep
- esp32_compare_d0wd-vs-s3.md:内容=ESP32-D0WD vs ESP32-S3 选型对比踩坑:USB, 烧录, PSRAM差异
- electrical-constraints.md:内容=电气约束通用规范
- common-devices.md:内容=常用器件参考
- protocol-quick-ref.md:内容=通信协议快速参考
- pcb_rules_v2.md:内容=PCB 设计规范 v2
- lvgl_README.md:内容=LVGL 图形库参考
- waveshare_README.md:内容=Waveshare 微雪电子模块参考
三、实战踩坑记录(6 文件)
- esp32_fail_log.md:内容=ESP32 翻车全记录:从面包板到V5.1投板的所有踩坑,按时间排序
- esp32-c3_pin_trap.md:内容=ESP32-C3 引脚踩坑:GPIO2/VDD_SPI变砖, GPIO8下载方向, 嘉立创封装差异
- mosfet_trap.md:内容=MOSFET 选型与驱动踩坑
- cap_select_trap.md:内容=电容选型踩坑
- smt_order_trap.md:内容=SMT 贴片下单踩坑
- pcb_4layer_trap.md:内容=PCB 四层板设计踩坑
- verify_flow_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
- GPIO2 做 I2C SDA → VDD_SPI 变砖:芯片=ESP32-C3, 查阅=esp32-c3_pin_trap.md
- GPIO8 下载方向与 D0WD 相反:芯片=ESP32-C3, 查阅=esp32-c3_pin_trap.md
- ADC2 开启 WiFi 后读数噪音:芯片=ESP32/S2/S3, 查阅=各 constraints.md
- Octal PSRAM 占用 GPIO33-37:芯片=ESP32-S3, 查阅=esp32-s3_constraints.md
- C2 没有通用 SPI:芯片=ESP32-C2, 查阅=esp32-c2_constraints.md
- H2 没有 WiFi:芯片=ESP32-H2, 查阅=esp32-h2_specs.md
- P4 没有无线:芯片=ESP32-P4, 查阅=esp32-p4_specs.md
- S2 没有蓝牙:芯片=ESP32-S2, 查阅=esp32-s2_specs.md
- WROOM-07 仅 3 个 GPIO:芯片=ESP32-H2, 查阅=esp32-h2_gpio.md