[media] tuner.h: rename TUNER_PAD_IF_OUTPUT to TUNER_PAD_OUTPUT
[deliverable/linux.git] / include / media / tuner.h
CommitLineData
10b89ee3 1/*
62e93f09
MCC
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 */
1da177e4
LT
17
18#ifndef _TUNER_H
19#define _TUNER_H
2d351df4 20#ifdef __KERNEL__
1da177e4 21
586b0cab
MCC
22#include <linux/videodev2.h>
23
163c9bca
MCC
24/**
25 * enum tuner_pad_index - tuner pad index
26 *
27 * @TUNER_PAD_RF_INPUT: Radiofrequency (RF) sink pad, usually linked to a
28 * RF connector entity.
29 * @TUNER_PAD_OUTPUT: Tuner output pad. This is actually more complex than
30 * a single pad output, as, in addition to luminance and
31 * chrominance IF a tuner may have internally an
32 * audio decoder (like xc3028) or it may produce an audio
33 * IF that will be used by an audio decoder like msp34xx.
34 * It may also have an IF-PLL demodulator on it, like
35 * tuners with tda9887. Yet, currently, we don't need to
36 * represent all the dirty details, as this is transparent
37 * for the V4L2 API usage. So, let's represent all kinds
38 * of different outputs as a single source pad.
39 * @TUNER_NUM_PADS: Number of pads of the tuner.
40 */
188d2d55
MCC
41enum tuner_pad_index {
42 TUNER_PAD_RF_INPUT,
163c9bca 43 TUNER_PAD_OUTPUT,
188d2d55
MCC
44 TUNER_NUM_PADS
45};
46
56fc08ca
MCC
47#define ADDR_UNSET (255)
48
1c94aeec
MCC
49#define TUNER_TEMIC_PAL 0 /* 4002 FH5 (3X 7756, 9483) */
50#define TUNER_PHILIPS_PAL_I 1
51#define TUNER_PHILIPS_NTSC 2
52#define TUNER_PHILIPS_SECAM 3 /* you must actively select B/G, L, L` */
53
54#define TUNER_ABSENT 4
55#define TUNER_PHILIPS_PAL 5
56#define TUNER_TEMIC_NTSC 6 /* 4032 FY5 (3X 7004, 9498, 9789) */
57#define TUNER_TEMIC_PAL_I 7 /* 4062 FY5 (3X 8501, 9957) */
58
59#define TUNER_TEMIC_4036FY5_NTSC 8 /* 4036 FY5 (3X 1223, 1981, 7686) */
60#define TUNER_ALPS_TSBH1_NTSC 9
61#define TUNER_ALPS_TSBE1_PAL 10
62#define TUNER_ALPS_TSBB5_PAL_I 11
63
64#define TUNER_ALPS_TSBE5_PAL 12
65#define TUNER_ALPS_TSBC5_PAL 13
66#define TUNER_TEMIC_4006FH5_PAL 14 /* 4006 FH5 (3X 9500, 9501, 7291) */
67#define TUNER_ALPS_TSHC6_NTSC 15
68
69#define TUNER_TEMIC_PAL_DK 16 /* 4016 FY5 (3X 1392, 1393) */
70#define TUNER_PHILIPS_NTSC_M 17
71#define TUNER_TEMIC_4066FY5_PAL_I 18 /* 4066 FY5 (3X 7032, 7035) */
72#define TUNER_TEMIC_4006FN5_MULTI_PAL 19 /* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */
73
74#define TUNER_TEMIC_4009FR5_PAL 20 /* incl. FM radio (3X 7607, 7488, 7711) */
75#define TUNER_TEMIC_4039FR5_NTSC 21 /* incl. FM radio (3X 7246, 7578, 7732) */
76#define TUNER_TEMIC_4046FM5 22 /* you must actively select B/G, D/K, I, L, L` ! (3X 7804, 7806, 8103, 8104) */
1da177e4
LT
77#define TUNER_PHILIPS_PAL_DK 23
78
1c94aeec
MCC
79#define TUNER_PHILIPS_FQ1216ME 24 /* you must actively select B/G/D/K, I, L, L` */
80#define TUNER_LG_PAL_I_FM 25
81#define TUNER_LG_PAL_I 26
82#define TUNER_LG_NTSC_FM 27
1da177e4 83
1c94aeec
MCC
84#define TUNER_LG_PAL_FM 28
85#define TUNER_LG_PAL 29
86#define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30 /* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
87#define TUNER_SHARP_2U5JF5540_NTSC 31
1da177e4 88
1c94aeec
MCC
89#define TUNER_Samsung_PAL_TCPM9091PD27 32
90#define TUNER_MT2032 33
91#define TUNER_TEMIC_4106FH5 34 /* 4106 FH5 (3X 7808, 7865) */
92#define TUNER_TEMIC_4012FY5 35 /* 4012 FY5 (3X 0971, 1099) */
1da177e4 93
1c94aeec
MCC
94#define TUNER_TEMIC_4136FY5 36 /* 4136 FY5 (3X 7708, 7746) */
95#define TUNER_LG_PAL_NEW_TAPC 37
96#define TUNER_PHILIPS_FM1216ME_MK3 38
97#define TUNER_LG_NTSC_NEW_TAPC 39
1da177e4 98
1c94aeec
MCC
99#define TUNER_HITACHI_NTSC 40
100#define TUNER_PHILIPS_PAL_MK 41
ab8b870e 101#define TUNER_PHILIPS_FCV1236D 42
1c94aeec 102#define TUNER_PHILIPS_FM1236_MK3 43
1da177e4 103
1c94aeec 104#define TUNER_PHILIPS_4IN1 44 /* ATI TV Wonder Pro - Conexant */
62e93f09
MCC
105 /*
106 * Microtune merged with Temic 12/31/1999 partially financed by Alps.
107 * these may be similar to Temic
108 */
109#define TUNER_MICROTUNE_4049FM5 45
174329d9 110#define TUNER_PANASONIC_VP27 46
1c94aeec
MCC
111#define TUNER_LG_NTSC_TAPE 47
112
113#define TUNER_TNF_8831BGFF 48
114#define TUNER_MICROTUNE_4042FI5 49 /* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
115#define TUNER_TCL_2002N 50
116#define TUNER_PHILIPS_FM1256_IH3 51
117
118#define TUNER_THOMSON_DTT7610 52
119#define TUNER_PHILIPS_FQ1286 53
120#define TUNER_PHILIPS_TDA8290 54
20f441f6 121#define TUNER_TCL_2002MB 55 /* Hauppauge PVR-150 PAL */
1c94aeec
MCC
122
123#define TUNER_PHILIPS_FQ1216AME_MK4 56 /* Hauppauge PVR-150 PAL */
124#define TUNER_PHILIPS_FQ1236A_MK4 57 /* Hauppauge PVR-500MCE NTSC */
125#define TUNER_YMEC_TVF_8531MF 58
126#define TUNER_YMEC_TVF_5533MF 59 /* Pixelview Pro Ultra NTSC */
127
83ac8722 128#define TUNER_THOMSON_DTT761X 60 /* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
1c94aeec
MCC
129#define TUNER_TENA_9533_DI 61
130#define TUNER_TEA5767 62 /* Only FM Radio Tuner */
131#define TUNER_PHILIPS_FMD1216ME_MK3 63
132
9c26c8b1 133#define TUNER_LG_TDVS_H06XF 64 /* TDVS H061F, H062F, H064F */
1c94aeec 134#define TUNER_YMEC_TVF66T5_B_DFF 65 /* Acorp Y878F */
f3629be8 135#define TUNER_LG_TALN 66
93df3413 136#define TUNER_PHILIPS_TD1316 67
793cf9e6 137
e976f937 138#define TUNER_PHILIPS_TUV1236D 68 /* ATI HDTV Wonder */
633323ff 139#define TUNER_TNF_5335MF 69 /* Sabrent Bt848 */
62e93f09 140#define TUNER_SAMSUNG_TCPN_2121P30A 70 /* Hauppauge PVR-500MCE NTSC */
12466577 141#define TUNER_XC2028 71
0004fd59 142
91ae3299 143#define TUNER_THOMSON_FE6600 72 /* DViCO FusionHDTV DVB-T Hybrid */
62e93f09 144#define TUNER_SAMSUNG_TCPG_6121P30A 73 /* Hauppauge PVR-500 PAL */
15396236 145#define TUNER_TDA9887 74 /* This tuner should be used only internally */
8573a9e6 146#define TUNER_TEA5761 75 /* Only FM Radio Tuner */
27c685a4 147#define TUNER_XC5000 76 /* Xceive Silicon Tuner */
8f2b7b70 148#define TUNER_TCL_MF02GIP_5N 77 /* TCL MF02GIP_5N */
953cafc0 149#define TUNER_PHILIPS_FMD1216MEX_MK3 78
8475cbcb 150#define TUNER_PHILIPS_FM1216MK5 79
5ddc9b10 151#define TUNER_PHILIPS_FQ1216LME_MK3 80 /* Active loopthrough, no FM */
8d009a0c 152
e3e1920b 153#define TUNER_PARTSNIC_PTI_5NF05 81
e558170a 154#define TUNER_PHILIPS_CU1216L 82
93463895 155#define TUNER_NXP_TDA18271 83
dbb9de9b 156#define TUNER_SONY_BTF_PXN01Z 84
095c2471 157#define TUNER_PHILIPS_FQ1236_MK5 85 /* NTSC, TDA9885, no FM radio */
0cda1255 158#define TUNER_TENA_TNF_5337 86
780dfef3 159
cd4ca7af 160#define TUNER_XC4000 87 /* Xceive Silicon Tuner */
f21cfaf6 161#define TUNER_XC5000C 88 /* Xceive Silicon Tuner */
cd4ca7af 162
e4d2a616
HV
163#define TUNER_SONY_BTF_PG472Z 89 /* PAL+SECAM */
164#define TUNER_SONY_BTF_PK467Z 90 /* NTSC_JP */
165#define TUNER_SONY_BTF_PB463Z 91 /* NTSC */
166
1da177e4 167/* tv card specific */
62e93f09
MCC
168#define TDA9887_PRESENT (1<<0)
169#define TDA9887_PORT1_INACTIVE (1<<1)
170#define TDA9887_PORT2_INACTIVE (1<<2)
171#define TDA9887_QSS (1<<3)
172#define TDA9887_INTERCARRIER (1<<4)
173#define TDA9887_PORT1_ACTIVE (1<<5)
174#define TDA9887_PORT2_ACTIVE (1<<6)
175#define TDA9887_INTERCARRIER_NTSC (1<<7)
f98c55ea 176/* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
62e93f09
MCC
177#define TDA9887_TOP_MASK (0x3f << 8)
178#define TDA9887_TOP_SET (1 << 13)
179#define TDA9887_TOP(top) (TDA9887_TOP_SET | \
180 (((16 + (top)) & 0x1f) << 8))
f98c55ea 181
1da177e4 182/* config options */
62e93f09
MCC
183#define TDA9887_DEEMPHASIS_MASK (3<<16)
184#define TDA9887_DEEMPHASIS_NONE (1<<16)
185#define TDA9887_DEEMPHASIS_50 (2<<16)
186#define TDA9887_DEEMPHASIS_75 (3<<16)
187#define TDA9887_AUTOMUTE (1<<18)
d7304dee 188#define TDA9887_GATING_18 (1<<19)
cefccc80 189#define TDA9887_GAIN_NORMAL (1<<20)
5e082f15 190#define TDA9887_RIF_41_3 (1<<21) /* radio IF1 41.3 vs 33.3 */
1da177e4 191
07c68a74
MCC
192/**
193 * enum tuner_mode - Mode of the tuner
194 *
195 * @T_RADIO: Tuner core will work in radio mode
196 * @T_ANALOG_TV: Tuner core will work in analog TV mode
197 *
198 * Older boards only had a single tuner device, but some devices have a
199 * separate tuner for radio. In any case, the tuner-core needs to know if
200 * the tuner chip(s) will be used in radio mode or analog TV mode, as, on
201 * radio mode, frequencies are specified on a different range than on TV
202 * mode. This enum is used by the tuner core in order to work with the
203 * proper tuner range and eventually use a different tuner chip while in
204 * radio mode.
205 */
f7ce3cc6 206enum tuner_mode {
f7ce3cc6
MCC
207 T_RADIO = 1 << V4L2_TUNER_RADIO,
208 T_ANALOG_TV = 1 << V4L2_TUNER_ANALOG_TV,
62e93f09 209 /* Don't map V4L2_TUNER_DIGITAL_TV, as tuner-core won't use it */
f7ce3cc6
MCC
210};
211
07c68a74
MCC
212/**
213 * struct tuner_setup - setup the tuner chipsets
214 *
215 * @addr: I2C address used to control the tuner device/chipset
216 * @type: Type of the tuner, as defined at the TUNER_* macros.
217 * Each different tuner model should have an unique
218 * identifier.
219 * @mode_mask: Mask with the allowed tuner modes: V4L2_TUNER_RADIO,
220 * V4L2_TUNER_ANALOG_TV and/or V4L2_TUNER_DIGITAL_TV,
221 * describing if the tuner should be used to support
222 * Radio, analog TV and/or digital TV.
223 * @config: Used to send tuner-specific configuration for complex
224 * tuners that require extra parameters to be set.
225 * Only a very few tuners require it and its usage on
226 * newer tuners should be avoided.
227 * @tuner_callback: Some tuners require to call back the bridge driver,
228 * in order to do some tasks like rising a GPIO at the
229 * bridge chipset, in order to do things like resetting
230 * the device.
231 *
232 * Older boards only had a single tuner device. Nowadays multiple tuner
233 * devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
234 * to pass the tuner_setup structure it is possible to setup each tuner
235 * device in turn.
236 *
237 * Since multiple devices may be present it is no longer sufficient to
238 * send a command to a single i2c device. Instead you should broadcast
239 * the command to all i2c devices.
240 *
241 * By setting the mode_mask correctly you can select which commands are
242 * accepted by a specific tuner device. For example, set mode_mask to
243 * T_RADIO if the device is a radio-only tuner. That specific tuner will
244 * only accept commands when the tuner is in radio mode and ignore them
245 * when the tuner is set to TV mode.
a544521e
HV
246 */
247
f7ce3cc6 248struct tuner_setup {
07c68a74
MCC
249 unsigned short addr;
250 unsigned int type;
251 unsigned int mode_mask;
252 void *config;
62e93f09 253 int (*tuner_callback)(void *dev, int component, int cmd, int arg);
391cd727
MCC
254};
255
1da177e4
LT
256#endif /* __KERNEL__ */
257
1c94aeec 258#endif /* _TUNER_H */
This page took 1.136696 seconds and 5 git commands to generate.