2 * $Id: saa7134.h,v 1.27 2004/11/04 11:03:52 kraxel Exp $
4 * v4l2 device driver for philips saa7134 based TV cards
6 * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 #include <linux/version.h>
24 #define SAA7134_VERSION_CODE KERNEL_VERSION(0,2,12)
26 #include <linux/pci.h>
27 #include <linux/i2c.h>
28 #include <linux/videodev.h>
29 #include <linux/kdev_t.h>
30 #include <linux/input.h>
34 #include <media/tuner.h>
35 #include <media/audiochip.h>
37 #include <media/ir-common.h>
38 #include <media/video-buf.h>
39 #include <media/video-buf-dvb.h>
49 /* 2.4 / 2.5 driver compatibility stuff */
51 /* ----------------------------------------------------------- */
54 enum saa7134_tvaudio_mode {
56 TVAUDIO_FM_BG_STEREO = 2,
57 TVAUDIO_FM_SAT_STEREO = 3,
58 TVAUDIO_FM_K_STEREO = 4,
63 enum saa7134_audio_in {
69 enum saa7134_video_out {
73 /* ----------------------------------------------------------- */
76 struct saa7134_tvnorm {
81 unsigned int sync_control;
82 unsigned int luma_control;
83 unsigned int chroma_ctrl1;
84 unsigned int chroma_gain;
85 unsigned int chroma_ctrl2;
86 unsigned int vgate_misc;
91 unsigned int video_v_start;
92 unsigned int video_v_stop;
93 unsigned int vbi_v_start;
94 unsigned int vbi_v_stop;
95 unsigned int src_timing;
98 struct saa7134_tvaudio {
101 enum saa7134_tvaudio_mode mode;
106 struct saa7134_format {
111 unsigned int vshift; /* vertical downsampling (for planar yuv) */
112 unsigned int hshift; /* horizontal downsampling (for planar yuv) */
113 unsigned int bswap:1;
114 unsigned int wswap:1;
116 unsigned int planar:1;
117 unsigned int uvswap:1;
120 /* ----------------------------------------------------------- */
121 /* card configuration */
123 #define SAA7134_BOARD_NOAUTO UNSET
124 #define SAA7134_BOARD_UNKNOWN 0
125 #define SAA7134_BOARD_PROTEUS_PRO 1
126 #define SAA7134_BOARD_FLYVIDEO3000 2
127 #define SAA7134_BOARD_FLYVIDEO2000 3
128 #define SAA7134_BOARD_EMPRESS 4
129 #define SAA7134_BOARD_MONSTERTV 5
130 #define SAA7134_BOARD_MD9717 6
131 #define SAA7134_BOARD_TVSTATION_RDS 7
132 #define SAA7134_BOARD_CINERGY400 8
133 #define SAA7134_BOARD_MD5044 9
134 #define SAA7134_BOARD_KWORLD 10
135 #define SAA7134_BOARD_CINERGY600 11
136 #define SAA7134_BOARD_MD7134 12
137 #define SAA7134_BOARD_TYPHOON_90031 13
138 #define SAA7134_BOARD_ELSA 14
139 #define SAA7134_BOARD_ELSA_500TV 15
140 #define SAA7134_BOARD_ASUSTeK_TVFM7134 16
141 #define SAA7134_BOARD_VA1000POWER 17
142 #define SAA7134_BOARD_BMK_MPEX_NOTUNER 18
143 #define SAA7134_BOARD_VIDEOMATE_TV 19
144 #define SAA7134_BOARD_CRONOS_PLUS 20
145 #define SAA7134_BOARD_10MOONSTVMASTER 21
146 #define SAA7134_BOARD_MD2819 22
147 #define SAA7134_BOARD_BMK_MPEX_TUNER 23
148 #define SAA7134_BOARD_TVSTATION_DVR 24
149 #define SAA7134_BOARD_ASUSTEK_TVFM7133 25
150 #define SAA7134_BOARD_PINNACLE_PCTV_STEREO 26
151 #define SAA7134_BOARD_MANLI_MTV002 27
152 #define SAA7134_BOARD_MANLI_MTV001 28
153 #define SAA7134_BOARD_TG3000TV 29
154 #define SAA7134_BOARD_ECS_TVP3XP 30
155 #define SAA7134_BOARD_ECS_TVP3XP_4CB5 31
156 #define SAA7134_BOARD_AVACSSMARTTV 32
157 #define SAA7134_BOARD_AVERMEDIA_DVD_EZMAKER 33
158 #define SAA7134_BOARD_NOVAC_PRIMETV7133 34
159 #define SAA7134_BOARD_AVERMEDIA_305 35
160 #define SAA7133_BOARD_UPMOST_PURPLE_TV 36
161 #define SAA7134_BOARD_ITEMS_MTV005 37
162 #define SAA7134_BOARD_CINERGY200 38
163 #define SAA7134_BOARD_FLYTVPLATINUM 39
164 #define SAA7134_BOARD_VIDEOMATE_TV_PVR 40
165 #define SAA7134_BOARD_VIDEOMATE_TV_GOLD_PLUS 41
166 #define SAA7134_BOARD_SABRENT_SBTTVFM 42
167 #define SAA7134_BOARD_ZOLID_XPERT_TV7134 43
168 #define SAA7134_BOARD_EMPIRE_PCI_TV_RADIO_LE 44
169 #define SAA7134_BOARD_AVERMEDIA_307 45
170 #define SAA7134_BOARD_AVERMEDIA_CARDBUS 46
171 #define SAA7134_BOARD_CINERGY400_CARDBUS 47
173 #define SAA7134_MAXBOARDS 8
174 #define SAA7134_INPUT_MAX 8
176 struct saa7134_input {
179 enum saa7134_audio_in amux;
184 enum saa7134_mpeg_type {
186 SAA7134_MPEG_EMPRESS,
190 struct saa7134_board {
192 unsigned int audio_clock;
194 /* input switching */
195 unsigned int gpiomask;
196 struct saa7134_input inputs[SAA7134_INPUT_MAX];
197 struct saa7134_input radio;
198 struct saa7134_input mute;
201 unsigned int tuner_type;
202 unsigned int tda9887_conf;
205 enum saa7134_video_out video_out;
206 enum saa7134_mpeg_type mpeg;
209 #define card_has_radio(dev) (NULL != saa7134_boards[dev->board].radio.name)
210 #define card_is_empress(dev) (SAA7134_MPEG_EMPRESS == saa7134_boards[dev->board].mpeg)
211 #define card_is_dvb(dev) (SAA7134_MPEG_DVB == saa7134_boards[dev->board].mpeg)
212 #define card_has_mpeg(dev) (SAA7134_MPEG_UNUSED != saa7134_boards[dev->board].mpeg)
213 #define card(dev) (saa7134_boards[dev->board])
214 #define card_in(dev,n) (saa7134_boards[dev->board].inputs[n])
216 /* ----------------------------------------------------------- */
217 /* device / file handle status */
219 #define RESOURCE_OVERLAY 1
220 #define RESOURCE_VIDEO 2
221 #define RESOURCE_VBI 4
223 #define INTERLACE_AUTO 0
224 #define INTERLACE_ON 1
225 #define INTERLACE_OFF 2
227 #define BUFFER_TIMEOUT (HZ/2) /* 0.5 seconds */
232 /* saa7134 page table */
233 struct saa7134_pgtable {
239 /* tvaudio thread status */
240 struct saa7134_thread {
242 struct completion exit;
243 wait_queue_head_t wq;
244 unsigned int shutdown;
250 /* buffer for one video/vbi/ts frame */
252 /* common v4l buffer stuff -- must be first */
253 struct videobuf_buffer vb;
255 /* saa7134 specific */
256 struct saa7134_format *fmt;
257 unsigned int top_seen;
258 int (*activate)(struct saa7134_dev *dev,
259 struct saa7134_buf *buf,
260 struct saa7134_buf *next);
263 struct saa7134_pgtable *pt;
266 struct saa7134_dmaqueue {
267 struct saa7134_dev *dev;
268 struct saa7134_buf *curr;
269 struct list_head queue;
270 struct timer_list timeout;
271 unsigned int need_two;
274 /* video filehandle status */
276 struct saa7134_dev *dev;
278 enum v4l2_buf_type type;
279 unsigned int resources;
280 #ifdef VIDIOC_G_PRIORITY
281 enum v4l2_priority prio;
285 struct v4l2_window win;
286 struct v4l2_clip clips[8];
290 struct saa7134_format *fmt;
291 unsigned int width,height;
292 struct videobuf_queue cap;
293 struct saa7134_pgtable pt_cap;
296 struct videobuf_queue vbi;
297 struct saa7134_pgtable pt_vbi;
302 struct semaphore lock;
305 unsigned int users_dsp;
308 enum saa7134_audio_in input;
316 unsigned int channels;
317 unsigned int recording_on;
318 unsigned int dma_running;
320 unsigned int blksize;
321 unsigned int bufsize;
322 struct saa7134_pgtable pt;
323 struct videobuf_dmabuf dma;
324 wait_queue_head_t wq;
325 unsigned int dma_blk;
326 unsigned int read_offset;
327 unsigned int read_count;
332 struct input_dev dev;
333 struct ir_input_state ir;
341 struct timer_list timer;
347 struct saa7134_pgtable pt_ts;
353 struct saa7134_mpeg_ops {
354 enum saa7134_mpeg_type type;
355 struct list_head next;
356 int (*init)(struct saa7134_dev *dev);
357 int (*fini)(struct saa7134_dev *dev);
360 /* global device status */
362 struct list_head devlist;
363 struct semaphore lock;
365 #ifdef VIDIOC_G_PRIORITY
366 struct v4l2_prio_state prio;
369 /* various device info */
370 unsigned int resources;
371 struct video_device *video_dev;
372 struct video_device *radio_dev;
373 struct video_device *vbi_dev;
374 struct saa7134_oss oss;
376 /* infrared remote */
378 struct saa7134_ir *remote;
384 unsigned char pci_rev,pci_lat;
385 __u32 __iomem *lmmio;
390 unsigned int tuner_type;
391 unsigned int tda9887_conf;
392 unsigned int gpio_value;
395 struct i2c_adapter i2c_adap;
396 struct i2c_client i2c_client;
397 unsigned char eedata[64];
400 struct v4l2_framebuffer ovbuf;
401 struct saa7134_format *ovfmt;
402 unsigned int ovenable;
403 enum v4l2_field ovfield;
405 /* video+ts+vbi capture */
406 struct saa7134_dmaqueue video_q;
407 struct saa7134_dmaqueue vbi_q;
408 unsigned int video_fieldcount;
409 unsigned int vbi_fieldcount;
411 /* various v4l controls */
412 struct saa7134_tvnorm *tvnorm; /* video */
413 struct saa7134_tvaudio *tvaudio;
414 unsigned int ctl_input;
420 int ctl_mute; /* audio */
422 int ctl_invert; /* private */
429 struct v4l2_rect crop_bounds;
430 struct v4l2_rect crop_defrect;
431 struct v4l2_rect crop_current;
433 /* other global state info */
434 unsigned int automute;
435 struct saa7134_thread thread;
436 struct saa7134_input *input;
437 struct saa7134_input *hw_input;
438 unsigned int hw_mute;
442 struct saa7134_ts ts;
443 struct saa7134_dmaqueue ts_q;
444 struct saa7134_mpeg_ops *mops;
446 /* SAA7134_MPEG_EMPRESS only */
447 struct video_device *empress_dev;
448 struct videobuf_queue empress_tsq;
449 unsigned int empress_users;
451 /* SAA7134_MPEG_DVB only */
452 struct videobuf_dvb dvb;
455 /* ----------------------------------------------------------- */
457 #define saa_readl(reg) readl(dev->lmmio + (reg))
458 #define saa_writel(reg,value) writel((value), dev->lmmio + (reg));
459 #define saa_andorl(reg,mask,value) \
460 writel((readl(dev->lmmio+(reg)) & ~(mask)) |\
461 ((value) & (mask)), dev->lmmio+(reg))
462 #define saa_setl(reg,bit) saa_andorl((reg),(bit),(bit))
463 #define saa_clearl(reg,bit) saa_andorl((reg),(bit),0)
465 #define saa_readb(reg) readb(dev->bmmio + (reg))
466 #define saa_writeb(reg,value) writeb((value), dev->bmmio + (reg));
467 #define saa_andorb(reg,mask,value) \
468 writeb((readb(dev->bmmio+(reg)) & ~(mask)) |\
469 ((value) & (mask)), dev->bmmio+(reg))
470 #define saa_setb(reg,bit) saa_andorb((reg),(bit),(bit))
471 #define saa_clearb(reg,bit) saa_andorb((reg),(bit),0)
473 #define saa_wait(us) { udelay(us); }
475 /* ----------------------------------------------------------- */
478 extern struct list_head saa7134_devlist;
479 extern unsigned int saa7134_devcount;
481 void saa7134_print_ioctl(char *name, unsigned int cmd);
482 void saa7134_track_gpio(struct saa7134_dev *dev, char *msg);
484 #define SAA7134_PGTABLE_SIZE 4096
486 int saa7134_pgtable_alloc(struct pci_dev *pci, struct saa7134_pgtable *pt);
487 int saa7134_pgtable_build(struct pci_dev *pci, struct saa7134_pgtable *pt,
488 struct scatterlist *list, unsigned int length,
489 unsigned int startpage);
490 void saa7134_pgtable_free(struct pci_dev *pci, struct saa7134_pgtable *pt);
492 int saa7134_buffer_count(unsigned int size, unsigned int count);
493 int saa7134_buffer_startpage(struct saa7134_buf *buf);
494 unsigned long saa7134_buffer_base(struct saa7134_buf *buf);
496 int saa7134_buffer_queue(struct saa7134_dev *dev, struct saa7134_dmaqueue *q,
497 struct saa7134_buf *buf);
498 void saa7134_buffer_finish(struct saa7134_dev *dev, struct saa7134_dmaqueue *q,
500 void saa7134_buffer_next(struct saa7134_dev *dev, struct saa7134_dmaqueue *q);
501 void saa7134_buffer_timeout(unsigned long data);
502 void saa7134_dma_free(struct saa7134_dev *dev,struct saa7134_buf *buf);
504 int saa7134_set_dmabits(struct saa7134_dev *dev);
506 /* ----------------------------------------------------------- */
507 /* saa7134-cards.c */
509 extern struct saa7134_board saa7134_boards[];
510 extern const unsigned int saa7134_bcount;
511 extern struct pci_device_id __devinitdata saa7134_pci_tbl[];
513 extern int saa7134_board_init1(struct saa7134_dev *dev);
514 extern int saa7134_board_init2(struct saa7134_dev *dev);
517 /* ----------------------------------------------------------- */
520 int saa7134_i2c_register(struct saa7134_dev *dev);
521 int saa7134_i2c_unregister(struct saa7134_dev *dev);
522 void saa7134_i2c_call_clients(struct saa7134_dev *dev,
523 unsigned int cmd, void *arg);
526 /* ----------------------------------------------------------- */
527 /* saa7134-video.c */
529 extern struct video_device saa7134_video_template;
530 extern struct video_device saa7134_radio_template;
532 int saa7134_common_ioctl(struct saa7134_dev *dev,
533 unsigned int cmd, void *arg);
535 int saa7134_video_init1(struct saa7134_dev *dev);
536 int saa7134_video_init2(struct saa7134_dev *dev);
537 int saa7134_video_fini(struct saa7134_dev *dev);
538 void saa7134_irq_video_intl(struct saa7134_dev *dev);
539 void saa7134_irq_video_done(struct saa7134_dev *dev, unsigned long status);
542 /* ----------------------------------------------------------- */
545 #define TS_PACKET_SIZE 188 /* TS packets 188 bytes */
547 extern struct videobuf_queue_ops saa7134_ts_qops;
549 int saa7134_ts_init1(struct saa7134_dev *dev);
550 int saa7134_ts_fini(struct saa7134_dev *dev);
551 void saa7134_irq_ts_done(struct saa7134_dev *dev, unsigned long status);
553 int saa7134_ts_register(struct saa7134_mpeg_ops *ops);
554 void saa7134_ts_unregister(struct saa7134_mpeg_ops *ops);
556 /* ----------------------------------------------------------- */
559 extern struct videobuf_queue_ops saa7134_vbi_qops;
560 extern struct video_device saa7134_vbi_template;
562 int saa7134_vbi_init1(struct saa7134_dev *dev);
563 int saa7134_vbi_fini(struct saa7134_dev *dev);
564 void saa7134_irq_vbi_done(struct saa7134_dev *dev, unsigned long status);
567 /* ----------------------------------------------------------- */
568 /* saa7134-tvaudio.c */
570 int saa7134_tvaudio_rx2mode(u32 rx);
572 void saa7134_tvaudio_setmute(struct saa7134_dev *dev);
573 void saa7134_tvaudio_setinput(struct saa7134_dev *dev,
574 struct saa7134_input *in);
575 void saa7134_tvaudio_setvolume(struct saa7134_dev *dev, int level);
576 int saa7134_tvaudio_getstereo(struct saa7134_dev *dev);
578 int saa7134_tvaudio_init2(struct saa7134_dev *dev);
579 int saa7134_tvaudio_fini(struct saa7134_dev *dev);
580 int saa7134_tvaudio_do_scan(struct saa7134_dev *dev);
582 int saa_dsp_writel(struct saa7134_dev *dev, int reg, u32 value);
584 /* ----------------------------------------------------------- */
587 extern struct file_operations saa7134_dsp_fops;
588 extern struct file_operations saa7134_mixer_fops;
590 int saa7134_oss_init1(struct saa7134_dev *dev);
591 int saa7134_oss_fini(struct saa7134_dev *dev);
592 void saa7134_irq_oss_done(struct saa7134_dev *dev, unsigned long status);
594 /* ----------------------------------------------------------- */
595 /* saa7134-input.c */
597 int saa7134_input_init1(struct saa7134_dev *dev);
598 void saa7134_input_fini(struct saa7134_dev *dev);
599 void saa7134_input_irq(struct saa7134_dev *dev);