xref: /aosp_15_r20/hardware/interfaces/camera/provider/README.md (revision 4d7e907c777eeecc4c5bd7cf640a754fac206ff7)
1*4d7e907cSAndroid Build Coastguard Worker## Camera Provider HAL ##
2*4d7e907cSAndroid Build Coastguard Worker---
3*4d7e907cSAndroid Build Coastguard Worker
4*4d7e907cSAndroid Build Coastguard Worker## Overview: ##
5*4d7e907cSAndroid Build Coastguard Worker
6*4d7e907cSAndroid Build Coastguard WorkerThe camera.provider HAL is used by the Android camera service to discover,
7*4d7e907cSAndroid Build Coastguard Workerquery, and open individual camera devices.
8*4d7e907cSAndroid Build Coastguard Worker
9*4d7e907cSAndroid Build Coastguard WorkerIt also allows for direct control of the flash unit of camera devices that have
10*4d7e907cSAndroid Build Coastguard Workerone, for turning on/off torch mode.
11*4d7e907cSAndroid Build Coastguard Worker
12*4d7e907cSAndroid Build Coastguard WorkerMore complete information about the Android camera HAL and subsystem can be found at
13*4d7e907cSAndroid Build Coastguard Worker[source.android.com](http://source.android.com/devices/camera/index.html).
14*4d7e907cSAndroid Build Coastguard Worker
15*4d7e907cSAndroid Build Coastguard Worker## Version history: ##
16*4d7e907cSAndroid Build Coastguard Worker
17*4d7e907cSAndroid Build Coastguard Worker## types.hal: ##
18*4d7e907cSAndroid Build Coastguard Worker
19*4d7e907cSAndroid Build Coastguard Worker### @0.0:
20*4d7e907cSAndroid Build Coastguard Worker
21*4d7e907cSAndroid Build Coastguard WorkerCommon enum and struct definitions for all camera HAL interfaces. Does not
22*4d7e907cSAndroid Build Coastguard Workerdefine any interfaces of its own.
23*4d7e907cSAndroid Build Coastguard Worker
24*4d7e907cSAndroid Build Coastguard Worker## ICameraProvider.hal: ##
25*4d7e907cSAndroid Build Coastguard Worker
26*4d7e907cSAndroid Build Coastguard Worker### @2.4:
27*4d7e907cSAndroid Build Coastguard Worker
28*4d7e907cSAndroid Build Coastguard WorkerFirst HIDL version of the camera provider HAL, closely matching the feature set
29*4d7e907cSAndroid Build Coastguard Workerand operation of the pre-HIDL camera HAL module v2.4.
30*4d7e907cSAndroid Build Coastguard Worker
31*4d7e907cSAndroid Build Coastguard Worker## ICameraProviderCallback.hal: ##
32*4d7e907cSAndroid Build Coastguard Worker
33*4d7e907cSAndroid Build Coastguard Worker### @2.4:
34*4d7e907cSAndroid Build Coastguard Worker
35*4d7e907cSAndroid Build Coastguard WorkerFirst HIDL version of the camara provider HAL callback interface, closely
36*4d7e907cSAndroid Build Coastguard Workermatching the feature set and operation of the pre-HIDL camera HAL module
37*4d7e907cSAndroid Build Coastguard Workercallbacks v2.4.
38*4d7e907cSAndroid Build Coastguard Worker
39*4d7e907cSAndroid Build Coastguard Worker### AIDL Camera HAL Default Implementation ###
40*4d7e907cSAndroid Build Coastguard Worker
41*4d7e907cSAndroid Build Coastguard WorkerThe default implementation can be found at
42*4d7e907cSAndroid Build Coastguard Worker$ANDROID_BUILD_TOP/hardware/google/camera/common/hal/aidl_service and
43*4d7e907cSAndroid Build Coastguard Worker$ANDROID_BUILD_TOP/hardware/google/camera/devices/EmulatedCamera
44