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