1. Camera HAL 概述

Camera HAL（Hardware Abstraction Layer）是 Android 相机子系统中连接 Framework 与底层硬件驱动的关键中间层。它定义了统一的接口规范，使上层应用无需关心具体硬件实现，同时为芯片厂商（如 Qualcomm、MediaTek、Samsung）提供硬件适配的标准化入口。在调试 Camera 问题时，理解 HAL 的位置、架构与交互流程是抓取和分析日志的前提。

1.1 Camera HAL 在 Android 系统中的位置

从 Android 系统分层来看，Camera HAL 位于 Framework 层 与 Kernel 驱动层 之间，属于 Vendor 实现层 的核心组件。其具体位置如下图所示：

1.2 HAL3 架构简介

Android 从 8.0 开始全面采用 HAL3（Camera HAL v3）架构，替代了旧的 HAL1。HAL3 的核心设计理念是 Pipeline 化 和 Request-Result 模型，支持更灵活的相机控制（如手动曝光、多帧合成、RAW 输出等）。

HAL3 的主要组件与职责如下表所示：

HAL3 的 Pipeline 处理流程可以用以下 SVG 图表示：

1.3 HAL 与 Framework 的交互流程

HAL 与 Framework 的交互主要通过 HIDL（Hardware Interface Definition Language） 或 AIDL（Android Interface Definition Language） 接口进行。在 Android 12 及以上版本，Google 推荐使用 AIDL 替代 HIDL。交互流程分为 初始化、配置流、捕获循环 和 关闭 四个阶段。

以下是一个典型的交互流程步骤列表：

1. 初始化阶段：
   • CameraService 通过 ICameraProvider 接口发现 HAL 服务。
   • HAL 返回支持的相机设备列表（如后置、前置、广角等）。
   • Framework 调用 open() 打开指定相机设备，HAL 返回 camera3_device_t 实例。
2. 配置流阶段：
   • Framework 调用 configure_streams() 配置输出流（预览流、拍照流、录像流）。
   • HAL 根据流配置分配内部 buffer 和 Pipeline 资源。
   • HAL 返回配置结果，包括实际使用的流格式和分辨率。
3. 捕获循环阶段：
   • Framework 下发 CaptureRequest，包含输出 buffer 和控制参数。
   • HAL 的 process_capture_request() 接收请求，驱动 ISP 和 Sensor 进行捕获。
   • 捕获完成后，HAL 通过 process_capture_result() 回调返回结果和 metadata。
   • Framework 将结果分发给应用层（如预览 Surface 或 ImageReader）。
4. 关闭阶段：
   • Framework 调用 flush() 等待所有未完成的请求完成。
   • 调用 close() 释放 HAL 资源，关闭相机设备。

交互流程的时序关系如下图所示：

1.4 调试日志的关键 TAG 与含义

在抓取 Camera HAL 调试信息时，熟悉以下关键 TAG 可以快速定位问题：