QCamera3Channel.h revision d625f35eaded37f9f2c6629cbd99cd243683b7a0 
1/* Copyright (c) 2012-2013, 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 __QCAMERA3_CHANNEL_H__
31#define __QCAMERA3_CHANNEL_H__
32
33#include <hardware/camera3.h>
34#include "QCamera3Stream.h"
35#include "QCamera3Mem.h"
36#include "QCamera3PostProc.h"
37#include "QCamera3HALHeader.h"
38
39extern "C" {
40#include <mm_camera_interface.h>
41}
42
43using namespace android;
44
45namespace qcamera {
46
47typedef void (*channel_cb_routine)(mm_camera_super_buf_t *metadata,
48                                camera3_stream_buffer_t *buffer,
49                                uint32_t frame_number, void *userdata);
50
51class QCamera3Channel
52{
53public:
54    QCamera3Channel(uint32_t cam_handle,
55                   mm_camera_ops_t *cam_ops,
56                   channel_cb_routine cb_routine,
57                   cam_padding_info_t *paddingInfo,
58                   void *userData);
59    QCamera3Channel();
60    virtual ~QCamera3Channel();
61
62    int32_t addStream(cam_stream_type_t streamType,
63                              cam_format_t streamFormat,
64                              cam_dimension_t streamDim,
65                              uint8_t minStreamBufnum);
66    int32_t start();
67    int32_t stop();
68    int32_t bufDone(mm_camera_super_buf_t *recvd_frame);
69
70    uint32_t getStreamTypeMask();
71    uint32_t getStreamID(uint32_t streamMask);
72    virtual int32_t registerBuffers(uint32_t num_buffers,
73                        buffer_handle_t **buffers) = 0;
74    virtual int32_t initialize() = 0;
75    virtual int32_t request(buffer_handle_t * /*buffer*/,
76                uint32_t /*frameNumber*/){ return 0;};
77    virtual int32_t request(buffer_handle_t * /*buffer*/,
78                uint32_t /*frameNumber*/,
79                jpeg_settings_t* /*mJpegSettings*/,
80                mm_camera_buf_def_t* /*pInputBuffer*/,
81                QCamera3Channel* /*pInputChannel*/){ return 0;};
82    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
83                            QCamera3Stream *stream) = 0;
84
85    virtual QCamera3Memory *getStreamBufs(uint32_t len) = 0;
86    virtual void putStreamBufs() = 0;
87
88    QCamera3Stream *getStreamByHandle(uint32_t streamHandle);
89    uint32_t getMyHandle() const {return m_handle;};
90    uint8_t getNumOfStreams() const {return m_numStreams;};
91    QCamera3Stream *getStreamByIndex(uint8_t index);
92
93    static void streamCbRoutine(mm_camera_super_buf_t *super_frame,
94                QCamera3Stream *stream, void *userdata);
95    void *mUserData;
96    cam_padding_info_t *mPaddingInfo;
97    QCamera3Stream *mStreams[MAX_STREAM_NUM_IN_BUNDLE];
98    uint8_t m_numStreams;
99protected:
100
101   virtual int32_t init(mm_camera_channel_attr_t *attr,
102                         mm_camera_buf_notify_t dataCB);
103    int32_t allocateStreamInfoBuf(camera3_stream_t *stream);
104
105    uint32_t m_camHandle;
106    mm_camera_ops_t *m_camOps;
107    bool m_bIsActive;
108
109    uint32_t m_handle;
110
111
112    mm_camera_buf_notify_t mDataCB;
113
114
115    QCamera3HeapMemory *mStreamInfoBuf;
116    channel_cb_routine mChannelCB;
117    //cam_padding_info_t *mPaddingInfo;
118};
119
120/* QCamera3RegularChannel is used to handle all streams that are directly
121 * generated by hardware and given to frameworks without any postprocessing at HAL.
122 * Examples are: all IMPLEMENTATION_DEFINED streams, CPU_READ streams. */
123class QCamera3RegularChannel : public QCamera3Channel
124{
125public:
126    QCamera3RegularChannel(uint32_t cam_handle,
127                    mm_camera_ops_t *cam_ops,
128                    channel_cb_routine cb_routine,
129                    cam_padding_info_t *paddingInfo,
130                    void *userData,
131                    camera3_stream_t *stream);
132    virtual ~QCamera3RegularChannel();
133
134    virtual int32_t initialize();
135    virtual int32_t request(buffer_handle_t *buffer, uint32_t frameNumber);
136    virtual int32_t registerBuffers(uint32_t num_buffers,
137                                buffer_handle_t **buffers);
138    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
139                                            QCamera3Stream *stream);
140
141    virtual QCamera3Memory *getStreamBufs(uint32_t le);
142    virtual void putStreamBufs();
143    mm_camera_buf_def_t* getInternalFormatBuffer(buffer_handle_t* buffer);
144
145public:
146    static int kMaxBuffers;
147protected:
148    QCamera3GrallocMemory *mMemory;
149private:
150    camera3_stream_t *mCamera3Stream;
151    uint32_t mNumBufs;
152    buffer_handle_t **mCamera3Buffers;
153};
154
155/* QCamera3MetadataChannel is for metadata stream generated by camera daemon. */
156class QCamera3MetadataChannel : public QCamera3Channel
157{
158public:
159    QCamera3MetadataChannel(uint32_t cam_handle,
160                    mm_camera_ops_t *cam_ops,
161                    channel_cb_routine cb_routine,
162                    cam_padding_info_t *paddingInfo,
163                    void *userData);
164    virtual ~QCamera3MetadataChannel();
165
166    virtual int32_t initialize();
167
168    virtual int32_t request(buffer_handle_t *buffer, uint32_t frameNumber);
169    virtual int32_t registerBuffers(uint32_t num_buffers,
170                buffer_handle_t **buffers);
171    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
172                            QCamera3Stream *stream);
173
174    virtual QCamera3Memory *getStreamBufs(uint32_t le);
175    virtual void putStreamBufs();
176
177private:
178    QCamera3HeapMemory *mMemory;
179};
180
181/* QCamera3RawChannel is for opaqueu/cross-platform raw stream containing
182 * vendor specific bayer data or 16-bit unpacked bayer data */
183class QCamera3RawChannel : public QCamera3RegularChannel
184{
185public:
186    QCamera3RawChannel(uint32_t cam_handle,
187                    mm_camera_ops_t *cam_ops,
188                    channel_cb_routine cb_routine,
189                    cam_padding_info_t *paddingInfo,
190                    void *userData,
191                    camera3_stream_t *stream,
192                    bool raw_16 = false);
193    virtual ~QCamera3RawChannel();
194
195    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
196                            QCamera3Stream *stream);
197
198
199public:
200    static int kMaxBuffers;
201
202private:
203    bool mRawDump;
204    bool mIsRaw16;
205
206    void dumpRawSnapshot(mm_camera_buf_def_t *frame);
207    void convertToRaw16(mm_camera_buf_def_t *frame);
208};
209
210
211/* QCamera3PicChannel is for JPEG stream, which contains a YUV stream generated
212 * by the hardware, and encoded to a JPEG stream */
213class QCamera3PicChannel : public QCamera3Channel
214{
215public:
216    QCamera3PicChannel(uint32_t cam_handle,
217            mm_camera_ops_t *cam_ops,
218            channel_cb_routine cb_routine,
219            cam_padding_info_t *paddingInfo,
220            void *userData,
221            camera3_stream_t *stream);
222    ~QCamera3PicChannel();
223
224    virtual int32_t initialize();
225
226    virtual int32_t request(buffer_handle_t *buffer,
227            uint32_t frameNumber, jpeg_settings_t* mJpegSettings,
228            mm_camera_buf_def_t* pInputBuffer,QCamera3Channel* pInputChannel);
229    virtual int32_t registerBuffers(uint32_t num_buffers,
230            buffer_handle_t **buffers);
231    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
232            QCamera3Stream *stream);
233
234    virtual QCamera3Memory *getStreamBufs(uint32_t le);
235    virtual void putStreamBufs();
236    bool isWNREnabled() {return m_bWNROn;};
237    bool needOnlineRotation();
238    void getThumbnailSize(cam_dimension_t &dim);
239    int getJpegQuality();
240    int getJpegRotation();
241    bool isRawSnapshot();
242    QCamera3Exif *getExifData();
243    static void jpegEvtHandle(jpeg_job_status_t status,
244            uint32_t /*client_hdl*/,
245            uint32_t jobId,
246            mm_jpeg_output_t *p_output,
247            void *userdata);
248    static void dataNotifyCB(mm_camera_super_buf_t *recvd_frame,
249            void *userdata);
250    void queueMetadata(mm_camera_super_buf_t *metadata_buf,
251                                       QCamera3Channel *pMetaChannel,
252                                       bool relinquish);
253
254public:
255    static int kMaxBuffers;
256    QCamera3PostProcessor m_postprocessor; // post processor
257private:
258    camera3_stream_t *mCamera3Stream;
259    uint32_t mNumBufs;
260    buffer_handle_t **mCamera3Buffers;
261    jpeg_settings_t* mJpegSettings;
262    int32_t mCurrentBufIndex;
263    bool m_bWNROn;
264
265
266    QCamera3GrallocMemory *mMemory;
267    QCamera3HeapMemory *mYuvMemory;
268    QCamera3Channel *m_pMetaChannel;
269    mm_camera_super_buf_t *mMetaFrame;
270};
271
272// reprocess channel class
273class QCamera3ReprocessChannel : public QCamera3Channel
274{
275public:
276    QCamera3ReprocessChannel(uint32_t cam_handle,
277                            mm_camera_ops_t *cam_ops,
278                            channel_cb_routine cb_routine,
279                            cam_padding_info_t *paddingInfo,
280                            void *userData, void *ch_hdl);
281    QCamera3ReprocessChannel();
282    virtual ~QCamera3ReprocessChannel();
283    // online reprocess
284    int32_t doReprocess(mm_camera_super_buf_t *frame,
285                        mm_camera_super_buf_t *meta_frame);
286    // offline reprocess
287    int32_t doReprocess(int buf_fd, uint32_t buf_length, int32_t &ret_val,
288                        mm_camera_super_buf_t *meta_buf);
289    virtual int32_t registerBuffers(uint32_t num_buffers, buffer_handle_t **buffers);
290    virtual QCamera3Memory *getStreamBufs(uint32_t len);
291    virtual void putStreamBufs();
292    virtual int32_t initialize();
293    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
294                            QCamera3Stream *stream);
295    static void dataNotifyCB(mm_camera_super_buf_t *recvd_frame,
296                                       void* userdata);
297    int32_t addReprocStreamsFromSource(cam_pp_feature_config_t &config,
298                                       QCamera3Channel *pSrcChannel,
299                                       QCamera3Channel *pMetaChannel);
300    QCamera3Stream *getStreamBySourceHandle(uint32_t srcHandle);
301    int32_t metadataBufDone(mm_camera_super_buf_t *recvd_frame);
302public:
303    void *picChHandle;
304private:
305    uint32_t mSrcStreamHandles[MAX_STREAM_NUM_IN_BUNDLE];
306    QCamera3Channel *m_pSrcChannel; // ptr to source channel for reprocess
307    QCamera3Channel *m_pMetaChannel;
308    QCamera3HeapMemory *mMemory;
309};
310
311}; // namespace qcamera
312
313#endif /* __QCAMERA_CHANNEL_H__ */
314