3. 图像质量调试环境搭建
图像质量调试不是“把板子接上、打开软件看画面”这么简单。同一颗 onsemi 传感器，在不同镜头、不同光源、不同曝光与增益下，输出的图像质量指标可能相差很大。因此，调试环境搭建的核心目标是：让传感器工作在一个可复现、可量化、可对比的成像条件下，这样后续的 IQ 调优、参数标定和问题定位才有意义。本节围绕评估板、镜头、光源与图卡、采集工具、数据抓取与日志记录五个环节展开，并给出可直接参考的配置与记录方法。
一、评估板：先确认“数据通路”和“控制通路”
onsemi 的评估板通常由传感器子板（如 AR0234、AR0820、AR0233 等）加转接底板组成，底板负责 MIPI/LVDS 输出、I²C 控制、时钟与供电。搭建时先区分两条通路：控制通路走 I²C，用于配置寄存器、曝光、增益、帧率、测试图案；数据通路走 MIPI CSI-2 或并行接口，把 RAW/YUV 数据送到采集端。两条通路必须分别确认，否则会出现“寄存器能读、画面不出”或“有画面但参数改不动”的典型问题。
上电顺序建议为：先接好地线与电源（典型 1.8V/2.8V/3.3V 多路供电），再给时钟，最后接 MIPI 排线。若评估板支持外部触发，调试阶段可先使用内部自由运行模式，稳定后再切到触发同步。判断评估板是否正常，最直接的方法是让传感器输出内部测试图案（如彩条、渐变、棋盘格），此时不依赖镜头和光源，若采集端能看到干净图案，说明数据通路基本正常。
二、镜头选型：视场角、光圈、分辨率与接口
镜头选型要围绕“拍什么、看多远、看多细”三个问题。关键参数包括焦距、视场角（FOV）、光圈（F 数）、接口（M12、C/CS 等）、靶面尺寸和分辨率。靶面必须覆盖传感器像面，否则会出现暗角；镜头分辨率要匹配像素尺寸，例如 2.2µm 像素、500 万像素传感器，若镜头 MTF 不足，边缘会明显发虚。
以车载前视示例：传感器有效像面约 1/2.7 英寸，选用 6mm 焦距、F1.6、M12 接口镜头，水平视场角约 60°，适合中距离目标。若换成 3.6mm 镜头，视场角变大约 90°，但远处细节下降。调试时建议固定一支“参考镜头”，所有参数对比都在同一镜头下进行，避免把镜头差异误判为传感器差异。
三、光源与测试图卡：让成像条件可复现
光源决定色温、显色性和照度均匀性。调试常用 D65（约 6500K）或 D50 标准光源，配合可调亮度，照度建议覆盖 10～1000 lux 范围，以模拟白天到黄昏。光源要避免频闪，否则会出现横纹或曝光波动。测试图卡常用 24 色卡（ColorChecker）、灰阶卡、分辨率卡（ISO 12233）、棋盘格和均匀白场卡。图卡应垂直正对镜头，距离按图卡尺寸和视场角计算，保证图卡占满画面约 80%。
四、采集工具：DevWare 与 Sensor Studio
onsemi 常用 DevWare 进行寄存器级调试和 RAW 数据抓取，Sensor Studio 则更适合图形化查看和参数调整。两者都需要正确选择设备、接口和传感器型号。DevWare 中可实时读写寄存器、保存 RAW 帧、导出寄存器列表；Sensor Studio 可直观看到曝光、增益、帧率变化对画面的影响。调试时建议先用 DevWare 确认寄存器写入生效，再用 Sensor Studio 做可视化对比。
五、数据抓取与日志记录：让每次调试可追溯
每次调试必须记录：日期、传感器型号、评估板编号、镜头型号、光源类型与照度、图卡类型、曝光/增益/帧率、寄存器关键值、抓取的 RAW 文件名和观察结论。RAW 数据建议按“日期_传感器_镜头_光源_曝光_增益”命名，例如 20240612_AR0234_6mm_D65_500lux_10ms_2x.raw。日志可用表格维护，便于后续对比和回归。
六、实操建议与常见问题
搭建完成后，建议按以下顺序验证：第一步，评估板输出内部测试图案，确认数据通路；第二步，装上参考镜头，对准均匀白场，检查暗角和亮度均匀性；第三步，换 24 色卡，检查白平衡和色彩还原；第四步，换分辨率卡，检查 MTF 和边缘清晰度；第五步，改变曝光和增益，观察噪声和动态范围变化。每一步都记录日志和 RAW 文件。
常见问题包括：MIPI 排线接触不良导致花屏，需重新插拔并确认方向；I²C 地址冲突导致寄存器读写失败，需确认地址跳线；光源频闪导致横纹，需改用直流或高频光源；镜头后焦不准导致整体模糊，需调整法兰距或使用垫片。遇到问题时，先回到“内部测试图案”这一步，快速判断是数据通路问题还是光学问题。
最后，环境搭建不是一次性的，而是一个持续维护的基准。建议固定一套“参考配置”：同一块评估板、同一支镜头、同一光源、同一图卡距离，所有后续 IQ 调优都以此为基准。这样当图像质量出现波动时，才能快速判断是传感器参数变化、镜头污染、光源老化还是采集链路问题。把环境搭稳，后面的调试才有据可依。