ESP32 外设与驱动（esp32-peripherals）

本 Skill 决定"用哪个外设、哪个驱动接口、接到哪个引脚"。硬件契约优先：引脚/复用/上拉/Strapping 一律以芯片 datasheet 或板原理图为准，禁止编造。 驱动接口以 v6.x 新式组件化方向为准，legacy 驱动在 v6.0 已移除（基线高置信）。

Determine Task Type

1. 选外设/驱动接口 — 需求映射到 GPIO/I2C/SPI/UART/ADC/PWM(LEDC)/RMT，并确认 v6.x 新式接口 → 决策表。
2. 接线与引脚分配 — 查 datasheet/原理图定引脚与上拉 → 走硬件契约流程（Workflow 1）。
3. 总线调不通 — I2C 无 ACK、SPI 花屏、UART 乱码 → Workflow 2（先查电气与配置，再查代码）。
4. 并发问题（ISR 与驱动共享数据）→ 移交 esp32-freertos；崩溃取证 → esp32-debug。

Preflight（先运行时核验）

idf.py --version                          # v6.x → 新式驱动方向；v5 → 提示迁移路径
grep -rn "#include \"driver/" main/       # 工程现有驱动头文件（发现 legacy 痕迹）
grep -m1 "CONFIG_IDF_TARGET" sdkconfig    # 芯片 target，与实物核对