多平台与多厂商调试：Camera HAL兼容性工程案例 - 第1节

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

Camera HAL（硬件抽象层）是 Android 相机子系统中连接 Framework 与底层硬件驱动的关键中间层。它位于 Android 系统的 用户空间，向上为 Framework 提供统一的相机操作接口，向下屏蔽不同 SoC 平台和传感器厂商的硬件差异。

1.1.1 系统层级中的位置

从 Android 系统分层来看，Camera HAL 处于以下位置：

1.1.2 HAL 的核心作用

1.2 HAL 接口定义

Android Camera HAL 主要分为两个版本：HAL 1.0（旧版，Android 4.x~6.x）和 HAL 3.x（新版，Android 7.0+ 强制要求）。当前主流平台均使用 HAL 3.x 架构。

1.2.1 HAL 3.x 核心接口结构

HAL 3.x 的核心定义位于 hardware/libhardware/include/hardware/camera3.h，主要包含以下关键结构体：

// camera3_device_t —— HAL 设备句柄
typedef struct camera3_device {
    hw_device_t common;
    camera3_device_ops_t *ops;   // 操作函数指针表
    void *priv;                  // HAL 私有数据
} camera3_device_t;

// camera3_device_ops_t —— 操作函数表
typedef struct camera3_device_ops {
    int (*initialize)(const struct camera3_device *, 
                      const camera3_callback_ops_t *callback_ops);
    int (*configure_streams)(const struct camera3_device *,
                             camera3_stream_configuration_t *stream_list);
    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);
    // ... 其他函数指针
} camera3_device_ops_t;

1.2.2 关键接口函数说明

1.2.3 Metadata 接口

HAL 3.x 使用 Camera Metadata（基于 camera_metadata_t）作为控制参数和结果数据的载体。Framework 通过 capture_request.settings 下发控制参数，HAL 通过 camera3_callback_ops_t.process_capture_result 返回结果 metadata。

// 典型的 metadata 控制项（部分）
ANDROID_SENSOR_EXPOSURE_TIME      // 曝光时间（纳秒）
ANDROID_SENSOR_SENSITIVITY        // ISO 感光度
ANDROID_CONTROL_AE_MODE           // 自动曝光模式
ANDROID_CONTROL_AF_MODE           // 自动对焦模式
ANDROID_CONTROL_AWB_MODE          // 自动白平衡模式
ANDROID_STATISTICS_FACE_RECTANGLES // 人脸检测结果
ANDROID_JPEG_QUALITY              // JPEG 压缩质量

1.3 HAL 与 Framework 的交互流程

从应用发起相机请求到最终收到图像数据，HAL 与 Framework 之间经历了一个完整的 Request-Result 循环。理解这一流程是调试兼容性问题的前提。

1.3.1 核心交互流程

1.3.2 交互流程关键步骤说明

1. 设备打开与初始化：CameraService 通过 HAL 的 open() 打开设备，然后调用 initialize() 注册回调函数指针表 camera3_callback_ops_t。
2. Stream 配置：应用设置预览/拍照/录像尺寸后，Framework 调用 configure_streams() 通知 HAL 配置数据流。HAL 需要返回支持的 stream 组合和 buffer 格式。
3. Request 下发：每次捕获（预览帧或拍照）由 process_capture_request() 触发。HAL 收到 request 后，需要填充 output buffers 并调用回调返回结果。
4. Result 回调：HAL 通过 process_capture_result() 回调返回 metadata 和图像 buffer。Framework 将结果分发给应用层。
5. Flush 与关闭：应用退出时，Framework 调用 flush() 清空所有 pending request，然后关闭设备。

1.3.3 Buffer 管理交互

HAL 3.x 使用 Gralloc Buffer 进行图像数据传输。Framework 负责分配 buffer 并注册到 HAL，HAL 在捕获完成后将填满数据的 buffer 返回给 Framework。

1.3.4 同步与超时机制

HAL 与 Framework 之间的交互必须遵守严格的同步契约：

• Request 超时：Framework 会为每个 request 设置超时（通常 3~5 秒）。如果 HAL 未在超时前返回 result，Framework 会触发 ANR（应用无响应）并 dump HAL 状态。
• Buffer 生命周期：HAL 必须在 process_capture_result() 回调中释放所有 output buffer 的引用。如果 HAL 持有 buffer 不释放，会导致 Framework 侧的 buffer 池耗尽。
• Flush 语义：flush() 调用后，HAL 必须立即返回所有 pending request 的 result（可以标记为 error），不能有 request 残留。