xref: /linux/include/media/tuner.h (revision a8fe58cec351c25e09c393bf46117c0c47b5a17c)
1 /*
2  * tuner.h - definition for different tuners
3  *
4  * Copyright (C) 1997 Markus Schroeder (schroedm@uni-duesseldorf.de)
5  * minor modifications by Ralph Metzler (rjkm@thp.uni-koeln.de)
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 #ifndef _TUNER_H
19 #define _TUNER_H
20 #ifdef __KERNEL__
21 
22 #include <linux/videodev2.h>
23 
24 /* Tuner PADs */
25 /* FIXME: is this the right place for it? */
26 enum tuner_pad_index {
27 	TUNER_PAD_RF_INPUT,
28 	TUNER_PAD_IF_OUTPUT,
29 	TUNER_NUM_PADS
30 };
31 
32 #define ADDR_UNSET (255)
33 
34 #define TUNER_TEMIC_PAL			0        /* 4002 FH5 (3X 7756, 9483) */
35 #define TUNER_PHILIPS_PAL_I		1
36 #define TUNER_PHILIPS_NTSC		2
37 #define TUNER_PHILIPS_SECAM		3	/* you must actively select B/G, L, L` */
38 
39 #define TUNER_ABSENT			4
40 #define TUNER_PHILIPS_PAL		5
41 #define TUNER_TEMIC_NTSC		6	/* 4032 FY5 (3X 7004, 9498, 9789)  */
42 #define TUNER_TEMIC_PAL_I		7	/* 4062 FY5 (3X 8501, 9957) */
43 
44 #define TUNER_TEMIC_4036FY5_NTSC	8	/* 4036 FY5 (3X 1223, 1981, 7686) */
45 #define TUNER_ALPS_TSBH1_NTSC		9
46 #define TUNER_ALPS_TSBE1_PAL		10
47 #define TUNER_ALPS_TSBB5_PAL_I		11
48 
49 #define TUNER_ALPS_TSBE5_PAL		12
50 #define TUNER_ALPS_TSBC5_PAL		13
51 #define TUNER_TEMIC_4006FH5_PAL		14	/* 4006 FH5 (3X 9500, 9501, 7291) */
52 #define TUNER_ALPS_TSHC6_NTSC		15
53 
54 #define TUNER_TEMIC_PAL_DK		16	/* 4016 FY5 (3X 1392, 1393) */
55 #define TUNER_PHILIPS_NTSC_M		17
56 #define TUNER_TEMIC_4066FY5_PAL_I	18	/* 4066 FY5 (3X 7032, 7035) */
57 #define TUNER_TEMIC_4006FN5_MULTI_PAL	19	/* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */
58 
59 #define TUNER_TEMIC_4009FR5_PAL		20	/* incl. FM radio (3X 7607, 7488, 7711) */
60 #define TUNER_TEMIC_4039FR5_NTSC	21	/* incl. FM radio (3X 7246, 7578, 7732) */
61 #define TUNER_TEMIC_4046FM5		22	/* you must actively select B/G, D/K, I, L, L` !  (3X 7804, 7806, 8103, 8104) */
62 #define TUNER_PHILIPS_PAL_DK		23
63 
64 #define TUNER_PHILIPS_FQ1216ME		24	/* you must actively select B/G/D/K, I, L, L` */
65 #define TUNER_LG_PAL_I_FM		25
66 #define TUNER_LG_PAL_I			26
67 #define TUNER_LG_NTSC_FM		27
68 
69 #define TUNER_LG_PAL_FM			28
70 #define TUNER_LG_PAL			29
71 #define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30	/* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
72 #define TUNER_SHARP_2U5JF5540_NTSC	31
73 
74 #define TUNER_Samsung_PAL_TCPM9091PD27	32
75 #define TUNER_MT2032			33
76 #define TUNER_TEMIC_4106FH5		34	/* 4106 FH5 (3X 7808, 7865) */
77 #define TUNER_TEMIC_4012FY5		35	/* 4012 FY5 (3X 0971, 1099) */
78 
79 #define TUNER_TEMIC_4136FY5		36	/* 4136 FY5 (3X 7708, 7746) */
80 #define TUNER_LG_PAL_NEW_TAPC		37
81 #define TUNER_PHILIPS_FM1216ME_MK3	38
82 #define TUNER_LG_NTSC_NEW_TAPC		39
83 
84 #define TUNER_HITACHI_NTSC		40
85 #define TUNER_PHILIPS_PAL_MK		41
86 #define TUNER_PHILIPS_FCV1236D		42
87 #define TUNER_PHILIPS_FM1236_MK3	43
88 
89 #define TUNER_PHILIPS_4IN1		44	/* ATI TV Wonder Pro - Conexant */
90 	/*
91 	 * Microtune merged with Temic 12/31/1999 partially financed by Alps.
92 	 * these may be similar to Temic
93 	 */
94 #define TUNER_MICROTUNE_4049FM5		45
95 #define TUNER_PANASONIC_VP27		46
96 #define TUNER_LG_NTSC_TAPE		47
97 
98 #define TUNER_TNF_8831BGFF		48
99 #define TUNER_MICROTUNE_4042FI5		49	/* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
100 #define TUNER_TCL_2002N			50
101 #define TUNER_PHILIPS_FM1256_IH3	51
102 
103 #define TUNER_THOMSON_DTT7610		52
104 #define TUNER_PHILIPS_FQ1286		53
105 #define TUNER_PHILIPS_TDA8290		54
106 #define TUNER_TCL_2002MB		55	/* Hauppauge PVR-150 PAL */
107 
108 #define TUNER_PHILIPS_FQ1216AME_MK4	56	/* Hauppauge PVR-150 PAL */
109 #define TUNER_PHILIPS_FQ1236A_MK4	57	/* Hauppauge PVR-500MCE NTSC */
110 #define TUNER_YMEC_TVF_8531MF		58
111 #define TUNER_YMEC_TVF_5533MF		59	/* Pixelview Pro Ultra NTSC */
112 
113 #define TUNER_THOMSON_DTT761X		60	/* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
114 #define TUNER_TENA_9533_DI		61
115 #define TUNER_TEA5767			62	/* Only FM Radio Tuner */
116 #define TUNER_PHILIPS_FMD1216ME_MK3	63
117 
118 #define TUNER_LG_TDVS_H06XF		64	/* TDVS H061F, H062F, H064F */
119 #define TUNER_YMEC_TVF66T5_B_DFF	65	/* Acorp Y878F */
120 #define TUNER_LG_TALN			66
121 #define TUNER_PHILIPS_TD1316		67
122 
123 #define TUNER_PHILIPS_TUV1236D		68	/* ATI HDTV Wonder */
124 #define TUNER_TNF_5335MF                69	/* Sabrent Bt848   */
125 #define TUNER_SAMSUNG_TCPN_2121P30A     70	/* Hauppauge PVR-500MCE NTSC */
126 #define TUNER_XC2028			71
127 
128 #define TUNER_THOMSON_FE6600		72	/* DViCO FusionHDTV DVB-T Hybrid */
129 #define TUNER_SAMSUNG_TCPG_6121P30A     73	/* Hauppauge PVR-500 PAL */
130 #define TUNER_TDA9887                   74      /* This tuner should be used only internally */
131 #define TUNER_TEA5761			75	/* Only FM Radio Tuner */
132 #define TUNER_XC5000			76	/* Xceive Silicon Tuner */
133 #define TUNER_TCL_MF02GIP_5N		77	/* TCL MF02GIP_5N */
134 #define TUNER_PHILIPS_FMD1216MEX_MK3	78
135 #define TUNER_PHILIPS_FM1216MK5		79
136 #define TUNER_PHILIPS_FQ1216LME_MK3	80	/* Active loopthrough, no FM */
137 
138 #define TUNER_PARTSNIC_PTI_5NF05	81
139 #define TUNER_PHILIPS_CU1216L           82
140 #define TUNER_NXP_TDA18271		83
141 #define TUNER_SONY_BTF_PXN01Z		84
142 #define TUNER_PHILIPS_FQ1236_MK5	85	/* NTSC, TDA9885, no FM radio */
143 #define TUNER_TENA_TNF_5337		86
144 
145 #define TUNER_XC4000			87	/* Xceive Silicon Tuner */
146 #define TUNER_XC5000C			88	/* Xceive Silicon Tuner */
147 
148 #define TUNER_SONY_BTF_PG472Z		89	/* PAL+SECAM */
149 #define TUNER_SONY_BTF_PK467Z		90	/* NTSC_JP */
150 #define TUNER_SONY_BTF_PB463Z		91	/* NTSC */
151 
152 /* tv card specific */
153 #define TDA9887_PRESENT			(1<<0)
154 #define TDA9887_PORT1_INACTIVE		(1<<1)
155 #define TDA9887_PORT2_INACTIVE		(1<<2)
156 #define TDA9887_QSS			(1<<3)
157 #define TDA9887_INTERCARRIER		(1<<4)
158 #define TDA9887_PORT1_ACTIVE		(1<<5)
159 #define TDA9887_PORT2_ACTIVE		(1<<6)
160 #define TDA9887_INTERCARRIER_NTSC	(1<<7)
161 /* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
162 #define TDA9887_TOP_MASK		(0x3f << 8)
163 #define TDA9887_TOP_SET			(1 << 13)
164 #define TDA9887_TOP(top)		(TDA9887_TOP_SET | \
165 					 (((16 + (top)) & 0x1f) << 8))
166 
167 /* config options */
168 #define TDA9887_DEEMPHASIS_MASK		(3<<16)
169 #define TDA9887_DEEMPHASIS_NONE		(1<<16)
170 #define TDA9887_DEEMPHASIS_50		(2<<16)
171 #define TDA9887_DEEMPHASIS_75		(3<<16)
172 #define TDA9887_AUTOMUTE		(1<<18)
173 #define TDA9887_GATING_18		(1<<19)
174 #define TDA9887_GAIN_NORMAL		(1<<20)
175 #define TDA9887_RIF_41_3		(1<<21)  /* radio IF1 41.3 vs 33.3 */
176 
177 /**
178  * enum tuner_mode      - Mode of the tuner
179  *
180  * @T_RADIO:        Tuner core will work in radio mode
181  * @T_ANALOG_TV:    Tuner core will work in analog TV mode
182  *
183  * Older boards only had a single tuner device, but some devices have a
184  * separate tuner for radio. In any case, the tuner-core needs to know if
185  * the tuner chip(s) will be used in radio mode or analog TV mode, as, on
186  * radio mode, frequencies are specified on a different range than on TV
187  * mode. This enum is used by the tuner core in order to work with the
188  * proper tuner range and eventually use a different tuner chip while in
189  * radio mode.
190  */
191 enum tuner_mode {
192 	T_RADIO		= 1 << V4L2_TUNER_RADIO,
193 	T_ANALOG_TV     = 1 << V4L2_TUNER_ANALOG_TV,
194 	/* Don't map V4L2_TUNER_DIGITAL_TV, as tuner-core won't use it */
195 };
196 
197 /**
198  * struct tuner_setup   - setup the tuner chipsets
199  *
200  * @addr:		I2C address used to control the tuner device/chipset
201  * @type:		Type of the tuner, as defined at the TUNER_* macros.
202  *			Each different tuner model should have an unique
203  *			identifier.
204  * @mode_mask:		Mask with the allowed tuner modes: V4L2_TUNER_RADIO,
205  *			V4L2_TUNER_ANALOG_TV and/or V4L2_TUNER_DIGITAL_TV,
206  *			describing if the tuner should be used to support
207  *			Radio, analog TV and/or digital TV.
208  * @config:		Used to send tuner-specific configuration for complex
209  *			tuners that require extra parameters to be set.
210  *			Only a very few tuners require it and its usage on
211  *			newer tuners should be avoided.
212  * @tuner_callback:	Some tuners require to call back the bridge driver,
213  *			in order to do some tasks like rising a GPIO at the
214  *			bridge chipset, in order to do things like resetting
215  *			the device.
216  *
217  * Older boards only had a single tuner device. Nowadays multiple tuner
218  * devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
219  * to pass the tuner_setup structure it is possible to setup each tuner
220  * device in turn.
221  *
222  * Since multiple devices may be present it is no longer sufficient to
223  * send a command to a single i2c device. Instead you should broadcast
224  * the command to all i2c devices.
225  *
226  * By setting the mode_mask correctly you can select which commands are
227  * accepted by a specific tuner device. For example, set mode_mask to
228  * T_RADIO if the device is a radio-only tuner. That specific tuner will
229  * only accept commands when the tuner is in radio mode and ignore them
230  * when the tuner is set to TV mode.
231  */
232 
233 struct tuner_setup {
234 	unsigned short	addr;
235 	unsigned int	type;
236 	unsigned int	mode_mask;
237 	void		*config;
238 	int (*tuner_callback)(void *dev, int component, int cmd, int arg);
239 };
240 
241 #endif /* __KERNEL__ */
242 
243 #endif /* _TUNER_H */
244