xref: /openbmc/linux/drivers/media/pci/cx88/cx88.h (revision 23c2b932)
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-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 
102 static inline unsigned int norm_maxh(v4l2_std_id norm)
103 {
104 	return (norm & V4L2_STD_525_60) ? 480 : 576;
105 }
106 
107 /* ----------------------------------------------------------- */
108 /* static data                                                 */
109 
110 struct cx8800_fmt {
111 	const char  *name;
112 	u32   fourcc;          /* v4l2 format id */
113 	int   depth;
114 	int   flags;
115 	u32   cxformat;
116 };
117 
118 /* ----------------------------------------------------------- */
119 /* SRAM memory management data (see cx88-core.c)               */
120 
121 #define SRAM_CH21 0   /* video */
122 #define SRAM_CH22 1
123 #define SRAM_CH23 2
124 #define SRAM_CH24 3   /* vbi   */
125 #define SRAM_CH25 4   /* audio */
126 #define SRAM_CH26 5
127 #define SRAM_CH28 6   /* mpeg */
128 #define SRAM_CH27 7   /* audio rds */
129 /* more */
130 
131 struct sram_channel {
132 	const char *name;
133 	u32  cmds_start;
134 	u32  ctrl_start;
135 	u32  cdt;
136 	u32  fifo_start;
137 	u32  fifo_size;
138 	u32  ptr1_reg;
139 	u32  ptr2_reg;
140 	u32  cnt1_reg;
141 	u32  cnt2_reg;
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		   width, height;
387 	unsigned		   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, grpid, o, f, ##args); \
431 			if (core->gate_ctrl)			\
432 				core->gate_ctrl(core, 0);	\
433 		}						\
434 	} while (0)
435 
436 #define call_all(core, o, f, args...) call_hw(core, 0, o, f, ##args)
437 
438 #define WM8775_GID      (1 << 0)
439 
440 #define wm8775_s_ctrl(core, id, val) \
441 	do {									\
442 		struct v4l2_ctrl *ctrl_ =					\
443 			v4l2_ctrl_find(core->sd_wm8775->ctrl_handler, id);	\
444 		if (ctrl_ && !core->i2c_rc) {					\
445 			if (core->gate_ctrl)					\
446 				core->gate_ctrl(core, 1);			\
447 			v4l2_ctrl_s_ctrl(ctrl_, val);				\
448 			if (core->gate_ctrl)					\
449 				core->gate_ctrl(core, 0);			\
450 		}								\
451 	} while (0)
452 
453 #define wm8775_g_ctrl(core, id) \
454 	({									\
455 		struct v4l2_ctrl *ctrl_ =					\
456 			v4l2_ctrl_find(core->sd_wm8775->ctrl_handler, id);	\
457 		s32 val = 0;							\
458 		if (ctrl_ && !core->i2c_rc) {					\
459 			if (core->gate_ctrl)					\
460 				core->gate_ctrl(core, 1);			\
461 			val = v4l2_ctrl_g_ctrl(ctrl_);				\
462 			if (core->gate_ctrl)					\
463 				core->gate_ctrl(core, 0);			\
464 		}								\
465 		val;								\
466 	})
467 
468 /* ----------------------------------------------------------- */
469 /* function 0: video stuff                                     */
470 
471 struct cx8800_suspend_state {
472 	int                        disabled;
473 };
474 
475 struct cx8800_dev {
476 	struct cx88_core           *core;
477 	spinlock_t                 slock;
478 
479 	/* various device info */
480 	unsigned int               resources;
481 	struct video_device        video_dev;
482 	struct video_device        vbi_dev;
483 	struct video_device        radio_dev;
484 
485 	/* pci i/o */
486 	struct pci_dev             *pci;
487 	unsigned char              pci_rev,pci_lat;
488 	void			   *alloc_ctx;
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 /* ----------------------------------------------------------- */
510 /* function 2: mpeg stuff                                      */
511 
512 struct cx8802_suspend_state {
513 	int                        disabled;
514 };
515 
516 struct cx8802_driver {
517 	struct cx88_core *core;
518 
519 	/* List of drivers attached to device */
520 	struct list_head drvlist;
521 
522 	/* Type of driver and access required */
523 	enum cx88_board_type type_id;
524 	enum cx8802_board_access hw_access;
525 
526 	/* MPEG 8802 internal only */
527 	int (*suspend)(struct pci_dev *pci_dev, pm_message_t state);
528 	int (*resume)(struct pci_dev *pci_dev);
529 
530 	/* Callers to the following functions must hold core->lock */
531 
532 	/* MPEG 8802 -> mini driver - Driver probe and configuration */
533 	int (*probe)(struct cx8802_driver *drv);
534 	int (*remove)(struct cx8802_driver *drv);
535 
536 	/* MPEG 8802 -> mini driver - Access for hardware control */
537 	int (*advise_acquire)(struct cx8802_driver *drv);
538 	int (*advise_release)(struct cx8802_driver *drv);
539 
540 	/* MPEG 8802 <- mini driver - Access for hardware control */
541 	int (*request_acquire)(struct cx8802_driver *drv);
542 	int (*request_release)(struct cx8802_driver *drv);
543 };
544 
545 struct cx8802_dev {
546 	struct cx88_core           *core;
547 	spinlock_t                 slock;
548 
549 	/* pci i/o */
550 	struct pci_dev             *pci;
551 	unsigned char              pci_rev,pci_lat;
552 	void			   *alloc_ctx;
553 
554 	/* dma queues */
555 	struct cx88_dmaqueue       mpegq;
556 	struct vb2_queue           vb2_mpegq;
557 	u32                        ts_packet_size;
558 	u32                        ts_packet_count;
559 
560 	/* other global state info */
561 	struct cx8802_suspend_state state;
562 
563 	/* for blackbird only */
564 	struct list_head           devlist;
565 #if IS_ENABLED(CONFIG_VIDEO_CX88_BLACKBIRD)
566 	struct video_device        mpeg_dev;
567 	u32                        mailbox;
568 
569 	/* mpeg params */
570 	struct cx2341x_handler     cxhdl;
571 #endif
572 
573 #if IS_ENABLED(CONFIG_VIDEO_CX88_DVB)
574 	/* for dvb only */
575 	struct vb2_dvb_frontends frontends;
576 #endif
577 
578 #if IS_ENABLED(CONFIG_VIDEO_CX88_VP3054)
579 	/* For VP3045 secondary I2C bus support */
580 	struct vp3054_i2c_state	   *vp3054;
581 #endif
582 	/* for switching modulation types */
583 	unsigned char              ts_gen_cntrl;
584 
585 	/* List of attached drivers; must hold core->lock to access */
586 	struct list_head	   drvlist;
587 
588 	struct work_struct	   request_module_wk;
589 };
590 
591 /* ----------------------------------------------------------- */
592 
593 #define cx_read(reg)             readl(core->lmmio + ((reg)>>2))
594 #define cx_write(reg,value)      writel((value), core->lmmio + ((reg)>>2))
595 #define cx_writeb(reg,value)     writeb((value), core->bmmio + (reg))
596 
597 #define cx_andor(reg,mask,value) \
598   writel((readl(core->lmmio+((reg)>>2)) & ~(mask)) |\
599   ((value) & (mask)), core->lmmio+((reg)>>2))
600 #define cx_set(reg,bit)          cx_andor((reg),(bit),(bit))
601 #define cx_clear(reg,bit)        cx_andor((reg),(bit),0)
602 
603 #define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
604 
605 /* shadow registers */
606 #define cx_sread(sreg)		    (core->shadow[sreg])
607 #define cx_swrite(sreg,reg,value) \
608   (core->shadow[sreg] = value, \
609    writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
610 #define cx_sandor(sreg,reg,mask,value) \
611   (core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | ((value) & (mask)), \
612    writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
613 
614 /* ----------------------------------------------------------- */
615 /* cx88-core.c                                                 */
616 
617 extern unsigned int cx88_core_debug;
618 
619 extern void cx88_print_irqbits(const char *name, const char *tag, const char *strings[],
620 			       int len, u32 bits, u32 mask);
621 
622 extern int cx88_core_irq(struct cx88_core *core, u32 status);
623 extern void cx88_wakeup(struct cx88_core *core,
624 			struct cx88_dmaqueue *q, u32 count);
625 extern void cx88_shutdown(struct cx88_core *core);
626 extern int cx88_reset(struct cx88_core *core);
627 
628 extern int
629 cx88_risc_buffer(struct pci_dev *pci, struct cx88_riscmem *risc,
630 		 struct scatterlist *sglist,
631 		 unsigned int top_offset, unsigned int bottom_offset,
632 		 unsigned int bpl, unsigned int padding, unsigned int lines);
633 extern int
634 cx88_risc_databuffer(struct pci_dev *pci, struct cx88_riscmem *risc,
635 		     struct scatterlist *sglist, unsigned int bpl,
636 		     unsigned int lines, unsigned int lpi);
637 
638 extern void cx88_risc_disasm(struct cx88_core *core,
639 			     struct cx88_riscmem *risc);
640 extern int cx88_sram_channel_setup(struct cx88_core *core,
641 				   const struct sram_channel *ch,
642 				   unsigned int bpl, u32 risc);
643 extern void cx88_sram_channel_dump(struct cx88_core *core,
644 				   const struct sram_channel *ch);
645 
646 extern int cx88_set_scale(struct cx88_core *core, unsigned int width,
647 			  unsigned int height, enum v4l2_field field);
648 extern int cx88_set_tvnorm(struct cx88_core *core, v4l2_std_id norm);
649 
650 extern void cx88_vdev_init(struct cx88_core *core,
651 			   struct pci_dev *pci,
652 			   struct video_device *vfd,
653 			   const struct video_device *template_,
654 			   const char *type);
655 extern struct cx88_core *cx88_core_get(struct pci_dev *pci);
656 extern void cx88_core_put(struct cx88_core *core,
657 			  struct pci_dev *pci);
658 
659 extern int cx88_start_audio_dma(struct cx88_core *core);
660 extern int cx88_stop_audio_dma(struct cx88_core *core);
661 
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 /*
671 int cx8800_start_vbi_dma(struct cx8800_dev    *dev,
672 			 struct cx88_dmaqueue *q,
673 			 struct cx88_buffer   *buf);
674 */
675 void cx8800_stop_vbi_dma(struct cx8800_dev *dev);
676 int cx8800_restart_vbi_queue(struct cx8800_dev *dev, struct cx88_dmaqueue *q);
677 
678 extern const struct vb2_ops cx8800_vbi_qops;
679 
680 /* ----------------------------------------------------------- */
681 /* cx88-i2c.c                                                  */
682 
683 extern int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
684 
685 
686 /* ----------------------------------------------------------- */
687 /* cx88-cards.c                                                */
688 
689 extern int cx88_tuner_callback(void *dev, int component, int command, int arg);
690 extern int cx88_get_resources(const struct cx88_core *core,
691 			      struct pci_dev *pci);
692 extern struct cx88_core *cx88_core_create(struct pci_dev *pci, int nr);
693 extern void cx88_setup_xc3028(struct cx88_core *core, struct xc2028_ctrl *ctl);
694 
695 /* ----------------------------------------------------------- */
696 /* cx88-tvaudio.c                                              */
697 
698 void cx88_set_tvaudio(struct cx88_core *core);
699 void cx88_newstation(struct cx88_core *core);
700 void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
701 void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
702 int cx88_audio_thread(void *data);
703 
704 int cx8802_register_driver(struct cx8802_driver *drv);
705 int cx8802_unregister_driver(struct cx8802_driver *drv);
706 
707 /* Caller must hold core->lock */
708 struct cx8802_driver * cx8802_get_driver(struct cx8802_dev *dev, enum cx88_board_type btype);
709 
710 /* ----------------------------------------------------------- */
711 /* cx88-dsp.c                                                  */
712 
713 s32 cx88_dsp_detect_stereo_sap(struct cx88_core *core);
714 
715 /* ----------------------------------------------------------- */
716 /* cx88-input.c                                                */
717 
718 int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
719 int cx88_ir_fini(struct cx88_core *core);
720 void cx88_ir_irq(struct cx88_core *core);
721 int cx88_ir_start(struct cx88_core *core);
722 void cx88_ir_stop(struct cx88_core *core);
723 extern void cx88_i2c_init_ir(struct cx88_core *core);
724 
725 /* ----------------------------------------------------------- */
726 /* cx88-mpeg.c                                                 */
727 
728 int cx8802_buf_prepare(struct vb2_queue *q, struct cx8802_dev *dev,
729 			struct cx88_buffer *buf);
730 void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
731 void cx8802_cancel_buffers(struct cx8802_dev *dev);
732 int cx8802_start_dma(struct cx8802_dev    *dev,
733 			    struct cx88_dmaqueue *q,
734 			    struct cx88_buffer   *buf);
735 
736 /* ----------------------------------------------------------- */
737 /* cx88-video.c*/
738 int cx88_enum_input(struct cx88_core *core, struct v4l2_input *i);
739 int cx88_set_freq(struct cx88_core  *core, const struct v4l2_frequency *f);
740 int cx88_video_mux(struct cx88_core *core, unsigned int input);
741 void cx88_querycap(struct file *file, struct cx88_core *core,
742 		struct v4l2_capability *cap);
743