xref: /linux/include/media/tuner.h (revision c537b994505099b7197e7d3125b942ecbcc51eb6)
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     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 #ifndef _TUNER_H
23 #define _TUNER_H
24 
25 #include <linux/videodev2.h>
26 #include <media/tuner-types.h>
27 
28 extern int tuner_debug;
29 
30 #define ADDR_UNSET (255)
31 
32 #define TUNER_TEMIC_PAL			0        /* 4002 FH5 (3X 7756, 9483) */
33 #define TUNER_PHILIPS_PAL_I		1
34 #define TUNER_PHILIPS_NTSC		2
35 #define TUNER_PHILIPS_SECAM		3	/* you must actively select B/G, L, L` */
36 
37 #define TUNER_ABSENT			4
38 #define TUNER_PHILIPS_PAL		5
39 #define TUNER_TEMIC_NTSC		6	/* 4032 FY5 (3X 7004, 9498, 9789)  */
40 #define TUNER_TEMIC_PAL_I		7	/* 4062 FY5 (3X 8501, 9957) */
41 
42 #define TUNER_TEMIC_4036FY5_NTSC	8	/* 4036 FY5 (3X 1223, 1981, 7686) */
43 #define TUNER_ALPS_TSBH1_NTSC		9
44 #define TUNER_ALPS_TSBE1_PAL		10
45 #define TUNER_ALPS_TSBB5_PAL_I		11
46 
47 #define TUNER_ALPS_TSBE5_PAL		12
48 #define TUNER_ALPS_TSBC5_PAL		13
49 #define TUNER_TEMIC_4006FH5_PAL		14	/* 4006 FH5 (3X 9500, 9501, 7291) */
50 #define TUNER_ALPS_TSHC6_NTSC		15
51 
52 #define TUNER_TEMIC_PAL_DK		16	/* 4016 FY5 (3X 1392, 1393) */
53 #define TUNER_PHILIPS_NTSC_M		17
54 #define TUNER_TEMIC_4066FY5_PAL_I	18	/* 4066 FY5 (3X 7032, 7035) */
55 #define TUNER_TEMIC_4006FN5_MULTI_PAL	19	/* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */
56 
57 #define TUNER_TEMIC_4009FR5_PAL		20	/* incl. FM radio (3X 7607, 7488, 7711) */
58 #define TUNER_TEMIC_4039FR5_NTSC	21	/* incl. FM radio (3X 7246, 7578, 7732) */
59 #define TUNER_TEMIC_4046FM5		22	/* you must actively select B/G, D/K, I, L, L` !  (3X 7804, 7806, 8103, 8104) */
60 #define TUNER_PHILIPS_PAL_DK		23
61 
62 #define TUNER_PHILIPS_FQ1216ME		24	/* you must actively select B/G/D/K, I, L, L` */
63 #define TUNER_LG_PAL_I_FM		25
64 #define TUNER_LG_PAL_I			26
65 #define TUNER_LG_NTSC_FM		27
66 
67 #define TUNER_LG_PAL_FM			28
68 #define TUNER_LG_PAL			29
69 #define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30	/* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
70 #define TUNER_SHARP_2U5JF5540_NTSC	31
71 
72 #define TUNER_Samsung_PAL_TCPM9091PD27	32
73 #define TUNER_MT2032			33
74 #define TUNER_TEMIC_4106FH5		34	/* 4106 FH5 (3X 7808, 7865) */
75 #define TUNER_TEMIC_4012FY5		35	/* 4012 FY5 (3X 0971, 1099) */
76 
77 #define TUNER_TEMIC_4136FY5		36	/* 4136 FY5 (3X 7708, 7746) */
78 #define TUNER_LG_PAL_NEW_TAPC		37
79 #define TUNER_PHILIPS_FM1216ME_MK3	38
80 #define TUNER_LG_NTSC_NEW_TAPC		39
81 
82 #define TUNER_HITACHI_NTSC		40
83 #define TUNER_PHILIPS_PAL_MK		41
84 #define TUNER_PHILIPS_ATSC		42
85 #define TUNER_PHILIPS_FM1236_MK3	43
86 
87 #define TUNER_PHILIPS_4IN1		44	/* ATI TV Wonder Pro - Conexant */
88 /* Microtune merged with Temic 12/31/1999 partially financed by Alps - these may be similar to Temic */
89 #define TUNER_MICROTUNE_4049FM5 	45
90 #define TUNER_PANASONIC_VP27		46
91 #define TUNER_LG_NTSC_TAPE		47
92 
93 #define TUNER_TNF_8831BGFF		48
94 #define TUNER_MICROTUNE_4042FI5		49	/* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
95 #define TUNER_TCL_2002N			50
96 #define TUNER_PHILIPS_FM1256_IH3	51
97 
98 #define TUNER_THOMSON_DTT7610		52
99 #define TUNER_PHILIPS_FQ1286		53
100 #define TUNER_PHILIPS_TDA8290		54
101 #define TUNER_TCL_2002MB		55	/* Hauppauge PVR-150 PAL */
102 
103 #define TUNER_PHILIPS_FQ1216AME_MK4	56	/* Hauppauge PVR-150 PAL */
104 #define TUNER_PHILIPS_FQ1236A_MK4	57	/* Hauppauge PVR-500MCE NTSC */
105 #define TUNER_YMEC_TVF_8531MF		58
106 #define TUNER_YMEC_TVF_5533MF		59	/* Pixelview Pro Ultra NTSC */
107 
108 #define TUNER_THOMSON_DTT761X		60	/* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
109 #define TUNER_TENA_9533_DI		61
110 #define TUNER_TEA5767			62	/* Only FM Radio Tuner */
111 #define TUNER_PHILIPS_FMD1216ME_MK3	63
112 
113 #define TUNER_LG_TDVS_H06XF		64	/* TDVS H061F, H062F, H064F */
114 #define TUNER_YMEC_TVF66T5_B_DFF	65	/* Acorp Y878F */
115 #define TUNER_LG_TALN			66
116 #define TUNER_PHILIPS_TD1316		67
117 
118 #define TUNER_PHILIPS_TUV1236D		68	/* ATI HDTV Wonder */
119 #define TUNER_TNF_5335MF                69	/* Sabrent Bt848   */
120 #define TUNER_SAMSUNG_TCPN_2121P30A     70 	/* Hauppauge PVR-500MCE NTSC */
121 #define TUNER_XCEIVE_XC3028		71
122 
123 #define TUNER_THOMSON_FE6600		72	/* DViCO FusionHDTV DVB-T Hybrid */
124 #define TUNER_SAMSUNG_TCPG_6121P30A     73 	/* Hauppauge PVR-500 PAL */
125 #define TUNER_TDA9887                   74      /* This tuner should be used only internally */
126 
127 /* tv card specific */
128 #define TDA9887_PRESENT 		(1<<0)
129 #define TDA9887_PORT1_INACTIVE 		(1<<1)
130 #define TDA9887_PORT2_INACTIVE 		(1<<2)
131 #define TDA9887_QSS 			(1<<3)
132 #define TDA9887_INTERCARRIER 		(1<<4)
133 #define TDA9887_PORT1_ACTIVE 		(1<<5)
134 #define TDA9887_PORT2_ACTIVE 		(1<<6)
135 #define TDA9887_INTERCARRIER_NTSC 	(1<<7)
136 /* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
137 #define TDA9887_TOP_MASK 		(0x3f << 8)
138 #define TDA9887_TOP_SET 		(1 << 13)
139 #define TDA9887_TOP(top) 		(TDA9887_TOP_SET | (((16 + (top)) & 0x1f) << 8))
140 
141 /* config options */
142 #define TDA9887_DEEMPHASIS_MASK 	(3<<16)
143 #define TDA9887_DEEMPHASIS_NONE 	(1<<16)
144 #define TDA9887_DEEMPHASIS_50 		(2<<16)
145 #define TDA9887_DEEMPHASIS_75 		(3<<16)
146 #define TDA9887_AUTOMUTE 		(1<<18)
147 #define TDA9887_GATING_18		(1<<19)
148 #define TDA9887_GAIN_NORMAL		(1<<20)
149 
150 #ifdef __KERNEL__
151 
152 enum tuner_mode {
153 	T_UNINITIALIZED = 0,
154 	T_RADIO		= 1 << V4L2_TUNER_RADIO,
155 	T_ANALOG_TV     = 1 << V4L2_TUNER_ANALOG_TV,
156 	T_DIGITAL_TV    = 1 << V4L2_TUNER_DIGITAL_TV,
157 	T_STANDBY	= 1 << 31
158 };
159 
160 /* Older boards only had a single tuner device. Nowadays multiple tuner
161    devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
162    to pass the tuner_setup structure it is possible to setup each tuner
163    device in turn.
164 
165    Since multiple devices may be present it is no longer sufficient to
166    send a command to a single i2c device. Instead you should broadcast
167    the command to all i2c devices.
168 
169    By setting the mode_mask correctly you can select which commands are
170    accepted by a specific tuner device. For example, set mode_mask to
171    T_RADIO if the device is a radio-only tuner. That specific tuner will
172    only accept commands when the tuner is in radio mode and ignore them
173    when the tuner is set to TV mode.
174  */
175 
176 struct tuner_setup {
177 	unsigned short	addr; 	/* I2C address */
178 	unsigned int	type;   /* Tuner type */
179 	unsigned int	mode_mask;  /* Allowed tuner modes */
180 };
181 
182 struct tuner {
183 	/* device */
184 	struct i2c_client i2c;
185 
186 	unsigned int type;	/* chip type */
187 
188 	unsigned int mode;
189 	unsigned int mode_mask;	/* Combination of allowable modes */
190 
191 	unsigned int tv_freq;	/* keep track of the current settings */
192 	unsigned int radio_freq;
193 	u16 	     last_div;
194 	unsigned int audmode;
195 	v4l2_std_id  std;
196 
197 	int          using_v4l2;
198 
199 	/* used by tda9887 */
200 	unsigned int       tda9887_config;
201 	unsigned char 	   tda9887_data[4];
202 
203 	/* used by MT2032 */
204 	unsigned int xogc;
205 	unsigned int radio_if2;
206 
207 	/* used by tda8290 */
208 	unsigned char tda8290_easy_mode;
209 	unsigned char tda827x_lpsel;
210 	unsigned char tda827x_addr;
211 	unsigned char tda827x_ver;
212 	unsigned int sgIF;
213 
214 	/* function ptrs */
215 	void (*set_tv_freq)(struct i2c_client *c, unsigned int freq);
216 	void (*set_radio_freq)(struct i2c_client *c, unsigned int freq);
217 	int  (*has_signal)(struct i2c_client *c);
218 	int  (*is_stereo)(struct i2c_client *c);
219 	int  (*get_afc)(struct i2c_client *c);
220 	void (*tuner_status)(struct i2c_client *c);
221 	void (*standby)(struct i2c_client *c);
222 };
223 
224 extern unsigned const int tuner_count;
225 
226 extern int microtune_init(struct i2c_client *c);
227 extern int xc3028_init(struct i2c_client *c);
228 extern int tda8290_init(struct i2c_client *c);
229 extern int tda8290_probe(struct i2c_client *c);
230 extern int tea5767_tuner_init(struct i2c_client *c);
231 extern int default_tuner_init(struct i2c_client *c);
232 extern int tea5767_autodetection(struct i2c_client *c);
233 extern int tda9887_tuner_init(struct i2c_client *c);
234 
235 #define tuner_warn(fmt, arg...) do {\
236 	printk(KERN_WARNING "%s %d-%04x: " fmt, t->i2c.driver->driver.name, \
237 			i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
238 #define tuner_info(fmt, arg...) do {\
239 	printk(KERN_INFO "%s %d-%04x: " fmt, t->i2c.driver->driver.name, \
240 			i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
241 #define tuner_dbg(fmt, arg...) do {\
242 	extern int tuner_debug; \
243 	if (tuner_debug) \
244 		printk(KERN_DEBUG "%s %d-%04x: " fmt, t->i2c.driver->driver.name, \
245 			i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
246 
247 #endif /* __KERNEL__ */
248 
249 #endif /* _TUNER_H */
250 
251 /*
252  * Overrides for Emacs so that we follow Linus's tabbing style.
253  * ---------------------------------------------------------------------------
254  * Local variables:
255  * c-basic-offset: 8
256  * End:
257  */
258