xref: /linux/drivers/media/pci/cx88/cx88.h (revision e5c86679d5e864947a52fb31e45a425dea3e7fa9)
1 /*
2  * v4l2 device driver for cx2388x based TV cards
3  *
4  * (c) 2003,04 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs]
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  */
16 
17 #ifndef CX88_H
18 #define CX88_H
19 
20 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
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-device.h>
29 #include <media/v4l2-fh.h>
30 #include <media/tuner.h>
31 #include <media/tveeprom.h>
32 #include <media/videobuf2-dma-sg.h>
33 #include <media/drv-intf/cx2341x.h>
34 #include <media/videobuf2-dvb.h>
35 #include <media/i2c/ir-kbd-i2c.h>
36 #include <media/i2c/wm8775.h>
37 
38 #include "cx88-reg.h"
39 #include "tuner-xc2028.h"
40 
41 #include <linux/mutex.h>
42 
43 #define CX88_VERSION "1.0.0"
44 
45 #define UNSET (-1U)
46 
47 #define CX88_MAXBOARDS 8
48 
49 /* Max number of inputs by card */
50 #define MAX_CX88_INPUT 8
51 
52 /* ----------------------------------------------------------- */
53 /* defines and enums                                           */
54 
55 /* Currently unsupported by the driver: PAL/H, NTSC/Kr, SECAM/LC */
56 #define CX88_NORMS (V4L2_STD_ALL		\
57 		    & ~V4L2_STD_PAL_H		\
58 		    & ~V4L2_STD_NTSC_M_KR	\
59 		    & ~V4L2_STD_SECAM_LC)
60 
61 #define FORMAT_FLAGS_PACKED       0x01
62 #define FORMAT_FLAGS_PLANAR       0x02
63 
64 #define VBI_LINE_PAL_COUNT              18
65 #define VBI_LINE_NTSC_COUNT             12
66 #define VBI_LINE_LENGTH           2048
67 
68 #define AUD_RDS_LINES		     4
69 
70 /* need "shadow" registers for some write-only ones ... */
71 #define SHADOW_AUD_VOL_CTL           1
72 #define SHADOW_AUD_BAL_CTL           2
73 #define SHADOW_MAX                   3
74 
75 /* FM Radio deemphasis type */
76 enum cx88_deemph_type {
77 	FM_NO_DEEMPH = 0,
78 	FM_DEEMPH_50,
79 	FM_DEEMPH_75
80 };
81 
82 enum cx88_board_type {
83 	CX88_BOARD_NONE = 0,
84 	CX88_MPEG_DVB,
85 	CX88_MPEG_BLACKBIRD
86 };
87 
88 enum cx8802_board_access {
89 	CX8802_DRVCTL_SHARED    = 1,
90 	CX8802_DRVCTL_EXCLUSIVE = 2,
91 };
92 
93 /* ----------------------------------------------------------- */
94 /* tv norms                                                    */
95 
96 static inline unsigned int norm_maxw(v4l2_std_id norm)
97 {
98 	return 720;
99 }
100 
101 static inline unsigned int norm_maxh(v4l2_std_id norm)
102 {
103 	return (norm & V4L2_STD_525_60) ? 480 : 576;
104 }
105 
106 /* ----------------------------------------------------------- */
107 /* static data                                                 */
108 
109 struct cx8800_fmt {
110 	const char  *name;
111 	u32   fourcc;          /* v4l2 format id */
112 	int   depth;
113 	int   flags;
114 	u32   cxformat;
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 #define SRAM_CH27 7   /* audio rds */
128 /* more */
129 
130 struct sram_channel {
131 	const char *name;
132 	u32  cmds_start;
133 	u32  ctrl_start;
134 	u32  cdt;
135 	u32  fifo_start;
136 	u32  fifo_size;
137 	u32  ptr1_reg;
138 	u32  ptr2_reg;
139 	u32  cnt1_reg;
140 	u32  cnt2_reg;
141 };
142 
143 extern const struct sram_channel cx88_sram_channels[];
144 
145 /* ----------------------------------------------------------- */
146 /* card configuration                                          */
147 
148 #define CX88_BOARD_NOAUTO               UNSET
149 #define CX88_BOARD_UNKNOWN                  0
150 #define CX88_BOARD_HAUPPAUGE                1
151 #define CX88_BOARD_GDI                      2
152 #define CX88_BOARD_PIXELVIEW                3
153 #define CX88_BOARD_ATI_WONDER_PRO           4
154 #define CX88_BOARD_WINFAST2000XP_EXPERT     5
155 #define CX88_BOARD_AVERTV_STUDIO_303        6
156 #define CX88_BOARD_MSI_TVANYWHERE_MASTER    7
157 #define CX88_BOARD_WINFAST_DV2000           8
158 #define CX88_BOARD_LEADTEK_PVR2000          9
159 #define CX88_BOARD_IODATA_GVVCP3PCI        10
160 #define CX88_BOARD_PROLINK_PLAYTVPVR       11
161 #define CX88_BOARD_ASUS_PVR_416            12
162 #define CX88_BOARD_MSI_TVANYWHERE          13
163 #define CX88_BOARD_KWORLD_DVB_T            14
164 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T1 15
165 #define CX88_BOARD_KWORLD_LTV883           16
166 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q  17
167 #define CX88_BOARD_HAUPPAUGE_DVB_T1        18
168 #define CX88_BOARD_CONEXANT_DVB_T1         19
169 #define CX88_BOARD_PROVIDEO_PV259          20
170 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PLUS 21
171 #define CX88_BOARD_PCHDTV_HD3000           22
172 #define CX88_BOARD_DNTV_LIVE_DVB_T         23
173 #define CX88_BOARD_HAUPPAUGE_ROSLYN        24
174 #define CX88_BOARD_DIGITALLOGIC_MEC        25
175 #define CX88_BOARD_IODATA_GVBCTV7E         26
176 #define CX88_BOARD_PIXELVIEW_PLAYTV_ULTRA_PRO 27
177 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T  28
178 #define CX88_BOARD_ADSTECH_DVB_T_PCI          29
179 #define CX88_BOARD_TERRATEC_CINERGY_1400_DVB_T1  30
180 #define CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD 31
181 #define CX88_BOARD_AVERMEDIA_ULTRATV_MC_550 32
182 #define CX88_BOARD_KWORLD_VSTREAM_EXPERT_DVD 33
183 #define CX88_BOARD_ATI_HDTVWONDER          34
184 #define CX88_BOARD_WINFAST_DTV1000         35
185 #define CX88_BOARD_AVERTV_303              36
186 #define CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1  37
187 #define CX88_BOARD_HAUPPAUGE_NOVASE2_S1    38
188 #define CX88_BOARD_KWORLD_DVBS_100         39
189 #define CX88_BOARD_HAUPPAUGE_HVR1100       40
190 #define CX88_BOARD_HAUPPAUGE_HVR1100LP     41
191 #define CX88_BOARD_DNTV_LIVE_DVB_T_PRO     42
192 #define CX88_BOARD_KWORLD_DVB_T_CX22702    43
193 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_DUAL 44
194 #define CX88_BOARD_KWORLD_HARDWARE_MPEG_TV_XPERT 45
195 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_HYBRID 46
196 #define CX88_BOARD_PCHDTV_HD5500           47
197 #define CX88_BOARD_KWORLD_MCE200_DELUXE    48
198 #define CX88_BOARD_PIXELVIEW_PLAYTV_P7000  49
199 #define CX88_BOARD_NPGTECH_REALTV_TOP10FM  50
200 #define CX88_BOARD_WINFAST_DTV2000H        51
201 #define CX88_BOARD_GENIATECH_DVBS          52
202 #define CX88_BOARD_HAUPPAUGE_HVR3000       53
203 #define CX88_BOARD_NORWOOD_MICRO           54
204 #define CX88_BOARD_TE_DTV_250_OEM_SWANN    55
205 #define CX88_BOARD_HAUPPAUGE_HVR1300       56
206 #define CX88_BOARD_ADSTECH_PTV_390         57
207 #define CX88_BOARD_PINNACLE_PCTV_HD_800i   58
208 #define CX88_BOARD_DVICO_FUSIONHDTV_5_PCI_NANO 59
209 #define CX88_BOARD_PINNACLE_HYBRID_PCTV    60
210 #define CX88_BOARD_WINFAST_TV2000_XP_GLOBAL 61
211 #define CX88_BOARD_POWERCOLOR_REAL_ANGEL   62
212 #define CX88_BOARD_GENIATECH_X8000_MT      63
213 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PRO 64
214 #define CX88_BOARD_DVICO_FUSIONHDTV_7_GOLD 65
215 #define CX88_BOARD_PROLINK_PV_8000GT       66
216 #define CX88_BOARD_KWORLD_ATSC_120         67
217 #define CX88_BOARD_HAUPPAUGE_HVR4000       68
218 #define CX88_BOARD_HAUPPAUGE_HVR4000LITE   69
219 #define CX88_BOARD_TEVII_S460              70
220 #define CX88_BOARD_OMICOM_SS4_PCI          71
221 #define CX88_BOARD_TBS_8920                72
222 #define CX88_BOARD_TEVII_S420              73
223 #define CX88_BOARD_PROLINK_PV_GLOBAL_XTREME 74
224 #define CX88_BOARD_PROF_7300               75
225 #define CX88_BOARD_SATTRADE_ST4200         76
226 #define CX88_BOARD_TBS_8910                77
227 #define CX88_BOARD_PROF_6200               78
228 #define CX88_BOARD_TERRATEC_CINERGY_HT_PCI_MKII 79
229 #define CX88_BOARD_HAUPPAUGE_IRONLY        80
230 #define CX88_BOARD_WINFAST_DTV1800H        81
231 #define CX88_BOARD_WINFAST_DTV2000H_J      82
232 #define CX88_BOARD_PROF_7301               83
233 #define CX88_BOARD_SAMSUNG_SMT_7020        84
234 #define CX88_BOARD_TWINHAN_VP1027_DVBS     85
235 #define CX88_BOARD_TEVII_S464              86
236 #define CX88_BOARD_WINFAST_DTV2000H_PLUS   87
237 #define CX88_BOARD_WINFAST_DTV1800H_XC4000 88
238 #define CX88_BOARD_WINFAST_TV2000_XP_GLOBAL_6F36 89
239 #define CX88_BOARD_WINFAST_TV2000_XP_GLOBAL_6F43 90
240 
241 enum cx88_itype {
242 	CX88_VMUX_COMPOSITE1 = 1,
243 	CX88_VMUX_COMPOSITE2,
244 	CX88_VMUX_COMPOSITE3,
245 	CX88_VMUX_COMPOSITE4,
246 	CX88_VMUX_SVIDEO,
247 	CX88_VMUX_TELEVISION,
248 	CX88_VMUX_CABLE,
249 	CX88_VMUX_DVB,
250 	CX88_VMUX_DEBUG,
251 	CX88_RADIO,
252 };
253 
254 struct cx88_input {
255 	enum cx88_itype type;
256 	u32             gpio0, gpio1, gpio2, gpio3;
257 	unsigned int    vmux:2;
258 	unsigned int    audioroute:4;
259 };
260 
261 enum cx88_audio_chip {
262 	CX88_AUDIO_WM8775 = 1,
263 	CX88_AUDIO_TVAUDIO,
264 };
265 
266 struct cx88_board {
267 	const char              *name;
268 	unsigned int            tuner_type;
269 	unsigned int		radio_type;
270 	unsigned char		tuner_addr;
271 	unsigned char		radio_addr;
272 	int                     tda9887_conf;
273 	struct cx88_input       input[MAX_CX88_INPUT];
274 	struct cx88_input       radio;
275 	enum cx88_board_type    mpeg;
276 	enum cx88_audio_chip	audio_chip;
277 	int			num_frontends;
278 
279 	/* Used for I2S devices */
280 	int			i2sinputcntl;
281 };
282 
283 struct cx88_subid {
284 	u16     subvendor;
285 	u16     subdevice;
286 	u32     card;
287 };
288 
289 enum cx88_tvaudio {
290 	WW_NONE = 1,
291 	WW_BTSC,
292 	WW_BG,
293 	WW_DK,
294 	WW_I,
295 	WW_L,
296 	WW_EIAJ,
297 	WW_I2SPT,
298 	WW_FM,
299 	WW_I2SADC,
300 	WW_M
301 };
302 
303 #define INPUT(nr) (core->board.input[nr])
304 
305 /* ----------------------------------------------------------- */
306 /* device / file handle status                                 */
307 
308 #define RESOURCE_OVERLAY       1
309 #define RESOURCE_VIDEO         2
310 #define RESOURCE_VBI           4
311 
312 #define BUFFER_TIMEOUT     msecs_to_jiffies(2000)
313 
314 struct cx88_riscmem {
315 	unsigned int   size;
316 	__le32         *cpu;
317 	__le32         *jmp;
318 	dma_addr_t     dma;
319 };
320 
321 /* buffer for one video frame */
322 struct cx88_buffer {
323 	/* common v4l buffer stuff -- must be first */
324 	struct vb2_v4l2_buffer vb;
325 	struct list_head       list;
326 
327 	/* cx88 specific */
328 	unsigned int           bpl;
329 	struct cx88_riscmem    risc;
330 };
331 
332 struct cx88_dmaqueue {
333 	struct list_head       active;
334 	u32                    count;
335 };
336 
337 struct cx8800_dev;
338 struct cx8802_dev;
339 
340 struct cx88_core {
341 	struct list_head           devlist;
342 	atomic_t                   refcount;
343 
344 	/* board name */
345 	int                        nr;
346 	char                       name[32];
347 	u32			   model;
348 
349 	/* pci stuff */
350 	int                        pci_bus;
351 	int                        pci_slot;
352 	u32                        __iomem *lmmio;
353 	u8                         __iomem *bmmio;
354 	u32                        shadow[SHADOW_MAX];
355 	int                        pci_irqmask;
356 
357 	/* i2c i/o */
358 	struct i2c_adapter         i2c_adap;
359 	struct i2c_algo_bit_data   i2c_algo;
360 	struct i2c_client          i2c_client;
361 	u32                        i2c_state, i2c_rc;
362 
363 	/* config info -- analog */
364 	struct v4l2_device	   v4l2_dev;
365 	struct v4l2_ctrl_handler   video_hdl;
366 	struct v4l2_ctrl	   *chroma_agc;
367 	struct v4l2_ctrl_handler   audio_hdl;
368 	struct v4l2_subdev	   *sd_wm8775;
369 	struct i2c_client	   *i2c_rtc;
370 	unsigned int               boardnr;
371 	struct cx88_board	   board;
372 
373 	/* Supported V4L _STD_ tuner formats */
374 	unsigned int               tuner_formats;
375 
376 	/* config info -- dvb */
377 #if IS_ENABLED(CONFIG_VIDEO_CX88_DVB)
378 	int	(*prev_set_voltage)(struct dvb_frontend *fe,
379 				    enum fe_sec_voltage voltage);
380 #endif
381 	void	(*gate_ctrl)(struct cx88_core *core, int open);
382 
383 	/* state info */
384 	struct task_struct         *kthread;
385 	v4l2_std_id                tvnorm;
386 	unsigned int		   width, height;
387 	unsigned int		   field;
388 	enum cx88_tvaudio          tvaudio;
389 	u32                        audiomode_manual;
390 	u32                        audiomode_current;
391 	u32                        input;
392 	u32                        last_analog_input;
393 	u32                        astat;
394 	u32			   use_nicam;
395 	unsigned long		   last_change;
396 
397 	/* IR remote control state */
398 	struct cx88_IR             *ir;
399 
400 	/* I2C remote data */
401 	struct IR_i2c_init_data    init_data;
402 	struct wm8775_platform_data wm8775_data;
403 
404 	struct mutex               lock;
405 	/* various v4l controls */
406 	u32                        freq;
407 
408 	/*
409 	 * cx88-video needs to access cx8802 for hybrid tuner pll access and
410 	 * for vb2_is_busy() checks.
411 	 */
412 	struct cx8802_dev          *dvbdev;
413 	/* cx88-blackbird needs to access cx8800 for vb2_is_busy() checks */
414 	struct cx8800_dev          *v4ldev;
415 	enum cx88_board_type       active_type_id;
416 	int			   active_ref;
417 	int			   active_fe_id;
418 };
419 
420 static inline struct cx88_core *to_core(struct v4l2_device *v4l2_dev)
421 {
422 	return container_of(v4l2_dev, struct cx88_core, v4l2_dev);
423 }
424 
425 #define call_hw(core, grpid, o, f, args...) \
426 	do {							\
427 		if (!core->i2c_rc) {				\
428 			if (core->gate_ctrl)			\
429 				core->gate_ctrl(core, 1);	\
430 			v4l2_device_call_all(&core->v4l2_dev,	\
431 					     grpid, o, f, ##args); \
432 			if (core->gate_ctrl)			\
433 				core->gate_ctrl(core, 0);	\
434 		}						\
435 	} while (0)
436 
437 #define call_all(core, o, f, args...) call_hw(core, 0, o, f, ##args)
438 
439 #define WM8775_GID      (1 << 0)
440 
441 #define wm8775_s_ctrl(core, id, val) \
442 	do {								\
443 		struct v4l2_ctrl *ctrl_ =				\
444 			v4l2_ctrl_find(core->sd_wm8775->ctrl_handler, id);\
445 		if (ctrl_ && !core->i2c_rc) {				\
446 			if (core->gate_ctrl)				\
447 				core->gate_ctrl(core, 1);		\
448 			v4l2_ctrl_s_ctrl(ctrl_, val);			\
449 			if (core->gate_ctrl)				\
450 				core->gate_ctrl(core, 0);		\
451 		}							\
452 	} while (0)
453 
454 #define wm8775_g_ctrl(core, id) \
455 	({								\
456 		struct v4l2_ctrl *ctrl_ =				\
457 			v4l2_ctrl_find(core->sd_wm8775->ctrl_handler, id);\
458 		s32 val = 0;						\
459 		if (ctrl_ && !core->i2c_rc) {				\
460 			if (core->gate_ctrl)				\
461 				core->gate_ctrl(core, 1);		\
462 			val = v4l2_ctrl_g_ctrl(ctrl_);			\
463 			if (core->gate_ctrl)				\
464 				core->gate_ctrl(core, 0);		\
465 		}							\
466 		val;							\
467 	})
468 
469 /* ----------------------------------------------------------- */
470 /* function 0: video stuff                                     */
471 
472 struct cx8800_suspend_state {
473 	int                        disabled;
474 };
475 
476 struct cx8800_dev {
477 	struct cx88_core           *core;
478 	spinlock_t                 slock;
479 
480 	/* various device info */
481 	unsigned int               resources;
482 	struct video_device        video_dev;
483 	struct video_device        vbi_dev;
484 	struct video_device        radio_dev;
485 
486 	/* pci i/o */
487 	struct pci_dev             *pci;
488 	unsigned char              pci_rev, pci_lat;
489 
490 	const struct cx8800_fmt    *fmt;
491 
492 	/* capture queues */
493 	struct cx88_dmaqueue       vidq;
494 	struct vb2_queue           vb2_vidq;
495 	struct cx88_dmaqueue       vbiq;
496 	struct vb2_queue           vb2_vbiq;
497 
498 	/* various v4l controls */
499 
500 	/* other global state info */
501 	struct cx8800_suspend_state state;
502 };
503 
504 /* ----------------------------------------------------------- */
505 /* function 1: audio/alsa stuff                                */
506 /* =============> moved to cx88-alsa.c <====================== */
507 
508 /* ----------------------------------------------------------- */
509 /* function 2: mpeg stuff                                      */
510 
511 struct cx8802_suspend_state {
512 	int                        disabled;
513 };
514 
515 struct cx8802_driver {
516 	struct cx88_core *core;
517 
518 	/* List of drivers attached to device */
519 	struct list_head drvlist;
520 
521 	/* Type of driver and access required */
522 	enum cx88_board_type type_id;
523 	enum cx8802_board_access hw_access;
524 
525 	/* MPEG 8802 internal only */
526 	int (*suspend)(struct pci_dev *pci_dev, pm_message_t state);
527 	int (*resume)(struct pci_dev *pci_dev);
528 
529 	/* Callers to the following functions must hold core->lock */
530 
531 	/* MPEG 8802 -> mini driver - Driver probe and configuration */
532 	int (*probe)(struct cx8802_driver *drv);
533 	int (*remove)(struct cx8802_driver *drv);
534 
535 	/* MPEG 8802 -> mini driver - Access for hardware control */
536 	int (*advise_acquire)(struct cx8802_driver *drv);
537 	int (*advise_release)(struct cx8802_driver *drv);
538 
539 	/* MPEG 8802 <- mini driver - Access for hardware control */
540 	int (*request_acquire)(struct cx8802_driver *drv);
541 	int (*request_release)(struct cx8802_driver *drv);
542 };
543 
544 struct cx8802_dev {
545 	struct cx88_core           *core;
546 	spinlock_t                 slock;
547 
548 	/* pci i/o */
549 	struct pci_dev             *pci;
550 	unsigned char              pci_rev, pci_lat;
551 
552 	/* dma queues */
553 	struct cx88_dmaqueue       mpegq;
554 	struct vb2_queue           vb2_mpegq;
555 	u32                        ts_packet_size;
556 	u32                        ts_packet_count;
557 
558 	/* other global state info */
559 	struct cx8802_suspend_state state;
560 
561 	/* for blackbird only */
562 	struct list_head           devlist;
563 #if IS_ENABLED(CONFIG_VIDEO_CX88_BLACKBIRD)
564 	struct video_device        mpeg_dev;
565 	u32                        mailbox;
566 
567 	/* mpeg params */
568 	struct cx2341x_handler     cxhdl;
569 
570 #endif
571 
572 #if IS_ENABLED(CONFIG_VIDEO_CX88_DVB)
573 	/* for dvb only */
574 	struct vb2_dvb_frontends frontends;
575 #endif
576 
577 #if IS_ENABLED(CONFIG_VIDEO_CX88_VP3054)
578 	/* For VP3045 secondary I2C bus support */
579 	struct vp3054_i2c_state	   *vp3054;
580 #endif
581 	/* for switching modulation types */
582 	unsigned char              ts_gen_cntrl;
583 
584 	/* List of attached drivers; must hold core->lock to access */
585 	struct list_head	   drvlist;
586 
587 	struct work_struct	   request_module_wk;
588 };
589 
590 /* ----------------------------------------------------------- */
591 
592 #define cx_read(reg)             readl(core->lmmio + ((reg) >> 2))
593 #define cx_write(reg, value)     writel((value), core->lmmio + ((reg) >> 2))
594 #define cx_writeb(reg, value)    writeb((value), core->bmmio + (reg))
595 
596 #define cx_andor(reg, mask, value) \
597 	writel((readl(core->lmmio + ((reg) >> 2)) & ~(mask)) |\
598 	((value) & (mask)), core->lmmio + ((reg) >> 2))
599 #define cx_set(reg, bit)         cx_andor((reg), (bit), (bit))
600 #define cx_clear(reg, bit)       cx_andor((reg), (bit), 0)
601 
602 #define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
603 
604 /* shadow registers */
605 #define cx_sread(sreg)		    (core->shadow[sreg])
606 #define cx_swrite(sreg, reg, value) \
607 	(core->shadow[sreg] = value, \
608 	writel(core->shadow[sreg], core->lmmio + ((reg) >> 2)))
609 #define cx_sandor(sreg, reg, mask, value) \
610 	(core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | \
611 			       ((value) & (mask)), \
612 				writel(core->shadow[sreg], \
613 				       core->lmmio + ((reg) >> 2)))
614 
615 /* ----------------------------------------------------------- */
616 /* cx88-core.c                                                 */
617 
618 extern unsigned int cx88_core_debug;
619 
620 void cx88_print_irqbits(const char *tag, const char *strings[],
621 			int len, u32 bits, u32 mask);
622 
623 int cx88_core_irq(struct cx88_core *core, u32 status);
624 void cx88_wakeup(struct cx88_core *core,
625 		 struct cx88_dmaqueue *q, u32 count);
626 void cx88_shutdown(struct cx88_core *core);
627 int cx88_reset(struct cx88_core *core);
628 
629 extern int
630 cx88_risc_buffer(struct pci_dev *pci, struct cx88_riscmem *risc,
631 		 struct scatterlist *sglist,
632 		 unsigned int top_offset, unsigned int bottom_offset,
633 		 unsigned int bpl, unsigned int padding, unsigned int lines);
634 extern int
635 cx88_risc_databuffer(struct pci_dev *pci, struct cx88_riscmem *risc,
636 		     struct scatterlist *sglist, unsigned int bpl,
637 		     unsigned int lines, unsigned int lpi);
638 
639 void cx88_risc_disasm(struct cx88_core *core,
640 		      struct cx88_riscmem *risc);
641 int cx88_sram_channel_setup(struct cx88_core *core,
642 			    const struct sram_channel *ch,
643 			    unsigned int bpl, u32 risc);
644 void cx88_sram_channel_dump(struct cx88_core *core,
645 			    const struct sram_channel *ch);
646 
647 int cx88_set_scale(struct cx88_core *core, unsigned int width,
648 		   unsigned int height, enum v4l2_field field);
649 int cx88_set_tvnorm(struct cx88_core *core, v4l2_std_id norm);
650 
651 void cx88_vdev_init(struct cx88_core *core,
652 		    struct pci_dev *pci,
653 		    struct video_device *vfd,
654 		    const struct video_device *template_,
655 		    const char *type);
656 struct cx88_core *cx88_core_get(struct pci_dev *pci);
657 void cx88_core_put(struct cx88_core *core,
658 		   struct pci_dev *pci);
659 
660 int cx88_start_audio_dma(struct cx88_core *core);
661 int cx88_stop_audio_dma(struct cx88_core *core);
662 
663 /* ----------------------------------------------------------- */
664 /* cx88-vbi.c                                                  */
665 
666 /* Can be used as g_vbi_fmt, try_vbi_fmt and s_vbi_fmt */
667 int cx8800_vbi_fmt(struct file *file, void *priv,
668 		   struct v4l2_format *f);
669 
670 void cx8800_stop_vbi_dma(struct cx8800_dev *dev);
671 int cx8800_restart_vbi_queue(struct cx8800_dev *dev, struct cx88_dmaqueue *q);
672 
673 extern const struct vb2_ops cx8800_vbi_qops;
674 
675 /* ----------------------------------------------------------- */
676 /* cx88-i2c.c                                                  */
677 
678 int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
679 
680 /* ----------------------------------------------------------- */
681 /* cx88-cards.c                                                */
682 
683 int cx88_tuner_callback(void *dev, int component, int command, int arg);
684 int cx88_get_resources(const struct cx88_core *core,
685 		       struct pci_dev *pci);
686 struct cx88_core *cx88_core_create(struct pci_dev *pci, int nr);
687 void cx88_setup_xc3028(struct cx88_core *core, struct xc2028_ctrl *ctl);
688 
689 /* ----------------------------------------------------------- */
690 /* cx88-tvaudio.c                                              */
691 
692 void cx88_set_tvaudio(struct cx88_core *core);
693 void cx88_newstation(struct cx88_core *core);
694 void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
695 void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
696 int cx88_audio_thread(void *data);
697 
698 int cx8802_register_driver(struct cx8802_driver *drv);
699 int cx8802_unregister_driver(struct cx8802_driver *drv);
700 
701 /* Caller must hold core->lock */
702 struct cx8802_driver *cx8802_get_driver(struct cx8802_dev *dev,
703 					enum cx88_board_type btype);
704 
705 /* ----------------------------------------------------------- */
706 /* cx88-dsp.c                                                  */
707 
708 s32 cx88_dsp_detect_stereo_sap(struct cx88_core *core);
709 
710 /* ----------------------------------------------------------- */
711 /* cx88-input.c                                                */
712 
713 int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
714 int cx88_ir_fini(struct cx88_core *core);
715 void cx88_ir_irq(struct cx88_core *core);
716 int cx88_ir_start(struct cx88_core *core);
717 void cx88_ir_stop(struct cx88_core *core);
718 void cx88_i2c_init_ir(struct cx88_core *core);
719 
720 /* ----------------------------------------------------------- */
721 /* cx88-mpeg.c                                                 */
722 
723 int cx8802_buf_prepare(struct vb2_queue *q, struct cx8802_dev *dev,
724 		       struct cx88_buffer *buf);
725 void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
726 void cx8802_cancel_buffers(struct cx8802_dev *dev);
727 int cx8802_start_dma(struct cx8802_dev    *dev,
728 		     struct cx88_dmaqueue *q,
729 		     struct cx88_buffer   *buf);
730 
731 /* ----------------------------------------------------------- */
732 /* cx88-video.c*/
733 int cx88_enum_input(struct cx88_core *core, struct v4l2_input *i);
734 int cx88_set_freq(struct cx88_core  *core, const struct v4l2_frequency *f);
735 int cx88_video_mux(struct cx88_core *core, unsigned int input);
736 void cx88_querycap(struct file *file, struct cx88_core *core,
737 		   struct v4l2_capability *cap);
738 
739 #endif
740