]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - drivers/media/video/saa7134/saa7134.h
[PATCH] v4l: add saa713x card #65 Kworld V-Stream Studio TV Terminator
[mirror_ubuntu-artful-kernel.git] / drivers / media / video / saa7134 / saa7134.h
CommitLineData
1da177e4 1/*
1da177e4
LT
2 *
3 * v4l2 device driver for philips saa7134 based TV cards
4 *
5 * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org>
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 */
21
2f180710 22#include <linux/utsname.h>
fd3113e8 23#define SAA7134_VERSION_CODE KERNEL_VERSION(0,2,14)
1da177e4
LT
24
25#include <linux/pci.h>
26#include <linux/i2c.h>
27#include <linux/videodev.h>
28#include <linux/kdev_t.h>
29#include <linux/input.h>
30
31#include <asm/io.h>
32
33#include <media/tuner.h>
34#include <media/audiochip.h>
35#include <media/id.h>
36#include <media/ir-common.h>
37#include <media/video-buf.h>
38#include <media/video-buf-dvb.h>
39
40#ifndef TRUE
41# define TRUE (1==1)
42#endif
43#ifndef FALSE
44# define FALSE (1==0)
45#endif
46#define UNSET (-1U)
47
1da177e4
LT
48/* ----------------------------------------------------------- */
49/* enums */
50
51enum saa7134_tvaudio_mode {
52 TVAUDIO_FM_MONO = 1,
53 TVAUDIO_FM_BG_STEREO = 2,
54 TVAUDIO_FM_SAT_STEREO = 3,
55 TVAUDIO_FM_K_STEREO = 4,
56 TVAUDIO_NICAM_AM = 5,
57 TVAUDIO_NICAM_FM = 6,
58};
59
60enum saa7134_audio_in {
61 TV = 1,
62 LINE1 = 2,
63 LINE2 = 3,
64 LINE2_LEFT,
65};
66
67enum saa7134_video_out {
68 CCIR656 = 1,
69};
70
71/* ----------------------------------------------------------- */
72/* static data */
73
74struct saa7134_tvnorm {
75 char *name;
76 v4l2_std_id id;
77
78 /* video decoder */
79 unsigned int sync_control;
80 unsigned int luma_control;
81 unsigned int chroma_ctrl1;
82 unsigned int chroma_gain;
83 unsigned int chroma_ctrl2;
84 unsigned int vgate_misc;
85
86 /* video scaler */
87 unsigned int h_start;
88 unsigned int h_stop;
89 unsigned int video_v_start;
90 unsigned int video_v_stop;
f246a817
MS
91 unsigned int vbi_v_start_0;
92 unsigned int vbi_v_stop_0;
1da177e4 93 unsigned int src_timing;
f246a817 94 unsigned int vbi_v_start_1;
1da177e4
LT
95};
96
97struct saa7134_tvaudio {
98 char *name;
99 v4l2_std_id std;
100 enum saa7134_tvaudio_mode mode;
101 int carr1;
102 int carr2;
103};
104
105struct saa7134_format {
106 char *name;
107 unsigned int fourcc;
108 unsigned int depth;
109 unsigned int pm;
110 unsigned int vshift; /* vertical downsampling (for planar yuv) */
111 unsigned int hshift; /* horizontal downsampling (for planar yuv) */
112 unsigned int bswap:1;
113 unsigned int wswap:1;
114 unsigned int yuv:1;
115 unsigned int planar:1;
116 unsigned int uvswap:1;
117};
118
119/* ----------------------------------------------------------- */
120/* card configuration */
121
122#define SAA7134_BOARD_NOAUTO UNSET
123#define SAA7134_BOARD_UNKNOWN 0
124#define SAA7134_BOARD_PROTEUS_PRO 1
125#define SAA7134_BOARD_FLYVIDEO3000 2
126#define SAA7134_BOARD_FLYVIDEO2000 3
127#define SAA7134_BOARD_EMPRESS 4
128#define SAA7134_BOARD_MONSTERTV 5
129#define SAA7134_BOARD_MD9717 6
130#define SAA7134_BOARD_TVSTATION_RDS 7
131#define SAA7134_BOARD_CINERGY400 8
132#define SAA7134_BOARD_MD5044 9
133#define SAA7134_BOARD_KWORLD 10
134#define SAA7134_BOARD_CINERGY600 11
135#define SAA7134_BOARD_MD7134 12
136#define SAA7134_BOARD_TYPHOON_90031 13
137#define SAA7134_BOARD_ELSA 14
138#define SAA7134_BOARD_ELSA_500TV 15
139#define SAA7134_BOARD_ASUSTeK_TVFM7134 16
140#define SAA7134_BOARD_VA1000POWER 17
141#define SAA7134_BOARD_BMK_MPEX_NOTUNER 18
142#define SAA7134_BOARD_VIDEOMATE_TV 19
143#define SAA7134_BOARD_CRONOS_PLUS 20
144#define SAA7134_BOARD_10MOONSTVMASTER 21
145#define SAA7134_BOARD_MD2819 22
146#define SAA7134_BOARD_BMK_MPEX_TUNER 23
147#define SAA7134_BOARD_TVSTATION_DVR 24
148#define SAA7134_BOARD_ASUSTEK_TVFM7133 25
149#define SAA7134_BOARD_PINNACLE_PCTV_STEREO 26
150#define SAA7134_BOARD_MANLI_MTV002 27
151#define SAA7134_BOARD_MANLI_MTV001 28
152#define SAA7134_BOARD_TG3000TV 29
153#define SAA7134_BOARD_ECS_TVP3XP 30
154#define SAA7134_BOARD_ECS_TVP3XP_4CB5 31
155#define SAA7134_BOARD_AVACSSMARTTV 32
156#define SAA7134_BOARD_AVERMEDIA_DVD_EZMAKER 33
157#define SAA7134_BOARD_NOVAC_PRIMETV7133 34
158#define SAA7134_BOARD_AVERMEDIA_STUDIO_305 35
330a115a 159#define SAA7134_BOARD_UPMOST_PURPLE_TV 36
1da177e4
LT
160#define SAA7134_BOARD_ITEMS_MTV005 37
161#define SAA7134_BOARD_CINERGY200 38
162#define SAA7134_BOARD_FLYTVPLATINUM_MINI 39
163#define SAA7134_BOARD_VIDEOMATE_TV_PVR 40
164#define SAA7134_BOARD_VIDEOMATE_TV_GOLD_PLUS 41
165#define SAA7134_BOARD_SABRENT_SBTTVFM 42
166#define SAA7134_BOARD_ZOLID_XPERT_TV7134 43
167#define SAA7134_BOARD_EMPIRE_PCI_TV_RADIO_LE 44
ac19ecc6 168#define SAA7134_BOARD_AVERMEDIA_STUDIO_307 45
1da177e4
LT
169#define SAA7134_BOARD_AVERMEDIA_CARDBUS 46
170#define SAA7134_BOARD_CINERGY400_CARDBUS 47
171#define SAA7134_BOARD_CINERGY600_MK3 48
172#define SAA7134_BOARD_VIDEOMATE_GOLD_PLUS 49
173#define SAA7134_BOARD_PINNACLE_300I_DVBT_PAL 50
174#define SAA7134_BOARD_PROVIDEO_PV952 51
175#define SAA7134_BOARD_AVERMEDIA_305 52
330a115a 176#define SAA7134_BOARD_ASUSTeK_TVFM7135 53
1da177e4
LT
177#define SAA7134_BOARD_FLYTVPLATINUM_FM 54
178#define SAA7134_BOARD_FLYDVBTDUO 55
ac19ecc6
MCC
179#define SAA7134_BOARD_AVERMEDIA_307 56
180#define SAA7134_BOARD_AVERMEDIA_GO_007_FM 57
181#define SAA7134_BOARD_ADS_INSTANT_TV 58
182#define SAA7134_BOARD_KWORLD_VSTREAM_XPERT 59
330a115a
MCC
183#define SAA7134_BOARD_THYPHOON_DVBT_DUO_CARDBUS 60
184#define SAA7134_BOARD_PHILIPS_TOUGH 61
185#define SAA7134_BOARD_VIDEOMATE_TV_GOLD_PLUSII 62
186#define SAA7134_BOARD_KWORLD_XPERT 63
2f180710 187#define SAA7134_BOARD_FLYTV_DIGIMATRIX 64
260784dc 188#define SAA7134_BOARD_KWORLD_TERMINATOR 65
1da177e4
LT
189
190#define SAA7134_MAXBOARDS 8
191#define SAA7134_INPUT_MAX 8
192
193struct saa7134_input {
194 char *name;
195 unsigned int vmux;
196 enum saa7134_audio_in amux;
197 unsigned int gpio;
198 unsigned int tv:1;
199};
200
201enum saa7134_mpeg_type {
202 SAA7134_MPEG_UNUSED,
203 SAA7134_MPEG_EMPRESS,
204 SAA7134_MPEG_DVB,
205};
206
207struct saa7134_board {
208 char *name;
209 unsigned int audio_clock;
210
211 /* input switching */
212 unsigned int gpiomask;
213 struct saa7134_input inputs[SAA7134_INPUT_MAX];
214 struct saa7134_input radio;
215 struct saa7134_input mute;
216
217 /* i2c chip info */
218 unsigned int tuner_type;
330a115a
MCC
219 unsigned int radio_type;
220 unsigned char tuner_addr;
221 unsigned char radio_addr;
222
1da177e4
LT
223 unsigned int tda9887_conf;
224
225 /* peripheral I/O */
226 enum saa7134_video_out video_out;
227 enum saa7134_mpeg_type mpeg;
228};
229
230#define card_has_radio(dev) (NULL != saa7134_boards[dev->board].radio.name)
231#define card_is_empress(dev) (SAA7134_MPEG_EMPRESS == saa7134_boards[dev->board].mpeg)
232#define card_is_dvb(dev) (SAA7134_MPEG_DVB == saa7134_boards[dev->board].mpeg)
233#define card_has_mpeg(dev) (SAA7134_MPEG_UNUSED != saa7134_boards[dev->board].mpeg)
234#define card(dev) (saa7134_boards[dev->board])
235#define card_in(dev,n) (saa7134_boards[dev->board].inputs[n])
236
237/* ----------------------------------------------------------- */
238/* device / file handle status */
239
240#define RESOURCE_OVERLAY 1
241#define RESOURCE_VIDEO 2
242#define RESOURCE_VBI 4
243
244#define INTERLACE_AUTO 0
245#define INTERLACE_ON 1
246#define INTERLACE_OFF 2
247
248#define BUFFER_TIMEOUT (HZ/2) /* 0.5 seconds */
249
250struct saa7134_dev;
251struct saa7134_dma;
252
253/* saa7134 page table */
254struct saa7134_pgtable {
255 unsigned int size;
c9c12b79 256 __le32 *cpu;
1da177e4
LT
257 dma_addr_t dma;
258};
259
260/* tvaudio thread status */
261struct saa7134_thread {
262 pid_t pid;
263 struct completion exit;
264 wait_queue_head_t wq;
265 unsigned int shutdown;
266 unsigned int scan1;
267 unsigned int scan2;
268 unsigned int mode;
269};
270
271/* buffer for one video/vbi/ts frame */
272struct saa7134_buf {
273 /* common v4l buffer stuff -- must be first */
274 struct videobuf_buffer vb;
275
276 /* saa7134 specific */
277 struct saa7134_format *fmt;
278 unsigned int top_seen;
279 int (*activate)(struct saa7134_dev *dev,
280 struct saa7134_buf *buf,
281 struct saa7134_buf *next);
282
283 /* page tables */
284 struct saa7134_pgtable *pt;
285};
286
287struct saa7134_dmaqueue {
288 struct saa7134_dev *dev;
289 struct saa7134_buf *curr;
290 struct list_head queue;
291 struct timer_list timeout;
292 unsigned int need_two;
293};
294
295/* video filehandle status */
296struct saa7134_fh {
297 struct saa7134_dev *dev;
298 unsigned int radio;
299 enum v4l2_buf_type type;
300 unsigned int resources;
301#ifdef VIDIOC_G_PRIORITY
302 enum v4l2_priority prio;
303#endif
304
305 /* video overlay */
306 struct v4l2_window win;
307 struct v4l2_clip clips[8];
308 unsigned int nclips;
309
310 /* video capture */
311 struct saa7134_format *fmt;
312 unsigned int width,height;
313 struct videobuf_queue cap;
314 struct saa7134_pgtable pt_cap;
315
316 /* vbi capture */
317 struct videobuf_queue vbi;
318 struct saa7134_pgtable pt_vbi;
319};
320
321/* oss dsp status */
322struct saa7134_oss {
323 struct semaphore lock;
324 int minor_mixer;
325 int minor_dsp;
326 unsigned int users_dsp;
327
328 /* mixer */
329 enum saa7134_audio_in input;
330 unsigned int count;
331 unsigned int line1;
332 unsigned int line2;
333
334 /* dsp */
335 unsigned int afmt;
336 unsigned int rate;
337 unsigned int channels;
338 unsigned int recording_on;
339 unsigned int dma_running;
340 unsigned int blocks;
341 unsigned int blksize;
342 unsigned int bufsize;
343 struct saa7134_pgtable pt;
344 struct videobuf_dmabuf dma;
345 wait_queue_head_t wq;
346 unsigned int dma_blk;
347 unsigned int read_offset;
348 unsigned int read_count;
349};
350
351/* IR input */
352struct saa7134_ir {
353 struct input_dev dev;
354 struct ir_input_state ir;
355 char name[32];
356 char phys[32];
357 u32 mask_keycode;
358 u32 mask_keydown;
359 u32 mask_keyup;
360 int polling;
361 u32 last_gpio;
362 struct timer_list timer;
363};
364
365/* ts/mpeg status */
366struct saa7134_ts {
367 /* TS capture */
368 struct saa7134_pgtable pt_ts;
369 int nr_packets;
370 int nr_bufs;
371};
372
373/* ts/mpeg ops */
374struct saa7134_mpeg_ops {
375 enum saa7134_mpeg_type type;
376 struct list_head next;
377 int (*init)(struct saa7134_dev *dev);
378 int (*fini)(struct saa7134_dev *dev);
379 void (*signal_change)(struct saa7134_dev *dev);
380};
381
382/* global device status */
383struct saa7134_dev {
384 struct list_head devlist;
385 struct semaphore lock;
386 spinlock_t slock;
387#ifdef VIDIOC_G_PRIORITY
388 struct v4l2_prio_state prio;
389#endif
390
391 /* various device info */
392 unsigned int resources;
393 struct video_device *video_dev;
394 struct video_device *radio_dev;
395 struct video_device *vbi_dev;
396 struct saa7134_oss oss;
397
398 /* infrared remote */
399 int has_remote;
400 struct saa7134_ir *remote;
401
402 /* pci i/o */
403 char name[32];
404 int nr;
405 struct pci_dev *pci;
406 unsigned char pci_rev,pci_lat;
407 __u32 __iomem *lmmio;
408 __u8 __iomem *bmmio;
409
410 /* config info */
411 unsigned int board;
412 unsigned int tuner_type;
330a115a
MCC
413 unsigned int radio_type;
414 unsigned char tuner_addr;
415 unsigned char radio_addr;
416
1da177e4
LT
417 unsigned int tda9887_conf;
418 unsigned int gpio_value;
1da177e4
LT
419
420 /* i2c i/o */
421 struct i2c_adapter i2c_adap;
422 struct i2c_client i2c_client;
423 unsigned char eedata[64];
424
425 /* video overlay */
426 struct v4l2_framebuffer ovbuf;
427 struct saa7134_format *ovfmt;
428 unsigned int ovenable;
429 enum v4l2_field ovfield;
430
431 /* video+ts+vbi capture */
432 struct saa7134_dmaqueue video_q;
433 struct saa7134_dmaqueue vbi_q;
434 unsigned int video_fieldcount;
435 unsigned int vbi_fieldcount;
436
437 /* various v4l controls */
438 struct saa7134_tvnorm *tvnorm; /* video */
439 struct saa7134_tvaudio *tvaudio;
440 unsigned int ctl_input;
441 int ctl_bright;
442 int ctl_contrast;
443 int ctl_hue;
444 int ctl_saturation;
445 int ctl_freq;
446 int ctl_mute; /* audio */
447 int ctl_volume;
448 int ctl_invert; /* private */
449 int ctl_mirror;
450 int ctl_y_odd;
451 int ctl_y_even;
452 int ctl_automute;
453
454 /* crop */
455 struct v4l2_rect crop_bounds;
456 struct v4l2_rect crop_defrect;
457 struct v4l2_rect crop_current;
458
459 /* other global state info */
460 unsigned int automute;
461 struct saa7134_thread thread;
462 struct saa7134_input *input;
463 struct saa7134_input *hw_input;
464 unsigned int hw_mute;
465 int last_carrier;
466 int nosignal;
467
468 /* SAA7134_MPEG_* */
469 struct saa7134_ts ts;
470 struct saa7134_dmaqueue ts_q;
471 struct saa7134_mpeg_ops *mops;
472
473 /* SAA7134_MPEG_EMPRESS only */
474 struct video_device *empress_dev;
475 struct videobuf_queue empress_tsq;
476 unsigned int empress_users;
477 struct work_struct empress_workqueue;
478 int empress_started;
479
480 /* SAA7134_MPEG_DVB only */
481 struct videobuf_dvb dvb;
482};
483
484/* ----------------------------------------------------------- */
485
486#define saa_readl(reg) readl(dev->lmmio + (reg))
487#define saa_writel(reg,value) writel((value), dev->lmmio + (reg));
488#define saa_andorl(reg,mask,value) \
489 writel((readl(dev->lmmio+(reg)) & ~(mask)) |\
490 ((value) & (mask)), dev->lmmio+(reg))
491#define saa_setl(reg,bit) saa_andorl((reg),(bit),(bit))
492#define saa_clearl(reg,bit) saa_andorl((reg),(bit),0)
493
494#define saa_readb(reg) readb(dev->bmmio + (reg))
495#define saa_writeb(reg,value) writeb((value), dev->bmmio + (reg));
496#define saa_andorb(reg,mask,value) \
497 writeb((readb(dev->bmmio+(reg)) & ~(mask)) |\
498 ((value) & (mask)), dev->bmmio+(reg))
499#define saa_setb(reg,bit) saa_andorb((reg),(bit),(bit))
500#define saa_clearb(reg,bit) saa_andorb((reg),(bit),0)
501
502#define saa_wait(us) { udelay(us); }
503
504/* ----------------------------------------------------------- */
505/* saa7134-core.c */
506
507extern struct list_head saa7134_devlist;
508
509void saa7134_print_ioctl(char *name, unsigned int cmd);
510void saa7134_track_gpio(struct saa7134_dev *dev, char *msg);
511
512#define SAA7134_PGTABLE_SIZE 4096
513
514int saa7134_pgtable_alloc(struct pci_dev *pci, struct saa7134_pgtable *pt);
515int saa7134_pgtable_build(struct pci_dev *pci, struct saa7134_pgtable *pt,
516 struct scatterlist *list, unsigned int length,
517 unsigned int startpage);
518void saa7134_pgtable_free(struct pci_dev *pci, struct saa7134_pgtable *pt);
519
520int saa7134_buffer_count(unsigned int size, unsigned int count);
521int saa7134_buffer_startpage(struct saa7134_buf *buf);
522unsigned long saa7134_buffer_base(struct saa7134_buf *buf);
523
524int saa7134_buffer_queue(struct saa7134_dev *dev, struct saa7134_dmaqueue *q,
525 struct saa7134_buf *buf);
526void saa7134_buffer_finish(struct saa7134_dev *dev, struct saa7134_dmaqueue *q,
527 unsigned int state);
528void saa7134_buffer_next(struct saa7134_dev *dev, struct saa7134_dmaqueue *q);
529void saa7134_buffer_timeout(unsigned long data);
530void saa7134_dma_free(struct saa7134_dev *dev,struct saa7134_buf *buf);
531
532int saa7134_set_dmabits(struct saa7134_dev *dev);
533
534/* ----------------------------------------------------------- */
535/* saa7134-cards.c */
536
537extern struct saa7134_board saa7134_boards[];
538extern const unsigned int saa7134_bcount;
539extern struct pci_device_id __devinitdata saa7134_pci_tbl[];
540
541extern int saa7134_board_init1(struct saa7134_dev *dev);
542extern int saa7134_board_init2(struct saa7134_dev *dev);
543
544
545/* ----------------------------------------------------------- */
546/* saa7134-i2c.c */
547
548int saa7134_i2c_register(struct saa7134_dev *dev);
549int saa7134_i2c_unregister(struct saa7134_dev *dev);
550void saa7134_i2c_call_clients(struct saa7134_dev *dev,
551 unsigned int cmd, void *arg);
552
553
554/* ----------------------------------------------------------- */
555/* saa7134-video.c */
556
557extern struct video_device saa7134_video_template;
558extern struct video_device saa7134_radio_template;
559
560int saa7134_common_ioctl(struct saa7134_dev *dev,
561 unsigned int cmd, void *arg);
562
563int saa7134_video_init1(struct saa7134_dev *dev);
564int saa7134_video_init2(struct saa7134_dev *dev);
565int saa7134_video_fini(struct saa7134_dev *dev);
566void saa7134_irq_video_intl(struct saa7134_dev *dev);
567void saa7134_irq_video_done(struct saa7134_dev *dev, unsigned long status);
568
569
570/* ----------------------------------------------------------- */
571/* saa7134-ts.c */
572
573#define TS_PACKET_SIZE 188 /* TS packets 188 bytes */
574
575extern struct videobuf_queue_ops saa7134_ts_qops;
576
577int saa7134_ts_init1(struct saa7134_dev *dev);
578int saa7134_ts_fini(struct saa7134_dev *dev);
579void saa7134_irq_ts_done(struct saa7134_dev *dev, unsigned long status);
580
581int saa7134_ts_register(struct saa7134_mpeg_ops *ops);
582void saa7134_ts_unregister(struct saa7134_mpeg_ops *ops);
583
584/* ----------------------------------------------------------- */
585/* saa7134-vbi.c */
586
587extern struct videobuf_queue_ops saa7134_vbi_qops;
588extern struct video_device saa7134_vbi_template;
589
590int saa7134_vbi_init1(struct saa7134_dev *dev);
591int saa7134_vbi_fini(struct saa7134_dev *dev);
592void saa7134_irq_vbi_done(struct saa7134_dev *dev, unsigned long status);
593
594
595/* ----------------------------------------------------------- */
596/* saa7134-tvaudio.c */
597
598int saa7134_tvaudio_rx2mode(u32 rx);
599
600void saa7134_tvaudio_setmute(struct saa7134_dev *dev);
601void saa7134_tvaudio_setinput(struct saa7134_dev *dev,
602 struct saa7134_input *in);
603void saa7134_tvaudio_setvolume(struct saa7134_dev *dev, int level);
604int saa7134_tvaudio_getstereo(struct saa7134_dev *dev);
605
606int saa7134_tvaudio_init2(struct saa7134_dev *dev);
607int saa7134_tvaudio_fini(struct saa7134_dev *dev);
608int saa7134_tvaudio_do_scan(struct saa7134_dev *dev);
609
610int saa_dsp_writel(struct saa7134_dev *dev, int reg, u32 value);
611
612/* ----------------------------------------------------------- */
613/* saa7134-oss.c */
614
615extern struct file_operations saa7134_dsp_fops;
616extern struct file_operations saa7134_mixer_fops;
617
618int saa7134_oss_init1(struct saa7134_dev *dev);
619int saa7134_oss_fini(struct saa7134_dev *dev);
620void saa7134_irq_oss_done(struct saa7134_dev *dev, unsigned long status);
621
622/* ----------------------------------------------------------- */
623/* saa7134-input.c */
624
625int saa7134_input_init1(struct saa7134_dev *dev);
626void saa7134_input_fini(struct saa7134_dev *dev);
627void saa7134_input_irq(struct saa7134_dev *dev);
628
629/*
630 * Local variables:
631 * c-basic-offset: 8
632 * End:
633 */