The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | /* |
| 2 | ** |
| 3 | ** Copyright (C) 2008, The Android Open Source Project |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 4 | ** |
| 5 | ** Licensed under the Apache License, Version 2.0 (the "License"); |
| 6 | ** you may not use this file except in compliance with the License. |
| 7 | ** You may obtain a copy of the License at |
| 8 | ** |
| 9 | ** http://www.apache.org/licenses/LICENSE-2.0 |
| 10 | ** |
| 11 | ** Unless required by applicable law or agreed to in writing, software |
| 12 | ** distributed under the License is distributed on an "AS IS" BASIS, |
| 13 | ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 14 | ** See the License for the specific language governing permissions and |
| 15 | ** limitations under the License. |
| 16 | */ |
| 17 | |
| 18 | #ifndef ANDROID_SERVERS_CAMERA_CAMERASERVICE_H |
| 19 | #define ANDROID_SERVERS_CAMERA_CAMERASERVICE_H |
| 20 | |
Mathias Agopian | 2465168 | 2010-07-14 18:41:18 -0700 | [diff] [blame] | 21 | #include <binder/BinderService.h> |
| 22 | |
Mathias Agopian | 000479f | 2010-02-09 17:46:37 -0800 | [diff] [blame] | 23 | #include <camera/ICameraService.h> |
| 24 | #include <camera/CameraHardwareInterface.h> |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 25 | |
| 26 | /* This needs to be increased if we can have more cameras */ |
| 27 | #define MAX_CAMERAS 2 |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 28 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 29 | namespace android { |
| 30 | |
Dave Sparks | dd158c9 | 2009-10-15 10:02:22 -0700 | [diff] [blame] | 31 | class MemoryHeapBase; |
Jason Sams | b18b691 | 2009-03-24 20:21:36 -0700 | [diff] [blame] | 32 | class MediaPlayer; |
| 33 | |
Mathias Agopian | 2465168 | 2010-07-14 18:41:18 -0700 | [diff] [blame] | 34 | class CameraService : |
| 35 | public BinderService<CameraService>, |
| 36 | public BnCameraService |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 37 | { |
| 38 | class Client; |
Mathias Agopian | 2465168 | 2010-07-14 18:41:18 -0700 | [diff] [blame] | 39 | friend class BinderService<CameraService>; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 40 | public: |
Mathias Agopian | 2465168 | 2010-07-14 18:41:18 -0700 | [diff] [blame] | 41 | static char const* getServiceName() { return "media.camera"; } |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 42 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 43 | CameraService(); |
| 44 | virtual ~CameraService(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 45 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 46 | virtual int32_t getNumberOfCameras(); |
Chih-Chung Chang | b8bb78f | 2010-06-10 13:32:16 +0800 | [diff] [blame] | 47 | virtual status_t getCameraInfo(int cameraId, |
| 48 | struct CameraInfo* cameraInfo); |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 49 | virtual sp<ICamera> connect(const sp<ICameraClient>& cameraClient, int cameraId); |
| 50 | virtual void removeClient(const sp<ICameraClient>& cameraClient); |
| 51 | virtual sp<Client> getClientById(int cameraId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 52 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 53 | virtual status_t dump(int fd, const Vector<String16>& args); |
| 54 | virtual status_t onTransact(uint32_t code, const Parcel& data, |
| 55 | Parcel* reply, uint32_t flags); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 56 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 57 | enum sound_kind { |
| 58 | SOUND_SHUTTER = 0, |
| 59 | SOUND_RECORDING = 1, |
| 60 | NUM_SOUNDS |
| 61 | }; |
| 62 | |
| 63 | void loadSound(); |
| 64 | void playSound(sound_kind kind); |
| 65 | void releaseSound(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 66 | |
| 67 | private: |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 68 | Mutex mServiceLock; |
| 69 | wp<Client> mClient[MAX_CAMERAS]; // protected by mServiceLock |
Chih-Chung Chang | b8bb78f | 2010-06-10 13:32:16 +0800 | [diff] [blame] | 70 | int mNumberOfCameras; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 71 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 72 | // atomics to record whether the hardware is allocated to some client. |
| 73 | volatile int32_t mBusy[MAX_CAMERAS]; |
| 74 | void setCameraBusy(int cameraId); |
| 75 | void setCameraFree(int cameraId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 76 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 77 | // sounds |
| 78 | Mutex mSoundLock; |
| 79 | sp<MediaPlayer> mSoundPlayer[NUM_SOUNDS]; |
| 80 | int mSoundRef; // reference count (release all MediaPlayer when 0) |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 81 | |
Jamie Gennis | 85cfdd0 | 2010-08-10 16:37:53 -0700 | [diff] [blame] | 82 | // Used by Client objects to extract the ISurface from a Surface object. |
| 83 | // This is used because making Client a friend class of Surface would |
| 84 | // require including this header in Surface.h since Client is a nested |
| 85 | // class. |
| 86 | static sp<ISurface> getISurface(const sp<Surface>& surface); |
| 87 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 88 | class Client : public BnCamera |
| 89 | { |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 90 | public: |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 91 | // ICamera interface (see ICamera for details) |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 92 | virtual void disconnect(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 93 | virtual status_t connect(const sp<ICameraClient>& client); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 94 | virtual status_t lock(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 95 | virtual status_t unlock(); |
Jamie Gennis | 85cfdd0 | 2010-08-10 16:37:53 -0700 | [diff] [blame] | 96 | virtual status_t setPreviewDisplay(const sp<Surface>& surface); |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 97 | virtual void setPreviewCallbackFlag(int flag); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 98 | virtual status_t startPreview(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 99 | virtual void stopPreview(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 100 | virtual bool previewEnabled(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 101 | virtual status_t startRecording(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 102 | virtual void stopRecording(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 103 | virtual bool recordingEnabled(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 104 | virtual void releaseRecordingFrame(const sp<IMemory>& mem); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 105 | virtual status_t autoFocus(); |
Chih-Chung Chang | 244f8c2 | 2009-09-15 14:51:56 +0800 | [diff] [blame] | 106 | virtual status_t cancelAutoFocus(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 107 | virtual status_t takePicture(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 108 | virtual status_t setParameters(const String8& params); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 109 | virtual String8 getParameters() const; |
Wu-cheng Li | 36f68b8 | 2009-09-28 16:14:58 -0700 | [diff] [blame] | 110 | virtual status_t sendCommand(int32_t cmd, int32_t arg1, int32_t arg2); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 111 | private: |
| 112 | friend class CameraService; |
| 113 | Client(const sp<CameraService>& cameraService, |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 114 | const sp<ICameraClient>& cameraClient, |
Wu-cheng Li | e704438 | 2010-08-17 15:45:37 -0700 | [diff] [blame] | 115 | const sp<CameraHardwareInterface>& hardware, |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 116 | int cameraId, |
| 117 | int clientPid); |
| 118 | ~Client(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 119 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 120 | // return our camera client |
| 121 | const sp<ICameraClient>& getCameraClient() { return mCameraClient; } |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 122 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 123 | // check whether the calling process matches mClientPid. |
| 124 | status_t checkPid() const; |
| 125 | status_t checkPidAndHardware() const; // also check mHardware != 0 |
Benny Wong | da83f46 | 2009-08-12 12:01:27 -0500 | [diff] [blame] | 126 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 127 | // these are internal functions used to set up preview buffers |
| 128 | status_t registerPreviewBuffers(); |
| 129 | status_t setOverlay(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 130 | |
| 131 | // camera operation mode |
| 132 | enum camera_mode { |
| 133 | CAMERA_PREVIEW_MODE = 0, // frame automatically released |
| 134 | CAMERA_RECORDING_MODE = 1, // frame has to be explicitly released by releaseRecordingFrame() |
| 135 | }; |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 136 | // these are internal functions used for preview/recording |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 137 | status_t startCameraMode(camera_mode mode); |
| 138 | status_t startPreviewMode(); |
| 139 | status_t startRecordingMode(); |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 140 | |
Nipun Kwatra | 088146a | 2010-09-11 19:31:10 -0700 | [diff] [blame] | 141 | // internal function used by sendCommand to enable/disable shutter sound. |
| 142 | status_t enableShutterSound(bool enable); |
| 143 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 144 | // these are static callback functions |
| 145 | static void notifyCallback(int32_t msgType, int32_t ext1, int32_t ext2, void* user); |
| 146 | static void dataCallback(int32_t msgType, const sp<IMemory>& dataPtr, void* user); |
| 147 | static void dataCallbackTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr, void* user); |
| 148 | // convert client from cookie |
| 149 | static sp<Client> getClientFromCookie(void* user); |
| 150 | // handlers for messages |
| 151 | void handleShutter(image_rect_type *size); |
| 152 | void handlePreviewData(const sp<IMemory>& mem); |
| 153 | void handlePostview(const sp<IMemory>& mem); |
| 154 | void handleRawPicture(const sp<IMemory>& mem); |
| 155 | void handleCompressedPicture(const sp<IMemory>& mem); |
| 156 | void handleGenericNotify(int32_t msgType, int32_t ext1, int32_t ext2); |
| 157 | void handleGenericData(int32_t msgType, const sp<IMemory>& dataPtr); |
| 158 | void handleGenericDataTimestamp(nsecs_t timestamp, int32_t msgType, const sp<IMemory>& dataPtr); |
| 159 | |
| 160 | void copyFrameAndPostCopiedFrame( |
| 161 | const sp<ICameraClient>& client, |
| 162 | const sp<IMemoryHeap>& heap, |
| 163 | size_t offset, size_t size); |
| 164 | |
| 165 | // these are initialized in the constructor. |
| 166 | sp<CameraService> mCameraService; // immutable after constructor |
| 167 | sp<ICameraClient> mCameraClient; |
| 168 | int mCameraId; // immutable after constructor |
| 169 | pid_t mClientPid; |
| 170 | sp<CameraHardwareInterface> mHardware; // cleared after disconnect() |
| 171 | bool mUseOverlay; // immutable after constructor |
| 172 | sp<OverlayRef> mOverlayRef; |
| 173 | int mOverlayW; |
| 174 | int mOverlayH; |
| 175 | int mPreviewCallbackFlag; |
Wu-cheng Li | b3347bc | 2010-09-23 17:17:43 -0700 | [diff] [blame] | 176 | int mOrientation; // Current display orientation |
| 177 | // True if display orientation has been changed. This is only used in overlay. |
| 178 | int mOrientationChanged; |
Nipun Kwatra | 088146a | 2010-09-11 19:31:10 -0700 | [diff] [blame] | 179 | bool mPlayShutterSound; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 180 | |
| 181 | // Ensures atomicity among the public methods |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 182 | mutable Mutex mLock; |
| 183 | sp<ISurface> mSurface; |
Jamie Gennis | 85cfdd0 | 2010-08-10 16:37:53 -0700 | [diff] [blame] | 184 | sp<ANativeWindow> mPreviewWindow; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 185 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 186 | // If the user want us to return a copy of the preview frame (instead |
| 187 | // of the original one), we allocate mPreviewBuffer and reuse it if possible. |
| 188 | sp<MemoryHeapBase> mPreviewBuffer; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 189 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 190 | // We need to avoid the deadlock when the incoming command thread and |
| 191 | // the CameraHardwareInterface callback thread both want to grab mLock. |
| 192 | // An extra flag is used to tell the callback thread that it should stop |
| 193 | // trying to deliver the callback messages if the client is not |
| 194 | // interested in it anymore. For example, if the client is calling |
| 195 | // stopPreview(), the preview frame messages do not need to be delivered |
| 196 | // anymore. |
Jason Sams | b18b691 | 2009-03-24 20:21:36 -0700 | [diff] [blame] | 197 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 198 | // This function takes the same parameter as the enableMsgType() and |
| 199 | // disableMsgType() functions in CameraHardwareInterface. |
| 200 | void enableMsgType(int32_t msgType); |
| 201 | void disableMsgType(int32_t msgType); |
| 202 | volatile int32_t mMsgEnabled; |
Benny Wong | 6d2090e | 2009-07-15 18:44:27 -0500 | [diff] [blame] | 203 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 204 | // This function keeps trying to grab mLock, or give up if the message |
| 205 | // is found to be disabled. It returns true if mLock is grabbed. |
| 206 | bool lockIfMessageWanted(int32_t msgType); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 207 | }; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 208 | }; |
| 209 | |
Chih-Chung Chang | e25cc65 | 2010-05-06 16:36:58 +0800 | [diff] [blame] | 210 | } // namespace android |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 211 | |
| 212 | #endif |