QCamera3Channel.h revision c8d1059ae679132e7654708fdfca6ee221775187 
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    virtual int32_t registerBuffers(uint32_t num_buffers,
71                        buffer_handle_t **buffers) = 0;
72    virtual int32_t initialize() = 0;
73    virtual int32_t request(buffer_handle_t * /*buffer*/,
74                uint32_t /*frameNumber*/){ return 0;};
75    virtual int32_t request(buffer_handle_t * /*buffer*/,
76                uint32_t /*frameNumber*/,
77                jpeg_settings_t* /*mJpegSettings*/,
78                mm_camera_buf_def_t* /*pInputBuffer*/,
79                QCamera3Channel* /*pInputChannel*/){ return 0;};
80    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
81                            QCamera3Stream *stream) = 0;
82
83    virtual QCamera3Memory *getStreamBufs(uint32_t len) = 0;
84    virtual void putStreamBufs() = 0;
85
86    QCamera3Stream *getStreamByHandle(uint32_t streamHandle);
87    uint32_t getMyHandle() const {return m_handle;};
88    uint8_t getNumOfStreams() const {return m_numStreams;};
89    QCamera3Stream *getStreamByIndex(uint8_t index);
90
91    static void streamCbRoutine(mm_camera_super_buf_t *super_frame,
92                QCamera3Stream *stream, void *userdata);
93protected:
94
95   virtual int32_t init(mm_camera_channel_attr_t *attr,
96                         mm_camera_buf_notify_t dataCB);
97    int32_t allocateStreamInfoBuf(camera3_stream_t *stream);
98
99    uint32_t m_camHandle;
100    mm_camera_ops_t *m_camOps;
101    bool m_bIsActive;
102
103    uint32_t m_handle;
104    uint8_t m_numStreams;
105    QCamera3Stream *mStreams[MAX_STREAM_NUM_IN_BUNDLE];
106    mm_camera_buf_notify_t mDataCB;
107    void *mUserData;
108
109    QCamera3HeapMemory *mStreamInfoBuf;
110    channel_cb_routine mChannelCB;
111    cam_padding_info_t *mPaddingInfo;
112};
113
114/* QCamera3RegularChannel is used to handle all streams that are directly
115 * generated by hardware and given to frameworks without any postprocessing at HAL.
116 * Examples are: all IMPLEMENTATION_DEFINED streams, CPU_READ streams. */
117class QCamera3RegularChannel : public QCamera3Channel
118{
119public:
120    QCamera3RegularChannel(uint32_t cam_handle,
121                    mm_camera_ops_t *cam_ops,
122                    channel_cb_routine cb_routine,
123                    cam_padding_info_t *paddingInfo,
124                    void *userData,
125                    camera3_stream_t *stream);
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                    uint32_t width, uint32_t height);
133    virtual ~QCamera3RegularChannel();
134
135    virtual int32_t initialize();
136    virtual int32_t request(buffer_handle_t *buffer, uint32_t frameNumber);
137    virtual int32_t registerBuffers(uint32_t num_buffers,
138                                buffer_handle_t **buffers);
139    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
140                                            QCamera3Stream *stream);
141
142    virtual QCamera3Memory *getStreamBufs(uint32_t le);
143    virtual void putStreamBufs();
144    mm_camera_buf_def_t* getInternalFormatBuffer(buffer_handle_t* buffer);
145
146public:
147    static int kMaxBuffers;
148private:
149    camera3_stream_t *mCamera3Stream;
150    uint32_t mNumBufs;
151    buffer_handle_t **mCamera3Buffers;
152
153    QCamera3GrallocMemory *mMemory;
154    // width and height of internal stream may be different than what's
155    // specified in camera3_stream_t. For example: ZSL stream size is
156    // always the active region size, but internally we use the JPEG
157    // size.
158    uint32_t mWidth, mHeight;
159};
160
161/* QCamera3MetadataChannel is for metadata stream generated by camera daemon. */
162class QCamera3MetadataChannel : public QCamera3Channel
163{
164public:
165    QCamera3MetadataChannel(uint32_t cam_handle,
166                    mm_camera_ops_t *cam_ops,
167                    channel_cb_routine cb_routine,
168                    cam_padding_info_t *paddingInfo,
169                    void *userData);
170    virtual ~QCamera3MetadataChannel();
171
172    virtual int32_t initialize();
173
174    virtual int32_t request(buffer_handle_t *buffer, uint32_t frameNumber);
175    virtual int32_t registerBuffers(uint32_t num_buffers,
176                buffer_handle_t **buffers);
177    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
178                            QCamera3Stream *stream);
179
180    virtual QCamera3Memory *getStreamBufs(uint32_t le);
181    virtual void putStreamBufs();
182
183private:
184    QCamera3HeapMemory *mMemory;
185};
186
187/* QCamera3PicChannel is for JPEG stream, which contains a YUV stream generated
188 * by the hardware, and encoded to a JPEG stream */
189class QCamera3PicChannel : public QCamera3Channel
190{
191public:
192    QCamera3PicChannel(uint32_t cam_handle,
193            mm_camera_ops_t *cam_ops,
194            channel_cb_routine cb_routine,
195            cam_padding_info_t *paddingInfo,
196            void *userData,
197            camera3_stream_t *stream);
198    ~QCamera3PicChannel();
199
200    virtual int32_t initialize();
201
202    virtual int32_t request(buffer_handle_t *buffer,
203            uint32_t frameNumber, jpeg_settings_t* mJpegSettings,
204            mm_camera_buf_def_t* pInputBuffer,QCamera3Channel* pInputChannel);
205    virtual int32_t registerBuffers(uint32_t num_buffers,
206            buffer_handle_t **buffers);
207    virtual void streamCbRoutine(mm_camera_super_buf_t *super_frame,
208            QCamera3Stream *stream);
209
210    virtual QCamera3Memory *getStreamBufs(uint32_t le);
211    virtual void putStreamBufs();
212    bool needOnlineRotation();
213    void getThumbnailSize(cam_dimension_t &dim);
214    int getJpegQuality();
215    int getJpegRotation();
216    QCamera3Exif *getExifData();
217    static void jpegEvtHandle(jpeg_job_status_t status,
218            uint32_t /*client_hdl*/,
219            uint32_t jobId,
220            mm_jpeg_output_t *p_output,
221            void *userdata);
222    static void dataNotifyCB(mm_camera_super_buf_t *recvd_frame,
223            void *userdata);
224
225public:
226    static int kMaxBuffers;
227private:
228    camera3_stream_t *mCamera3Stream;
229    uint32_t mNumBufs;
230    buffer_handle_t **mCamera3Buffers;
231    jpeg_settings_t* mJpegSettings;
232    int32_t mCurrentBufIndex;
233
234
235    QCamera3GrallocMemory *mMemory;
236    QCamera3HeapMemory *mYuvMemory;
237    QCamera3PostProcessor m_postprocessor; // post processor
238};
239
240}; // namespace qcamera
241
242#endif /* __QCAMERA_CHANNEL_H__ */
243