1 /* Copyright (c) 2012-2013, 2015, The Linux Foundataion. All rights reserved.
2 *
3 * Redistribution and use in source and binary forms, with or without
4 * modification, are permitted provided that the following conditions are
5 * met:
6 *     * Redistributions of source code must retain the above copyright
7 *       notice, this list of conditions and the following disclaimer.
8 *     * Redistributions in binary form must reproduce the above
9 *       copyright notice, this list of conditions and the following
10 *       disclaimer in the documentation and/or other materials provided
11 *       with the distribution.
12 *     * Neither the name of The Linux Foundation nor the names of its
13 *       contributors may be used to endorse or promote products derived
14 *       from this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
19 * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
20 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
23 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
24 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
25 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
26 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 */
29 
30 #ifndef __QCAMERA3HARDWAREINTERFACE_H__
31 #define __QCAMERA3HARDWAREINTERFACE_H__
32 
33 #include <pthread.h>
34 #include <utils/List.h>
35 #include <utils/KeyedVector.h>
36 #include <hardware/camera3.h>
37 #include <camera/CameraMetadata.h>
38 #include "QCamera3HALHeader.h"
39 #include "QCamera3Channel.h"
40 
41 #include <hardware/power.h>
42 
43 extern "C" {
44 #include <mm_camera_interface.h>
45 #include <mm_jpeg_interface.h>
46 }
47 
48 using namespace android;
49 
50 namespace qcamera {
51 
52 #ifndef TRUE
53 #define TRUE 1
54 #endif
55 
56 #ifndef FALSE
57 #define FALSE 0
58 #endif
59 
60 /* Time related macros */
61 typedef int64_t nsecs_t;
62 #define NSEC_PER_SEC 1000000000LL
63 #define NSEC_PER_USEC 1000
64 #define NSEC_PER_33MSEC 33000000LL
65 
66 class QCamera3MetadataChannel;
67 class QCamera3PicChannel;
68 class QCamera3HeapMemory;
69 class QCamera3Exif;
70 
71 class QCamera3HardwareInterface {
72 public:
73     /* static variable and functions accessed by camera service */
74     static camera3_device_ops_t mCameraOps;
75     static int initialize(const struct camera3_device *,
76                 const camera3_callback_ops_t *callback_ops);
77     static int configure_streams(const struct camera3_device *,
78                 camera3_stream_configuration_t *stream_list);
79     static int register_stream_buffers(const struct camera3_device *,
80                 const camera3_stream_buffer_set_t *buffer_set);
81     static const camera_metadata_t* construct_default_request_settings(
82                                 const struct camera3_device *, int type);
83     static int process_capture_request(const struct camera3_device *,
84                                 camera3_capture_request_t *request);
85     static void get_metadata_vendor_tag_ops(const struct camera3_device *,
86                                                vendor_tag_query_ops_t* ops);
87     static void dump(const struct camera3_device *, int fd);
88     static int close_camera_device(struct hw_device_t* device);
89 public:
90     QCamera3HardwareInterface(int cameraId);
91     virtual ~QCamera3HardwareInterface();
92     int openCamera(struct hw_device_t **hw_device);
93     int getMetadata(int type);
94     camera_metadata_t* translateCapabilityToMetadata(int type);
95 
96     static int getCamInfo(int cameraId, struct camera_info *info);
97     static int initCapabilities(int cameraId);
98     static int initStaticMetadata(int cameraId);
99     static void makeTable(cam_dimension_t* dimTable, uint8_t size, int32_t* sizeTable);
100     static void makeFPSTable(cam_fps_range_t* fpsTable, uint8_t size,
101                                           int32_t* fpsRangesTable);
102     static void makeOverridesList(cam_scene_mode_overrides_t* overridesTable, uint8_t size,
103                                    uint8_t* overridesList, uint8_t* supported_indexes, int camera_id);
104     static void convertToRegions(cam_rect_t rect, int32_t* region, int weight);
105     static void convertFromRegions(cam_area_t* roi, const camera_metadata_t *settings,
106                                    uint32_t tag);
107     static bool resetIfNeededROI(cam_area_t* roi, const cam_crop_region_t* scalerCropRegion);
108     static void convertLandmarks(cam_face_detection_info_t face, int32_t* landmarks);
109     static void postproc_channel_cb_routine(mm_camera_super_buf_t *recvd_frame,
110                                             void *userdata);
111     static int32_t getScalarFormat(int32_t format);
112     static int32_t getSensorSensitivity(int32_t iso_mode);
113     static void captureResultCb(mm_camera_super_buf_t *metadata,
114                 camera3_stream_buffer_t *buffer, uint32_t frame_number,
115                 void *userdata);
116 
117     int initialize(const camera3_callback_ops_t *callback_ops);
118     int configureStreams(camera3_stream_configuration_t *stream_list);
119     int registerStreamBuffers(const camera3_stream_buffer_set_t *buffer_set);
120     int processCaptureRequest(camera3_capture_request_t *request);
121     void getMetadataVendorTagOps(vendor_tag_query_ops_t* ops);
122     void dump(int fd);
123 
124     int setFrameParameters(int frame_id, const camera_metadata_t *settings,
125         uint32_t streamTypeMask, cam_trigger_t &aeTrigger);
126     int translateMetadataToParameters(const camera_metadata_t *settings,
127             cam_trigger_t &aeTrigger);
128     camera_metadata_t* translateCbMetadataToResultMetadata(metadata_buffer_t *metadata,
129                             nsecs_t timestamp, int32_t request_id,
130                             const cam_trigger_t &aeTrigger);
131     int getJpegSettings(const camera_metadata_t *settings);
132     int initParameters();
133     void deinitParameters();
134     int getMaxUnmatchedFramesInQueue();
135     QCamera3ReprocessChannel *addOnlineReprocChannel(QCamera3Channel *pInputChannel, QCamera3PicChannel *picChHandle);
136     bool needRotationReprocess();
137     bool needReprocess();
138     bool isWNREnabled();
139     cam_denoise_process_type_t getWaveletDenoiseProcessPlate();
140 
141     void captureResultCb(mm_camera_super_buf_t *metadata,
142                 camera3_stream_buffer_t *buffer, uint32_t frame_number);
143 
144     typedef struct {
145         uint8_t fwk_name;
146         uint8_t hal_name;
147     } QCameraMap;
148 
149 private:
150 
151     int openCamera();
152     int closeCamera();
153     int AddSetParmEntryToBatch(parm_buffer_t *p_table,
154                                cam_intf_parm_type_t paramType,
155                                uint32_t paramLength,
156                                void *paramValue);
157     static int8_t lookupHalName(const QCameraMap arr[],
158                       int len, int fwk_name);
159     static int8_t lookupFwkName(const QCameraMap arr[],
160                       int len, int hal_name);
161 
162     int validateCaptureRequest(camera3_capture_request_t *request);
163 
164 public:
165 
166     bool needOnlineRotation();
167     void getThumbnailSize(cam_dimension_t &dim);
168     int getJpegQuality();
169     int calcMaxJpegSize();
170     QCamera3Exif *getExifData();
171 private:
172     camera3_device_t   mCameraDevice;
173     uint8_t            mCameraId;
174     mm_camera_vtbl_t  *mCameraHandle;
175     bool               mCameraOpened;
176     bool               mCameraInitialized;
177     camera_metadata_t *mDefaultMetadata[CAMERA3_TEMPLATE_COUNT];
178     int mBlobRequest;
179 
180     const camera3_callback_ops_t *mCallbackOps;
181 
182     camera3_stream_t *mInputStream;
183     QCamera3MetadataChannel *mMetadataChannel;
184     QCamera3PicChannel *mPictureChannel;
185 
186      //First request yet to be processed after configureStreams
187     bool mFirstRequest;
188     QCamera3HeapMemory *mParamHeap;
189     parm_buffer_t* mParameters;
190     bool m_bWNROn;
191 
192     /* Data structure to store pending request */
193     typedef struct {
194         camera3_stream_t *stream;
195         camera3_stream_buffer_t *buffer;
196     } RequestedBufferInfo;
197     typedef struct {
198         uint32_t frame_number;
199         uint32_t num_buffers;
200         int32_t request_id;
201         List<RequestedBufferInfo> buffers;
202         int blob_request;
203         cam_trigger_t ae_trigger;
204     } PendingRequestInfo;
205     typedef KeyedVector<camera3_stream_t *, uint32_t> PendingBuffersMap;
206 
207     List<PendingRequestInfo> mPendingRequestsList;
208     PendingBuffersMap mPendingBuffersMap;
209     pthread_cond_t mRequestCond;
210     int mPendingRequest;
211     int32_t mCurrentRequestId;
212 
213     //mutex for serialized access to camera3_device_ops_t functions
214     pthread_mutex_t mMutex;
215 
216     jpeg_settings_t* mJpegSettings;
217     metadata_response_t mMetadataResponse;
218     List<stream_info_t*> mStreamInfo;
219     bool mIsZslMode;
220 
221     power_module_t *m_pPowerModule;   // power module
222 
223     int32_t mPrecaptureId;
224 
225     static const QCameraMap EFFECT_MODES_MAP[];
226     static const QCameraMap WHITE_BALANCE_MODES_MAP[];
227     static const QCameraMap SCENE_MODES_MAP[];
228     static const QCameraMap FOCUS_MODES_MAP[];
229     static const QCameraMap ANTIBANDING_MODES_MAP[];
230     static const QCameraMap AE_FLASH_MODE_MAP[];
231     static const QCameraMap FLASH_MODES_MAP[];
232 
233     static pthread_mutex_t mCameraSessionLock;
234     static unsigned int mCameraSessionActive;
235 };
236 
237 }; // namespace qcamera
238 
239 #endif /* __QCAMERA2HARDWAREINTERFACE_H__ */
240