相机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。