xref: /aosp_15_r20/hardware/interfaces/camera/common/default/include/CameraModule.h (revision 4d7e907c777eeecc4c5bd7cf640a754fac206ff7)
1*4d7e907cSAndroid Build Coastguard Worker /*
2*4d7e907cSAndroid Build Coastguard Worker  * Copyright (C) 2016 The Android Open Source Project
3*4d7e907cSAndroid Build Coastguard Worker  *
4*4d7e907cSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*4d7e907cSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*4d7e907cSAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*4d7e907cSAndroid Build Coastguard Worker  *
8*4d7e907cSAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*4d7e907cSAndroid Build Coastguard Worker  *
10*4d7e907cSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*4d7e907cSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*4d7e907cSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*4d7e907cSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*4d7e907cSAndroid Build Coastguard Worker  * limitations under the License.
15*4d7e907cSAndroid Build Coastguard Worker  */
16*4d7e907cSAndroid Build Coastguard Worker 
17*4d7e907cSAndroid Build Coastguard Worker #ifndef CAMERA_COMMON_1_0_CAMERAMODULE_H
18*4d7e907cSAndroid Build Coastguard Worker #define CAMERA_COMMON_1_0_CAMERAMODULE_H
19*4d7e907cSAndroid Build Coastguard Worker 
20*4d7e907cSAndroid Build Coastguard Worker #include <string>
21*4d7e907cSAndroid Build Coastguard Worker #include <unordered_set>
22*4d7e907cSAndroid Build Coastguard Worker 
23*4d7e907cSAndroid Build Coastguard Worker #include <hardware/camera.h>
24*4d7e907cSAndroid Build Coastguard Worker #include <utils/KeyedVector.h>
25*4d7e907cSAndroid Build Coastguard Worker #include <utils/Mutex.h>
26*4d7e907cSAndroid Build Coastguard Worker #include <utils/RefBase.h>
27*4d7e907cSAndroid Build Coastguard Worker 
28*4d7e907cSAndroid Build Coastguard Worker #include "CameraMetadata.h"
29*4d7e907cSAndroid Build Coastguard Worker 
30*4d7e907cSAndroid Build Coastguard Worker namespace android {
31*4d7e907cSAndroid Build Coastguard Worker namespace hardware {
32*4d7e907cSAndroid Build Coastguard Worker namespace camera {
33*4d7e907cSAndroid Build Coastguard Worker namespace common {
34*4d7e907cSAndroid Build Coastguard Worker namespace helper {
35*4d7e907cSAndroid Build Coastguard Worker /**
36*4d7e907cSAndroid Build Coastguard Worker  * A wrapper class for HAL camera module.
37*4d7e907cSAndroid Build Coastguard Worker  *
38*4d7e907cSAndroid Build Coastguard Worker  * This class wraps camera_module_t returned from HAL to provide a wrapped
39*4d7e907cSAndroid Build Coastguard Worker  * get_camera_info implementation which CameraService generates some
40*4d7e907cSAndroid Build Coastguard Worker  * camera characteristics keys defined in newer HAL version on an older HAL.
41*4d7e907cSAndroid Build Coastguard Worker  */
42*4d7e907cSAndroid Build Coastguard Worker class CameraModule : public RefBase {
43*4d7e907cSAndroid Build Coastguard Worker   public:
44*4d7e907cSAndroid Build Coastguard Worker     explicit CameraModule(camera_module_t* module);
45*4d7e907cSAndroid Build Coastguard Worker     virtual ~CameraModule();
46*4d7e907cSAndroid Build Coastguard Worker 
47*4d7e907cSAndroid Build Coastguard Worker     // Must be called after construction
48*4d7e907cSAndroid Build Coastguard Worker     // Returns OK on success, NO_INIT on failure
49*4d7e907cSAndroid Build Coastguard Worker     int init();
50*4d7e907cSAndroid Build Coastguard Worker 
51*4d7e907cSAndroid Build Coastguard Worker     int getCameraInfo(int cameraId, struct camera_info* info);
52*4d7e907cSAndroid Build Coastguard Worker     int getDeviceVersion(int cameraId);
53*4d7e907cSAndroid Build Coastguard Worker     int getNumberOfCameras(void);
54*4d7e907cSAndroid Build Coastguard Worker     int open(const char* id, struct hw_device_t** device);
55*4d7e907cSAndroid Build Coastguard Worker     bool isOpenLegacyDefined() const;
56*4d7e907cSAndroid Build Coastguard Worker     int openLegacy(const char* id, uint32_t halVersion, struct hw_device_t** device);
57*4d7e907cSAndroid Build Coastguard Worker     int setCallbacks(const camera_module_callbacks_t* callbacks);
58*4d7e907cSAndroid Build Coastguard Worker     bool isVendorTagDefined() const;
59*4d7e907cSAndroid Build Coastguard Worker     void getVendorTagOps(vendor_tag_ops_t* ops);
60*4d7e907cSAndroid Build Coastguard Worker     bool isSetTorchModeSupported() const;
61*4d7e907cSAndroid Build Coastguard Worker     int setTorchMode(const char* camera_id, bool enable);
62*4d7e907cSAndroid Build Coastguard Worker     uint16_t getModuleApiVersion() const;
63*4d7e907cSAndroid Build Coastguard Worker     const char* getModuleName() const;
64*4d7e907cSAndroid Build Coastguard Worker     uint16_t getHalApiVersion() const;
65*4d7e907cSAndroid Build Coastguard Worker     const char* getModuleAuthor() const;
66*4d7e907cSAndroid Build Coastguard Worker     // Only used by CameraModuleFixture native test. Do NOT use elsewhere.
67*4d7e907cSAndroid Build Coastguard Worker     void* getDso();
68*4d7e907cSAndroid Build Coastguard Worker     // Only used by CameraProvider
69*4d7e907cSAndroid Build Coastguard Worker     void removeCamera(int cameraId);
70*4d7e907cSAndroid Build Coastguard Worker     int getPhysicalCameraInfo(int physicalCameraId, camera_metadata_t** physicalInfo);
71*4d7e907cSAndroid Build Coastguard Worker     int isStreamCombinationSupported(int cameraId, camera_stream_combination_t* streams);
72*4d7e907cSAndroid Build Coastguard Worker     void notifyDeviceStateChange(uint64_t deviceState);
73*4d7e907cSAndroid Build Coastguard Worker 
74*4d7e907cSAndroid Build Coastguard Worker     static bool isLogicalMultiCamera(const common::helper::CameraMetadata& metadata,
75*4d7e907cSAndroid Build Coastguard Worker                                      std::unordered_set<std::string>* physicalCameraIds);
76*4d7e907cSAndroid Build Coastguard Worker 
77*4d7e907cSAndroid Build Coastguard Worker   private:
78*4d7e907cSAndroid Build Coastguard Worker     // Derive camera characteristics keys defined after HAL device version
79*4d7e907cSAndroid Build Coastguard Worker     static void deriveCameraCharacteristicsKeys(uint32_t deviceVersion, CameraMetadata& chars);
80*4d7e907cSAndroid Build Coastguard Worker     // Helper function to append available[request|result|chars]Keys
81*4d7e907cSAndroid Build Coastguard Worker     static void appendAvailableKeys(CameraMetadata& chars, int32_t keyTag,
82*4d7e907cSAndroid Build Coastguard Worker                                     const Vector<int32_t>& appendKeys);
83*4d7e907cSAndroid Build Coastguard Worker     status_t filterOpenErrorCode(status_t err);
84*4d7e907cSAndroid Build Coastguard Worker     camera_module_t* mModule;
85*4d7e907cSAndroid Build Coastguard Worker     int mNumberOfCameras;
86*4d7e907cSAndroid Build Coastguard Worker     KeyedVector<int, camera_info> mCameraInfoMap;
87*4d7e907cSAndroid Build Coastguard Worker     KeyedVector<int, int> mDeviceVersionMap;
88*4d7e907cSAndroid Build Coastguard Worker     KeyedVector<int, camera_metadata_t*> mPhysicalCameraInfoMap;
89*4d7e907cSAndroid Build Coastguard Worker     Mutex mCameraInfoLock;
90*4d7e907cSAndroid Build Coastguard Worker };
91*4d7e907cSAndroid Build Coastguard Worker 
92*4d7e907cSAndroid Build Coastguard Worker }  // namespace helper
93*4d7e907cSAndroid Build Coastguard Worker 
94*4d7e907cSAndroid Build Coastguard Worker // NOTE: Deprecated namespace. This namespace should no longer be used for the following symbols
95*4d7e907cSAndroid Build Coastguard Worker namespace V1_0::helper {
96*4d7e907cSAndroid Build Coastguard Worker // Export symbols to the old namespace to preserve compatibility
97*4d7e907cSAndroid Build Coastguard Worker typedef android::hardware::camera::common::helper::CameraModule CameraModule;
98*4d7e907cSAndroid Build Coastguard Worker }  // namespace V1_0::helper
99*4d7e907cSAndroid Build Coastguard Worker 
100*4d7e907cSAndroid Build Coastguard Worker }  // namespace common
101*4d7e907cSAndroid Build Coastguard Worker }  // namespace camera
102*4d7e907cSAndroid Build Coastguard Worker }  // namespace hardware
103*4d7e907cSAndroid Build Coastguard Worker }  // namespace android
104*4d7e907cSAndroid Build Coastguard Worker 
105*4d7e907cSAndroid Build Coastguard Worker #endif
106