4. Camera HAL3 初始化流程：open()、initialize()、configure_streams() 的调用时序与参数解析

Camera HAL3 的初始化流程是 Camera Service 与 Vendor HAL 建立通信通道、协商数据格式并分配内存的关键阶段。该流程由三个核心接口调用组成：open()、initialize() 和 configure_streams()。理解它们的调用时序、参数含义以及 Vendor 层的实现约束，是进行 HAL 适配与调试的基础。

4.1 调用时序与状态机

HAL3 的初始化遵循严格的状态机转换。Camera Service 按照固定顺序调用这三个接口，Vendor 层必须正确维护内部状态，否则会触发 Service 侧的异常处理。

4.2 open()：建立设备连接

open() 是 HAL 模块加载后的第一个调用，用于实例化一个 camera 设备。其原型定义在 camera_module_t 中：

int (*open)(const struct hw_module_t* module, const char* id,
            struct hw_device_t** device);

参数解析

4.3 initialize()：交换能力与回调

initialize() 是 Camera Service 与 HAL 建立双向通信的关键步骤。Service 传入回调接口，HAL 返回设备静态信息。

int (*initialize)(const struct camera3_device *device,
                  const camera3_callback_ops_t *callback_ops);

参数解析

回调函数表 (camera3_callback_ops_t)

• process_capture_result：HAL 通过此回调将已处理完成的 capture result 返回给 Service。
• notify：HAL 通过此回调发送异步事件，如快门事件、错误事件、缓冲区释放信号等。

4.4 configure_streams()：协商数据管道

configure_streams() 是初始化流程中最复杂、最关键的接口。它决定了 Camera 输出的格式、分辨率、帧率以及内存分配策略。

int (*configure_streams)(const struct camera3_device *device,
                         camera3_stream_configuration_t *stream_list);

参数解析

camera3_stream_configuration_t 结构体

typedef struct camera3_stream_configuration {
    uint32_t                    num_streams;        // stream 数量
    camera3_stream_t            **streams;          // stream 指针数组
    uint32_t                    operation_mode;     // 操作模式
    const camera3_stream_buffer_set_t *buffer_set;  // 可选，用于 buffer 管理
} camera3_stream_configuration_t;

操作模式 (operation_mode)

camera3_stream_t 关键字段

4.5 参数校验与常见错误码

Vendor 层在实现这三个接口时，必须对输入参数进行严格校验。以下是常见的错误码及其含义：

4.6 调试工具链实战建议

• 日志打点： 在 open()、initialize()、configure_streams() 的入口和出口添加 ALOGD 日志，打印关键参数（ID、stream 数量、格式、分辨率）。
• 参数转储： 在 configure_streams() 中，将 stream_list 内容转储到 /data/vendor/camera/ 目录下的 dump 文件，便于离线分析。
• 状态机检查： 在每次接口调用时，检查当前 HAL 内部状态是否合法，非法状态直接返回 -ENODEV 并打印错误栈。
• 超时监控： 使用 adb shell dumpsys media.camera 查看 Service 侧的调用超时统计，定位 Vendor 实现中的耗时瓶颈。