Camera HAL开发：Metadata处理与调试方法 - 第1节

1.1 Camera HAL在Android相机架构中的位置

Android相机架构采用分层设计，Camera HAL（Hardware Abstraction Layer）位于Framework与Kernel Driver之间，是连接上层相机服务与底层硬件的关键桥梁。HAL层屏蔽了不同SoC平台和传感器厂商的硬件差异，为上层提供统一的接口标准。

1.1.1 架构分层与职责

Android相机架构从上到下依次为：

1. 应用层（App）：调用Camera2 API，发送拍照/录像请求。
2. Framework层：包含CameraService、CameraProvider等系统服务，管理权限、会话和流配置。
3. HAL层：实现ICameraDevice、ICameraDeviceSession等接口，处理metadata和buffer流转。
4. Kernel层：V4L2、CSI驱动、ISP固件，控制传感器和图像信号处理器。

1.2 HAL接口版本演进

Camera HAL接口从Android早期版本至今经历了多次重大迭代，每次演进都带来了架构优化和功能增强。下表总结了主要版本的关键差异：

1.2.1 HAL v3接口核心结构

HAL v3以camera3_device_t为核心结构体，包含以下关键函数指针：

typedef struct camera3_device {
    hw_device_t common;
    // 设备操作接口
    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);
    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 *);
    void (*signal_stream_flush)(const struct camera3_device *,
                                uint32_t num_streams,
                                const camera3_stream_t *const *streams);
    int (*is_reconfiguration_required)(const struct camera3_device *,
                                       const camera3_stream_configuration_t *new_config);
} camera3_device_t;

1.3 HAL与Framework的交互流程

HAL与Framework的交互遵循请求-结果（Request-Result）模型。每次拍照或预览都对应一个完整的交互周期，涉及metadata的传递和buffer的流转。

1.3.1 核心交互流程

1. 初始化阶段：CameraService调用HAL的initialize()，注册回调函数。
2. 流配置阶段：Framework下发configure_streams()，指定输出流格式、分辨率和用途。
3. 请求下发阶段：Framework通过process_capture_request()发送CaptureRequest，包含metadata和buffer句柄。
4. HAL处理阶段：HAL解析metadata，驱动ISP和传感器完成曝光、对焦、图像处理。
5. 结果回调阶段：HAL通过process_capture_result()回调返回CaptureResult，包含结果metadata和填充后的buffer。

1.3.2 Metadata在交互中的角色

Metadata是HAL v3交互模型的核心数据载体，贯穿整个请求-结果周期：

1.3.3 Buffer管理机制

除了metadata，buffer管理也是HAL交互的重要组成部分。Framework通过dequeue_buffer/queue_buffer机制与HAL共享图像缓冲区：

// HAL端buffer处理示例
int process_capture_request(const camera3_device_t *device,
                            camera3_capture_request_t *request) {
    // 解析request中的metadata
    camera_metadata_ro_entry_t entry;
    find_camera_metadata_ro_entry(request->settings,
                                  ANDROID_SENSOR_EXPOSURE_TIME, &entry);
    int64_t exposure_time = entry.data.i64[0];

    // 获取输出buffer
    const camera3_stream_buffer_t *output_buffers = request->output_buffers;
    for (size_t i = 0; i < request->num_output_buffers; i++) {
        buffer_handle_t *buf = output_buffers[i].buffer;
        void *addr;
        gralloc_lock(*buf, GRALLOC_USAGE_SW_WRITE_OFTEN, &addr);
        // 填充图像数据到addr
        fill_image_data(addr, exposure_time);
        gralloc_unlock(*buf);
    }

    // 构造结果metadata
    camera_metadata_t *result_metadata = allocate_camera_metadata(...);
    // 填充结果tag
    // ...

    // 回调返回
    camera3_capture_result_t result = {
        .frame_number = request->frame_number,
        .result = result_metadata,
        .num_output_buffers = request->num_output_buffers,
        .output_buffers = output_buffers,
    };
    device->ops->process_capture_result(device->ops, &result);
    return 0;
}