PCI: fix pci-driver kernel-doc
[linux-2.6.git] / include / media / tuner.h
blob99acf847365caa81d4bab76a3dcd4e954fc145e0
1 /*
2 tuner.h - definition for different tuners
4 Copyright (C) 1997 Markus Schroeder (schroedm@uni-duesseldorf.de)
5 minor modifications by Ralph Metzler (rjkm@thp.uni-koeln.de)
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.
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.
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.
22 #ifndef _TUNER_H
23 #define _TUNER_H
25 #include <linux/videodev2.h>
26 #include <media/tuner-types.h>
28 extern int tuner_debug;
30 #define ADDR_UNSET (255)
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` */
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) */
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
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
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) */
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
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
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
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) */
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
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
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
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
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 */
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 */
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
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
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
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 */
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))
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)
150 #ifdef __KERNEL__
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
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.
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.
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.
176 struct tuner_setup {
177 unsigned short addr; /* I2C address */
178 unsigned int type; /* Tuner type */
179 unsigned int mode_mask; /* Allowed tuner modes */
182 struct tuner {
183 /* device */
184 struct i2c_client i2c;
186 unsigned int type; /* chip type */
188 unsigned int mode;
189 unsigned int mode_mask; /* Combination of allowable modes */
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;
197 int using_v4l2;
199 /* used by tda9887 */
200 unsigned int tda9887_config;
201 unsigned char tda9887_data[4];
203 /* used by MT2032 */
204 unsigned int xogc;
205 unsigned int radio_if2;
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;
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);
224 extern unsigned const int tuner_count;
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);
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)
247 #endif /* __KERNEL__ */
249 #endif /* _TUNER_H */
252 * Overrides for Emacs so that we follow Linus's tabbing style.
253 * ---------------------------------------------------------------------------
254 * Local variables:
255 * c-basic-offset: 8
256 * End: