785fe2e0d702e3ac5614b789c06ba54d705069ec
[sfrench/cifs-2.6.git] / drivers / media / pci / 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/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/cx2341x.h>
34 #include <media/videobuf2-dvb.h>
35 #include <media/ir-kbd-i2c.h>
36 #include <media/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_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);