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