4. Camera HAL3 核心数据结构详解

Camera HAL3 的设计围绕一套精炼的数据结构展开，它们是 HAL 层与 Camera Service 之间通信的契约。掌握这些结构是理解 HAL3 运作机制的基础。本章将深入剖析 camera3_device_t、camera3_callback_ops_t、camera3_stream_t 和 camera3_capture_request_t 这四大核心数据结构。

4.1 camera3_device_t：HAL 设备实例

camera3_device_t 是 HAL3 设备在 Camera Service 中的抽象表示。它继承自 Android 硬件抽象层的通用设备结构 hw_device_t，并扩展了 Camera HAL3 特有的操作接口。每一个打开的 Camera 设备（如后置摄像头）都对应一个 camera3_device_t 实例。

4.1.1 结构体定义与核心字段

typedef struct camera3_device {
    hw_device_t common;                     // 继承自通用硬件设备结构
    camera3_device_ops_t *ops;              // 指向设备操作函数集的指针
    void *priv;                             // HAL 私有数据指针，由 HAL 实现管理
} camera3_device_t;

4.1.2 设备操作函数集 (camera3_device_ops_t)

camera3_device_ops_t 是 HAL3 的核心操作接口，它定义了 Camera Service 可以调用的所有功能。以下是最关键的几个函数：

• initialize：在设备打开后调用，用于初始化 HAL 设备，并注册回调函数。
• configure_streams：配置 Camera 的输入/输出流，是建立数据管道的核心步骤。
• process_capture_request：提交一个捕获请求，HAL 需要处理该请求并返回结果。
• flush：清空所有正在处理的请求，用于快速停止或重置设备。
• dump：导出 HAL 设备的调试信息。

4.2 camera3_callback_ops_t：异步回调接口

Camera HAL3 是一个异步系统。当 HAL 处理完一个请求或产生事件时，它不能直接调用 Service 的内部方法，而是通过 camera3_callback_ops_t 结构体中注册的回调函数来通知 Service。这个结构体由 Camera Service 实现，并在 initialize() 时传递给 HAL。

4.2.1 核心回调函数

4.2.2 回调机制的重要性

• 解耦：HAL 不需要知道 Service 的内部实现细节，只需调用函数指针。
• 异步性：HAL 可以在自己的线程中处理完请求后，通过回调返回结果，不会阻塞 Service。
• 生命周期管理：Service 通过 notify 回调中的 CAMERA3_MSG_ERROR 事件来感知 HAL 层的错误，并进行恢复或销毁操作。

4.3 camera3_stream_t：数据流描述

camera3_stream_t 描述了一个 Camera 数据流的属性。它定义了图像的格式、尺寸、用途以及 HAL 和 Service 之间传递 buffer 的方式。在 configure_streams() 阶段，Service 会创建一个或多个 camera3_stream_t 实例，并传递给 HAL 进行配置。

4.3.1 核心字段解析

4.3.2 流配置流程

1. Service 创建流数组：根据应用层的需求（如预览、拍照、录像）创建 camera3_stream_t 数组。
2. 调用 configure_streams()：Service 将流数组传递给 HAL。
3. HAL 验证并调整：HAL 检查流参数是否支持，并可以修改 usage、max_buffers 和 format 字段。
4. 分配 buffer：配置完成后，Service 和 HAL 通过 Gralloc 分配器为这些流分配实际的图形 buffer。

4.4 camera3_capture_request_t：捕获请求

每一个拍照或预览帧的请求都由 camera3_capture_request_t 结构体描述。它包含了 HAL 处理一帧图像所需的所有信息：目标流、元数据、输入 buffer 等。Service 通过 process_capture_request() 将请求提交给 HAL。

4.4.1 结构体核心字段

typedef struct camera3_capture_request {
    uint32_t frame_number;                  // 帧序号，单调递增
    const camera3_stream_buffer_t *input_buffer; // 输入 buffer (用于 reprocessing)
    uint32_t num_output_buffers;            // 输出 buffer 数量
    const camera3_stream_buffer_t *output_buffers; // 输出 buffer 数组
    const camera_metadata_t *settings;      // 请求的元数据 (3A 参数等)
    uint32_t num_physcam_settings;          // 物理相机设置数量 (多摄)
    const camera_metadata_t **physcam_settings; // 物理相机设置数组
} camera3_capture_request_t;

4.4.2 请求生命周期

1. 创建：Service 根据应用层的请求（如点击拍照按钮）创建一个 camera3_capture_request_t 实例。
2. 填充：Service 填充帧序号、输出 buffer 列表（从对应流的 buffer 池中取出）、以及包含 AE/AWB/AF 等参数的元数据。
3. 提交：Service 调用 process_capture_request() 将请求发送给 HAL。
4. 处理：HAL 解析请求，驱动 ISP 进行图像处理，并将结果填充到输出 buffer 中。
5. 返回：HAL 通过 process_capture_result() 回调将填充好的 buffer 和结果元数据返回给 Service。

4.5 数据结构关系总结

这四种数据结构共同构成了 HAL3 的通信骨架：

• camera3_device_t 是通信的端点，提供了操作入口。
• camera3_callback_ops_t 是反向通道，用于异步通知。
• camera3_stream_t 定义了数据的格式和流向。
• camera3_capture_request_t 是驱动数据流动的指令单元。