2. Camera HAL 层架构：Android Camera HAL3 详解与 UVC 交互

Camera HAL (Hardware Abstraction Layer) 是 Android 相机框架中连接 Framework 与底层硬件驱动的关键中间层。在 UVC 设备接入场景下，HAL 层需要将标准的 UVC 流数据转换为 Android Camera HAL3 接口所定义的 pipeline 格式。本章深入剖析 HAL3 架构、与 UVC 驱动的交互接口以及核心的 Buffer 管理流程。

2.1 Android Camera HAL3 架构详解

HAL3 接口（Camera3Module）采用 pipeline 设计理念，将相机处理流程抽象为多个可配置的阶段。相比 HAL1 的固定流模式，HAL3 允许更精细的控制和更高的性能。

2.1.1 HAL3 关键组件

2.1.2 HAL3 Pipeline 状态机

HAL3 设备在生命周期内经历以下状态转换，UVC 设备的插拔事件会触发状态迁移：

1. Uninitialized → 设备枚举后进入 Opened 状态。
2. Opened → 配置 stream 后进入 Configured 状态。
3. Configured → 开始处理 capture request 时进入 Streaming 状态。
4. Streaming → 收到 flush 或错误时回到 Configured 或 Opened。

2.2 HAL 层与 UVC 驱动的交互接口

HAL 层通过 V4L2 (Video for Linux 2) 框架与 UVC 驱动通信。UVC 驱动注册为 V4L2 设备节点（/dev/videoX），HAL 层通过标准的 V4L2 ioctl 和 mmap 接口完成控制与数据交换。

2.2.1 关键交互接口清单

2.2.2 交互流程示例代码

// HAL 层初始化 UVC 设备
int uvc_fd = open("/dev/video0", O_RDWR);
struct v4l2_capability cap;
ioctl(uvc_fd, VIDIOC_QUERYCAP, &cap);

// 设置格式：YUYV 640x480
struct v4l2_format fmt = {0};
fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
fmt.fmt.pix.width = 640;
fmt.fmt.pix.height = 480;
fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;
fmt.fmt.pix.field = V4L2_FIELD_NONE;
ioctl(uvc_fd, VIDIOC_S_FMT, &fmt);

// 请求 4 个 buffer
struct v4l2_requestbuffers req = {0};
req.count = 4;
req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
req.memory = V4L2_MEMORY_MMAP;
ioctl(uvc_fd, VIDIOC_REQBUFS, &req);

// 映射 buffer 到用户空间
for (int i = 0; i < 4; i++) {
    struct v4l2_buffer buf = {0};
    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    buf.memory = V4L2_MEMORY_MMAP;
    buf.index = i;
    ioctl(uvc_fd, VIDIOC_QUERYBUF, &buf);
    buffers[i].start = mmap(NULL, buf.length,
                            PROT_READ | PROT_WRITE,
                            MAP_SHARED, uvc_fd, buf.m.offset);
    buffers[i].length = buf.length;
}

// 入队所有 buffer
for (int i = 0; i < 4; i++) {
    struct v4l2_buffer buf = {0};
    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    buf.memory = V4L2_MEMORY_MMAP;
    buf.index = i;
    ioctl(uvc_fd, VIDIOC_QBUF, &buf);
}

// 开始流
int type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
ioctl(uvc_fd, VIDIOC_STREAMON, &type);

2.3 Buffer 管理流程

Buffer 管理是 HAL 层性能优化的核心。在 UVC 场景下，HAL 需要协调 V4L2 buffer 池 和 Android GraphicBuffer 池 之间的数据流转，避免不必要的内存拷贝。

2.3.1 双 Buffer 池模型

2.3.2 零拷贝策略

为了降低延迟和 CPU 负载，HAL 层应优先采用 零拷贝 方式：

• 直接映射： 如果 UVC 驱动支持 V4L2_MEMORY_DMABUF，HAL 可以将 GraphicBuffer 的 dma-buf fd 传递给驱动，让 UVC 直接写入目标 buffer。
• GPU 共享： 使用 EGL_EXT_image_dma_buf_import 扩展，将 UVC 帧数据直接导入 GPU 纹理，避免 CPU 拷贝。
• 回退方案： 当硬件不支持时，使用 memcpy 从 V4L2 buffer 拷贝到 GraphicBuffer，但需注意对齐和缓存一致性。

2.3.3 完整 Buffer 流转步骤

1. HAL 接收 capture request： Framework 下发 camera3_capture_request，包含目标 GraphicBuffer 句柄。
2. HAL 从 V4L2 池获取帧： 调用 VIDIOC_DQBUF 阻塞等待 UVC 驱动返回已填充的 buffer。
3. 数据转换/拷贝： 根据格式（MJPEG 解码、颜色空间转换）处理数据，填充到 GraphicBuffer。
4. 回调 Framework： 调用 process_capture_result 将填充后的 buffer 返回给 Framework。
5. V4L2 buffer 重新入队： 调用 VIDIOC_QBUF 将空闲 buffer 归还驱动，供下一帧使用。

2.3.4 性能关键指标