📚 课程目录第2章 Camx Pipeline基础概念

HAL架构下Camx Pipeline配置与性能调优 - 第2节

2.1 Pipeline 的定义与核心作用

在 Camx 架构中，Pipeline 是相机数据流处理的基本执行单元。它定义了一组按特定顺序排列的硬件 IP（如 ISP、传感器、DMA）和软件算法节点，用于完成从 RAW 图采集到最终输出帧的完整处理链路。每个 Pipeline 实例对应一次具体的拍照、预览或录像请求。

  核心要点：Pipeline 是 HAL 层向 Camera Framework 暴露的最小功能单元，其配置直接决定相机启动速度、帧率和图像质量。

2.1.1 Pipeline 的组成要素

组成要素	说明	示例
Node（节点）	Pipeline 中的最小处理单元，对应一个硬件模块或软件算法	IFE、IPE、BPS、Stats
Link（链路）	节点之间的数据通道，定义数据流向和缓冲区传递方式	IFE→IPE、Sensor→IFE
Port（端口）	节点的输入/输出接口，支持多输入多输出	Input Port 0、Output Port 1
Buffer Queue（缓冲队列）	节点间数据暂存与同步机制	HAL Buffer、Stream Buffer

2.1.2 Pipeline 的配置描述

Pipeline 的拓扑结构通过 XML 或 JSON 配置文件定义，在 Camx 中通常以 camxsettings.xml 或 pipeline_*.xml 形式存在。以下是一个简化的 Pipeline 配置片段：

<Pipeline name="ZSL_Preview" id="0x1001">
    <Node name="Sensor" type="HW">
        <Port id="0" direction="output"/>
    </Node>
    <Node name="IFE" type="HW">
        <Port id="0" direction="input"/>
        <Port id="1" direction="output"/>
    </Node>
    <Link from="Sensor:0" to="IFE:0"/>
    <Link from="IFE:1" to="IPE:0"/>
</Pipeline>

2.2 Pipeline 的生命周期

Pipeline 从创建到销毁经历五个关键阶段，每个阶段都涉及资源分配、状态迁移和性能调优点。

创建（Create）：解析配置、分配内存、初始化硬件 IP。
配置（Configure）：设置分辨率、帧率、格式等参数。
启动（Start）：激活硬件时钟、开始帧同步。
运行（Run）：持续处理帧数据，处理请求与回调。
销毁（Destroy）：停止硬件、释放缓冲区、清理资源。

性能调优提示：Pipeline 的创建和销毁阶段是相机启动/关闭延迟的主要来源。建议在系统初始化时预创建常用 Pipeline，避免运行时频繁创建销毁。

2.2.1 生命周期状态机

下图展示了 Pipeline 在 Camx HAL 层中的状态迁移路径：

2.3 Pipeline 的拓扑结构

Camx 支持三种基本的 Pipeline 拓扑结构，分别适用于不同的相机场景需求。理解拓扑结构是进行性能调优和资源规划的基础。

2.3.1 线性拓扑（Linear Pipeline）

线性拓扑是最简单的 Pipeline 结构，数据按固定顺序依次经过每个节点，无分支、无合并。适用于基础预览和单帧拍照场景。

  适用场景：基础预览、单帧拍照、低延迟需求场景。

  性能特点：延迟最低，但无法并行处理多路数据流。

2.3.2 分支拓扑（Branch Pipeline）

分支拓扑从一个源节点分出多条并行路径，每条路径独立处理数据。适用于同时输出不同分辨率或格式的场景，如预览 + 拍照 + 视频录制。

调优要点：分支拓扑中，分支节点的带宽分配是关键。如果 IFE 输出带宽不足，会导致帧率下降。建议根据各分支的优先级动态调整带宽配额。

2.3.3 合并拓扑（Merge Pipeline）

合并拓扑将多个输入源的数据汇聚到一个节点进行处理。常用于多摄像头融合（如双摄虚化、超分辨率）或传感器数据融合场景。

注意事项：合并拓扑对帧同步要求极高。如果两个输入源的帧到达时间不一致，会导致融合失败或图像错位。必须配置硬件帧同步（Frame Sync）机制。

2.4 拓扑结构对比与选型指南

拓扑类型	延迟	吞吐量	资源消耗	典型场景
线性	低	中	低	基础预览、单帧拍照
分支	中	高	中	多路输出（预览+拍照+录像）
合并	高	低	高	多摄融合、超分辨率

  选型建议：在性能敏感场景（如高帧率录像）优先选择线性拓扑；在多路输出场景使用分支拓扑；在图像质量优先场景（如夜景模式）使用合并拓扑。实际产品中常采用混合拓扑，即在一个 Pipeline 中同时包含分支和合并节点。

2.5 本章小结

Pipeline 定义：Camx 中数据流处理的基本单元，由 Node、Link、Port、Buffer Queue 组成。
生命周期：Create → Configure → Start → Run → Destroy，每个阶段都有对应的资源管理策略。
三种拓扑：线性（低延迟）、分支（高吞吐）、合并（多源融合），实际应用中常组合使用。
配置方式：通过 XML/JSON 文件定义拓扑结构，运行时由 Camx HAL 解析并实例化。