V4L/DVB (4359): Cx88: add initial support for Hauppauge HVR3000 trimode card
[safe/jmp/linux-2.6] / drivers / media / video / cx88 / cx88.h
1 /*
2  *
3  * v4l2 device driver for cx2388x based TV cards
4  *
5  * (c) 2003,04 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs]
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
22 #include <linux/pci.h>
23 #include <linux/i2c.h>
24 #include <linux/i2c-algo-bit.h>
25 #include <linux/videodev2.h>
26 #include <linux/kdev_t.h>
27
28 #include <media/v4l2-common.h>
29 #include <media/tuner.h>
30 #include <media/tveeprom.h>
31 #include <media/video-buf.h>
32 #include <media/cx2341x.h>
33 #include <media/video-buf-dvb.h>
34
35 #include "btcx-risc.h"
36 #include "cx88-reg.h"
37
38 #include <linux/version.h>
39 #include <linux/mutex.h>
40 #define CX88_VERSION_CODE KERNEL_VERSION(0,0,6)
41
42 #ifndef TRUE
43 # define TRUE (1==1)
44 #endif
45 #ifndef FALSE
46 # define FALSE (1==0)
47 #endif
48 #define UNSET (-1U)
49
50 #define CX88_MAXBOARDS 8
51
52 /* Max number of inputs by card */
53 #define MAX_CX88_INPUT 8
54
55 /* ----------------------------------------------------------- */
56 /* defines and enums                                           */
57
58 #define FORMAT_FLAGS_PACKED       0x01
59 #define FORMAT_FLAGS_PLANAR       0x02
60
61 #define VBI_LINE_COUNT              17
62 #define VBI_LINE_LENGTH           2048
63
64 /* need "shadow" registers for some write-only ones ... */
65 #define SHADOW_AUD_VOL_CTL           1
66 #define SHADOW_AUD_BAL_CTL           2
67 #define SHADOW_MAX                   3
68
69 /* FM Radio deemphasis type */
70 enum cx88_deemph_type {
71         FM_NO_DEEMPH = 0,
72         FM_DEEMPH_50,
73         FM_DEEMPH_75
74 };
75
76 /* ----------------------------------------------------------- */
77 /* tv norms                                                    */
78
79 struct cx88_tvnorm {
80         char                   *name;
81         v4l2_std_id            id;
82         u32                    cxiformat;
83         u32                    cxoformat;
84 };
85
86 static unsigned int inline norm_maxw(struct cx88_tvnorm *norm)
87 {
88         return (norm->id & V4L2_STD_625_50) ? 768 : 640;
89 }
90
91
92 static unsigned int inline norm_maxh(struct cx88_tvnorm *norm)
93 {
94         return (norm->id & V4L2_STD_625_50) ? 576 : 480;
95 }
96
97 /* ----------------------------------------------------------- */
98 /* static data                                                 */
99
100 struct cx8800_fmt {
101         char  *name;
102         u32   fourcc;          /* v4l2 format id */
103         int   depth;
104         int   flags;
105         u32   cxformat;
106 };
107
108 struct cx88_ctrl {
109         struct v4l2_queryctrl  v;
110         u32                    off;
111         u32                    reg;
112         u32                    sreg;
113         u32                    mask;
114         u32                    shift;
115 };
116
117 /* ----------------------------------------------------------- */
118 /* SRAM memory management data (see cx88-core.c)               */
119
120 #define SRAM_CH21 0   /* video */
121 #define SRAM_CH22 1
122 #define SRAM_CH23 2
123 #define SRAM_CH24 3   /* vbi   */
124 #define SRAM_CH25 4   /* audio */
125 #define SRAM_CH26 5
126 #define SRAM_CH28 6   /* mpeg */
127 /* more */
128
129 struct sram_channel {
130         char *name;
131         u32  cmds_start;
132         u32  ctrl_start;
133         u32  cdt;
134         u32  fifo_start;
135         u32  fifo_size;
136         u32  ptr1_reg;
137         u32  ptr2_reg;
138         u32  cnt1_reg;
139         u32  cnt2_reg;
140 };
141 extern struct sram_channel cx88_sram_channels[];
142
143 /* ----------------------------------------------------------- */
144 /* card configuration                                          */
145
146 #define CX88_BOARD_NOAUTO               UNSET
147 #define CX88_BOARD_UNKNOWN                  0
148 #define CX88_BOARD_HAUPPAUGE                1
149 #define CX88_BOARD_GDI                      2
150 #define CX88_BOARD_PIXELVIEW                3
151 #define CX88_BOARD_ATI_WONDER_PRO           4
152 #define CX88_BOARD_WINFAST2000XP_EXPERT     5
153 #define CX88_BOARD_AVERTV_STUDIO_303        6
154 #define CX88_BOARD_MSI_TVANYWHERE_MASTER    7
155 #define CX88_BOARD_WINFAST_DV2000           8
156 #define CX88_BOARD_LEADTEK_PVR2000          9
157 #define CX88_BOARD_IODATA_GVVCP3PCI        10
158 #define CX88_BOARD_PROLINK_PLAYTVPVR       11
159 #define CX88_BOARD_ASUS_PVR_416            12
160 #define CX88_BOARD_MSI_TVANYWHERE          13
161 #define CX88_BOARD_KWORLD_DVB_T            14
162 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T1 15
163 #define CX88_BOARD_KWORLD_LTV883           16
164 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q  17
165 #define CX88_BOARD_HAUPPAUGE_DVB_T1        18
166 #define CX88_BOARD_CONEXANT_DVB_T1         19
167 #define CX88_BOARD_PROVIDEO_PV259          20
168 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PLUS 21
169 #define CX88_BOARD_PCHDTV_HD3000           22
170 #define CX88_BOARD_DNTV_LIVE_DVB_T         23
171 #define CX88_BOARD_HAUPPAUGE_ROSLYN        24
172 #define CX88_BOARD_DIGITALLOGIC_MEC        25
173 #define CX88_BOARD_IODATA_GVBCTV7E         26
174 #define CX88_BOARD_PIXELVIEW_PLAYTV_ULTRA_PRO 27
175 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T  28
176 #define CX88_BOARD_ADSTECH_DVB_T_PCI          29
177 #define CX88_BOARD_TERRATEC_CINERGY_1400_DVB_T1  30
178 #define CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD 31
179 #define CX88_BOARD_AVERMEDIA_ULTRATV_MC_550 32
180 #define CX88_BOARD_KWORLD_VSTREAM_EXPERT_DVD 33
181 #define CX88_BOARD_ATI_HDTVWONDER          34
182 #define CX88_BOARD_WINFAST_DTV1000         35
183 #define CX88_BOARD_AVERTV_303              36
184 #define CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1  37
185 #define CX88_BOARD_HAUPPAUGE_NOVASE2_S1    38
186 #define CX88_BOARD_KWORLD_DVBS_100         39
187 #define CX88_BOARD_HAUPPAUGE_HVR1100       40
188 #define CX88_BOARD_HAUPPAUGE_HVR1100LP     41
189 #define CX88_BOARD_DNTV_LIVE_DVB_T_PRO     42
190 #define CX88_BOARD_KWORLD_DVB_T_CX22702    43
191 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_DUAL 44
192 #define CX88_BOARD_KWORLD_HARDWARE_MPEG_TV_XPERT 45
193 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_HYBRID 46
194 #define CX88_BOARD_PCHDTV_HD5500           47
195 #define CX88_BOARD_KWORLD_MCE200_DELUXE    48
196 #define CX88_BOARD_PIXELVIEW_PLAYTV_P7000  49
197 #define CX88_BOARD_NPGTECH_REALTV_TOP10FM  50
198 #define CX88_BOARD_WINFAST_DTV2000H        51
199 #define CX88_BOARD_GENIATECH_DVBS          52
200 #define CX88_BOARD_HAUPPAUGE_HVR3000       53
201
202 enum cx88_itype {
203         CX88_VMUX_COMPOSITE1 = 1,
204         CX88_VMUX_COMPOSITE2,
205         CX88_VMUX_COMPOSITE3,
206         CX88_VMUX_COMPOSITE4,
207         CX88_VMUX_SVIDEO,
208         CX88_VMUX_TELEVISION,
209         CX88_VMUX_CABLE,
210         CX88_VMUX_DVB,
211         CX88_VMUX_DEBUG,
212         CX88_RADIO,
213 };
214
215 struct cx88_input {
216         enum cx88_itype type;
217         unsigned int    vmux;
218         u32             gpio0, gpio1, gpio2, gpio3;
219 };
220
221 struct cx88_board {
222         char                    *name;
223         unsigned int            tuner_type;
224         unsigned int            radio_type;
225         unsigned char           tuner_addr;
226         unsigned char           radio_addr;
227         int                     tda9887_conf;
228         struct cx88_input       input[MAX_CX88_INPUT];
229         struct cx88_input       radio;
230         unsigned int            blackbird:1;
231         unsigned int            dvb:1;
232 };
233
234 struct cx88_subid {
235         u16     subvendor;
236         u16     subdevice;
237         u32     card;
238 };
239
240 #define INPUT(nr) (&cx88_boards[core->board].input[nr])
241
242 /* ----------------------------------------------------------- */
243 /* device / file handle status                                 */
244
245 #define RESOURCE_OVERLAY       1
246 #define RESOURCE_VIDEO         2
247 #define RESOURCE_VBI           4
248
249 #define BUFFER_TIMEOUT     (HZ/2)  /* 0.5 seconds */
250
251 /* buffer for one video frame */
252 struct cx88_buffer {
253         /* common v4l buffer stuff -- must be first */
254         struct videobuf_buffer vb;
255
256         /* cx88 specific */
257         unsigned int           bpl;
258         struct btcx_riscmem    risc;
259         struct cx8800_fmt      *fmt;
260         u32                    count;
261 };
262
263 struct cx88_dmaqueue {
264         struct list_head       active;
265         struct list_head       queued;
266         struct timer_list      timeout;
267         struct btcx_riscmem    stopper;
268         u32                    count;
269 };
270
271 struct cx88_core {
272         struct list_head           devlist;
273         atomic_t                   refcount;
274
275         /* board name */
276         int                        nr;
277         char                       name[32];
278
279         /* pci stuff */
280         int                        pci_bus;
281         int                        pci_slot;
282         u32                        __iomem *lmmio;
283         u8                         __iomem *bmmio;
284         u32                        shadow[SHADOW_MAX];
285         int                        pci_irqmask;
286
287         /* i2c i/o */
288         struct i2c_adapter         i2c_adap;
289         struct i2c_algo_bit_data   i2c_algo;
290         struct i2c_client          i2c_client;
291         u32                        i2c_state, i2c_rc;
292
293         /* config info -- analog */
294         unsigned int               board;
295         unsigned int               tuner_type;
296         unsigned int               radio_type;
297         unsigned char              tuner_addr;
298         unsigned char              radio_addr;
299         unsigned int               tda9887_conf;
300         unsigned int               has_radio;
301
302         /* Supported V4L _STD_ tuner formats */
303         unsigned int               tuner_formats;
304
305         /* config info -- dvb */
306         struct dvb_pll_desc        *pll_desc;
307         unsigned int               pll_addr;
308         int                        (*prev_set_voltage)(struct dvb_frontend* fe, fe_sec_voltage_t voltage);
309
310         /* state info */
311         struct task_struct         *kthread;
312         struct cx88_tvnorm         *tvnorm;
313         u32                        tvaudio;
314         u32                        audiomode_manual;
315         u32                        audiomode_current;
316         u32                        input;
317         u32                        astat;
318         u32                        use_nicam;
319
320         /* IR remote control state */
321         struct cx88_IR             *ir;
322
323         struct mutex               lock;
324         /* various v4l controls */
325         u32                        freq;
326
327         /* cx88-video needs to access cx8802 for hybrid tuner pll access. */
328         struct cx8802_dev          *dvbdev;
329 };
330
331 struct cx8800_dev;
332 struct cx8802_dev;
333
334 /* ----------------------------------------------------------- */
335 /* function 0: video stuff                                     */
336
337 struct cx8800_fh {
338         struct cx8800_dev          *dev;
339         enum v4l2_buf_type         type;
340         int                        radio;
341         unsigned int               resources;
342
343         /* video overlay */
344         struct v4l2_window         win;
345         struct v4l2_clip           *clips;
346         unsigned int               nclips;
347
348         /* video capture */
349         struct cx8800_fmt          *fmt;
350         unsigned int               width,height;
351         struct videobuf_queue      vidq;
352
353         /* vbi capture */
354         struct videobuf_queue      vbiq;
355 };
356
357 struct cx8800_suspend_state {
358         int                        disabled;
359 };
360
361 struct cx8800_dev {
362         struct cx88_core           *core;
363         struct list_head           devlist;
364         spinlock_t                 slock;
365
366         /* various device info */
367         unsigned int               resources;
368         struct video_device        *video_dev;
369         struct video_device        *vbi_dev;
370         struct video_device        *radio_dev;
371
372         /* pci i/o */
373         struct pci_dev             *pci;
374         unsigned char              pci_rev,pci_lat;
375
376
377         /* capture queues */
378         struct cx88_dmaqueue       vidq;
379         struct cx88_dmaqueue       vbiq;
380
381         /* various v4l controls */
382
383         /* other global state info */
384         struct cx8800_suspend_state state;
385 };
386
387 /* ----------------------------------------------------------- */
388 /* function 1: audio/alsa stuff                                */
389 /* =============> moved to cx88-alsa.c <====================== */
390
391
392 /* ----------------------------------------------------------- */
393 /* function 2: mpeg stuff                                      */
394
395 struct cx8802_fh {
396         struct cx8802_dev          *dev;
397         struct videobuf_queue      mpegq;
398 };
399
400 struct cx8802_suspend_state {
401         int                        disabled;
402 };
403
404 struct cx8802_dev {
405         struct cx88_core           *core;
406         spinlock_t                 slock;
407
408         /* pci i/o */
409         struct pci_dev             *pci;
410         unsigned char              pci_rev,pci_lat;
411
412         /* dma queues */
413         struct cx88_dmaqueue       mpegq;
414         u32                        ts_packet_size;
415         u32                        ts_packet_count;
416
417         /* other global state info */
418         struct cx8802_suspend_state state;
419
420         /* for blackbird only */
421         struct list_head           devlist;
422         struct video_device        *mpeg_dev;
423         u32                        mailbox;
424         int                        width;
425         int                        height;
426
427         /* for dvb only */
428         struct videobuf_dvb        dvb;
429         void*                      fe_handle;
430         int                        (*fe_release)(void *handle);
431
432         void                       *card_priv;
433         /* for switching modulation types */
434         unsigned char              ts_gen_cntrl;
435
436         /* mpeg params */
437         struct cx2341x_mpeg_params params;
438 };
439
440 /* ----------------------------------------------------------- */
441
442 #define cx_read(reg)             readl(core->lmmio + ((reg)>>2))
443 #define cx_write(reg,value)      writel((value), core->lmmio + ((reg)>>2))
444 #define cx_writeb(reg,value)     writeb((value), core->bmmio + (reg))
445
446 #define cx_andor(reg,mask,value) \
447   writel((readl(core->lmmio+((reg)>>2)) & ~(mask)) |\
448   ((value) & (mask)), core->lmmio+((reg)>>2))
449 #define cx_set(reg,bit)          cx_andor((reg),(bit),(bit))
450 #define cx_clear(reg,bit)        cx_andor((reg),(bit),0)
451
452 #define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
453
454 /* shadow registers */
455 #define cx_sread(sreg)              (core->shadow[sreg])
456 #define cx_swrite(sreg,reg,value) \
457   (core->shadow[sreg] = value, \
458    writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
459 #define cx_sandor(sreg,reg,mask,value) \
460   (core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | ((value) & (mask)), \
461    writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
462
463 /* ----------------------------------------------------------- */
464 /* cx88-core.c                                                 */
465
466 extern void cx88_print_irqbits(char *name, char *tag, char **strings,
467                                u32 bits, u32 mask);
468
469 extern int cx88_core_irq(struct cx88_core *core, u32 status);
470 extern void cx88_wakeup(struct cx88_core *core,
471                         struct cx88_dmaqueue *q, u32 count);
472 extern void cx88_shutdown(struct cx88_core *core);
473 extern int cx88_reset(struct cx88_core *core);
474
475 extern int
476 cx88_risc_buffer(struct pci_dev *pci, struct btcx_riscmem *risc,
477                  struct scatterlist *sglist,
478                  unsigned int top_offset, unsigned int bottom_offset,
479                  unsigned int bpl, unsigned int padding, unsigned int lines);
480 extern int
481 cx88_risc_databuffer(struct pci_dev *pci, struct btcx_riscmem *risc,
482                      struct scatterlist *sglist, unsigned int bpl,
483                      unsigned int lines);
484 extern int
485 cx88_risc_stopper(struct pci_dev *pci, struct btcx_riscmem *risc,
486                   u32 reg, u32 mask, u32 value);
487 extern void
488 cx88_free_buffer(struct videobuf_queue *q, struct cx88_buffer *buf);
489
490 extern void cx88_risc_disasm(struct cx88_core *core,
491                              struct btcx_riscmem *risc);
492 extern int cx88_sram_channel_setup(struct cx88_core *core,
493                                    struct sram_channel *ch,
494                                    unsigned int bpl, u32 risc);
495 extern void cx88_sram_channel_dump(struct cx88_core *core,
496                                    struct sram_channel *ch);
497
498 extern int cx88_set_scale(struct cx88_core *core, unsigned int width,
499                           unsigned int height, enum v4l2_field field);
500 extern int cx88_set_tvnorm(struct cx88_core *core, struct cx88_tvnorm *norm);
501
502 extern struct video_device *cx88_vdev_init(struct cx88_core *core,
503                                            struct pci_dev *pci,
504                                            struct video_device *template,
505                                            char *type);
506 extern struct cx88_core* cx88_core_get(struct pci_dev *pci);
507 extern void cx88_core_put(struct cx88_core *core,
508                           struct pci_dev *pci);
509
510 extern int cx88_start_audio_dma(struct cx88_core *core);
511 extern int cx88_stop_audio_dma(struct cx88_core *core);
512
513
514 /* ----------------------------------------------------------- */
515 /* cx88-vbi.c                                                  */
516
517 void cx8800_vbi_fmt(struct cx8800_dev *dev, struct v4l2_format *f);
518 /*
519 int cx8800_start_vbi_dma(struct cx8800_dev    *dev,
520                          struct cx88_dmaqueue *q,
521                          struct cx88_buffer   *buf);
522 */
523 int cx8800_stop_vbi_dma(struct cx8800_dev *dev);
524 int cx8800_restart_vbi_queue(struct cx8800_dev    *dev,
525                              struct cx88_dmaqueue *q);
526 void cx8800_vbi_timeout(unsigned long data);
527
528 extern struct videobuf_queue_ops cx8800_vbi_qops;
529
530 /* ----------------------------------------------------------- */
531 /* cx88-i2c.c                                                  */
532
533 extern int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
534 extern void cx88_call_i2c_clients(struct cx88_core *core,
535                                   unsigned int cmd, void *arg);
536
537
538 /* ----------------------------------------------------------- */
539 /* cx88-cards.c                                                */
540
541 extern struct cx88_board cx88_boards[];
542 extern const unsigned int cx88_bcount;
543
544 extern struct cx88_subid cx88_subids[];
545 extern const unsigned int cx88_idcount;
546
547 extern void cx88_card_list(struct cx88_core *core, struct pci_dev *pci);
548 extern void cx88_card_setup(struct cx88_core *core);
549
550 /* ----------------------------------------------------------- */
551 /* cx88-tvaudio.c                                              */
552
553 #define WW_NONE          1
554 #define WW_BTSC          2
555 #define WW_BG            3
556 #define WW_DK            4
557 #define WW_I             5
558 #define WW_L             6
559 #define WW_EIAJ          7
560 #define WW_I2SPT         8
561 #define WW_FM            9
562
563 void cx88_set_tvaudio(struct cx88_core *core);
564 void cx88_newstation(struct cx88_core *core);
565 void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
566 void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
567 int cx88_audio_thread(void *data);
568
569 /* ----------------------------------------------------------- */
570 /* cx88-input.c                                                */
571
572 int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
573 int cx88_ir_fini(struct cx88_core *core);
574 void cx88_ir_irq(struct cx88_core *core);
575
576 /* ----------------------------------------------------------- */
577 /* cx88-mpeg.c                                                 */
578
579 int cx8802_buf_prepare(struct videobuf_queue *q,struct cx8802_dev *dev,
580                         struct cx88_buffer *buf, enum v4l2_field field);
581 void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
582 void cx8802_cancel_buffers(struct cx8802_dev *dev);
583
584 int cx8802_init_common(struct cx8802_dev *dev);
585 void cx8802_fini_common(struct cx8802_dev *dev);
586
587 int cx8802_suspend_common(struct pci_dev *pci_dev, pm_message_t state);
588 int cx8802_resume_common(struct pci_dev *pci_dev);
589
590 /* ----------------------------------------------------------- */
591 /* cx88-video.c                                                */
592 extern int cx88_do_ioctl(struct inode *inode, struct file *file, int radio,
593                                 struct cx88_core *core, unsigned int cmd,
594                                 void *arg, v4l2_kioctl driver_ioctl);
595 extern const u32 cx88_user_ctrls[];
596 extern int cx8800_ctrl_query(struct v4l2_queryctrl *qctrl);
597
598 /*
599  * Local variables:
600  * c-basic-offset: 8
601  * End:
602  * kate: eol "unix"; indent-width 3; remove-trailing-space on; replace-trailing-space-save on; tab-width 8; replace-tabs off; space-indent off; mixed-indent off
603  */