4. Camera HAL 初始化流程：HAL模块加载、open()调用链、camera_info获取、static_info配置

Camera HAL 初始化是相机系统启动的第一个关键阶段，决定了上层应用能否成功发现并操作摄像头设备。本章深入剖析从 HAL 模块加载到 static_info 配置的完整链路，帮助你在日志中快速定位初始化失败根因。

4.1 初始化全流程概览

HAL 初始化分为四个核心阶段，每个阶段都有明确的日志特征和失败模式：

4.2 HAL 模块加载：从 hw_get_module 到 dlopen

Android 的 HAL 框架通过 hw_get_module() 函数加载特定硬件模块。对于 Camera HAL，加载路径如下：

1. 模块标识匹配： hw_get_module(CAMERA_HARDWARE_MODULE_ID, &module) 根据 CAMERA_HARDWARE_MODULE_ID（值为 "camera"）查找已注册的 HAL 模块。
2. 动态库加载： 框架在 /vendor/lib/hw/ 或 /system/lib/hw/ 目录下搜索 camera.<variant>.so 文件，通过 dlopen() 加载。
3. 符号解析： 加载后查找 HAL_MODULE_INFO_SYM 符号，获取 hw_module_t 结构体指针。
4. 模块版本校验： 检查 module->module_api_version 是否匹配框架期望的版本。

// 典型 HAL 模块定义示例 (camera_module.h)
struct hw_module_methods_t camera_module_methods = {
    .open = camera_device_open,
};

struct camera_module HAL_MODULE_INFO_SYM = {
    .common = {
        .tag = HARDWARE_MODULE_TAG,
        .module_api_version = CAMERA_MODULE_API_VERSION_2_4,
        .hal_api_version = HARDWARE_HAL_API_VERSION,
        .id = CAMERA_HARDWARE_MODULE_ID,
        .name = "Camera HAL Module",
        .author = "Vendor",
        .methods = &camera_module_methods,
        .dso = NULL,
        .reserved = {0},
    },
};

4.3 open() 调用链：从 CameraService 到 HAL 设备

模块加载成功后，CameraService 调用 module->methods->open() 打开指定 camera ID 的设备。调用链如下：

// CameraService 调用路径
CameraService::connect() 
  → CameraClient::initialize() 
    → CameraHal::openCamera() 
      → hw_module_t->methods->open(module, camera_id, &device)
        → camera_device_open()  // HAL 实现
          → 分配 camera_device_t 结构体
          → 初始化硬件资源 (I2C, MIPI, ISP)
          → 设置 ops 函数指针
          → 返回 0 表示成功

HAL 层 camera_device_open() 实现必须完成以下工作：

• 验证 camera ID 是否在有效范围内（0 ~ get_number_of_cameras() - 1）
• 分配并初始化 camera_device_t 结构体
• 设置 ops 函数表，包括 set_preview_window()、start_preview()、take_picture() 等
• 打开底层硬件设备（如 V4L2 节点、ISP 驱动）
• 返回 0 表示成功，负值表示失败（如 -ENODEV、-EBUSY）

4.4 camera_info 获取：设备能力初探

打开设备后，CameraService 调用 get_camera_info() 获取摄像头的基本信息，包括朝向、安装角度、是否支持闪光灯等。这些信息存储在 camera_info_t 结构体中：

// camera_info_t 结构体定义 (camera_common.h)
typedef struct camera_info {
    int                     device_version;     // CAMERA_DEVICE_API_VERSION_3_0 等
    uint32_t                device_id;          // 设备 ID
    int32_t                 facing;             // CAMERA_FACING_BACK / FRONT
    int32_t                 orientation;        // 图像旋转角度 (0, 90, 180, 270)
    const char              *resource_cost;     // 资源开销描述
    camera_metadata_t       *static_camera_characteristics; // 静态元数据
    void                    *reserved[2];
} camera_info_t;

HAL 实现 get_camera_info() 时，需要填充以下关键字段：

4.5 static_info 配置：元数据构建与校验

static_camera_characteristics 是 Camera HAL 最核心的元数据集合，包含摄像头所有静态能力描述。框架通过 getCameraCharacteristics() 获取该元数据，用于能力查询和策略决策。

static_info 的构建流程：

1. 元数据分配： HAL 调用 allocate_camera_metadata() 或 camera_metadata_t 构建函数创建元数据缓冲区。
2. 标签填充： 按照 Android CDD 要求，填充所有 mandatory 标签，如 ANDROID_SENSOR_INFO_PIXEL_ARRAY_SIZE、ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS 等。
3. 能力声明： 设置 ANDROID_REQUEST_AVAILABLE_CAPABILITIES，声明设备支持的逻辑能力（如 BACKWARD_COMPATIBLE、MANUAL_SENSOR、RAW 等）。
4. 元数据排序： 调用 sort_camera_metadata() 确保元数据内部有序，便于二分查找。
5. 指针赋值： 将构建好的元数据指针赋值给 camera_info_t.static_camera_characteristics。

// static_info 构建示例 (伪代码)
static camera_metadata_t* build_static_metadata() {
    camera_metadata_t *metadata = allocate_camera_metadata(
        ENTRY_COUNT, DATA_SIZE);
    
    // 填充 mandatory 标签
    int32_t pixel_array[] = {1920, 1080};
    add_camera_metadata_entry(metadata,
        ANDROID_SENSOR_INFO_PIXEL_ARRAY_SIZE, pixel_array, 2);
    
    int32_t stream_configs[] = {
        // 格式, 宽度, 高度, 方向
        HAL_PIXEL_FORMAT_YCbCr_420_SP, 640, 480, 
        ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_OUTPUT,
        // ... 更多配置
    };
    add_camera_metadata_entry(metadata,
        ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS, 
        stream_configs, sizeof(stream_configs)/sizeof(int32_t));
    
    // 能力声明
    uint8_t capabilities[] = {
        ANDROID_REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
    };
    add_camera_metadata_entry(metadata,
        ANDROID_REQUEST_AVAILABLE_CAPABILITIES, capabilities, 1);
    
    sort_camera_metadata(metadata);
    return metadata;
}

4.6 初始化失败排查清单

当 Camera HAL 初始化失败时，按以下清单逐级排查：

4.7 初始化阶段日志分析实战

以下是一段典型的初始化失败日志，我们逐行分析：

01-01 12:00:01.123  1234  5678 D CameraService: Opening camera 0
01-01 12:00:01.124  1234  5678 E CameraHal: hw_get_module failed: -ENOENT
01-01 12:00:01.124  1234  5678 E CameraService: Failed to load HAL module for camera 0
01-01 12:00:01.124  1234  5678 E CameraService: CameraService::connect() failed: -ENODEV

分析结论：

• hw_get_module failed: -ENOENT 表示 HAL 库文件不存在（文件未找到）。
• 检查 /vendor/lib/hw/camera.*.so 是否存在，或 ro.hardware 属性是否正确指向 HAL 变体。
• 解决方案：确认编译产物中包含正确的 HAL 库，或检查 device.mk 中 PRODUCT_PACKAGES 是否包含 camera.<variant>。

01-01 12:00:02.456  5678  9012 D CameraService: Opening camera 1
01-01 12:00:02.457  5678  9012 I CameraHal: camera_device_open() called for camera_id=1
01-01 12:00:02.458  5678  9012 E CameraHal: Failed to open V4L2 device: No such file or directory
01-01 12:00:02.458  5678  9012 E CameraHal: open_device() failed: -ENODEV
01-01 12:00:02.458  5678  9012 E CameraService: open() failed: -ENODEV

分析结论：

• HAL 模块加载成功，但 open() 阶段失败。
• Failed to open V4L2 device 表明底层驱动节点（如 /dev/video0）不存在。
• 检查 dmesg | grep camera 确认驱动是否加载成功，或检查设备树配置是否正确。