第二章 调试环境搭建：硬件与软件的准备
调试环境搭建，说白了就是给摄像头模组搭一个「手术台」。手术台稳不稳，直接决定你能不能找到病灶。我见过太多工程师，算法调了三个月，最后发现是灯箱色温不准——白调了。
这一章，我把硬件环境和软件环境拆开讲。每个环节我都会告诉你：哪些钱不能省，哪些坑我替你踩过了。
2.1 硬件环境：光源箱、灯箱、色卡、图卡
硬件是调试的基石。你想想看，如果光源都不稳定，3A算法怎么收敛？
2.1.1 光源箱与灯箱
光源箱的核心指标就三个：色温准确度、照度均匀性、光谱连续性。
| 参数 | 要求 | 常见问题 |
|---|---|---|
| 色温准确度 | D65（6500K）偏差 < 100K | LED灯珠老化后色温漂移 |
| 照度均匀性 | 中心与边缘差异 < 5% | 灯管排列不均导致暗角 |
| 光谱连续性 | CRI > 95 | 廉价LED光谱有尖峰，影响AWB |
⚠ 我曾经踩过的坑： 有一次项目赶进度，用了供应商送的「免费灯箱」。结果D65色温实际只有5800K，AWB调试全部偏蓝。后来换了X-Rite的灯箱，一次过。光源箱的钱，真不能省。
我个人习惯，灯箱选型时至少看三个品牌：X-Rite（行业标准）、Just Normlicht（德国货，光谱稳）、国产的虹谱（性价比高，但需要定期校准）。
2.1.2 色卡与图卡
色卡是AWB的「标尺」，图卡是AE/AF的「靶子」。
- 色卡：推荐X-Rite ColorChecker Classic（24色）或Digital SG（140色）。24色卡够用，140色卡用于精细校准。
- 灰卡：柯达灰卡（18%反射率），用于手动白平衡标定。
- 图卡：ISO 12233分辨率卡（测MTF）、Dead Pixel卡（测坏点）、Shading卡（测亮度均匀性）。
💡 小技巧： 色卡用久了会褪色。我每半年用分光光度计测一次，偏差超过ΔE 2就换新。别等到AWB调不准了才想起来。
2.2 软件环境：调试工具链、驱动、串口工具、图像采集软件
硬件搭好了，软件就是你的「手术刀」。工具链不顺手，调试效率直接砍半。
2.2.1 调试工具链
主流方案分三类：
- 芯片原厂工具： 高通（Qualcomm Chromatix）、联发科（MTK Camera Tool）、海思（HiISP Tool）。功能全，但上手慢。
- 第三方工具： Imatest（图像质量分析）、DxO Analyzer（综合测试）。适合实验室批量验证。
- 自研脚本： Python + OpenCV + 串口。适合自动化回归测试。
我建议新手先从原厂工具入手。为什么？因为原厂工具直接对接寄存器，你能看到3A算法每一步的中间结果。
2.2.2 驱动与串口工具
驱动装不上，是调试环境搭建的第一道坎。
- USB驱动： 常见的是FTDI、CP210x、CH340。记得关掉Windows的驱动签名强制。
- 串口工具： SecureCRT（收费但稳定）、Putty（免费）、MobaXterm（功能多）。波特率通常115200或921600。
🔧 驱动安装避坑： 我遇到过最离谱的一次，是CH340驱动和某个蓝牙驱动冲突，导致串口一打开就蓝屏。解决办法：在设备管理器里禁用冲突设备，或者换一个USB口（不同USB控制器）。
2.2.3 图像采集软件
采集原始RAW数据，是调试的第一步。
| 软件 | 适用场景 | 特点 |
|---|---|---|
| 原厂Capture Tool | 寄存器级调试 | 能抓取RAW、YUV、统计信息 |
| Imatest Master | 图像质量分析 | 自动计算MTF、SNR、色彩精度 |
| Python + OpenCV | 自动化采集 | 灵活，但需要自己写驱动接口 |
我个人习惯，调试阶段用原厂工具，验证阶段用Imatest。原厂工具能看到寄存器值，Imatest能出报告，两者互补。
2.3 环境搭建的常见问题与避坑
这部分是我最想说的。下面这些问题，我几乎每个都遇到过。
2.3.1 硬件环境常见问题
- 灯箱色温漂移： LED灯珠用久了色温会变。解决办法：每次调试前用色温计校准，或者买带闭环反馈的灯箱。
- 图卡反光： 哑光图卡才是正道。亮光图卡在灯箱里会产生镜面反射，影响AE统计。
- 色卡摆放角度： 色卡必须与摄像头光轴垂直。偏一度，AWB结果就差一截。
2.3.2 软件环境常见问题
- 驱动冲突： 多个USB串口设备共用同一驱动，导致设备识别混乱。解决办法：每个设备用独立的USB控制器，或者手动指定COM口。
- 图像采集丢帧： USB带宽不足。解决办法：降低分辨率或帧率，或者换USB 3.0线缆。
- 工具链版本不匹配： 原厂工具和驱动版本对不上，导致连接失败。解决办法：用原厂推荐的组合版本，别追新。
⚠ 我曾经踩过的坑： 有一次用Imatest采集RAW图，怎么都连不上模组。折腾了两天，最后发现是USB线太长（5米），信号衰减了。换成1.5米的线，秒连。线缆长度，真的会影响信号完整性。
2.4 调试环境搭建流程图
下面这张图，是我自己总结的调试环境搭建流程。照着走，能省一半时间。
2.5 环境搭建检查清单
每次搭建新环境，我都会过一遍这个清单。你也试试看。
| 检查项 | 标准 | 验证方法 |
|---|---|---|
| 灯箱色温 | D65: 6500K ± 100K | 色温计测量 |
| 照度均匀性 | 中心/边缘 < 5% | 照度计九点测量 |
| 色卡状态 | ΔE < 2 | 分光光度计 |
| 驱动版本 | 与原厂工具匹配 | 设备管理器查看 |
| 串口通信 | 无丢包、无乱码 | 发送AT指令回显 |
| 图像采集 | RAW图无坏线、无丢帧 | 连续采集100帧检查 |
💡 我的习惯： 这个清单我打印出来贴在工位上。每次换项目、换模组，先过一遍清单再开始调试。省下来的时间，够你喝好几杯咖啡了。
环境搭建，说白了就是「磨刀不误砍柴工」。硬件稳了，软件通了，后面的3A调试才能顺风顺水。别急着上手调参数，先把手术台搭扎实了。