KJX ENGINEERING GUIDE · 03

ESP32 / S3 工程基线与首轮自检

固定 ESP-IDF、芯片目标、分区表和烧录参数，先形成可重复构建的最小工程。

本站流程 · 按目标芯片验证 入门 参考学习时长 45–90 分钟 核查 2026-08-09
返回所选配置与 BOM 商城搜索 ESP32
ESP32-S3-EYE 视觉开发板参考原作者实物参考 原作者实物参考 · ESP32-S3-EYE 视觉开发板参考
适用说明：本手册用于 ESP32、ESP32-S3；ESP32-P4 的外设和工具链边界需单独确认。实施时请以目标板卡、固件和外设的实际版本为准；正式交付的功能、资料与验收标准以订单或技术协议为准。
返回配置：ESP32-S3-EYE 视觉开发板参考 · 同版参考基线。手册是适用范围内的工程参考，不代表所选配置已经完成实测。

准备与目标

适用范围ESP32、ESP32-S3；ESP32-P4 的外设和工具链边界需单独确认
实施方式本站流程 · 按目标芯片验证；按目标硬件执行并记录结果

开始前准备

  • 明确的芯片/模组型号
  • USB 数据线
  • ESP-IDF 稳定版本
  • 可用串口

完成后应得到

  • 得到可复现构建
  • 确认 Flash/PSRAM 与接口
  • 保存启动和诊断信息

01 · 固定工具链

项目必须记录 IDF 版本、目标芯片和依赖锁定文件。

3 个步骤
  1. 创建最小工程并设置正确目标芯片。
  2. 保存 IDF 版本、Python 环境和组件锁定文件。
  3. 构建并记录固件大小和分区表。
✓ 干净环境可重新构建✓ 目标芯片无误✓ 依赖版本可追溯

02 · 烧录与启动

用启动日志核对 Flash、PSRAM 和复位原因。

3 个步骤
  1. 先备份当前固件、分区表和允许备份的配置/校准数据，确认恢复方法；按目标板分区烧录最小测试固件，不默认全片擦除。
  2. 记录启动日志、Flash 大小和 PSRAM 检测结果。
  3. 执行三次冷启动和一次软件重启。
✓ 恢复路径已确认✓ 串口日志稳定✓ 存储配置一致✓ 复位原因合理
停止条件：仅在负责人确认丢失影响及可恢复性后才清空测试板；不擦除生产凭据，不操作 eFuse/OTP 或安全密钥。

03 · 接口冒烟

每次只验证一种总线，避免接线与驱动问题叠加。

3 个步骤
  1. 按供电、GPIO、I²C、SPI、USB 的顺序检查。
  2. 保存引脚表和被占用的启动脚。
  3. 给失败步骤保留最小复现工程。
✓ 引脚表已归档✓ 总线异常可单独复现✓ 启动脚没有被错误拉电平

故障定位

现象常见原因建议动作
能编译但无法启动目标芯片、Flash 模式、分区或供电不匹配回到最小工程并逐项核对启动日志。

验收与归档

  • 全新环境可构建
  • 固件与分区可追溯
  • 冷启动三次通过
  • 接口占用表完整

建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论，方便后续复现、维护与售后。