blob: 705fe69765964e86a098bb74c3f79e9cfb33409f [file] [log] [blame]
Igor Murashkin44cfcf02013-03-01 16:22:28 -08001/*
2 * Copyright (C) 2013 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef ANDROID_SERVERS_CAMERA_CAMERA2CLIENT_BASE_H
18#define ANDROID_SERVERS_CAMERA_CAMERA2CLIENT_BASE_H
19
Eino-Ville Talvala7b82efe2013-07-25 17:12:35 -070020#include "common/CameraDeviceBase.h"
Jianing Weicb0652e2014-03-12 18:29:36 -070021#include "camera/CaptureResult.h"
Jayant Chowdhary48162a72022-05-27 05:37:14 +000022#include "CameraServiceWatchdog.h"
Igor Murashkin44cfcf02013-03-01 16:22:28 -080023
24namespace android {
25
26class IMemory;
27
Eino-Ville Talvala7b82efe2013-07-25 17:12:35 -070028class CameraService;
29
Igor Murashkin44cfcf02013-03-01 16:22:28 -080030template <typename TClientBase>
31class Camera2ClientBase :
32 public TClientBase,
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -080033 public NotificationListener
Igor Murashkin44cfcf02013-03-01 16:22:28 -080034{
35public:
36 typedef typename TClientBase::TCamCallbacks TCamCallbacks;
37
38 /**
Ruben Brunk9efdf952015-03-18 23:11:57 -070039 * Base binder interface (see ICamera/ICameraDeviceUser for details)
Igor Murashkin44cfcf02013-03-01 16:22:28 -080040 */
Eino-Ville Talvalad56db1d2015-12-17 16:50:35 -080041 virtual status_t connect(const sp<TCamCallbacks>& callbacks);
42 virtual binder::Status disconnect();
Igor Murashkin44cfcf02013-03-01 16:22:28 -080043
44 /**
45 * Interface used by CameraService
46 */
47
48 // TODO: too many params, move into a ClientArgs<T>
49 Camera2ClientBase(const sp<CameraService>& cameraService,
50 const sp<TCamCallbacks>& remoteCallback,
51 const String16& clientPackageName,
Jayant Chowdharyeb0169f2022-01-31 00:00:02 -080052 bool systemNativeClient,
Jooyung Han3f9a3b42020-01-23 12:27:18 +090053 const std::optional<String16>& clientFeatureId,
Eino-Ville Talvala2f09bac2016-12-13 11:29:54 -080054 const String8& cameraId,
Yin-Chia Yehc3e9d6f2018-02-06 10:56:32 -080055 int api1CameraId,
Igor Murashkin44cfcf02013-03-01 16:22:28 -080056 int cameraFacing,
Emilian Peev8b64f282021-03-25 16:49:57 -070057 int sensorOrientation,
Igor Murashkin44cfcf02013-03-01 16:22:28 -080058 int clientPid,
59 uid_t clientUid,
Shuzhen Wangd4abdf72021-05-28 11:22:50 -070060 int servicePid,
Emilian Peev5104fe92021-10-21 14:27:09 -070061 bool overrideForPerfClass,
Austin Borger3560b7e2022-10-27 12:20:29 -070062 bool overrideToPortrait,
Emilian Peev5104fe92021-10-21 14:27:09 -070063 bool legacyClient = false);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080064 virtual ~Camera2ClientBase();
65
Emilian Peevbd8c5032018-02-14 23:05:40 +000066 virtual status_t initialize(sp<CameraProviderManager> manager, const String8& monitorTags);
Eino-Ville Talvalac4003962016-01-13 10:07:04 -080067 virtual status_t dumpClient(int fd, const Vector<String16>& args);
Avichal Rakesh7e53cad2021-10-05 13:46:30 -070068 virtual status_t startWatchingTags(const String8 &tags, int out);
69 virtual status_t stopWatchingTags(int out);
70 virtual status_t dumpWatchedEventsToVector(std::vector<std::string> &out);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080071
72 /**
Yin-Chia Yeh5fd603e2019-11-20 11:22:27 -080073 * NotificationListener implementation
Igor Murashkin44cfcf02013-03-01 16:22:28 -080074 */
75
Eino-Ville Talvalad56db1d2015-12-17 16:50:35 -080076 virtual void notifyError(int32_t errorCode,
Jianing Weicb0652e2014-03-12 18:29:36 -070077 const CaptureResultExtras& resultExtras);
Austin Borgerc8099762023-01-12 17:08:46 -080078 virtual void notifyPhysicalCameraChange(const std::string &physicalId) override;
Austin Borger4a870a32022-02-25 01:48:41 +000079 // Returns errors on app ops permission failures
80 virtual status_t notifyActive(float maxPreviewFps);
Shuzhen Wangd26b1862022-03-07 12:05:05 -080081 virtual void notifyIdle(int64_t /*requestCount*/, int64_t /*resultErrorCount*/,
82 bool /*deviceError*/,
83 const std::vector<hardware::CameraStreamStats>&) {}
Jianing Weicb0652e2014-03-12 18:29:36 -070084 virtual void notifyShutter(const CaptureResultExtras& resultExtras,
85 nsecs_t timestamp);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080086 virtual void notifyAutoFocus(uint8_t newState, int triggerId);
87 virtual void notifyAutoExposure(uint8_t newState, int triggerId);
88 virtual void notifyAutoWhitebalance(uint8_t newState,
89 int triggerId);
Eino-Ville Talvala4d44cad2015-04-11 13:15:45 -070090 virtual void notifyPrepared(int streamId);
Shuzhen Wang9d066012016-09-30 11:30:20 -070091 virtual void notifyRequestQueueEmpty();
Chien-Yu Chene8c535e2016-04-14 12:18:26 -070092 virtual void notifyRepeatingRequestError(long lastFrameNumber);
Igor Murashkin44cfcf02013-03-01 16:22:28 -080093
Shuzhen Wangd26b1862022-03-07 12:05:05 -080094 void notifyIdleWithUserTag(int64_t requestCount, int64_t resultErrorCount,
95 bool deviceError,
96 const std::vector<hardware::CameraStreamStats>& streamStats,
Shuzhen Wang9372b0b2022-05-11 18:55:19 -070097 const std::string& userTag, int videoStabilizationMode);
Shuzhen Wangd26b1862022-03-07 12:05:05 -080098
Igor Murashkin44cfcf02013-03-01 16:22:28 -080099 int getCameraId() const;
100 const sp<CameraDeviceBase>&
101 getCameraDevice();
Yin-Chia Yehcd8fce82014-06-18 10:51:34 -0700102 int getCameraDeviceVersion() const;
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800103 const sp<CameraService>&
104 getCameraService();
105
106 /**
107 * Interface used by independent components of CameraClient2Base.
108 */
109
110 // Simple class to ensure that access to TCamCallbacks is serialized
111 // by requiring mRemoteCallbackLock to be locked before access to
112 // mRemoteCallback is possible.
113 class SharedCameraCallbacks {
114 public:
115 class Lock {
116 public:
Chih-Hung Hsieh8b0b9712016-08-09 14:25:53 -0700117 explicit Lock(SharedCameraCallbacks &client);
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800118 ~Lock();
119 sp<TCamCallbacks> &mRemoteCallback;
120 private:
121 SharedCameraCallbacks &mSharedClient;
122 };
Chih-Hung Hsieh8b0b9712016-08-09 14:25:53 -0700123 explicit SharedCameraCallbacks(const sp<TCamCallbacks>& client);
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800124 SharedCameraCallbacks& operator=(const sp<TCamCallbacks>& client);
125 void clear();
126 private:
127 sp<TCamCallbacks> mRemoteCallback;
128 mutable Mutex mRemoteCallbackLock;
129 } mSharedCameraCallbacks;
130
Cliff Wud3a05312021-04-26 23:07:31 +0800131 status_t injectCamera(const String8& injectedCamId,
132 sp<CameraProviderManager> manager) override;
133 status_t stopInjection() override;
134
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800135protected:
136
Ravneet Dhanjal72c96652022-06-29 01:34:01 +0000137 // Used for watchdog timeout to monitor disconnect
138 static const nsecs_t kBufferTimeDisconnectNs = 3000000000; // 3 sec.
139
Eino-Ville Talvalab9d2f332014-09-18 17:24:22 -0700140 // The PID provided in the constructor call
141 pid_t mInitialClientPid;
Jayant Chowdhary22441f32021-12-26 18:35:41 -0800142 bool mOverrideForPerfClass = false;
143 bool mLegacyClient = false;
Eino-Ville Talvalab9d2f332014-09-18 17:24:22 -0700144
Igor Murashkine7ee7632013-06-11 18:10:18 -0700145 virtual sp<IBinder> asBinderWrapper() {
Marco Nelissen06b46062014-11-14 07:58:25 -0800146 return IInterface::asBinder(this);
Igor Murashkine7ee7632013-06-11 18:10:18 -0700147 }
148
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800149 virtual status_t dumpDevice(int fd, const Vector<String16>& args);
150
151 /** Binder client interface-related private members */
152
153 // Mutex that must be locked by methods implementing the binder client
154 // interface. Ensures serialization between incoming client calls.
155 // All methods in this class hierarchy that append 'L' to the name assume
156 // that mBinderSerializationLock is locked when they're called
157 mutable Mutex mBinderSerializationLock;
158
Eino-Ville Talvalad309fb92015-11-25 12:12:45 -0800159 /** CameraDeviceBase instance wrapping HAL3+ entry */
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800160
Jayant Chowdhary22441f32021-12-26 18:35:41 -0800161 // Note: This was previously set to const to avoid mDevice being updated -
162 // b/112639939 (update of sp<> is racy) during dumpDevice (which is important to be lock free
163 // for debugging purpose). The const has been removed since CameraDeviceBase
164 // needs to be set during initializeImpl(). This must not be set / cleared
165 // anywhere else.
166 sp<CameraDeviceBase> mDevice;
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800167
168 /** Utility members */
169
170 // Verify that caller is the owner of the camera
171 status_t checkPid(const char *checkLocation) const;
172
173 virtual void detachDevice();
Eino-Ville Talvala412fe562015-08-20 17:08:32 -0700174
175 bool mDeviceActive;
Eino-Ville Talvala2f09bac2016-12-13 11:29:54 -0800176
Yin-Chia Yehc3e9d6f2018-02-06 10:56:32 -0800177 const int mApi1CameraId; // -1 if client is API2
178
Eino-Ville Talvala2f09bac2016-12-13 11:29:54 -0800179private:
180 template<typename TProviderPtr>
Emilian Peevbd8c5032018-02-14 23:05:40 +0000181 status_t initializeImpl(TProviderPtr providerPtr, const String8& monitorTags);
Jayant Chowdhary48162a72022-05-27 05:37:14 +0000182
183 binder::Status disconnectImpl();
184
185 // Watchdog thread
186 sp<CameraServiceWatchdog> mCameraServiceWatchdog;
187
Igor Murashkin44cfcf02013-03-01 16:22:28 -0800188};
189
190}; // namespace android
191
192#endif