常见问题实战：Camera HAL工程排查与案例解析 - 第1节

1.1 Camera HAL 在 Android 系统中的位置与作用

Camera HAL（Hardware Abstraction Layer）是 Android 相机子系统中连接 Framework 与底层硬件驱动的关键中间层。它定义了上层相机服务（CameraService）与硬件实现之间的标准接口，使得同一套 Android 系统能够适配不同厂商的摄像头硬件。

1.1.1 系统层级关系

从 Android 相机软件栈的纵向分层来看，Camera HAL 处于承上启下的关键位置：

1. 应用层（App）：调用 Camera2 API 或 Camera1 API 发起拍照/录像请求。
2. Framework 层：CameraService 管理客户端连接、权限校验、流配置与数据分发。
3. HAL 层：实现 camera_module_t、camera3_device_t 等接口，负责将 Framework 的请求转换为硬件指令。
4. Kernel 层：V4L2、CSI、I2C 等驱动与传感器、ISP 硬件交互。

1.1.2 作用总结

1.2 HAL3 与 HAL1 架构对比

Android 相机 HAL 经历了从 HAL1 到 HAL3 的重大架构演进。HAL3（即 Camera3 HAL）是当前主流架构，HAL1 仅用于兼容老旧设备或特定低端场景。理解两者的差异是排查 HAL 问题的前提。

1.2.1 架构设计对比

1.2.2 HAL3 请求-响应模型

HAL3 的核心是 Capture Request / Capture Result 模型。每一帧的采集都由一个独立的请求驱动，HAL 处理完成后返回结果。这种设计使得每一帧的控制参数、输出流、元数据都可以独立配置。

// HAL3 核心接口：process_capture_request
int process_capture_request(const camera3_capture_request_t *request);

// 请求结构体关键字段
typedef struct camera3_capture_request {
    uint32_t                frame_number;       // 帧序号，单调递增
    const camera3_stream_t  **output_buffers;   // 输出 buffer 数组
    size_t                  num_output_buffers; // 输出 buffer 数量
    const camera_metadata_t *settings;          // 帧控制元数据
    // ...
} camera3_capture_request_t;

1.3 HAL 接口定义与核心数据结构

Camera HAL 的接口定义集中在 hardware/libhardware/include/hardware/camera3.h 和 camera_common.h 中。理解这些接口和数据结构是进行 HAL 层问题定位的基础。

1.3.1 模块级接口：camera_module_t

HAL 模块的入口点，Framework 通过 hw_get_module() 加载并获取该结构体。

typedef struct camera_module {
    hw_module_t common;                         // 继承自 hw_module_t
    int (*get_number_of_cameras)(void);         // 获取摄像头数量
    int (*get_camera_info)(int id, struct camera_info *info); // 获取摄像头信息
    int (*set_callbacks)(const camera_module_callbacks_t *callbacks); // 注册回调
    void (*get_vendor_tag_ops)(vendor_tag_ops_t *ops); // 获取厂商自定义 tag
    int (*open_legacy)(const struct hw_module_t *module, const char *id,
                       uint32_t halVersion, struct hw_device_t **device); // 打开旧版 HAL
    // ...
} camera_module_t;

1.3.2 设备级接口：camera3_device_t

每个摄像头设备对应一个 camera3_device_t 实例，Framework 通过 open() 获取。

typedef struct camera3_device {
    hw_device_t common;                         // 继承自 hw_device_t
    int (*initialize)(const struct camera3_device *,
                      const camera3_callback_ops_t *callback_ops); // 初始化
    int (*configure_streams)(const struct camera3_device *,
                             camera3_stream_configuration_t *config); // 配置流
    int (*register_stream_buffers)(const struct camera3_device *,
                                   const camera3_stream_buffer_set_t *buffer_set); // 注册 buffer
    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 *request); // 处理捕获请求
    void (*dump)(const struct camera3_device *, int fd); // 导出调试信息
    int (*flush)(const struct camera3_device *); // 刷新所有待处理请求
    // ...
} camera3_device_t;

1.3.3 核心数据结构

1.3.4 元数据系统

camera_metadata_t 是 HAL3 中最重要的数据结构之一。它使用紧凑的二进制格式存储数百个控制项（如 ANDROID_SENSOR_EXPOSURE_TIME）和结果项（如 ANDROID_SENSOR_TIMESTAMP）。

// 元数据查找示例
camera_metadata_entry_t entry;
int ret = find_camera_metadata_entry(metadata,
    ANDROID_SENSOR_SENSITIVITY, &entry);
if (ret == 0) {
    int32_t iso = entry.data.i32[0];  // 读取 ISO 值
}