📚 课程目录第1章 CHI架构总览

CHI配置进阶：高通Camera项目管线链路参数调优 - 第1节

1.1 高通Camera HAL3与CHI框架关系

高通平台的Camera软件栈在Android HAL3接口之上，引入了CHI (Camera Hardware Interface)架构。CHI并非替代HAL3，而是在HAL3标准框架内，提供了一套可配置、可扩展的硬件抽象层实现。

1.1.1 层级关系

核心理解：CHI是HAL3的具体实现，HAL3是Android定义的接口规范，CHI通过XML配置驱动底层ISP硬件，实现管线链路的灵活编排。

1.1.2 HAL3与CHI职责对比

维度	Android HAL3	高通CHI
定位	接口规范，定义camera3_device_ops回调	HAL3的具体实现，面向高通ISP硬件
配置方式	代码硬编码或vendor tag	XML驱动，运行时动态加载管线配置
管线管理	Stream配置固定，灵活性低	Pipeline可组合、可复用、可调优
扩展性	需修改HAL代码	修改XML即可调整行为，无需重新编译
调试手段	log + dump	XML参数热加载 + CHI Tuning Tool

调优启示：CHI架构下，大部分管线行为由XML控制，调优工作从"改代码"转变为"改配置"，大幅降低了开发门槛和迭代周期。

1.2 CHI XML配置体系概述

CHI XML配置体系是整个调优工作的核心。高通将Camera硬件管线的拓扑结构、节点参数、流控制策略全部抽象为XML文件，在系统启动时由CHI解析引擎加载并实例化。

1.2.1 配置文件的分类与作用

1.2.2 XML配置加载流程

平台初始化：CHI驱动加载 camxsettings.xml，获取平台能力、Sensor列表、最大管线数等全局信息。
Sensor探测：根据 sensor_*.xml 中的寄存器配置，初始化物理Sensor并获取其能力。
管线构建：根据 pipeline_*.xml 定义的拓扑，创建ISP硬件管线节点。
调优参数注入：加载 tuning_*.xml 中的ISP参数（AEC、AWB、AF、降噪、锐化等）。
用例绑定：通过 usecase_*.xml 将不同场景（预览、拍照、录像）映射到对应的管线。

常见陷阱：XML文件之间的引用关系必须正确，例如pipeline中引用的node名称必须在tuning文件中存在，否则CHI解析会失败，导致Camera无法启动。

1.3 管线 (Pipeline) 概念

Pipeline是CHI架构中最核心的抽象概念。一条Pipeline代表一条从Sensor输入到最终图像输出的完整数据处理链路，由多个Node（节点）串联而成。

1.3.1 Pipeline的基本组成

1.3.2 常见Pipeline类型

Pipeline类型	典型用途	包含节点	输出格式
Preview Pipeline	取景预览	Sensor → IFE → IPE → Display	NV12 / YUV
Snapshot Pipeline	拍照	Sensor → IFE → BPS → IPE → JPEG	YUV → JPEG
Video Pipeline	录像	Sensor → IFE → IPE → Encoder	NV12
ZSL Pipeline	零快门延迟	Sensor → IFE → BPS → IPE → (双路输出)	YUV + JPEG
Raw Pipeline	专业模式/算法调试	Sensor → IFE → Raw Output	Bayer RAW

1.3.3 Pipeline的XML定义示例

以下是一个简化的Preview Pipeline XML定义片段，展示了Node的链接关系和参数配置：

<Pipeline name="preview_pipeline">
    <Node name="sensor_node" type="Sensor">
        <Output port="0" link="ife_node:0"/>
    </Node>
    <Node name="ife_node" type="IFE">
        <Input port="0" from="sensor_node:0"/>
        <Output port="0" link="ipe_node:0"/>
        <Parameter name="output_width" value="1920"/>
        <Parameter name="output_height" value="1080"/>
    </Node>
    <Node name="ipe_node" type="IPE">
        <Input port="0" from="ife_node:0"/>
        <Output port="0" link="display_node:0"/>
        <Parameter name="denoise_level" value="3"/>
        <Parameter name="sharpness" value="5"/>
    </Node>
    <Node name="display_node" type="Output">
        <Input port="0" from="ipe_node:0"/>
        <Format width="1920" height="1080" color="NV12"/>
    </Node>
</Pipeline>

调优切入点：上述XML中的 denoise_level 和 sharpness 就是典型的调优参数。修改这些值无需重新编译代码，只需更新XML文件并重启Camera服务即可生效。

1.3.4 Pipeline的生命周期

创建 (Create)：CHI根据XML定义，在内存中构建Pipeline对象，分配硬件资源。
配置 (Configure)：根据Stream请求，设置分辨率、帧率、格式等参数。
启动 (Start)：激活Pipeline，Sensor开始输出数据，Node开始处理。
运行 (Run)：持续处理每一帧数据，直到收到停止命令。
停止 (Stop)：停止数据流，释放硬件资源。
销毁 (Destroy)：释放Pipeline对象占用的所有内存和资源。

性能关键：Pipeline的创建和销毁是耗时操作，在需要频繁切换场景（如预览→拍照→预览）时，建议使用Pipeline复用或预创建策略，避免重复创建开销。

1.4 本章小结

CHI是Android HAL3在高通平台上的具体实现，通过XML配置驱动ISP管线。
CHI XML配置体系包含全局设置、管线拓扑、Sensor驱动、调优参数、统计配置和用例绑定六大类文件。
Pipeline是CHI的核心抽象，由多个Node串联形成完整的数据处理链路。
不同类型的Pipeline（Preview、Snapshot、Video、ZSL、Raw）对应不同的应用场景和节点组合。
调优工作主要围绕Pipeline中各个Node的参数进行，修改XML即可快速迭代。