相机HAL

相机 HAL
相机 实现 HAL

android12-release

---

1、概览实现 HAL

HAL 位于 相机驱动程序 和 更高级别的 Android 框架 之间，它定义您必须实现的接口，以便应用可以正确地操作相机硬件。相机 HAL 的 HIDL 接口在 hardware/interfaces/camera 中定义。(HAL 硬件抽象层定义了由相机服务调用、且您必须实现以确保相机硬件正常运行的标准接口(Camera内核驱动程序)。)

典型的绑定式 HAL 必须实现以下 HIDL 接口：

• ICameraProvider：用于枚举单个设备并管理其状态。
• ICameraDevice：相机设备接口。
• ICameraDeviceSession：活跃的相机设备会话接口。

参考 HIDL 实现适用于 CameraProvider.cpp、CameraDevice.cpp 和 CameraDeviceSession.cpp。该实现封装了仍在使用旧版 API 的旧 HAL。从 Android 8.0 开始，相机 HAL 实现必须使用 HIDL API；不支持使用旧版接口。

2、相机 HAL

Android 的相机硬件抽象层 (HAL) 可将 android.hardware.camera2 中较高级别的相机框架 API 连接到底层的相机驱动程序和硬件。 从 Android 13 开始，相机 HAL 接口使用 AIDL 进行开发。 Android 8.0 引入了 Treble，用于将 Camera HAL API 切换到由 HAL 接口描述语言 (HIDL) 定义的稳定接口。 如果您之前为 Android 7.0 及更低版本开发过相机 HAL 模块和驱动程序，请注意相机管道中发生的重大变化。

2.1 AIDL 相机 HAL

对于搭载 Android 13 或更高版本的设备，该相机框架包含对 AIDL 相机 HAL 的支持。该相机框架还支持 HIDL 相机 HAL，不过，在 Android 13 或更高版本中添加的相机功能只能通过 AIDL 相机 HAL 接口使用。如需在升级到 Android 13 或更高版本的设备上实现此类功能，设备制造商必须将其 HAL 进程从使用 HIDL 相机接口迁移到使用 AIDL 相机接口。

实现 AIDL 相机 HAL
有关 AIDL 相机 HAL 的参考实现，请参阅 hardware/google/camera/common/hal/aidl_service/。


AIDL 相机 HAL 规范位于以下位置：

• 相机提供程序： hardware/interfaces/camera/provider/aidl/
• 相机设备： hardware/interfaces/camera/device/aidl/
• 相机元数据： hardware/interfaces/camera/metadata/aidl/
• 常见数据类型： hardware/interfaces/camera/common/aidl/

对于迁移到 AIDL 的设备，设备制造商可能需要修改 Android SELinux 政策 (sepolicy) 和 RC 文件，具体取决于代码结构。

验证 AIDL 相机 HAL
如需测试 AIDL 相机 HAL 实现，请确保设备已通过所有 CTS 和 VTS 测试。Android 13 引入了 AIDL VTS 测试 VtsAidlHalCameraProvider_TargetTest.cpp。

2.2 相机 HAL3 功能

重新设计 Android Camera API 的目的在于大幅提高应用对于 Android 设备上的相机子系统的控制能力，同时重新组织 API，提高其效率和可维护性。借助额外的控制能力，您可以更轻松地在 Android 设备上构建高品质的相机应用，这些应用可在多种产品上稳定运行，同时仍会尽可能使用设备专用算法来最大限度地提升质量和性能。

版本 3 相机子系统将多个运行模式整合为一个统一的视图，您可以使用这种视图实现之前的任何模式以及一些其他模式，例如连拍模式。这样一来，便可以提高用户对聚焦、曝光以及更多后期处理（例如降噪、对比度和锐化）效果的控制能力。此外，这种简化的视图还能够使应用开发者更轻松地使用相机的各种功能。

API 将相机子系统塑造为一个管道，该管道可按照 1:1 的基准将传入的帧捕获请求转化为帧。这些请求包含有关帧的捕获和处理的所有配置信息，其中包括分辨率和像素格式；手动传感器、镜头和闪光灯控件；3A 操作模式；RAW 到 YUV 处理控件；统计信息生成等等。

简单来说，应用框架从相机子系统请求帧，然后相机子系统将结果返回到输出流。此外，系统还会针对每组结果生成包含色彩空间和镜头遮蔽等信息的元数据。您可以将相机版本 3 看作相机版本 1 的单向流管道。它会将每个捕获请求转化为传感器捕获的一张图像，这张图像将被处理成：

• 包含有关捕获的元数据的 Result 对象。
• 图像数据的 1 到 N 个缓冲区，每个缓冲区会进入自己的目标 Surface。
  
  

可能的输出 Surface 组经过预配置：

• 每个 Surface 都是一个固定分辨率的图像缓冲区数据流的目标位置。
• 一次只能将少量 Surface 配置为输出（约 3 个）。
  
  

一个请求中包含所需的全部捕获设置，以及要针对该请求将图像缓冲区（从总配置组）推送到其中的输出 Surface 的列表。请求可以只发>生一次（使用 capture()），也可以无限重复（使用 setRepeatingRequest()）。捕获的优先级高于重复请求的优先级。

2.3 Camera HAL1 概览

注意：由于 Camera HAL1 已弃用，建议在搭载 Android 9 或更高版本的设备上使用 Camera HAL3。