摄像头平台调试:首次沟通需要哪些资料
“接上后没有画面”还不足以定位问题。把硬件、系统、连接和操作步骤固定下来,再描述故障,可以减少反复补充资料。以下内容可整理成一份调试资料包。

1. 建立版本表
记录模组型号或样品编号、板卡版本、主控与载板、操作系统镜像、内核或 BSP、驱动和采集应用。NVIDIA 项目请同时写出 JetPack 与 Jetson Linux 版本,并区分原厂载板和自定义载板。
- 不要只写“Jetson”“Linux”或“最新版”。版本号和镜像来源都要保留。
2. 保存实际连接图
拍摄模组、转接板、主机端口和电源连接,再配一张简图标注引脚、线缆和连接器方向。说明近期是否更换过模组、线缆、电源或系统镜像。
- 每次只改动一个可控因素,并记下改动前后的结果。
3. 区分识别、采集与图像处理
先说明设备是否被系统识别,再说明能否启动采集、输出什么格式,以及应用最终显示什么。NVIDIA 的相机开发文档区分直接 V4L2 采集与相机核心库路径;不同采集路径得到的结果,不应只用一张显示截图判断。
- 分别保留:设备识别日志、采集命令与参数、原始输出文件、应用显示结果。
4. 写一组能复现的步骤
从上电或重启开始,逐项列出操作、等待时间、采集模式和失败位置。说明问题每次发生还是偶发,是否与摄像头数量、线长、运行时间或温度变化有关。
- 填写:预期结果、实际结果、复现频率和最近一次正常配置。
5. 一次提交完整资料包
建议按日期和样品编号保存版本表、连接图、操作步骤、日志与图像。日志保留问题发生前后的内容,图像保留原始格式。若资料包含其他项目的信息,先清理无关内容。
- 资料齐全仍不代表某个模组已支持该平台;适配范围以项目评估和实际验证为准。
保存测试与配置记录
调试资料包的目标是让另一位工程师能复现同一条件。系统版本或连接方式改变后,也要更新资料包。