4. HAL3 Pipeline 模型：request、result、stream、buffer 管理、pipeline 深度解析

Camera HAL3 的核心设计思想是 Pipeline（流水线） 模型。它将一次拍照或预览抽象为一个由多个阶段组成的、可并行处理的请求-响应循环。理解 Pipeline 模型是掌握 HAL3 适配的关键，它直接决定了相机的吞吐量、延迟和资源利用率。

4.1 Pipeline 核心概念与数据流

Pipeline 模型包含四个核心抽象：Request、Result、Stream 和 Buffer。它们之间的关系构成了 HAL3 的数据流动骨架。

4.2 Request 与 Result：请求-响应契约

Capture Request 是 Pipeline 的输入，Capture Result 是输出。它们通过 frame_number 唯一关联，形成一对一的契约关系。

4.2.1 Capture Request 结构

一个 Request 包含以下关键字段：

4.2.2 Capture Result 结构

Result 是 HAL 对 Request 的响应，包含处理后的元数据和填充好的缓冲区：

// HAL3 中 Result 的核心结构
typedef struct camera3_capture_result {
    uint32_t            frame_number;       // 对应 Request 的帧号
    const camera3_stream_buffer_t *output_buffers; // 输出缓冲区数组
    uint32_t            num_output_buffers; // 输出缓冲区数量
    const camera3_stream_buffer_t *input_buffers;  // 输入缓冲区（reprocessing）
    uint32_t            num_input_buffers;
    const camera_metadata_t *result;        // 最终元数据（包含 3A 结果、统计信息等）
    uint32_t            partial_result;     // 部分结果标记（用于分阶段返回）
} camera3_capture_result_t;

4.3 Stream 与 Buffer 管理

Stream 定义了数据的格式和用途，Buffer 是实际的数据载体。HAL3 通过 configure_streams 建立 Stream 配置，然后在运行时通过 Buffer 管理机制进行数据交换。

4.3.1 Stream 配置表

4.3.2 Buffer 管理流程

Buffer 在 HAL 和 Framework 之间通过 Dequeue → Fill → Enqueue 循环流转：

1. Dequeue： HAL 从 Stream 的 Buffer 池中取出一个空闲 Buffer。
2. Fill： HAL 将 Sensor 数据或 ISP 处理后的数据写入 Buffer。
3. Enqueue： HAL 将填充好的 Buffer 通过 process_capture_result 返回给 Framework。
4. Release： Framework 消费完数据后，将 Buffer 归还给 HAL 的 Buffer 池。

4.4 Pipeline 深度解析：从 Request 到 Result 的完整路径

一个完整的 Pipeline 周期包含以下阶段：

4.5 Pipeline 深度与性能调优

Pipeline 深度（outstanding request count）是 HAL3 性能调优的核心参数。它决定了系统能够同时处理多少个未完成的 Request。

4.6 Treble 架构下的 Pipeline 适配要点

在 Treble 架构中，HAL3 Pipeline 的实现需要额外关注以下方面：

• HIDL 接口封装： process_capture_request 和 process_capture_result 需要通过 ICameraDevice HIDL 接口进行跨进程调用，注意 IPC 性能开销。
• Buffer 传递： 使用 hidl_memory 或 native_handle_t 传递 Buffer 句柄，避免跨进程拷贝大块数据。
• 同步机制： 利用 camera3_stream_buffer 中的 acquire_fence 和 release_fence 实现跨进程同步，防止数据竞争。
• Vendor 扩展： 在 Pipeline 中插入 Vendor 特定的处理节点（如 AI 降噪、HDR 融合）时，必须通过 vendor_tag 暴露配置接口。