ESP32-P4 / S3 视觉检测基线与模型核对

准备与目标

开始前准备

• 完整板型、Flash/PSRAM 与相机型号
• ESP-IDF/视觉组件支持版本
• 许可明确的模型与代表性图片
• 供电、排线和显示资料

完成后应得到

• 把 P4/S3 配置分别锁定
• 防止预处理错误导致误识别
• 使性能数字可复测

1. 从项目 BOM 选择一套完整板型，核对相机接口、内存与显示；其他板型保留独立配置记录。
2. 锁定 IDF、BSP、ESP-VISION/ESP-DL 与示例版本，记录官方支持依据；未支持的组合列为移植。
3. 若使用 esp-detection，单独评估其许可及部署/分发方式；模型和数据集权限不由 SDK 许可代替。

1. 按目标板资料断电连接相机与显示，保存排线和供电照片。
2. 运行对应版本官方最小取流例程，记录像素格式、分辨率、方向、帧率与内存。
3. 固定一张测试图片与哈希，保存后续模型所用的 resize、裁剪、RGB/BGR、量化及归一化参数。

1. 用固定样本对照预期类别与目标框；不正确时先检查标签顺序、阈值、坐标还原和模型支持。
2. 分别记录采集、预处理、推理、后处理和显示耗时，注明线程、供电、分辨率与测试次数。
3. 加入显示或联网后复测峰值内存、丢帧及温升；P4 联网需实际协处理器和驱动，不写成芯片原生 Wi-Fi。

1. 归档板型/BOM、源码 commit、依赖锁、配置、模型哈希和测试样本许可。
2. 写明构建环境、运行入口、预期输出、错误示例与恢复方法；命令从已验证工程记录中提取。
3. 对模型、板卡、镜头或光照变化重新测试，不把示例检测率作为客户现场承诺。

故障定位

验收与归档

• 板型与组件支持范围明确
• 单相机和单模型通过复测
• 输入输出与性能条件有记录
• 交付模型/数据权限已确认

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