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