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