3、Camera HAL 核心数据结构解析

Camera HAL 的移植与稳定性优化，本质上是围绕一组核心数据结构进行实例化、回调注册与状态管理的过程。本章深入解析 camera_module_t、camera_device_t 和 camera3_device_ops_t 三个关键结构体，理解它们的职责、成员布局与生命周期，是编写可移植、高性能 HAL 的基础。

3.1 camera_module_t：HAL 模块的入口

camera_module_t 是 HAL 层暴露给 Camera Service 的第一个结构体，定义在 hardware/libhardware/include/hardware/camera_common.h 中。它继承自 hw_module_t，并扩展了摄像头枚举与打开接口。

3.2 camera_device_t：设备实例的抽象

camera_device_t 继承自 hw_device_t，代表一个已打开的摄像头设备实例。它本身是一个轻量级包装，真正的操作接口通过 ops 指针指向 camera3_device_ops_t。

typedef struct camera_device {
    hw_device_t common;               // 标准设备头，包含 close 函数指针
    camera3_device_ops_t *ops;        // Camera3 操作接口表
    void *priv;                       // 私有数据指针，通常指向自定义的设备上下文
} camera_device_t;

三个关键字段的职责：

• common.close：关闭设备时调用，负责释放所有资源、停止流、销毁 pipeline。
• ops：指向 camera3_device_ops_t 结构体，所有请求处理、流配置、metadata 交互都通过此表完成。
• priv：HAL 实现者自定义的上下文结构体，通常包含 sensor 驱动句柄、ISP 实例、stream 列表、buffer 管理器等。

3.3 camera3_device_ops_t：Camera3 操作接口表

这是 Camera HAL 中最核心的函数指针集合，Camera Service 通过它向 HAL 下发配置、请求和 buffer。结构体定义在 hardware/libhardware/include/hardware/camera3.h 中，包含约 20 个函数指针。

3.4 核心结构体关系图

下图展示了 Camera Service、HAL Module、Device 与 ops 之间的层级调用关系：

3.5 生命周期与初始化顺序

理解三个结构体的初始化顺序，对移植调试至关重要：

1. HAL 加载阶段： Camera Service 通过 hw_get_module() 加载 camera_module_t，调用 get_number_of_cameras() 和 get_camera_info() 枚举设备。
2. 设备打开阶段： Service 调用 camera_module_t.open()，HAL 分配 camera_device_t 并填充 ops 指针。
3. 初始化阶段： Service 调用 ops->initialize()，传入回调函数指针，HAL 保存回调并完成内部 pipeline 初始化。
4. 配置与运行阶段： configure_streams() 配置流，process_capture_request() 处理每一帧请求。
5. 关闭阶段： Service 调用 common.close()，HAL 释放所有资源。

3.6 稳定性优化关键点