suyushi/esp32-dev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: knowledge base

Browse Source
This commit is contained in:
suyushi
2026-08-05 17:12:34 +08:00
commit bfabe83832
21 changed files with 1720 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
INDEX.md
+172
View File
@@ -0,0 +1,172 @@
# 嵌入式专属查询系统 — 知识库总索引
> 文件总数：**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)