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