Android - 摄像头 - hal - 开发教程，例子，常见问题，分析方法，解决方案

Android Camera HAL 完整开发指南AIDL HAL 新架构适配 Android 16前置核心背景承接上文HIDL→AIDL HAL变革Android 11开始支持AIDL HALAndroid 16彻底移除HIDLCamera HAL必须基于AIDL HAL实现IPC全程单Binder驱动不再有hwbinder。Camera HAL 两个主流版本Camera HAL3AOSP标准主流android.hardware.camera.device3.xAIDL重构后为android.hardware.camera.deviceAIDL接口Camera HAL1废弃老旧设备兼容新项目不考虑Treble分区要求HAL实现必须放到vendor分区通过VNDK隔离system/vendor遵循分区不可直接链接规则。一、整体调用数据流AIDL HAL新架构App Camera2 API → Framework CameraService(Java AIDL) → JNI → libcamera_client.so(Native) → AIDL HAL标准Binder→ vendor 厂商Camera HAL实现 → 内核V4L2驱动 → 硬件Sensor/ISP老架构此处是HIDLHwBinderAndroid16全链路统一标准Binder。层级拆解App层Camera2 APICaptureRequest/CaptureResultFramework层CameraService、CameraProviderManager向上AIDL向下调用HALAIDL HAL接口层Google定义的标准AIDL接口camera.provider/camera.device/camera.metadataVendor HAL实现层厂商自研代码对接V4L2内核驱动Linux内核层V4L2 subdev、ISP、CSI总线、DMA缓冲区管理二、环境准备 目录结构AOSP源码1. 源码路径1Google标准AIDL HAL接口不可修改hardware/interfaces/camera/ ├── device/ # ICameraDevice.aidl 设备操作接口 ├── provider/ # ICameraProvider.aidl 枚举摄像头、打开设备 ├── metadata/ # 元数据定义、能力参数Characteristics/Request/Result └── common/ # 共用枚举、结构体2厂商Vendor HAL实现目录自定义规范路径vendor/[厂商名]/hardware/camera/aidl/vendor/xxx/hardware/camera/aidl/camera_device/ ├── Android.bp # Soong编译脚本AIDL HAL必须用bp弃用mk ├── CameraDevice.cpp/h # 实现ICameraDevice AIDL接口 ├── CameraProvider.cpp/h # 实现ICameraProvider AIDL接口 ├── V4L2Wrapper.cpp/h # 封装内核V4L2 ioctl操作 ├── MetadataHelper.cpp/h # 处理camera metadata静态/动态参数 └── buffer/ # Gralloc buffer管理ANativeWindow、DMA buf3Manifest声明Treble注册HAL服务vendor/etc/vintf/manifest.xml必须添加否则Framework无法通过Binder发现HAL服务halformataidlnameandroid.hardware.camera.provider/nameversion1/versioninterfacenameICameraProvider/nameinstanceinternal/0/instance/interface/hal2. Android.bp 核心编译模板AIDL HAL固定写法cc_binary{name:android.hardware.camera.provider-service.xxx,init_rc:[camera_provider.rc],// init启动脚本srcs:[CameraProvider.cpp,CameraDevice.cpp,V4L2Wrapper.cpp,MetadataHelper.cpp,],// 依赖Google官方AIDL HAL接口库shared_libs:[android.hardware.camera.provider-V1-ndk,android.hardware.camera.device-V1-ndk,android.hardware.camera.metadata-V1-ndk,libbinder_ndk,// AIDL Binder依赖libutils,libcutils,libgralloc,// 图形缓冲区libcamera_metadata,],// 关键标记为vendor分区HALVNDK稳定vendor:true,soc_specific:true,vintf_fragments:[manifest_camera.xml],}3. init.rc 启动脚本camera_provider.rc让init进程开机启动HAL Binder服务注册到servicemanagerservice camera-provider-xxx /vendor/bin/android.hardware.camera.provider-service.xxx class hal user camera group camera graphics drmrpc capabilities SYS_NICE on binder SERVICE_MANAGER_PRIORITY_HAL三、最简代码实现示例AIDL HAL示例1ICameraProvider 核心接口实现枚举摄像头#includeandroid/hardware/camera/provider/ICameraProvider.husingnamespace::android::hardware::camera::provider;classCameraProvider:publicICameraProvider{public:// 1. 获取当前所有摄像头ID后置0、前置1binder::StatusgetCameraIdList(std::vectorstd::string*outCameraIds)override{outCameraIds-clear();outCameraIds-push_back(0);// 后置主摄outCameraIds-push_back(1);// 前置副摄returnbinder::Status::ok();}// 2. 根据cameraId打开ICameraDevice设备binder::StatusopenCameraDevice(conststd::stringcameraId,const::android::sp::android::hardware::camera::device::ICameraDeviceCallbackcb,::android::sp::android::hardware::camera::device::ICameraDevice*outDevice)override{if(cameraId0||cameraId1){*outDevicenewCameraDevice(cameraId,cb);}else{returnbinder::Status::fromServiceSpecificError(-1);}returnbinder::Status::ok();}// 3. 注册Binder服务入口staticvoidregisterService(){spICameraProviderprovidernewCameraProvider();::android::defaultServiceManager()-addService(String16(android.hardware.camera.provider/internal/0),provider);}};// main函数HAL服务入口intmain(){CameraProvider::registerService();::android::ProcessState::self()-startThreadPool();pause();return0;}示例2ICameraDevice 核心能力下发CaptureRequest、V4L2取流核心需要实现的关键AIDL方法getCameraCharacteristics()上报摄像头静态能力分辨率、对焦、AE、HDR、传感器尺寸configureStreams()配置预览/拍照流尺寸、格式YUV_420_888、RAW、JPEGsubmitCaptureRequests()下发上层CaptureRequest驱动V4L2队列buffer、触发ISP拍照flush()/close()停止流、释放buffer、关闭V4L2设备节点V4L2极简封装片段intV4L2Wrapper::openDev(conststd::stringdevPath){mFdopen(devPath.c_str(),O_RDWR);// 设置捕获格式 V4L2_PIX_FMT_YUV420structv4l2_formatfmt{};fmt.typeV4L2_BUF_TYPE_VIDEO_CAPTURE;fmt.fmt.pix.width1920;fmt.fmt.pix.height1080;fmt.fmt.pix.pixelformatV4L2_PIX_FMT_YUV420;ioctl(mFd,VIDIOC_S_FMT,fmt);// 申请MMAP缓冲区、入队bufferrequestBuffers();enqueueAllBuffers();// 启动捕获inttypeV4L2_BUF_TYPE_VIDEO_CAPTURE;ioctl(mFd,VIDIOC_STREAMON,type);returnmFd;}示例3Camera Metadata 能力上报决定App可用功能getCameraCharacteristics必须填充标准keyFramework校验不通过摄像头直接不可用camera_metadata_t*charsallocate_camera_metadata(100,10);// 支持自动对焦add_camera_metadata_entry(chars,ANDROID_LENS_FOCUS_AVAILABLE_MODES,ANDROID_LENS_FOCUS_MODE_AUTO);// 最大预览分辨率int32_tres[]{1920,1080};add_camera_metadata_array(chars,ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS,res,2);四、调试问题定位全套分析方法实操工具链工具1dumpsys 查看HAL服务是否注册成功# 查看camera provider AIDL HAL是否注册adb shell dumpsys android.hardware.camera.provider# 列出所有已注册AIDL HAL服务adb shell dumpsys binder|grepcamera# 查看VINTF manifest是否加载正确adb shell dumpsys vendor|grepcamera.provider正常输出能看到internal/0实例失败manifest.xml写错/rc未启动服务。工具2Logcat 分层日志过滤# 过滤CameraService Framework日志adb logcat-bmain CameraService:* *:S# 过滤Vendor HAL层自定义日志TAG:CAM_HALadb logcat CAM_HAL:* *:S# 过滤Binder AIDL调用事务日志adb logcat Binder:* BpCamera:* BnCamera:* *:S工具3Perfetto 全链路性能追踪你重点在用抓取要点适配Android16 AIDL HAL数据源勾选binder transaction、camera、ftrace、v4l2、dmabuf可观测链路App → CameraService Binder耗时CameraService → Vendor AIDL HAL Binder单次调用耗时只有一套Binder无HwBinder割裂HAL内部V4L2 ioctl阻塞、buffer队列等待、DMA内存拷贝耗时典型瓶颈submitCaptureRequestsBinder调用耗时过长、V4L2 poll阻塞、内存拷贝过多。工具4内核层V4L2调试工具# 查看摄像头V4L2设备节点adb shellls/dev/v4l-subdev* /dev/video*# v4l2-ctl查看当前格式、帧率、buffer队列状态adb shell v4l2-ctl-d/dev/video0 --get-fmt-video adb shell v4l2-ctl --list-formats# 查看内核CSI/ISP报错dmesgadb shelldmesg|grep-Ecamera|isp|csi|dvp|v4l2工具5libcamera工具验证HAL可用性adb shell libcamera-hello# 枚举摄像头能力adb shell libcamera-list如果libcamera能枚举说明HAL服务注册、V4L2驱动基本正常问题在上层Framework参数适配。五、高频常见问题 根因 解决方案问题1打开相机提示无法连接相机App闪退dumpsys看不到HAL实例根因vintf manifest.xml AIDL hal name/version写错init.rc权限不足缺少camera/graphics用户组Android.bp未添加vendor: true编译进system分区Treble拦截HAL进程crashlogcat有SIGSEGV空指针。解决核对manifest AIDL格式HIDL写法全部删掉Android16不兼容rc文件group添加camera、graphics、drmrpcbp强制vendor:truesoc_specific:truelogcat定位崩溃栈修复空指针大概率openCameraDevice返回空设备。问题2摄像头枚举成功configureStreams失败预览黑屏根因stream配置的分辨率/像素格式V4L2内核不支持Gralloc buffer DMA内存分配失败HAL无法映射buffer到内核V4L2_STREAMON启动失败ISP时钟/CSI硬件未上电。解决用v4l2-ctl --list-formats只上报硬件支持的格式依赖libgralloc使用dmabuf fd传递缓冲区避免用户态拷贝dmesg排查ISP上电、时钟树、MIPI CSI配置。问题3拍照CaptureRequest下发无回调CaptureResult不返回根因HAL层ICameraDeviceCallback AIDL回调未触发V4L2 DQBUF取帧阻塞死锁Metadata Result未填充有效数据回调给Framework。解决出队V4L2 buffer后主动调用cb-notifyCaptureResult()V4L2 poll设置超时防止无限阻塞必须填充ANDROID_SENSOR_TIMESTAMP等必填元数据。问题4预览卡顿、掉帧Perfetto看到Binder耗时高根因Android16 AIDL HAL特有CaptureRequest频繁大量AIDL Parcel序列化拷贝HAL内同步阻塞ioctl占用Binder线程池buffer频繁内存拷贝未使用DMA零拷贝。解决耗时V4L2操作丢到独立工作线程不占用Binder主线程使用dmabuf文件描述符跨进程传递buffer零拷贝批量合并CaptureRequest减少Binder事务次数。问题5Android16编译报错提示HIDL接口找不到根因Android16完全移除HIDL库旧项目依赖3.5 HIDL接口直接编译失败。解决全部迁移为AIDL HAL替换所有hidl-gen编译规则为aidl-gen删除hwbinder依赖全程使用标准binder。问题6前后摄切换卡死CameraDevice关闭释放异常根因V4L2文件句柄未closefd泄漏Binder强引用sp循环引用导致对象无法析构buffer队列未flushV4L2缓冲区未释放。解决close接口中停止V4L2流、释放mmap buffer、close fd手动弱引用断开ICameraDeviceCallbacksubmit flush命令清空pending请求队列。问题7相机特性缺失HDR、美颜、自动对焦App不显示根因getCameraCharacteristicsmetadata关键字段未正确上报Framework判定硬件不支持。解决对照AOSPcamera_metadata_tags.h完整填充对焦模式、AE模式、可用流配置、动态范围能力。六、进阶优化点车载/智能座舱场景HiCar适配常用多摄像头并发CameraProvider管理多个ICameraDevice实例线程池隔离低功耗Idle状态关闭ISP/CSI时钟降低功耗360全景拼接HAL层多目同步曝光、时间戳对齐输出拼接后大图安全权限vendor sepolicy添加camera HAL对/dev/video、dmabuf、sysfs的访问权限device/vendor/sepolicyVNDK稳定性所有对外接口使用NDK稳定库禁止直接链接system私有库避免大版本升级兼容断裂。七、开源参考工程直接对照仿写AOSP默认参考HALhardware/google/camera/aidl/Google官方AIDL Camera HAL最简实现第三方开源V4L2 Camera AIDL HALandroid-v4l2-camera-halgithub车载厂商参考高通QCOM Camera HAL、瑞芯微RK Camera AIDL HALvendor目录下可扒逻辑如果你需要我可以给你完整可直接编译的全套Android.bp rc manifest.xml文件或者给一份Perfetto抓取Camera AIDL Binder卡顿的pbtxt配置或者拆解车载360全景摄像头HAL同步逻辑。