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