2 * $Id: cx88.h,v 1.69 2005/07/13 17:25:25 mchehab Exp $
4 * v4l2 device driver for cx2388x based TV cards
6 * (c) 2003,04 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs]
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/pci.h>
24 #include <linux/i2c.h>
25 #include <linux/i2c-algo-bit.h>
26 #include <linux/videodev.h>
27 #include <linux/kdev_t.h>
29 #include <media/tuner.h>
30 #include <media/tveeprom.h>
31 #include <media/audiochip.h>
32 #include <media/video-buf.h>
33 #include <media/video-buf-dvb.h>
35 #include "btcx-risc.h"
38 #include <linux/utsname.h>
39 #define CX88_VERSION_CODE KERNEL_VERSION(0,0,5)
49 #define CX88_MAXBOARDS 8
51 /* ----------------------------------------------------------- */
52 /* defines and enums */
54 #define FORMAT_FLAGS_PACKED 0x01
55 #define FORMAT_FLAGS_PLANAR 0x02
57 #define VBI_LINE_COUNT 17
58 #define VBI_LINE_LENGTH 2048
60 /* need "shadow" registers for some write-only ones ... */
61 #define SHADOW_AUD_VOL_CTL 1
62 #define SHADOW_AUD_BAL_CTL 2
65 /* FM Radio deemphasis type */
66 enum cx88_deemph_type {
72 /* ----------------------------------------------------------- */
82 static unsigned int inline norm_maxw(struct cx88_tvnorm *norm)
84 return (norm->id & V4L2_STD_625_50) ? 768 : 640;
88 static unsigned int inline norm_maxh(struct cx88_tvnorm *norm)
90 return (norm->id & V4L2_STD_625_50) ? 576 : 480;
93 /* ----------------------------------------------------------- */
98 u32 fourcc; /* v4l2 format id */
105 struct v4l2_queryctrl v;
113 /* ----------------------------------------------------------- */
114 /* SRAM memory management data (see cx88-core.c) */
116 #define SRAM_CH21 0 /* video */
119 #define SRAM_CH24 3 /* vbi */
120 #define SRAM_CH25 4 /* audio */
122 #define SRAM_CH28 6 /* mpeg */
125 struct sram_channel {
137 extern struct sram_channel cx88_sram_channels[];
139 /* ----------------------------------------------------------- */
140 /* card configuration */
142 #define CX88_BOARD_NOAUTO UNSET
143 #define CX88_BOARD_UNKNOWN 0
144 #define CX88_BOARD_HAUPPAUGE 1
145 #define CX88_BOARD_GDI 2
146 #define CX88_BOARD_PIXELVIEW 3
147 #define CX88_BOARD_ATI_WONDER_PRO 4
148 #define CX88_BOARD_WINFAST2000XP_EXPERT 5
149 #define CX88_BOARD_AVERTV_303 6
150 #define CX88_BOARD_MSI_TVANYWHERE_MASTER 7
151 #define CX88_BOARD_WINFAST_DV2000 8
152 #define CX88_BOARD_LEADTEK_PVR2000 9
153 #define CX88_BOARD_IODATA_GVVCP3PCI 10
154 #define CX88_BOARD_PROLINK_PLAYTVPVR 11
155 #define CX88_BOARD_ASUS_PVR_416 12
156 #define CX88_BOARD_MSI_TVANYWHERE 13
157 #define CX88_BOARD_KWORLD_DVB_T 14
158 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T1 15
159 #define CX88_BOARD_KWORLD_LTV883 16
160 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q 17
161 #define CX88_BOARD_HAUPPAUGE_DVB_T1 18
162 #define CX88_BOARD_CONEXANT_DVB_T1 19
163 #define CX88_BOARD_PROVIDEO_PV259 20
164 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PLUS 21
165 #define CX88_BOARD_PCHDTV_HD3000 22
166 #define CX88_BOARD_DNTV_LIVE_DVB_T 23
167 #define CX88_BOARD_HAUPPAUGE_ROSLYN 24
168 #define CX88_BOARD_DIGITALLOGIC_MEC 25
169 #define CX88_BOARD_IODATA_GVBCTV7E 26
170 #define CX88_BOARD_PIXELVIEW_PLAYTV_ULTRA_PRO 27
171 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T 28
172 #define CX88_BOARD_ADSTECH_DVB_T_PCI 29
173 #define CX88_BOARD_TERRATEC_CINERGY_1400_DVB_T1 30
176 CX88_VMUX_COMPOSITE1 = 1,
177 CX88_VMUX_COMPOSITE2,
178 CX88_VMUX_COMPOSITE3,
179 CX88_VMUX_COMPOSITE4,
181 CX88_VMUX_TELEVISION,
189 enum cx88_itype type;
191 u32 gpio0, gpio1, gpio2, gpio3;
196 unsigned int tuner_type;
197 unsigned int radio_type;
198 unsigned char tuner_addr;
199 unsigned char radio_addr;
201 struct cx88_input input[8];
202 struct cx88_input radio;
213 #define INPUT(nr) (&cx88_boards[core->board].input[nr])
215 /* ----------------------------------------------------------- */
216 /* device / file handle status */
218 #define RESOURCE_OVERLAY 1
219 #define RESOURCE_VIDEO 2
220 #define RESOURCE_VBI 4
222 #define BUFFER_TIMEOUT (HZ/2) /* 0.5 seconds */
224 /* buffer for one video frame */
226 /* common v4l buffer stuff -- must be first */
227 struct videobuf_buffer vb;
231 struct btcx_riscmem risc;
232 struct cx8800_fmt *fmt;
236 struct cx88_dmaqueue {
237 struct list_head active;
238 struct list_head queued;
239 struct timer_list timeout;
240 struct btcx_riscmem stopper;
245 struct list_head devlist;
257 u32 shadow[SHADOW_MAX];
261 struct i2c_adapter i2c_adap;
262 struct i2c_algo_bit_data i2c_algo;
263 struct i2c_client i2c_client;
264 u32 i2c_state, i2c_rc;
266 /* config info -- analog */
268 unsigned int tuner_type;
269 unsigned int radio_type;
270 unsigned char tuner_addr;
271 unsigned char radio_addr;
272 unsigned int tda9887_conf;
273 unsigned int has_radio;
275 /* config info -- dvb */
276 struct dvb_pll_desc *pll_desc;
277 unsigned int pll_addr;
280 struct task_struct *kthread;
281 struct cx88_tvnorm *tvnorm;
283 u32 audiomode_manual;
284 u32 audiomode_current;
288 /* IR remote control state */
295 /* ----------------------------------------------------------- */
296 /* function 0: video stuff */
299 struct cx8800_dev *dev;
300 enum v4l2_buf_type type;
302 unsigned int resources;
305 struct v4l2_window win;
306 struct v4l2_clip *clips;
310 struct cx8800_fmt *fmt;
311 unsigned int width,height;
312 struct videobuf_queue vidq;
315 struct videobuf_queue vbiq;
318 struct cx8800_suspend_state {
323 struct cx88_core *core;
324 struct list_head devlist;
325 struct semaphore lock;
328 /* various device info */
329 unsigned int resources;
330 struct video_device *video_dev;
331 struct video_device *vbi_dev;
332 struct video_device *radio_dev;
336 unsigned char pci_rev,pci_lat;
340 struct cx88_dmaqueue vidq;
341 struct cx88_dmaqueue vbiq;
343 /* various v4l controls */
346 /* other global state info */
347 struct cx8800_suspend_state state;
350 /* ----------------------------------------------------------- */
351 /* function 1: audio/alsa stuff */
354 struct cx88_core *core;
358 unsigned char pci_rev,pci_lat;
361 /* ----------------------------------------------------------- */
362 /* function 2: mpeg stuff */
365 struct cx8802_dev *dev;
366 struct videobuf_queue mpegq;
369 struct cx8802_suspend_state {
374 struct cx88_core *core;
375 struct semaphore lock;
380 unsigned char pci_rev,pci_lat;
383 struct cx88_dmaqueue mpegq;
387 /* other global state info */
388 struct cx8802_suspend_state state;
390 /* for blackbird only */
391 struct list_head devlist;
392 struct video_device *mpeg_dev;
398 struct videobuf_dvb dvb;
400 int (*fe_release)(void *handle);
402 /* for switching modulation types */
403 unsigned char ts_gen_cntrl;
406 /* ----------------------------------------------------------- */
408 #define cx_read(reg) readl(core->lmmio + ((reg)>>2))
409 #define cx_write(reg,value) writel((value), core->lmmio + ((reg)>>2))
410 #define cx_writeb(reg,value) writeb((value), core->bmmio + (reg))
412 #define cx_andor(reg,mask,value) \
413 writel((readl(core->lmmio+((reg)>>2)) & ~(mask)) |\
414 ((value) & (mask)), core->lmmio+((reg)>>2))
415 #define cx_set(reg,bit) cx_andor((reg),(bit),(bit))
416 #define cx_clear(reg,bit) cx_andor((reg),(bit),0)
418 #define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
420 /* shadow registers */
421 #define cx_sread(sreg) (core->shadow[sreg])
422 #define cx_swrite(sreg,reg,value) \
423 (core->shadow[sreg] = value, \
424 writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
425 #define cx_sandor(sreg,reg,mask,value) \
426 (core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | ((value) & (mask)), \
427 writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
429 /* ----------------------------------------------------------- */
432 extern void cx88_print_irqbits(char *name, char *tag, char **strings,
434 extern void cx88_print_ioctl(char *name, unsigned int cmd);
436 extern int cx88_core_irq(struct cx88_core *core, u32 status);
437 extern void cx88_wakeup(struct cx88_core *core,
438 struct cx88_dmaqueue *q, u32 count);
439 extern void cx88_shutdown(struct cx88_core *core);
440 extern int cx88_reset(struct cx88_core *core);
443 cx88_risc_buffer(struct pci_dev *pci, struct btcx_riscmem *risc,
444 struct scatterlist *sglist,
445 unsigned int top_offset, unsigned int bottom_offset,
446 unsigned int bpl, unsigned int padding, unsigned int lines);
448 cx88_risc_databuffer(struct pci_dev *pci, struct btcx_riscmem *risc,
449 struct scatterlist *sglist, unsigned int bpl,
452 cx88_risc_stopper(struct pci_dev *pci, struct btcx_riscmem *risc,
453 u32 reg, u32 mask, u32 value);
455 cx88_free_buffer(struct pci_dev *pci, struct cx88_buffer *buf);
457 extern void cx88_risc_disasm(struct cx88_core *core,
458 struct btcx_riscmem *risc);
459 extern int cx88_sram_channel_setup(struct cx88_core *core,
460 struct sram_channel *ch,
461 unsigned int bpl, u32 risc);
462 extern void cx88_sram_channel_dump(struct cx88_core *core,
463 struct sram_channel *ch);
465 extern int cx88_set_scale(struct cx88_core *core, unsigned int width,
466 unsigned int height, enum v4l2_field field);
467 extern int cx88_set_tvnorm(struct cx88_core *core, struct cx88_tvnorm *norm);
469 extern struct video_device *cx88_vdev_init(struct cx88_core *core,
471 struct video_device *template,
473 extern struct cx88_core* cx88_core_get(struct pci_dev *pci);
474 extern void cx88_core_put(struct cx88_core *core,
475 struct pci_dev *pci);
477 /* ----------------------------------------------------------- */
480 void cx8800_vbi_fmt(struct cx8800_dev *dev, struct v4l2_format *f);
482 int cx8800_start_vbi_dma(struct cx8800_dev *dev,
483 struct cx88_dmaqueue *q,
484 struct cx88_buffer *buf);
486 int cx8800_stop_vbi_dma(struct cx8800_dev *dev);
487 int cx8800_restart_vbi_queue(struct cx8800_dev *dev,
488 struct cx88_dmaqueue *q);
489 void cx8800_vbi_timeout(unsigned long data);
491 extern struct videobuf_queue_ops cx8800_vbi_qops;
493 /* ----------------------------------------------------------- */
496 extern int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
497 extern void cx88_call_i2c_clients(struct cx88_core *core,
498 unsigned int cmd, void *arg);
501 /* ----------------------------------------------------------- */
504 extern struct cx88_board cx88_boards[];
505 extern const unsigned int cx88_bcount;
507 extern struct cx88_subid cx88_subids[];
508 extern const unsigned int cx88_idcount;
510 extern void cx88_card_list(struct cx88_core *core, struct pci_dev *pci);
511 extern void cx88_card_setup(struct cx88_core *core);
513 /* ----------------------------------------------------------- */
519 #define WW_NICAM_BGDKL 4
525 #define WW_SYSTEM_L_AM 10
529 void cx88_set_tvaudio(struct cx88_core *core);
530 void cx88_newstation(struct cx88_core *core);
531 void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
532 void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
533 int cx88_audio_thread(void *data);
535 /* ----------------------------------------------------------- */
538 int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
539 int cx88_ir_fini(struct cx88_core *core);
540 void cx88_ir_irq(struct cx88_core *core);
542 /* ----------------------------------------------------------- */
545 int cx8802_buf_prepare(struct cx8802_dev *dev, struct cx88_buffer *buf);
546 void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
547 void cx8802_cancel_buffers(struct cx8802_dev *dev);
549 int cx8802_init_common(struct cx8802_dev *dev);
550 void cx8802_fini_common(struct cx8802_dev *dev);
552 int cx8802_suspend_common(struct pci_dev *pci_dev, pm_message_t state);
553 int cx8802_resume_common(struct pci_dev *pci_dev);