第4章：3A算法参数体系：高通3A XML配置文件结构、关键Tag解析、参数作用域与优先级
做3A调优，绕不开的就是高通那套XML配置文件。说实话，我第一次打开这个文件的时候，头都大了——几千行配置，各种看不懂的Tag，嵌套层级深得离谱。后来摸爬滚打多了，才慢慢理清楚它的套路。
这一章，我就带你把它拆开揉碎。你只要搞懂三件事：文件怎么组织的、关键Tag是干什么的、参数打架时听谁的。这三件事通了，XML在你眼里就不再是天书。
4.1 配置文件结构：一棵树，三个根
高通的3A XML，本质上是一棵配置树。树根有三个主分支：AEC、AWB、AF。每个分支下面挂着自己的参数节点。
我习惯把它想象成三个独立的“配置空间”。每个空间里，又按功能模块继续细分。比如AEC下面，会有曝光策略、增益限制、帧率控制这些子模块。
核心结构示意：
<SensorName>IMX586_Sensor</SensorName>
<AEC>
<ExpControl>...</ExpControl>
<GainControl>...</GainControl>
<FrameRateControl>...</FrameRateControl>
</AEC>
<AWB>
<ColorTemperature>...</ColorTemperature>
<GainLimit>...</GainLimit>
</AWB>
<AF>
<SearchStrategy>...</SearchStrategy>
<LensControl>...</LensControl>
</AF>嗯，这里要注意：根节点名称是固定的，你不能自己发明一个叫“HDR”的根节点。所有自定义参数，都得挂在已有的三个根下面。
4.2 关键Tag解析：你必须要认识的“熟人”
XML里Tag少说上百个，但真正天天打交道的，也就二三十个。我挑几个最关键的，给你过一遍。
4.2.1 AEC核心Tag
| Tag路径 | 作用 | 我的经验 |
|---|---|---|
AEC/ExpControl/TargetBrightness |
目标亮度，决定画面整体明暗 | 别死磕一个值。室内和室外，差2~3档很正常 |
AEC/GainControl/MaxAnalogGain |
模拟增益上限，直接影响噪点 | 我曾经为了压低噪点，把上限设到4x，结果暗光下画面死活提不亮 |
AEC/FrameRateControl/MinFrameRate |
最低帧率，防抖和预览流畅度的底线 | 低于15fps时，预览卡顿感就很明显了 |
AEC/ExpStrategy/Mode |
曝光模式：自动、快门优先、光圈优先 | 大部分场景用自动就行，特殊场景才切模式 |
4.2.2 AWB核心Tag
| Tag路径 | 作用 | 我的经验 |
|---|---|---|
AWB/ColorTemp/RangeMin |
色温下限，通常设为2000K | 低于2000K的场景极少，设太低反而容易误判 |
AWB/ColorTemp/RangeMax |
色温上限，通常设为8000K | 户外强阳光下可能到7500K，留点余量 |
AWB/GainLimit/RGainMax |
R增益上限，防止偏红 | 设太高，白炽灯下画面会红得离谱 |
AWB/GainLimit/BGainMax |
B增益上限，防止偏蓝 | 阴天场景容易触发，注意平衡 |
4.2.3 AF核心Tag
| Tag路径 | 作用 | 我的经验 |
|---|---|---|
AF/SearchStrategy/Mode |
对焦策略：反差对焦、相位对焦、混合 | 混合模式最稳，但功耗高一点 |
AF/LensControl/StepSize |
马达步进大小，影响对焦速度和精度 | 步进太大容易过冲，太小对焦慢 |
AF/LensControl/InfinityPos |
无穷远位置，校准用 | 每颗模组都有差异，量产时要单独校准 |
小技巧： 我习惯在XML里用注释标注每个Tag的“最后修改日期”和“修改人”。团队协作时，这能省掉很多扯皮的时间。
4.3 参数作用域与优先级：到底听谁的？
这是最容易踩坑的地方。同一个参数，可能在多个地方出现。比如TargetBrightness，在sensor.xml里有一个值，在common.xml里也有一个值，在scene_mode.xml里还有一个值。那到底听谁的？
高通有一套明确的优先级规则，我把它总结成一句话：越具体的配置，优先级越高。
具体来说，优先级从高到低是这样的：
- 场景模式配置（如
scene_mode_portrait.xml）—— 最高 - 模组级配置（如
sensor_imx586.xml） - 平台级配置（如
common.xml） - 默认配置（芯片内部硬编码）—— 最低
举个例子：你在common.xml里把MaxAnalogGain设为8x，但在scene_mode_night.xml里设为4x。那夜景模式下，实际生效的是4x。其他场景，才用8x。
避坑指南： 我曾经犯过一个错——在common.xml里改了TargetBrightness，但发现某个场景下没生效。查了半天，才发现那个场景有自己的scene_mode.xml，里面的值覆盖了common的配置。所以，改参数前，先确认当前生效的是哪一层。
4.4 参数继承与覆盖机制
除了优先级，还有一个概念叫“继承”。高通的配置系统，有点像面向对象编程——子配置会继承父配置的参数，除非子配置显式覆盖了它。
我画了一张图，帮你理解这个关系：
你看，从下往上，优先级越来越高。但反过来，从上往下，覆盖范围越来越广。默认配置覆盖所有芯片，平台级覆盖所有模组，模组级覆盖所有场景，场景级只覆盖特定场景。
这个设计其实很合理。你想想看，芯片厂商定一个“能用”的默认值，平台厂商根据硬件特性调一个“通用”的值，模组厂商针对具体传感器再优化，最后场景调优师针对不同场景做微调。各司其职，互不干扰。
4.5 实战：如何快速定位生效参数
说了这么多理论，来点实际的。当你面对一个3A问题，怎么快速找到当前生效的参数值？
我的做法分三步：
- 先看场景：当前是普通预览、拍照、还是夜景模式？找到对应的
scene_mode_xxx.xml。 - 再看模组：当前用的是哪个sensor？找到对应的
sensor_xxx.xml。 - 最后看common：如果前两层都没定义，就去
common.xml里找。
举个例子。假设你在调试夜景模式，发现画面偏暗。你想改TargetBrightness。按上面的步骤：
- 先打开
scene_mode_night.xml，看里面有没有TargetBrightness。如果有，直接改这里。 - 如果没有，再打开
sensor_imx586.xml，看里面有没有。 - 如果还没有，最后去
common.xml里改。
调试小工具： 高通有个工具叫QCARC，可以实时dump当前生效的3A参数。我每次调参前，都会先dump一份，确认当前到底在用哪一层的配置。这能避免很多“改了没生效”的乌龙。
4.6 本章小结
这一章的内容，说白了就是三句话：
- 结构：XML是一棵树，三个根（AEC、AWB、AF），每个根下面挂自己的参数。
- 关键Tag：记住那十几个核心Tag，其他的用到再查。
- 优先级：场景级 > 模组级 > 平台级 > 默认配置。越具体，越优先。
把这些搞清楚了，XML配置文件在你眼里就不再是黑盒。下一层，我们就要开始真正动手调参了——从AEC的曝光策略开始。