📚 课程目录第4章平台差异分析(一)

4. 平台差异分析(一)：硬件抽象层接口对比——高通UAPI vs MTK Metadata机制

在Camera HAL适配过程中，最核心的差异体现在硬件抽象层（HAL）的接口设计哲学上。高通平台采用UAPI（User API）体系，而MTK平台则依赖Metadata机制。这两种设计在数据流、控制逻辑和扩展性上存在根本性差异，是移植工作的首要攻坚点。

  核心观点：高通UAPI是“管道+节点”的流式处理模型，强调数据流的显式传递；MTK Metadata是“键值对+回调”的松耦合模型，强调参数的动态协商与异步通知。移植的本质是将UAPI的流式逻辑映射到MTK的Metadata空间。

4.1 高通UAPI架构概览

高通UAPI基于Pipeline和Node的概念，将Camera处理流程抽象为一条可配置的数据管道。每个Node代表一个处理单元（如ISP、Sensor、JPEG编码器），通过Link连接形成完整的处理流。

UAPI的核心数据结构包括：

struct camera3_stream_t：定义数据流的格式、分辨率、使用场景（如预览/拍照/录像）。
struct camera3_stream_buffer_t：封装具体的Buffer句柄、状态和时间戳。
struct camera3_capture_request_t：一次捕获请求，包含目标Stream列表和对应的Settings（Metadata）。
struct camera3_capture_result_t：捕获结果，包含输出Buffer、结果Metadata和部分Metadata。

移植要点：高通UAPI中，每个Node的配置通过UAPI_NODE_CMD_SET_CONFIG等ioctl命令下发，而MTK平台则通过Metadata中的特定Tag来驱动硬件模块。移植时需要将UAPI的Node配置参数逐一映射到MTK的Metadata Tag集合。

4.2 MTK Metadata机制详解

MTK平台采用Metadata驱动的架构，所有控制参数和状态信息都封装在Metadata结构中。HAL层通过setParameter和getParameter接口与底层交互，底层通过回调函数通知HAL层事件。

MTK Metadata的关键特征：

Tag索引：每个参数对应一个唯一的Tag ID（如MTK_SENSOR_EXPOSURE_TIME），通过Tag进行读写。
动态协商：HAL层可以查询底层支持的参数范围，动态调整配置。
异步回调：底层状态变化（如帧到达、错误发生）通过回调函数通知HAL层。
批量操作：支持一次setParameter传入多个Tag，减少IPC开销。

4.3 核心接口对比

对比维度	高通UAPI	MTK Metadata
数据模型	Pipeline + Node + Link	Metadata Tag + Callback
控制方式	ioctl命令 + Buffer Queue	setParameter / getParameter
参数传递	通过camera3_capture_request_t中的settings字段传递	通过Metadata结构体直接传递
流管理	显式创建Stream，通过Stream配置Pipeline	隐式流管理，通过Metadata中的Stream配置Tag控制
事件通知	通过process_capture_result回调返回结果	通过注册的Event Callback通知HAL
扩展性	新增Node需要修改Kernel驱动和UAPI定义	新增Tag即可扩展功能，无需修改底层接口
调试难度	需要跟踪ioctl调用和Buffer流转	需要监控Metadata Tag的读写和回调触发

4.4 移植映射策略

从高通UAPI移植到MTK Metadata，核心工作是将UAPI的流式控制逻辑转换为MTK的Tag驱动模型。以下是关键映射关系：

具体映射步骤：

Pipeline → Metadata集合：将UAPI的Pipeline配置（包含所有Node的拓扑关系）转换为MTK的初始化Metadata Tag集合，一次性通过setParameter下发。
Stream → Stream Tag：UAPI的每个Stream对应MTK中的一个Stream Tag，包含格式、分辨率、使用场景等信息。
Capture Request → Capture Tag：每次捕获请求转换为MTK的Capture Tag，包含帧编号、曝光参数、增益参数等。
Result → Event Callback：UAPI的process_capture_result回调映射为MTK的Event Callback，通过解析返回的Metadata Tag获取结果数据。

常见陷阱：MTK平台对Metadata Tag的写入顺序有严格依赖。例如，设置Sensor分辨率之前必须先设置Sensor的PLL配置。移植时不能简单地将UAPI的配置顺序照搬，需要参考MTK的Tag依赖关系文档重新编排。

4.5 代码示例对比

以下展示同一功能（设置曝光时间）在两个平台上的实现差异：

高通UAPI实现：

// 高通UAPI：通过Node命令设置曝光时间
struct uapi_node_cmd_set_config cmd;
cmd.node_id = SENSOR_NODE_ID;
cmd.config_id = UAPI_SENSOR_CONFIG_EXPOSURE_TIME;
cmd.value = exposure_time_us;  // 单位：微秒

int ret = ioctl(fd, UAPI_NODE_CMD_SET_CONFIG, &cmd);
if (ret < 0) {
    ALOGE("Failed to set exposure time: %s", strerror(errno));
    return ret;
}

// 等待Node确认
struct uapi_node_event event;
ret = ioctl(fd, UAPI_NODE_CMD_GET_EVENT, &event);
if (event.type == UAPI_EVENT_CONFIG_ACK) {
    ALOGI("Exposure time set successfully");
}

MTK Metadata实现：

// MTK Metadata：通过setParameter设置曝光时间
Metadata metadata;
metadata.addTag(MTK_SENSOR_EXPOSURE_TIME, exposure_time_us);  // 单位：微秒

// 可选：同时设置相关Tag
metadata.addTag(MTK_SENSOR_GAIN, gain_value);
metadata.addTag(MTK_SENSOR_FRAME_LENGTH, frame_length);

int ret = setParameter(metadata);
if (ret != MTK_OK) {
    ALOGE("Failed to set exposure time via metadata: %d", ret);
    return ret;
}

// 通过回调确认（异步）
// 注册的Event Callback会在底层处理完成后被调用
void onSensorEvent(uint32_t event_id, Metadata& result) {
    if (event_id == MTK_EVENT_SENSOR_CONFIG_DONE) {
        ALOGI("Exposure time set successfully (async)");
    }
}

  差异总结：
  高通UAPI是同步+ioctl模型，每个操作需要等待Kernel确认。
MTK Metadata是异步+回调模型，setParameter立即返回，结果通过回调通知。
MTK支持批量Tag设置，一次调用可以配置多个参数，减少IPC次数。
高通UAPI的Node配置是独立命令，每个Node需要单独操作。

4.6 移植优先级与建议

优先级	移植内容	说明
P0	基础控制Tag映射	曝光、增益、帧率、白平衡等核心3A参数
P1	Stream配置映射	预览/拍照/录像的Stream格式和Buffer管理
P2	事件回调适配	帧到达、错误处理、状态变化等异步通知
P3	扩展功能映射	HDR、夜景、美颜等厂商自定义功能

建议在移植初期，先建立Tag映射表，将高通UAPI的所有Node配置命令与MTK的Metadata Tag一一对应。同时，注意MTK平台对Tag的版本兼容性——不同MTK芯片（如Helio P系列 vs Dimensity系列）支持的Tag集合可能不同，需要查阅对应的MTK Camera HAL API Reference。