rbtree_test: add __init/__exit annotations
[platform/adaptation/renesas_rcar/renesas_kernel.git] / include / media / saa7146_vv.h
1 #ifndef __SAA7146_VV__
2 #define __SAA7146_VV__
3
4 #include <media/v4l2-common.h>
5 #include <media/v4l2-ioctl.h>
6 #include <media/v4l2-fh.h>
7 #include <media/saa7146.h>
8 #include <media/videobuf-dma-sg.h>
9
10 #define MAX_SAA7146_CAPTURE_BUFFERS     32      /* arbitrary */
11 #define BUFFER_TIMEOUT     (HZ/2)  /* 0.5 seconds */
12
13 #define WRITE_RPS0(x) do { \
14         dev->d_rps0.cpu_addr[ count++ ] = cpu_to_le32(x); \
15         } while (0);
16
17 #define WRITE_RPS1(x) do { \
18         dev->d_rps1.cpu_addr[ count++ ] = cpu_to_le32(x); \
19         } while (0);
20
21 struct  saa7146_video_dma {
22         u32 base_odd;
23         u32 base_even;
24         u32 prot_addr;
25         u32 pitch;
26         u32 base_page;
27         u32 num_line_byte;
28 };
29
30 #define FORMAT_BYTE_SWAP        0x1
31 #define FORMAT_IS_PLANAR        0x2
32
33 struct saa7146_format {
34         char    *name;
35         u32     pixelformat;
36         u32     trans;
37         u8      depth;
38         u8      flags;
39         u8      swap;
40 };
41
42 struct saa7146_standard
43 {
44         char          *name;
45         v4l2_std_id   id;
46
47         int v_offset;   /* number of lines of vertical offset before processing */
48         int v_field;    /* number of lines in a field for HPS to process */
49
50         int h_offset;   /* horizontal offset of processing window */
51         int h_pixels;   /* number of horizontal pixels to process */
52
53         int v_max_out;
54         int h_max_out;
55 };
56
57 /* buffer for one video/vbi frame */
58 struct saa7146_buf {
59         /* common v4l buffer stuff -- must be first */
60         struct videobuf_buffer vb;
61
62         /* saa7146 specific */
63         struct v4l2_pix_format  *fmt;
64         int (*activate)(struct saa7146_dev *dev,
65                         struct saa7146_buf *buf,
66                         struct saa7146_buf *next);
67
68         /* page tables */
69         struct saa7146_pgtable  pt[3];
70 };
71
72 struct saa7146_dmaqueue {
73         struct saa7146_dev      *dev;
74         struct saa7146_buf      *curr;
75         struct list_head        queue;
76         struct timer_list       timeout;
77 };
78
79 struct saa7146_overlay {
80         struct saa7146_fh       *fh;
81         struct v4l2_window      win;
82         struct v4l2_clip        clips[16];
83         int                     nclips;
84 };
85
86 /* per open data */
87 struct saa7146_fh {
88         /* Must be the first field! */
89         struct v4l2_fh          fh;
90         struct saa7146_dev      *dev;
91
92         /* video capture */
93         struct videobuf_queue   video_q;
94
95         /* vbi capture */
96         struct videobuf_queue   vbi_q;
97
98         unsigned int resources; /* resource management for device open */
99 };
100
101 #define STATUS_OVERLAY  0x01
102 #define STATUS_CAPTURE  0x02
103
104 struct saa7146_vv
105 {
106         /* vbi capture */
107         struct saa7146_dmaqueue         vbi_dmaq;
108         struct v4l2_vbi_format          vbi_fmt;
109         struct timer_list               vbi_read_timeout;
110         /* vbi workaround interrupt queue */
111         wait_queue_head_t               vbi_wq;
112         int                             vbi_fieldcount;
113         struct saa7146_fh               *vbi_streaming;
114
115         int                             video_status;
116         struct saa7146_fh               *video_fh;
117
118         /* video overlay */
119         struct saa7146_overlay          ov;
120         struct v4l2_framebuffer         ov_fb;
121         struct saa7146_format           *ov_fmt;
122         struct saa7146_fh               *ov_suspend;
123
124         /* video capture */
125         struct saa7146_dmaqueue         video_dmaq;
126         struct v4l2_pix_format          video_fmt;
127         enum v4l2_field                 last_field;
128
129         /* common: fixme? shouldn't this be in saa7146_fh?
130            (this leads to a more complicated question: shall the driver
131            store the different settings (for example S_INPUT) for every open
132            and restore it appropriately, or should all settings be common for
133            all opens? currently, we do the latter, like all other
134            drivers do... */
135         struct saa7146_standard *standard;
136
137         int     vflip;
138         int     hflip;
139         int     current_hps_source;
140         int     current_hps_sync;
141
142         struct saa7146_dma      d_clipping;     /* pointer to clipping memory */
143
144         unsigned int resources; /* resource management for device */
145 };
146
147 /* flags */
148 #define SAA7146_USE_PORT_B_FOR_VBI      0x2     /* use input port b for vbi hardware bug workaround */
149
150 struct saa7146_ext_vv
151 {
152         /* informations about the video capabilities of the device */
153         int     inputs;
154         int     audios;
155         u32     capabilities;
156         int     flags;
157
158         /* additionally supported transmission standards */
159         struct saa7146_standard *stds;
160         int num_stds;
161         int (*std_callback)(struct saa7146_dev*, struct saa7146_standard *);
162
163         /* the extension can override this */
164         struct v4l2_ioctl_ops vid_ops;
165         struct v4l2_ioctl_ops vbi_ops;
166         /* pointer to the saa7146 core ops */
167         const struct v4l2_ioctl_ops *core_ops;
168
169         struct v4l2_file_operations vbi_fops;
170 };
171
172 struct saa7146_use_ops  {
173         void (*init)(struct saa7146_dev *, struct saa7146_vv *);
174         int(*open)(struct saa7146_dev *, struct file *);
175         void (*release)(struct saa7146_dev *, struct file *);
176         void (*irq_done)(struct saa7146_dev *, unsigned long status);
177         ssize_t (*read)(struct file *, char __user *, size_t, loff_t *);
178 };
179
180 /* from saa7146_fops.c */
181 int saa7146_register_device(struct video_device **vid, struct saa7146_dev* dev, char *name, int type);
182 int saa7146_unregister_device(struct video_device **vid, struct saa7146_dev* dev);
183 void saa7146_buffer_finish(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, int state);
184 void saa7146_buffer_next(struct saa7146_dev *dev, struct saa7146_dmaqueue *q,int vbi);
185 int saa7146_buffer_queue(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, struct saa7146_buf *buf);
186 void saa7146_buffer_timeout(unsigned long data);
187 void saa7146_dma_free(struct saa7146_dev* dev,struct videobuf_queue *q,
188                                                 struct saa7146_buf *buf);
189
190 int saa7146_vv_init(struct saa7146_dev* dev, struct saa7146_ext_vv *ext_vv);
191 int saa7146_vv_release(struct saa7146_dev* dev);
192
193 /* from saa7146_hlp.c */
194 int saa7146_enable_overlay(struct saa7146_fh *fh);
195 void saa7146_disable_overlay(struct saa7146_fh *fh);
196
197 void saa7146_set_capture(struct saa7146_dev *dev, struct saa7146_buf *buf, struct saa7146_buf *next);
198 void saa7146_write_out_dma(struct saa7146_dev* dev, int which, struct saa7146_video_dma* vdma) ;
199 void saa7146_set_hps_source_and_sync(struct saa7146_dev *saa, int source, int sync);
200 void saa7146_set_gpio(struct saa7146_dev *saa, u8 pin, u8 data);
201
202 /* from saa7146_video.c */
203 extern const struct v4l2_ioctl_ops saa7146_video_ioctl_ops;
204 extern const struct v4l2_ioctl_ops saa7146_vbi_ioctl_ops;
205 extern struct saa7146_use_ops saa7146_video_uops;
206 int saa7146_start_preview(struct saa7146_fh *fh);
207 int saa7146_stop_preview(struct saa7146_fh *fh);
208 long saa7146_video_do_ioctl(struct file *file, unsigned int cmd, void *arg);
209 int saa7146_s_ctrl(struct v4l2_ctrl *ctrl);
210
211 /* from saa7146_vbi.c */
212 extern struct saa7146_use_ops saa7146_vbi_uops;
213
214 /* resource management functions */
215 int saa7146_res_get(struct saa7146_fh *fh, unsigned int bit);
216 void saa7146_res_free(struct saa7146_fh *fh, unsigned int bits);
217
218 #define RESOURCE_DMA1_HPS       0x1
219 #define RESOURCE_DMA2_CLP       0x2
220 #define RESOURCE_DMA3_BRS       0x4
221
222 /* saa7146 source inputs */
223 #define SAA7146_HPS_SOURCE_PORT_A       0x00
224 #define SAA7146_HPS_SOURCE_PORT_B       0x01
225 #define SAA7146_HPS_SOURCE_YPB_CPA      0x02
226 #define SAA7146_HPS_SOURCE_YPA_CPB      0x03
227
228 /* sync inputs */
229 #define SAA7146_HPS_SYNC_PORT_A         0x00
230 #define SAA7146_HPS_SYNC_PORT_B         0x01
231
232 /* some memory sizes */
233 /* max. 16 clipping rectangles */
234 #define SAA7146_CLIPPING_MEM    (16 * 4 * sizeof(u32))
235
236 /* some defines for the various clipping-modes */
237 #define SAA7146_CLIPPING_RECT           0x4
238 #define SAA7146_CLIPPING_RECT_INVERTED  0x5
239 #define SAA7146_CLIPPING_MASK           0x6
240 #define SAA7146_CLIPPING_MASK_INVERTED  0x7
241
242 /* output formats: each entry holds four informations */
243 #define RGB08_COMPOSED  0x0217 /* composed is used in the sense of "not-planar" */
244 /* this means: planar?=0, yuv2rgb-conversation-mode=2, dither=yes(=1), format-mode = 7 */
245 #define RGB15_COMPOSED  0x0213
246 #define RGB16_COMPOSED  0x0210
247 #define RGB24_COMPOSED  0x0201
248 #define RGB32_COMPOSED  0x0202
249
250 #define Y8                      0x0006
251 #define YUV411_COMPOSED         0x0003
252 #define YUV422_COMPOSED         0x0000
253 /* this means: planar?=1, yuv2rgb-conversion-mode=0, dither=no(=0), format-mode = b */
254 #define YUV411_DECOMPOSED       0x100b
255 #define YUV422_DECOMPOSED       0x1009
256 #define YUV420_DECOMPOSED       0x100a
257
258 #define IS_PLANAR(x) (x & 0xf000)
259
260 /* misc defines */
261 #define SAA7146_NO_SWAP         (0x0)
262 #define SAA7146_TWO_BYTE_SWAP   (0x1)
263 #define SAA7146_FOUR_BYTE_SWAP  (0x2)
264
265 #endif