Camera HAL3开发调试与图像参数适配 - 第4节

4.1 HAL 模块加载机制

Camera HAL 的初始化始于 Android 系统通过 hw_get_module() 或 HAL_MODULE_INFO_SYM 符号查找并加载 HAL 动态库。该过程由 cameraserver 进程触发，最终定位到 camera.<variant>.so 共享库。

4.1.1 模块加载流程

1. 服务启动： cameraserver 调用 CameraService::instantiate()。
2. HAL 查找： hw_get_module(CAMERA_HARDWARE_MODULE_ID, &module) 根据系统属性 ro.hardware.camera 或 ro.board.platform 定位 .so 文件。
3. 符号解析： 加载库后，通过 dlsym() 获取 HAL_MODULE_INFO_SYM 结构体地址。
4. 模块验证： 检查 module->tag 是否为 HARDWARE_MODULE_TAG，版本号是否匹配。
5. 回调注册： 将 camera_module_callbacks_t 注册到 HAL，用于热插拔通知。

4.2 open() 函数调用链

模块加载成功后，CameraService 调用 module->common.open() 打开指定 camera ID 的设备。该函数在 HAL 侧对应 camera_device_open()，负责初始化硬件并返回 camera_device_t 接口。

4.2.1 调用链分解

// HAL 侧 open() 典型实现骨架
static int camera_device_open(const hw_module_t* module, const char* id,
                              hw_device_t** device) {
    int camera_id = atoi(id);
    if (camera_id < 0 || camera_id >= MAX_CAMERAS) {
        ALOGE("Invalid camera id: %s", id);
        return -ENODEV;
    }
    camera_device_t* camera_dev = (camera_device_t*)malloc(sizeof(camera_device_t));
    memset(camera_dev, 0, sizeof(*camera_dev));
    camera_dev->common.tag = HARDWARE_DEVICE_TAG;
    camera_dev->common.version = CAMERA_DEVICE_API_VERSION_3_5;
    camera_dev->common.module = (hw_module_t*)module;
    camera_dev->common.close = camera_device_close;
    camera_dev->ops = &camera_device_ops;
    // 初始化硬件：GPIO、时钟、I2C 配置
    if (init_hardware(camera_id) != 0) {
        free(camera_dev);
        return -EIO;
    }
    *device = &camera_dev->common;
    return 0;
}

4.3 camera_info 初始化

在 open() 之后，CameraService 调用 camera_module_t::get_camera_info() 获取每个 camera 的静态能力信息。该信息填充到 camera_info_t 结构体中，包含设备方向、闪光灯支持、传感器朝向等。

4.3.1 camera_info_t 关键字段

4.4.2 初始化流程

• 静态配置读取： 从设备树、板级配置文件或硬编码表中读取 sensor 物理属性。
• 动态校准加载： 从 /vendor/etc/camera/ 或 /data/misc/camera/ 加载镜头校准参数。
• 能力合成： 将静态配置与校准参数合并，填充 camera_info_t。
• 注册到服务： CameraService 将 info 存入全局列表，供后续 getCameraInfo() 查询。

// camera_info 初始化示例
static int camera_get_info(const struct camera_module* module,
                           int camera_id, struct camera_info* info) {
    if (camera_id == 0) {
        info->facing = CAMERA_FACING_BACK;
        info->orientation = 90;
        info->device_version = CAMERA_DEVICE_API_VERSION_3_5;
        info->resource_cost = 100;
        info->conflicting_devices = (const char*[]){ "1", NULL };
    } else if (camera_id == 1) {
        info->facing = CAMERA_FACING_FRONT;
        info->orientation = 270;
        info->device_version = CAMERA_DEVICE_API_VERSION_3_5;
        info->resource_cost = 50;
        info->conflicting_devices = NULL;
    } else {
        return -EINVAL;
    }
    ALOGD("camera_info[%d]: facing=%d, orientation=%d", camera_id,
          info->facing, info->orientation);
    return 0;
}

4.4 初始化流程总结

Camera HAL 初始化可归纳为三个阶段：模块加载、设备打开、信息注册。每个阶段都有明确的错误码和调试入口，掌握这些流程是进行参数配置与调试的基础。