KJX ENGINEERING GUIDE · 03

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

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

本站流程 · 按目标芯片验证 入门 预计 45–90 分钟 核查 2026-08-09
查看对应方案与 BOM 商城搜索 ESP32
ESP32-S3-DevKitC-1 官方开发板实物参考 原厂最小系统参考 · ESP32-S3 模块化核心板
使用边界：本页是可简芯原创工程检查流程，不是第三方教程改名，也不代表所有同名板卡已实测通过。当前适用于：ESP32、ESP32-S3；ESP32-P4 的外设和工具链边界需单独确认。正式交付前须把目标板卡、固件、外设批次和验收结果写入订单或技术协议。

准备与目标

适用范围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. 执行三次冷启动和一次软件重启。
✓ 串口日志稳定✓ 存储配置一致✓ 复位原因合理

03 · 接口冒烟

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

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

故障定位

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

验收与归档

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

建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论。图片演示不能替代这些记录。