3. HAL模块加载机制

HAL（Hardware Abstraction Layer）模块加载机制是Camera HAL层初始化的核心入口。Android系统通过标准化的结构体定义与回调函数接口，实现HAL模块的动态发现、加载与生命周期管理。理解这一机制，是掌握Camera HAL层开发的基础。

3.1 HAL module结构体定义

每个HAL模块都必须以hw_module_t结构体作为起始成员。该结构体定义在hardware/libhardware/include/hardware/hardware.h中，是HAL模块与Android框架之间的契约。

3.2 hw_module_methods_t回调函数

hw_module_methods_t是HAL模块暴露给框架层的唯一回调结构体，目前只包含一个函数指针——open。该结构体定义如下：

typedef struct hw_module_methods_t {
    int (*open)(const struct hw_module_t* module, 
                const char* id,
                struct hw_device_t** device);
} hw_module_methods_t;

open回调的三个参数含义：

• module：指向当前HAL模块实例的指针
• id：要打开的设备标识符，如"0"表示Camera ID 0
• device：输出参数，指向新创建的hw_device_t结构体指针

框架层通过hw_get_module()加载HAL模块后，立即调用methods->open()来获取具体设备实例。这意味着open函数是HAL模块从“静态描述”进入“运行时设备”的桥梁。

3.3 open/close接口实现

open接口的实现通常包含以下步骤：

1. 参数校验：检查module和device指针非空，id合法
2. 内存分配：为Camera设备结构体（如camera_device_t）分配内存
3. 初始化：填充设备结构体的ops函数表、私有数据等
4. 硬件准备：打开驱动节点、初始化传感器、分配内存池
5. 返回设备：将设备结构体指针写入*device

static int camera_device_open(const hw_module_t* module, 
                              const char* id, 
                              hw_device_t** device) {
    if (module == NULL || device == NULL) {
        return -EINVAL;
    }

    camera_device_t* cam_dev = (camera_device_t*)malloc(sizeof(camera_device_t));
    if (cam_dev == NULL) {
        return -ENOMEM;
    }

    memset(cam_dev, 0, sizeof(camera_device_t));
    cam_dev->common.tag = HARDWARE_DEVICE_TAG;
    cam_dev->common.version = CAMERA_DEVICE_API_VERSION_1_0;
    cam_dev->common.module = (hw_module_t*)module;
    cam_dev->common.close = camera_device_close;

    // 填充ops函数表
    cam_dev->ops = &camera_ops;

    // 初始化私有数据（如驱动句柄、流状态等）
    cam_dev->priv = init_camera_private_data(atoi(id));

    *device = &cam_dev->common;
    return 0;
}

close接口负责资源释放：

static int camera_device_close(hw_device_t* device) {
    camera_device_t* cam_dev = (camera_device_t*)device;
    if (cam_dev == NULL) {
        return -EINVAL;
    }

    // 释放私有数据资源
    if (cam_dev->priv) {
        deinit_camera_private_data(cam_dev->priv);
    }

    free(cam_dev);
    return 0;
}

3.4 HAL module ID注册

HAL模块的ID注册通过hw_module_t结构体的id字段实现。Camera HAL模块的ID固定为"camera"。完整的模块定义示例如下：

static struct hw_module_methods_t camera_module_methods = {
    .open = camera_device_open
};

camera_module_t HAL_MODULE_INFO_SYM = {
    .common = {
        .tag = HARDWARE_MODULE_TAG,
        .module_api_version = CAMERA_MODULE_API_VERSION_1_0,
        .hal_api_version = HARDWARE_HAL_API_VERSION,
        .id = "camera",
        .name = "Camera HAL Module",
        .author = "Your Company",
        .methods = &camera_module_methods,
        .dso = NULL,
        .reserved = {0}
    },
    .get_number_of_cameras = get_number_of_cameras,
    .get_camera_info = get_camera_info
};

Android HAL加载器通过以下流程定位模块：

• 根据id（如"camera"）在系统库路径中搜索camera.<variant>.so
• 使用dlopen()加载动态库
• 通过dlsym()查找HAL_MODULE_INFO_SYM符号
• 验证tag和版本号，返回hw_module_t指针

3.5 模块加载机制总结