xref: /linux/drivers/media/pci/saa7134/saa7134.h (revision c411ed854584a71b0e86ac3019b60e4789d88086)
1 /*
2  *
3  * v4l2 device driver for philips saa7134 based TV cards
4  *
5  * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org>
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 
18 #define SAA7134_VERSION "0, 2, 17"
19 
20 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
21 
22 #include <linux/pci.h>
23 #include <linux/i2c.h>
24 #include <linux/videodev2.h>
25 #include <linux/kdev_t.h>
26 #include <linux/input.h>
27 #include <linux/notifier.h>
28 #include <linux/delay.h>
29 #include <linux/mutex.h>
30 #include <linux/pm_qos.h>
31 
32 #include <asm/io.h>
33 
34 #include <media/v4l2-common.h>
35 #include <media/v4l2-ioctl.h>
36 #include <media/v4l2-device.h>
37 #include <media/v4l2-fh.h>
38 #include <media/v4l2-ctrls.h>
39 #include <media/tuner.h>
40 #include <media/rc-core.h>
41 #include <media/i2c/ir-kbd-i2c.h>
42 #include <media/videobuf2-dma-sg.h>
43 #include <sound/core.h>
44 #include <sound/pcm.h>
45 #if IS_ENABLED(CONFIG_VIDEO_SAA7134_DVB)
46 #include <media/videobuf2-dvb.h>
47 #endif
48 #include "tda8290.h"
49 
50 #define UNSET (-1U)
51 
52 /* ----------------------------------------------------------- */
53 /* enums                                                       */
54 
55 enum saa7134_tvaudio_mode {
56 	TVAUDIO_FM_MONO       = 1,
57 	TVAUDIO_FM_BG_STEREO  = 2,
58 	TVAUDIO_FM_SAT_STEREO = 3,
59 	TVAUDIO_FM_K_STEREO   = 4,
60 	TVAUDIO_NICAM_AM      = 5,
61 	TVAUDIO_NICAM_FM      = 6,
62 };
63 
64 enum saa7134_audio_in {
65 	TV    = 1,
66 	LINE1 = 2,
67 	LINE2 = 3,
68 	LINE2_LEFT,
69 };
70 
71 enum saa7134_video_out {
72 	CCIR656 = 1,
73 };
74 
75 /* ----------------------------------------------------------- */
76 /* static data                                                 */
77 
78 struct saa7134_tvnorm {
79 	char          *name;
80 	v4l2_std_id   id;
81 
82 	/* video decoder */
83 	unsigned int  sync_control;
84 	unsigned int  luma_control;
85 	unsigned int  chroma_ctrl1;
86 	unsigned int  chroma_gain;
87 	unsigned int  chroma_ctrl2;
88 	unsigned int  vgate_misc;
89 
90 	/* video scaler */
91 	unsigned int  h_start;
92 	unsigned int  h_stop;
93 	unsigned int  video_v_start;
94 	unsigned int  video_v_stop;
95 	unsigned int  vbi_v_start_0;
96 	unsigned int  vbi_v_stop_0;
97 	unsigned int  src_timing;
98 	unsigned int  vbi_v_start_1;
99 };
100 
101 struct saa7134_tvaudio {
102 	char         *name;
103 	v4l2_std_id  std;
104 	enum         saa7134_tvaudio_mode mode;
105 	int          carr1;
106 	int          carr2;
107 };
108 
109 struct saa7134_format {
110 	char           *name;
111 	unsigned int   fourcc;
112 	unsigned int   depth;
113 	unsigned int   pm;
114 	unsigned int   vshift;   /* vertical downsampling (for planar yuv) */
115 	unsigned int   hshift;   /* horizontal downsampling (for planar yuv) */
116 	unsigned int   bswap:1;
117 	unsigned int   wswap:1;
118 	unsigned int   yuv:1;
119 	unsigned int   planar:1;
120 	unsigned int   uvswap:1;
121 };
122 
123 struct saa7134_card_ir {
124 	struct rc_dev		*dev;
125 
126 	char                    name[32];
127 	char                    phys[32];
128 	unsigned                users;
129 
130 	u32			polling;
131 	u32			last_gpio;
132 	u32			mask_keycode, mask_keydown, mask_keyup;
133 
134 	bool                    running;
135 
136 	struct timer_list       timer;
137 
138 	/* IR core raw decoding */
139 	u32                     raw_decode;
140 };
141 
142 /* ----------------------------------------------------------- */
143 /* card configuration                                          */
144 
145 #define SAA7134_BOARD_NOAUTO        UNSET
146 #define SAA7134_BOARD_UNKNOWN           0
147 #define SAA7134_BOARD_PROTEUS_PRO       1
148 #define SAA7134_BOARD_FLYVIDEO3000      2
149 #define SAA7134_BOARD_FLYVIDEO2000      3
150 #define SAA7134_BOARD_EMPRESS           4
151 #define SAA7134_BOARD_MONSTERTV         5
152 #define SAA7134_BOARD_MD9717            6
153 #define SAA7134_BOARD_TVSTATION_RDS     7
154 #define SAA7134_BOARD_CINERGY400	8
155 #define SAA7134_BOARD_MD5044		9
156 #define SAA7134_BOARD_KWORLD           10
157 #define SAA7134_BOARD_CINERGY600       11
158 #define SAA7134_BOARD_MD7134           12
159 #define SAA7134_BOARD_TYPHOON_90031    13
160 #define SAA7134_BOARD_ELSA             14
161 #define SAA7134_BOARD_ELSA_500TV       15
162 #define SAA7134_BOARD_ASUSTeK_TVFM7134 16
163 #define SAA7134_BOARD_VA1000POWER      17
164 #define SAA7134_BOARD_BMK_MPEX_NOTUNER 18
165 #define SAA7134_BOARD_VIDEOMATE_TV     19
166 #define SAA7134_BOARD_CRONOS_PLUS      20
167 #define SAA7134_BOARD_10MOONSTVMASTER  21
168 #define SAA7134_BOARD_MD2819           22
169 #define SAA7134_BOARD_BMK_MPEX_TUNER   23
170 #define SAA7134_BOARD_TVSTATION_DVR    24
171 #define SAA7134_BOARD_ASUSTEK_TVFM7133	25
172 #define SAA7134_BOARD_PINNACLE_PCTV_STEREO 26
173 #define SAA7134_BOARD_MANLI_MTV002     27
174 #define SAA7134_BOARD_MANLI_MTV001     28
175 #define SAA7134_BOARD_TG3000TV         29
176 #define SAA7134_BOARD_ECS_TVP3XP       30
177 #define SAA7134_BOARD_ECS_TVP3XP_4CB5  31
178 #define SAA7134_BOARD_AVACSSMARTTV     32
179 #define SAA7134_BOARD_AVERMEDIA_DVD_EZMAKER 33
180 #define SAA7134_BOARD_NOVAC_PRIMETV7133 34
181 #define SAA7134_BOARD_AVERMEDIA_STUDIO_305 35
182 #define SAA7134_BOARD_UPMOST_PURPLE_TV 36
183 #define SAA7134_BOARD_ITEMS_MTV005     37
184 #define SAA7134_BOARD_CINERGY200       38
185 #define SAA7134_BOARD_FLYTVPLATINUM_MINI 39
186 #define SAA7134_BOARD_VIDEOMATE_TV_PVR 40
187 #define SAA7134_BOARD_VIDEOMATE_TV_GOLD_PLUS 41
188 #define SAA7134_BOARD_SABRENT_SBTTVFM  42
189 #define SAA7134_BOARD_ZOLID_XPERT_TV7134 43
190 #define SAA7134_BOARD_EMPIRE_PCI_TV_RADIO_LE 44
191 #define SAA7134_BOARD_AVERMEDIA_STUDIO_307    45
192 #define SAA7134_BOARD_AVERMEDIA_CARDBUS 46
193 #define SAA7134_BOARD_CINERGY400_CARDBUS 47
194 #define SAA7134_BOARD_CINERGY600_MK3   48
195 #define SAA7134_BOARD_VIDEOMATE_GOLD_PLUS 49
196 #define SAA7134_BOARD_PINNACLE_300I_DVBT_PAL 50
197 #define SAA7134_BOARD_PROVIDEO_PV952   51
198 #define SAA7134_BOARD_AVERMEDIA_305    52
199 #define SAA7134_BOARD_ASUSTeK_TVFM7135 53
200 #define SAA7134_BOARD_FLYTVPLATINUM_FM 54
201 #define SAA7134_BOARD_FLYDVBTDUO 55
202 #define SAA7134_BOARD_AVERMEDIA_307    56
203 #define SAA7134_BOARD_AVERMEDIA_GO_007_FM 57
204 #define SAA7134_BOARD_ADS_INSTANT_TV 58
205 #define SAA7134_BOARD_KWORLD_VSTREAM_XPERT 59
206 #define SAA7134_BOARD_FLYDVBT_DUO_CARDBUS 60
207 #define SAA7134_BOARD_PHILIPS_TOUGH 61
208 #define SAA7134_BOARD_VIDEOMATE_TV_GOLD_PLUSII 62
209 #define SAA7134_BOARD_KWORLD_XPERT 63
210 #define SAA7134_BOARD_FLYTV_DIGIMATRIX 64
211 #define SAA7134_BOARD_KWORLD_TERMINATOR 65
212 #define SAA7134_BOARD_YUAN_TUN900 66
213 #define SAA7134_BOARD_BEHOLD_409FM 67
214 #define SAA7134_BOARD_GOTVIEW_7135 68
215 #define SAA7134_BOARD_PHILIPS_EUROPA  69
216 #define SAA7134_BOARD_VIDEOMATE_DVBT_300 70
217 #define SAA7134_BOARD_VIDEOMATE_DVBT_200 71
218 #define SAA7134_BOARD_RTD_VFG7350 72
219 #define SAA7134_BOARD_RTD_VFG7330 73
220 #define SAA7134_BOARD_FLYTVPLATINUM_MINI2 74
221 #define SAA7134_BOARD_AVERMEDIA_AVERTVHD_A180 75
222 #define SAA7134_BOARD_MONSTERTV_MOBILE 76
223 #define SAA7134_BOARD_PINNACLE_PCTV_110i 77
224 #define SAA7134_BOARD_ASUSTeK_P7131_DUAL 78
225 #define SAA7134_BOARD_SEDNA_PC_TV_CARDBUS     79
226 #define SAA7134_BOARD_ASUSTEK_DIGIMATRIX_TV 80
227 #define SAA7134_BOARD_PHILIPS_TIGER  81
228 #define SAA7134_BOARD_MSI_TVATANYWHERE_PLUS  82
229 #define SAA7134_BOARD_CINERGY250PCI 83
230 #define SAA7134_BOARD_FLYDVB_TRIO 84
231 #define SAA7134_BOARD_AVERMEDIA_777 85
232 #define SAA7134_BOARD_FLYDVBT_LR301 86
233 #define SAA7134_BOARD_ADS_DUO_CARDBUS_PTV331 87
234 #define SAA7134_BOARD_TEVION_DVBT_220RF 88
235 #define SAA7134_BOARD_ELSA_700TV       89
236 #define SAA7134_BOARD_KWORLD_ATSC110   90
237 #define SAA7134_BOARD_AVERMEDIA_A169_B 91
238 #define SAA7134_BOARD_AVERMEDIA_A169_B1 92
239 #define SAA7134_BOARD_MD7134_BRIDGE_2     93
240 #define SAA7134_BOARD_FLYDVBT_HYBRID_CARDBUS 94
241 #define SAA7134_BOARD_FLYVIDEO3000_NTSC 95
242 #define SAA7134_BOARD_MEDION_MD8800_QUADRO 96
243 #define SAA7134_BOARD_FLYDVBS_LR300 97
244 #define SAA7134_BOARD_PROTEUS_2309 98
245 #define SAA7134_BOARD_AVERMEDIA_A16AR   99
246 #define SAA7134_BOARD_ASUS_EUROPA2_HYBRID 100
247 #define SAA7134_BOARD_PINNACLE_PCTV_310i  101
248 #define SAA7134_BOARD_AVERMEDIA_STUDIO_507 102
249 #define SAA7134_BOARD_VIDEOMATE_DVBT_200A  103
250 #define SAA7134_BOARD_HAUPPAUGE_HVR1110    104
251 #define SAA7134_BOARD_CINERGY_HT_PCMCIA    105
252 #define SAA7134_BOARD_ENCORE_ENLTV         106
253 #define SAA7134_BOARD_ENCORE_ENLTV_FM      107
254 #define SAA7134_BOARD_CINERGY_HT_PCI       108
255 #define SAA7134_BOARD_PHILIPS_TIGER_S      109
256 #define SAA7134_BOARD_AVERMEDIA_M102	   110
257 #define SAA7134_BOARD_ASUS_P7131_4871	   111
258 #define SAA7134_BOARD_ASUSTeK_P7131_HYBRID_LNA 112
259 #define SAA7134_BOARD_ECS_TVP3XP_4CB6  113
260 #define SAA7134_BOARD_KWORLD_DVBT_210 114
261 #define SAA7134_BOARD_SABRENT_TV_PCB05     115
262 #define SAA7134_BOARD_10MOONSTVMASTER3     116
263 #define SAA7134_BOARD_AVERMEDIA_SUPER_007  117
264 #define SAA7134_BOARD_BEHOLD_401  	118
265 #define SAA7134_BOARD_BEHOLD_403  	119
266 #define SAA7134_BOARD_BEHOLD_403FM	120
267 #define SAA7134_BOARD_BEHOLD_405	121
268 #define SAA7134_BOARD_BEHOLD_405FM	122
269 #define SAA7134_BOARD_BEHOLD_407	123
270 #define SAA7134_BOARD_BEHOLD_407FM	124
271 #define SAA7134_BOARD_BEHOLD_409	125
272 #define SAA7134_BOARD_BEHOLD_505FM	126
273 #define SAA7134_BOARD_BEHOLD_507_9FM	127
274 #define SAA7134_BOARD_BEHOLD_COLUMBUS_TVFM 128
275 #define SAA7134_BOARD_BEHOLD_607FM_MK3	129
276 #define SAA7134_BOARD_BEHOLD_M6		130
277 #define SAA7134_BOARD_TWINHAN_DTV_DVB_3056 131
278 #define SAA7134_BOARD_GENIUS_TVGO_A11MCE   132
279 #define SAA7134_BOARD_PHILIPS_SNAKE        133
280 #define SAA7134_BOARD_CREATIX_CTX953       134
281 #define SAA7134_BOARD_MSI_TVANYWHERE_AD11  135
282 #define SAA7134_BOARD_AVERMEDIA_CARDBUS_506 136
283 #define SAA7134_BOARD_AVERMEDIA_A16D       137
284 #define SAA7134_BOARD_AVERMEDIA_M115       138
285 #define SAA7134_BOARD_VIDEOMATE_T750       139
286 #define SAA7134_BOARD_AVERMEDIA_A700_PRO    140
287 #define SAA7134_BOARD_AVERMEDIA_A700_HYBRID 141
288 #define SAA7134_BOARD_BEHOLD_H6      142
289 #define SAA7134_BOARD_BEHOLD_M63      143
290 #define SAA7134_BOARD_BEHOLD_M6_EXTRA    144
291 #define SAA7134_BOARD_AVERMEDIA_M103    145
292 #define SAA7134_BOARD_ASUSTeK_P7131_ANALOG 146
293 #define SAA7134_BOARD_ASUSTeK_TIGER_3IN1   147
294 #define SAA7134_BOARD_ENCORE_ENLTV_FM53 148
295 #define SAA7134_BOARD_AVERMEDIA_M135A    149
296 #define SAA7134_BOARD_REAL_ANGEL_220     150
297 #define SAA7134_BOARD_ADS_INSTANT_HDTV_PCI  151
298 #define SAA7134_BOARD_ASUSTeK_TIGER         152
299 #define SAA7134_BOARD_KWORLD_PLUS_TV_ANALOG 153
300 #define SAA7134_BOARD_AVERMEDIA_GO_007_FM_PLUS 154
301 #define SAA7134_BOARD_HAUPPAUGE_HVR1150     155
302 #define SAA7134_BOARD_HAUPPAUGE_HVR1120   156
303 #define SAA7134_BOARD_AVERMEDIA_STUDIO_507UA 157
304 #define SAA7134_BOARD_AVERMEDIA_CARDBUS_501 158
305 #define SAA7134_BOARD_BEHOLD_505RDS_MK5     159
306 #define SAA7134_BOARD_BEHOLD_507RDS_MK3     160
307 #define SAA7134_BOARD_BEHOLD_507RDS_MK5     161
308 #define SAA7134_BOARD_BEHOLD_607FM_MK5      162
309 #define SAA7134_BOARD_BEHOLD_609FM_MK3      163
310 #define SAA7134_BOARD_BEHOLD_609FM_MK5      164
311 #define SAA7134_BOARD_BEHOLD_607RDS_MK3     165
312 #define SAA7134_BOARD_BEHOLD_607RDS_MK5     166
313 #define SAA7134_BOARD_BEHOLD_609RDS_MK3     167
314 #define SAA7134_BOARD_BEHOLD_609RDS_MK5     168
315 #define SAA7134_BOARD_VIDEOMATE_S350        169
316 #define SAA7134_BOARD_AVERMEDIA_STUDIO_505  170
317 #define SAA7134_BOARD_BEHOLD_X7             171
318 #define SAA7134_BOARD_ROVERMEDIA_LINK_PRO_FM 172
319 #define SAA7134_BOARD_ZOLID_HYBRID_PCI		173
320 #define SAA7134_BOARD_ASUS_EUROPA_HYBRID	174
321 #define SAA7134_BOARD_LEADTEK_WINFAST_DTV1000S 175
322 #define SAA7134_BOARD_BEHOLD_505RDS_MK3     176
323 #define SAA7134_BOARD_HAWELL_HW_404M7		177
324 #define SAA7134_BOARD_BEHOLD_H7             178
325 #define SAA7134_BOARD_BEHOLD_A7             179
326 #define SAA7134_BOARD_AVERMEDIA_M733A       180
327 #define SAA7134_BOARD_TECHNOTREND_BUDGET_T3000 181
328 #define SAA7134_BOARD_KWORLD_PCI_SBTVD_FULLSEG 182
329 #define SAA7134_BOARD_VIDEOMATE_M1F         183
330 #define SAA7134_BOARD_ENCORE_ENLTV_FM3      184
331 #define SAA7134_BOARD_MAGICPRO_PROHDTV_PRO2 185
332 #define SAA7134_BOARD_BEHOLD_501            186
333 #define SAA7134_BOARD_BEHOLD_503FM          187
334 #define SAA7134_BOARD_SENSORAY811_911       188
335 #define SAA7134_BOARD_KWORLD_PC150U         189
336 #define SAA7134_BOARD_ASUSTeK_PS3_100      190
337 #define SAA7134_BOARD_HAWELL_HW_9004V1      191
338 #define SAA7134_BOARD_AVERMEDIA_A706		192
339 #define SAA7134_BOARD_WIS_VOYAGER           193
340 #define SAA7134_BOARD_AVERMEDIA_505         194
341 #define SAA7134_BOARD_LEADTEK_WINFAST_TV2100_FM 195
342 #define SAA7134_BOARD_SNAZIO_TVPVR_PRO      196
343 
344 #define SAA7134_MAXBOARDS 32
345 #define SAA7134_INPUT_MAX 8
346 
347 /* ----------------------------------------------------------- */
348 /* Since we support 2 remote types, lets tell them apart       */
349 
350 #define SAA7134_REMOTE_GPIO  1
351 #define SAA7134_REMOTE_I2C   2
352 
353 /* ----------------------------------------------------------- */
354 /* Video Output Port Register Initialization Options           */
355 
356 #define SET_T_CODE_POLARITY_NON_INVERTED	(1 << 0)
357 #define SET_CLOCK_NOT_DELAYED			(1 << 1)
358 #define SET_CLOCK_INVERTED			(1 << 2)
359 #define SET_VSYNC_OFF				(1 << 3)
360 
361 enum saa7134_input_types {
362 	SAA7134_NO_INPUT = 0,
363 	SAA7134_INPUT_MUTE,
364 	SAA7134_INPUT_RADIO,
365 	SAA7134_INPUT_TV,
366 	SAA7134_INPUT_TV_MONO,
367 	SAA7134_INPUT_COMPOSITE,
368 	SAA7134_INPUT_COMPOSITE0,
369 	SAA7134_INPUT_COMPOSITE1,
370 	SAA7134_INPUT_COMPOSITE2,
371 	SAA7134_INPUT_COMPOSITE3,
372 	SAA7134_INPUT_COMPOSITE4,
373 	SAA7134_INPUT_SVIDEO,
374 	SAA7134_INPUT_SVIDEO0,
375 	SAA7134_INPUT_SVIDEO1,
376 	SAA7134_INPUT_COMPOSITE_OVER_SVIDEO,
377 };
378 
379 struct saa7134_input {
380 	enum saa7134_input_types type;
381 	unsigned int             vmux;
382 	enum saa7134_audio_in    amux;
383 	unsigned int             gpio;
384 };
385 
386 enum saa7134_mpeg_type {
387 	SAA7134_MPEG_UNUSED,
388 	SAA7134_MPEG_EMPRESS,
389 	SAA7134_MPEG_DVB,
390 	SAA7134_MPEG_GO7007,
391 };
392 
393 enum saa7134_mpeg_ts_type {
394 	SAA7134_MPEG_TS_PARALLEL = 0,
395 	SAA7134_MPEG_TS_SERIAL,
396 };
397 
398 struct saa7134_board {
399 	char                    *name;
400 	unsigned int            audio_clock;
401 
402 	/* input switching */
403 	unsigned int            gpiomask;
404 	struct saa7134_input    inputs[SAA7134_INPUT_MAX];
405 	struct saa7134_input    radio;
406 	struct saa7134_input    mute;
407 
408 	/* i2c chip info */
409 	unsigned int            tuner_type;
410 	unsigned int		radio_type;
411 	unsigned char		tuner_addr;
412 	unsigned char		radio_addr;
413 	unsigned char		empress_addr;
414 	unsigned char		rds_addr;
415 
416 	unsigned int            tda9887_conf;
417 	struct tda829x_config   tda829x_conf;
418 
419 	/* peripheral I/O */
420 	enum saa7134_video_out  video_out;
421 	enum saa7134_mpeg_type  mpeg;
422 	enum saa7134_mpeg_ts_type ts_type;
423 	unsigned int            vid_port_opts;
424 	unsigned int            ts_force_val:1;
425 };
426 
427 #define card_has_radio(dev)   (SAA7134_NO_INPUT != saa7134_boards[dev->board].radio.type)
428 #define card_is_empress(dev)  (SAA7134_MPEG_EMPRESS == saa7134_boards[dev->board].mpeg)
429 #define card_is_dvb(dev)      (SAA7134_MPEG_DVB     == saa7134_boards[dev->board].mpeg)
430 #define card_is_go7007(dev)   (SAA7134_MPEG_GO7007  == saa7134_boards[dev->board].mpeg)
431 #define card_has_mpeg(dev)    (SAA7134_MPEG_UNUSED  != saa7134_boards[dev->board].mpeg)
432 #define card(dev)             (saa7134_boards[dev->board])
433 #define card_in(dev,n)        (saa7134_boards[dev->board].inputs[n])
434 
435 #define V4L2_CID_PRIVATE_INVERT      (V4L2_CID_USER_SAA7134_BASE + 0)
436 #define V4L2_CID_PRIVATE_Y_ODD       (V4L2_CID_USER_SAA7134_BASE + 1)
437 #define V4L2_CID_PRIVATE_Y_EVEN      (V4L2_CID_USER_SAA7134_BASE + 2)
438 #define V4L2_CID_PRIVATE_AUTOMUTE    (V4L2_CID_USER_SAA7134_BASE + 3)
439 
440 /* ----------------------------------------------------------- */
441 /* device / file handle status                                 */
442 
443 #define RESOURCE_OVERLAY       1
444 #define RESOURCE_VIDEO         2
445 #define RESOURCE_VBI           4
446 #define RESOURCE_EMPRESS       8
447 
448 #define INTERLACE_AUTO         0
449 #define INTERLACE_ON           1
450 #define INTERLACE_OFF          2
451 
452 #define BUFFER_TIMEOUT     msecs_to_jiffies(500)  /* 0.5 seconds */
453 #define TS_BUFFER_TIMEOUT  msecs_to_jiffies(1000)  /* 1 second */
454 
455 struct saa7134_dev;
456 struct saa7134_dma;
457 
458 /* saa7134 page table */
459 struct saa7134_pgtable {
460 	unsigned int               size;
461 	__le32                     *cpu;
462 	dma_addr_t                 dma;
463 };
464 
465 /* tvaudio thread status */
466 struct saa7134_thread {
467 	struct task_struct         *thread;
468 	unsigned int               scan1;
469 	unsigned int               scan2;
470 	unsigned int               mode;
471 	unsigned int		   stopped;
472 };
473 
474 /* buffer for one video/vbi/ts frame */
475 struct saa7134_buf {
476 	/* common v4l buffer stuff -- must be first */
477 	struct vb2_v4l2_buffer vb2;
478 
479 	/* saa7134 specific */
480 	unsigned int            top_seen;
481 	int (*activate)(struct saa7134_dev *dev,
482 			struct saa7134_buf *buf,
483 			struct saa7134_buf *next);
484 
485 	struct list_head	entry;
486 };
487 
488 struct saa7134_dmaqueue {
489 	struct saa7134_dev         *dev;
490 	struct saa7134_buf         *curr;
491 	struct list_head           queue;
492 	struct timer_list          timeout;
493 	unsigned int               need_two;
494 	unsigned int               seq_nr;
495 	struct saa7134_pgtable     pt;
496 };
497 
498 /* dmasound dsp status */
499 struct saa7134_dmasound {
500 	struct mutex               lock;
501 	int                        minor_mixer;
502 	int                        minor_dsp;
503 	unsigned int               users_dsp;
504 
505 	/* mixer */
506 	enum saa7134_audio_in      input;
507 	unsigned int               count;
508 	unsigned int               line1;
509 	unsigned int               line2;
510 
511 	/* dsp */
512 	unsigned int               afmt;
513 	unsigned int               rate;
514 	unsigned int               channels;
515 	unsigned int               recording_on;
516 	unsigned int               dma_running;
517 	unsigned int               blocks;
518 	unsigned int               blksize;
519 	unsigned int               bufsize;
520 	struct saa7134_pgtable     pt;
521 	void			   *vaddr;
522 	struct scatterlist	   *sglist;
523 	int                        sglen;
524 	int                        nr_pages;
525 	unsigned int               dma_blk;
526 	unsigned int               read_offset;
527 	unsigned int               read_count;
528 	void *			   priv_data;
529 	struct snd_pcm_substream   *substream;
530 };
531 
532 /* ts/mpeg status */
533 struct saa7134_ts {
534 	/* TS capture */
535 	int                        nr_packets;
536 	int                        nr_bufs;
537 };
538 
539 /* ts/mpeg ops */
540 struct saa7134_mpeg_ops {
541 	enum saa7134_mpeg_type     type;
542 	struct list_head           next;
543 	int                        (*init)(struct saa7134_dev *dev);
544 	int                        (*fini)(struct saa7134_dev *dev);
545 	void                       (*signal_change)(struct saa7134_dev *dev);
546 	void                       (*irq_ts_done)(struct saa7134_dev *dev,
547 						  unsigned long status);
548 };
549 
550 /* global device status */
551 struct saa7134_dev {
552 	struct list_head           devlist;
553 	struct mutex               lock;
554 	spinlock_t                 slock;
555 	struct v4l2_device         v4l2_dev;
556 	/* workstruct for loading modules */
557 	struct work_struct request_module_wk;
558 
559 	/* insmod option/autodetected */
560 	int                        autodetected;
561 
562 	/* various device info */
563 	unsigned int               resources;
564 	struct video_device        *video_dev;
565 	struct video_device        *radio_dev;
566 	struct video_device        *vbi_dev;
567 	struct saa7134_dmasound    dmasound;
568 
569 	/* infrared remote */
570 	int                        has_remote;
571 	struct saa7134_card_ir     *remote;
572 
573 	/* pci i/o */
574 	char                       name[32];
575 	int                        nr;
576 	struct pci_dev             *pci;
577 	unsigned char              pci_rev,pci_lat;
578 	__u32                      __iomem *lmmio;
579 	__u8                       __iomem *bmmio;
580 
581 	/* config info */
582 	unsigned int               board;
583 	unsigned int               tuner_type;
584 	unsigned int 		   radio_type;
585 	unsigned char		   tuner_addr;
586 	unsigned char		   radio_addr;
587 
588 	unsigned int               tda9887_conf;
589 	unsigned int               gpio_value;
590 
591 	/* i2c i/o */
592 	struct i2c_adapter         i2c_adap;
593 	struct i2c_client          i2c_client;
594 	unsigned char              eedata[256];
595 	int 			   has_rds;
596 
597 	/* video overlay */
598 	struct v4l2_framebuffer    ovbuf;
599 	struct saa7134_format      *ovfmt;
600 	unsigned int               ovenable;
601 	enum v4l2_field            ovfield;
602 	struct v4l2_window         win;
603 	struct v4l2_clip           clips[8];
604 	unsigned int               nclips;
605 	struct v4l2_fh		   *overlay_owner;
606 
607 
608 	/* video+ts+vbi capture */
609 	struct saa7134_dmaqueue    video_q;
610 	struct vb2_queue           video_vbq;
611 	struct saa7134_dmaqueue    vbi_q;
612 	struct vb2_queue           vbi_vbq;
613 	enum v4l2_field		   field;
614 	struct saa7134_format      *fmt;
615 	unsigned int               width, height;
616 	unsigned int               vbi_hlen, vbi_vlen;
617 	struct pm_qos_request	   qos_request;
618 
619 	/* SAA7134_MPEG_* */
620 	struct saa7134_ts          ts;
621 	struct saa7134_dmaqueue    ts_q;
622 	enum v4l2_field		   ts_field;
623 	int                        ts_started;
624 	struct saa7134_mpeg_ops    *mops;
625 
626 	/* SAA7134_MPEG_EMPRESS only */
627 	struct video_device        *empress_dev;
628 	struct v4l2_subdev	   *empress_sd;
629 	struct vb2_queue           empress_vbq;
630 	struct work_struct         empress_workqueue;
631 	int                        empress_started;
632 	struct v4l2_ctrl_handler   empress_ctrl_handler;
633 
634 	/* various v4l controls */
635 	struct saa7134_tvnorm      *tvnorm;              /* video */
636 	struct saa7134_tvaudio     *tvaudio;
637 	struct v4l2_ctrl_handler   ctrl_handler;
638 	unsigned int               ctl_input;
639 	int                        ctl_bright;
640 	int                        ctl_contrast;
641 	int                        ctl_hue;
642 	int                        ctl_saturation;
643 	int                        ctl_mute;             /* audio */
644 	int                        ctl_volume;
645 	int                        ctl_invert;           /* private */
646 	int                        ctl_mirror;
647 	int                        ctl_y_odd;
648 	int                        ctl_y_even;
649 	int                        ctl_automute;
650 
651 	/* crop */
652 	struct v4l2_rect           crop_bounds;
653 	struct v4l2_rect           crop_defrect;
654 	struct v4l2_rect           crop_current;
655 
656 	/* other global state info */
657 	unsigned int               automute;
658 	struct saa7134_thread      thread;
659 	struct saa7134_input       *input;
660 	struct saa7134_input       *hw_input;
661 	unsigned int               hw_mute;
662 	int                        last_carrier;
663 	int                        nosignal;
664 	unsigned int               insuspend;
665 	struct v4l2_ctrl_handler   radio_ctrl_handler;
666 
667 	/* I2C keyboard data */
668 	struct IR_i2c_init_data    init_data;
669 
670 #ifdef CONFIG_MEDIA_CONTROLLER
671 	struct media_device *media_dev;
672 
673 	struct media_entity input_ent[SAA7134_INPUT_MAX + 1];
674 	struct media_pad input_pad[SAA7134_INPUT_MAX + 1];
675 
676 	struct media_entity demod;
677 	struct media_pad demod_pad[DEMOD_NUM_PADS];
678 
679 	struct media_pad video_pad, vbi_pad;
680 	struct media_entity *decoder;
681 #endif
682 
683 #if IS_ENABLED(CONFIG_VIDEO_SAA7134_DVB)
684 	/* SAA7134_MPEG_DVB only */
685 	struct vb2_dvb_frontends frontends;
686 	int (*original_demod_sleep)(struct dvb_frontend *fe);
687 	int (*original_set_voltage)(struct dvb_frontend *fe,
688 				    enum fe_sec_voltage voltage);
689 	int (*original_set_high_voltage)(struct dvb_frontend *fe, long arg);
690 #endif
691 	void (*gate_ctrl)(struct saa7134_dev *dev, int open);
692 };
693 
694 /* ----------------------------------------------------------- */
695 
696 #define saa_readl(reg)             readl(dev->lmmio + (reg))
697 #define saa_writel(reg,value)      writel((value), dev->lmmio + (reg));
698 #define saa_andorl(reg,mask,value) \
699   writel((readl(dev->lmmio+(reg)) & ~(mask)) |\
700   ((value) & (mask)), dev->lmmio+(reg))
701 #define saa_setl(reg,bit)          saa_andorl((reg),(bit),(bit))
702 #define saa_clearl(reg,bit)        saa_andorl((reg),(bit),0)
703 
704 #define saa_readb(reg)             readb(dev->bmmio + (reg))
705 #define saa_writeb(reg,value)      writeb((value), dev->bmmio + (reg));
706 #define saa_andorb(reg,mask,value) \
707   writeb((readb(dev->bmmio+(reg)) & ~(mask)) |\
708   ((value) & (mask)), dev->bmmio+(reg))
709 #define saa_setb(reg,bit)          saa_andorb((reg),(bit),(bit))
710 #define saa_clearb(reg,bit)        saa_andorb((reg),(bit),0)
711 
712 #define saa_wait(us) { udelay(us); }
713 
714 #define SAA7134_NORMS	(\
715 		V4L2_STD_PAL    | V4L2_STD_PAL_N | \
716 		V4L2_STD_PAL_Nc | V4L2_STD_SECAM | \
717 		V4L2_STD_NTSC   | V4L2_STD_PAL_M | \
718 		V4L2_STD_PAL_60)
719 
720 #define GRP_EMPRESS (1)
721 #define saa_call_all(dev, o, f, args...) do {				\
722 	if (dev->gate_ctrl)						\
723 		dev->gate_ctrl(dev, 1);					\
724 	v4l2_device_call_all(&(dev)->v4l2_dev, 0, o, f , ##args);	\
725 	if (dev->gate_ctrl)						\
726 		dev->gate_ctrl(dev, 0);					\
727 } while (0)
728 
729 #define saa_call_empress(dev, o, f, args...) ({				\
730 	long _rc;							\
731 	if (dev->gate_ctrl)						\
732 		dev->gate_ctrl(dev, 1);					\
733 	_rc = v4l2_device_call_until_err(&(dev)->v4l2_dev,		\
734 					 GRP_EMPRESS, o, f , ##args);	\
735 	if (dev->gate_ctrl)						\
736 		dev->gate_ctrl(dev, 0);					\
737 	_rc;								\
738 })
739 
740 static inline bool is_empress(struct file *file)
741 {
742 	struct video_device *vdev = video_devdata(file);
743 	struct saa7134_dev *dev = video_get_drvdata(vdev);
744 
745 	return vdev->queue == &dev->empress_vbq;
746 }
747 
748 /* ----------------------------------------------------------- */
749 /* saa7134-core.c                                              */
750 
751 extern struct list_head  saa7134_devlist;
752 extern struct mutex saa7134_devlist_lock;
753 extern int saa7134_no_overlay;
754 extern bool saa7134_userptr;
755 
756 void saa7134_track_gpio(struct saa7134_dev *dev, const char *msg);
757 void saa7134_set_gpio(struct saa7134_dev *dev, int bit_no, int value);
758 
759 #define SAA7134_PGTABLE_SIZE 4096
760 
761 int saa7134_pgtable_alloc(struct pci_dev *pci, struct saa7134_pgtable *pt);
762 int  saa7134_pgtable_build(struct pci_dev *pci, struct saa7134_pgtable *pt,
763 			   struct scatterlist *list, unsigned int length,
764 			   unsigned int startpage);
765 void saa7134_pgtable_free(struct pci_dev *pci, struct saa7134_pgtable *pt);
766 
767 int saa7134_buffer_count(unsigned int size, unsigned int count);
768 int saa7134_buffer_startpage(struct saa7134_buf *buf);
769 unsigned long saa7134_buffer_base(struct saa7134_buf *buf);
770 
771 int saa7134_buffer_queue(struct saa7134_dev *dev, struct saa7134_dmaqueue *q,
772 			 struct saa7134_buf *buf);
773 void saa7134_buffer_finish(struct saa7134_dev *dev, struct saa7134_dmaqueue *q,
774 			   unsigned int state);
775 void saa7134_buffer_next(struct saa7134_dev *dev, struct saa7134_dmaqueue *q);
776 void saa7134_buffer_timeout(unsigned long data);
777 void saa7134_stop_streaming(struct saa7134_dev *dev, struct saa7134_dmaqueue *q);
778 
779 int saa7134_set_dmabits(struct saa7134_dev *dev);
780 
781 extern int (*saa7134_dmasound_init)(struct saa7134_dev *dev);
782 extern int (*saa7134_dmasound_exit)(struct saa7134_dev *dev);
783 
784 
785 /* ----------------------------------------------------------- */
786 /* saa7134-cards.c                                             */
787 
788 extern struct saa7134_board saa7134_boards[];
789 extern const char * const saa7134_input_name[];
790 extern const unsigned int saa7134_bcount;
791 extern struct pci_device_id saa7134_pci_tbl[];
792 
793 extern int saa7134_board_init1(struct saa7134_dev *dev);
794 extern int saa7134_board_init2(struct saa7134_dev *dev);
795 int saa7134_tuner_callback(void *priv, int component, int command, int arg);
796 
797 
798 /* ----------------------------------------------------------- */
799 /* saa7134-i2c.c                                               */
800 
801 int saa7134_i2c_register(struct saa7134_dev *dev);
802 int saa7134_i2c_unregister(struct saa7134_dev *dev);
803 
804 
805 /* ----------------------------------------------------------- */
806 /* saa7134-video.c                                             */
807 
808 extern unsigned int video_debug;
809 extern struct video_device saa7134_video_template;
810 extern struct video_device saa7134_radio_template;
811 
812 void saa7134_vb2_buffer_queue(struct vb2_buffer *vb);
813 int saa7134_vb2_start_streaming(struct vb2_queue *vq, unsigned int count);
814 void saa7134_vb2_stop_streaming(struct vb2_queue *vq);
815 
816 int saa7134_s_std(struct file *file, void *priv, v4l2_std_id id);
817 int saa7134_g_std(struct file *file, void *priv, v4l2_std_id *id);
818 int saa7134_querystd(struct file *file, void *priv, v4l2_std_id *std);
819 int saa7134_enum_input(struct file *file, void *priv, struct v4l2_input *i);
820 int saa7134_g_input(struct file *file, void *priv, unsigned int *i);
821 int saa7134_s_input(struct file *file, void *priv, unsigned int i);
822 int saa7134_querycap(struct file *file, void  *priv,
823 					struct v4l2_capability *cap);
824 int saa7134_g_tuner(struct file *file, void *priv,
825 					struct v4l2_tuner *t);
826 int saa7134_s_tuner(struct file *file, void *priv,
827 					const struct v4l2_tuner *t);
828 int saa7134_g_frequency(struct file *file, void *priv,
829 					struct v4l2_frequency *f);
830 int saa7134_s_frequency(struct file *file, void *priv,
831 					const struct v4l2_frequency *f);
832 
833 int saa7134_videoport_init(struct saa7134_dev *dev);
834 void saa7134_set_tvnorm_hw(struct saa7134_dev *dev);
835 
836 int saa7134_video_init1(struct saa7134_dev *dev);
837 int saa7134_video_init2(struct saa7134_dev *dev);
838 void saa7134_irq_video_signalchange(struct saa7134_dev *dev);
839 void saa7134_irq_video_done(struct saa7134_dev *dev, unsigned long status);
840 void saa7134_video_fini(struct saa7134_dev *dev);
841 
842 
843 /* ----------------------------------------------------------- */
844 /* saa7134-ts.c                                                */
845 
846 #define TS_PACKET_SIZE 188 /* TS packets 188 bytes */
847 
848 int saa7134_ts_buffer_init(struct vb2_buffer *vb2);
849 int saa7134_ts_buffer_prepare(struct vb2_buffer *vb2);
850 int saa7134_ts_queue_setup(struct vb2_queue *q,
851 			   unsigned int *nbuffers, unsigned int *nplanes,
852 			   unsigned int sizes[], struct device *alloc_devs[]);
853 int saa7134_ts_start_streaming(struct vb2_queue *vq, unsigned int count);
854 void saa7134_ts_stop_streaming(struct vb2_queue *vq);
855 
856 extern struct vb2_ops saa7134_ts_qops;
857 
858 int saa7134_ts_init1(struct saa7134_dev *dev);
859 int saa7134_ts_fini(struct saa7134_dev *dev);
860 void saa7134_irq_ts_done(struct saa7134_dev *dev, unsigned long status);
861 
862 int saa7134_ts_register(struct saa7134_mpeg_ops *ops);
863 void saa7134_ts_unregister(struct saa7134_mpeg_ops *ops);
864 
865 int saa7134_ts_init_hw(struct saa7134_dev *dev);
866 
867 int saa7134_ts_start(struct saa7134_dev *dev);
868 int saa7134_ts_stop(struct saa7134_dev *dev);
869 
870 /* ----------------------------------------------------------- */
871 /* saa7134-vbi.c                                               */
872 
873 extern struct vb2_ops saa7134_vbi_qops;
874 extern struct video_device saa7134_vbi_template;
875 
876 int saa7134_vbi_init1(struct saa7134_dev *dev);
877 int saa7134_vbi_fini(struct saa7134_dev *dev);
878 void saa7134_irq_vbi_done(struct saa7134_dev *dev, unsigned long status);
879 
880 
881 /* ----------------------------------------------------------- */
882 /* saa7134-tvaudio.c                                           */
883 
884 int saa7134_tvaudio_rx2mode(u32 rx);
885 
886 void saa7134_tvaudio_setmute(struct saa7134_dev *dev);
887 void saa7134_tvaudio_setinput(struct saa7134_dev *dev,
888 			      struct saa7134_input *in);
889 void saa7134_tvaudio_setvolume(struct saa7134_dev *dev, int level);
890 int saa7134_tvaudio_getstereo(struct saa7134_dev *dev);
891 
892 void saa7134_tvaudio_init(struct saa7134_dev *dev);
893 int saa7134_tvaudio_init2(struct saa7134_dev *dev);
894 int saa7134_tvaudio_fini(struct saa7134_dev *dev);
895 int saa7134_tvaudio_do_scan(struct saa7134_dev *dev);
896 int saa7134_tvaudio_close(struct saa7134_dev *dev);
897 
898 int saa_dsp_writel(struct saa7134_dev *dev, int reg, u32 value);
899 
900 void saa7134_enable_i2s(struct saa7134_dev *dev);
901 
902 /* ----------------------------------------------------------- */
903 /* saa7134-oss.c                                               */
904 
905 extern const struct file_operations saa7134_dsp_fops;
906 extern const struct file_operations saa7134_mixer_fops;
907 
908 int saa7134_oss_init1(struct saa7134_dev *dev);
909 int saa7134_oss_fini(struct saa7134_dev *dev);
910 void saa7134_irq_oss_done(struct saa7134_dev *dev, unsigned long status);
911 
912 /* ----------------------------------------------------------- */
913 /* saa7134-input.c                                             */
914 
915 #if defined(CONFIG_VIDEO_SAA7134_RC)
916 int  saa7134_input_init1(struct saa7134_dev *dev);
917 void saa7134_input_fini(struct saa7134_dev *dev);
918 void saa7134_input_irq(struct saa7134_dev *dev);
919 void saa7134_probe_i2c_ir(struct saa7134_dev *dev);
920 int saa7134_ir_start(struct saa7134_dev *dev);
921 void saa7134_ir_stop(struct saa7134_dev *dev);
922 #else
923 #define saa7134_input_init1(dev)	((void)0)
924 #define saa7134_input_fini(dev)		((void)0)
925 #define saa7134_input_irq(dev)		((void)0)
926 #define saa7134_probe_i2c_ir(dev)	((void)0)
927 #define saa7134_ir_start(dev)		((void)0)
928 #define saa7134_ir_stop(dev)		((void)0)
929 #endif
930