Camera HAL3开发调试与图像参数适配 - 第1节

1.1 Camera HAL 在 Android 系统中的位置

Android 相机系统采用分层架构，从上至下依次为 应用层 (Application Framework)、相机服务层 (Camera Service)、HAL 层 (Hardware Abstraction Layer) 以及 内核驱动层 (Kernel Driver)。Camera HAL 位于用户空间的相机服务与内核空间的硬件驱动之间，是连接 Android 框架与具体摄像头硬件的关键桥梁。

以下示意图展示了 Camera HAL 在 Android 相机栈中的具体位置与上下游关系：

1.2 HAL 层的作用

HAL 层在 Android 相机系统中承担着 硬件抽象、接口标准化 和 功能封装 三大核心作用。具体体现在以下几个方面：

1.3 Camera HAL3 架构简介

Android 从 API Level 21（Android 5.0）开始引入 Camera HAL3 架构，取代了旧的 HAL1 架构。HAL3 的核心设计理念是 基于请求的流水线模型 (Request-based Pipeline)，将相机设备抽象为一个可配置的 处理流水线 (Pipeline)。

1.3.1 HAL3 核心组件

HAL3 架构由以下几个关键组件构成：

• Camera Device (camera3_device_t)：代表一个物理或逻辑摄像头设备，是 HAL 层与 Camera Service 交互的主要对象。
• Camera Module (camera_module_t)：负责枚举系统中的摄像头设备，提供设备信息查询接口。
• Stream (camera3_stream_t)：表示一条数据流，定义了图像的格式、分辨率、用途（预览/拍照/录像等）。
• Request (camera3_capture_request_t)：上层下发的捕获请求，包含输出流列表、控制元数据（如 AE/AWB/AF 参数）。
• Result (camera3_capture_result_t)：HAL 返回的捕获结果，包含输出 Buffer 和结果元数据。
• Metadata (CameraMetadata)：使用键值对（Key-Value）结构描述相机参数和控制信息，是 HAL3 中传递配置的核心载体。

1.3.2 HAL3 请求-结果流水线模型

HAL3 的工作流程遵循“请求-处理-结果”的循环模式。Camera Service 向 HAL 下发捕获请求，HAL 按照请求中的配置参数处理图像数据，最终返回结果。这种模型支持多请求并发、多流并行输出，极大提升了灵活性和性能。

1.3.3 HAL3 与 HAL1 的关键差异

理解 HAL3 与 HAL1 的区别，有助于把握 HAL3 的设计优势：

1.3.4 HAL3 关键数据结构

HAL3 中定义了若干关键数据结构，是进行 HAL 层开发与调试时必须掌握的：

// camera3_device_ops_t：HAL 设备操作接口
typedef struct camera3_device_ops {
    int (*initialize)(const struct camera3_device *, const camera3_callback_ops_t *);
    int (*configure_streams)(const struct camera3_device *, camera3_stream_configuration_t *);
    int (*register_stream_buffers)(const struct camera3_device *, const camera3_stream_buffer_set_t *);
    const camera_metadata_t *(*construct_default_request_settings)(const struct camera3_device *, int type);
    int (*process_capture_request)(const struct camera3_device *, camera3_capture_request_t *);
    void (*dump)(const struct camera3_device *, int fd);
    int (*flush)(const struct camera3_device *);
    void (*signal_stream_flush)(const struct camera3_device *, uint32_t num_streams, const camera3_stream_t *const *streams);
    // ... 其他回调函数
} camera3_device_ops_t;

// camera3_capture_request_t：捕获请求结构体
typedef struct camera3_capture_request {
    uint32_t frame_number;                    // 帧序号
    const camera_metadata_t *settings;        // 控制元数据
    size_t num_output_buffers;                // 输出 Buffer 数量
    const camera3_stream_buffer_t *output_buffers; // 输出 Buffer 数组
    // ... 其他字段
} camera3_capture_request_t;

// camera3_capture_result_t：捕获结果结构体
typedef struct camera3_capture_result {
    uint32_t frame_number;                    // 对应请求的帧序号
    const camera_metadata_t *result;          // 结果元数据
    size_t num_output_buffers;                // 输出 Buffer 数量
    const camera3_stream_buffer_t *output_buffers; // 输出 Buffer 数组
    // ... 其他字段
} camera3_capture_result_t;