[mirror_ubuntu-bionic-kernel.git] / include / media / tuner.h

/*
 * tuner.h - definition for different tuners
 *
 * Copyright (C) 1997 Markus Schroeder (schroedm@uni-duesseldorf.de)
 * minor modifications by Ralph Metzler (rjkm@thp.uni-koeln.de)
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */

#ifndef _TUNER_H
#define _TUNER_H
#ifdef __KERNEL__

#include <linux/videodev2.h>
#include <media/v4l2-mc.h>

#define ADDR_UNSET (255)

#define TUNER_TEMIC_PAL			0        /* 4002 FH5 (3X 7756, 9483) */
#define TUNER_PHILIPS_PAL_I		1
#define TUNER_PHILIPS_NTSC		2
#define TUNER_PHILIPS_SECAM		3	/* you must actively select B/G, L, L` */

#define TUNER_ABSENT			4
#define TUNER_PHILIPS_PAL		5
#define TUNER_TEMIC_NTSC		6	/* 4032 FY5 (3X 7004, 9498, 9789)  */
#define TUNER_TEMIC_PAL_I		7	/* 4062 FY5 (3X 8501, 9957) */

#define TUNER_TEMIC_4036FY5_NTSC	8	/* 4036 FY5 (3X 1223, 1981, 7686) */
#define TUNER_ALPS_TSBH1_NTSC		9
#define TUNER_ALPS_TSBE1_PAL		10
#define TUNER_ALPS_TSBB5_PAL_I		11

#define TUNER_ALPS_TSBE5_PAL		12
#define TUNER_ALPS_TSBC5_PAL		13
#define TUNER_TEMIC_4006FH5_PAL		14	/* 4006 FH5 (3X 9500, 9501, 7291) */
#define TUNER_ALPS_TSHC6_NTSC		15

#define TUNER_TEMIC_PAL_DK		16	/* 4016 FY5 (3X 1392, 1393) */
#define TUNER_PHILIPS_NTSC_M		17
#define TUNER_TEMIC_4066FY5_PAL_I	18	/* 4066 FY5 (3X 7032, 7035) */
#define TUNER_TEMIC_4006FN5_MULTI_PAL	19	/* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */

#define TUNER_TEMIC_4009FR5_PAL		20	/* incl. FM radio (3X 7607, 7488, 7711) */
#define TUNER_TEMIC_4039FR5_NTSC	21	/* incl. FM radio (3X 7246, 7578, 7732) */
#define TUNER_TEMIC_4046FM5		22	/* you must actively select B/G, D/K, I, L, L` !  (3X 7804, 7806, 8103, 8104) */
#define TUNER_PHILIPS_PAL_DK		23

#define TUNER_PHILIPS_FQ1216ME		24	/* you must actively select B/G/D/K, I, L, L` */
#define TUNER_LG_PAL_I_FM		25
#define TUNER_LG_PAL_I			26
#define TUNER_LG_NTSC_FM		27

#define TUNER_LG_PAL_FM			28
#define TUNER_LG_PAL			29
#define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30	/* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
#define TUNER_SHARP_2U5JF5540_NTSC	31

#define TUNER_Samsung_PAL_TCPM9091PD27	32
#define TUNER_MT2032			33
#define TUNER_TEMIC_4106FH5		34	/* 4106 FH5 (3X 7808, 7865) */
#define TUNER_TEMIC_4012FY5		35	/* 4012 FY5 (3X 0971, 1099) */

#define TUNER_TEMIC_4136FY5		36	/* 4136 FY5 (3X 7708, 7746) */
#define TUNER_LG_PAL_NEW_TAPC		37
#define TUNER_PHILIPS_FM1216ME_MK3	38
#define TUNER_LG_NTSC_NEW_TAPC		39

#define TUNER_HITACHI_NTSC		40
#define TUNER_PHILIPS_PAL_MK		41
#define TUNER_PHILIPS_FCV1236D		42
#define TUNER_PHILIPS_FM1236_MK3	43

#define TUNER_PHILIPS_4IN1		44	/* ATI TV Wonder Pro - Conexant */
	/*
	 * Microtune merged with Temic 12/31/1999 partially financed by Alps.
	 * these may be similar to Temic
	 */
#define TUNER_MICROTUNE_4049FM5		45
#define TUNER_PANASONIC_VP27		46
#define TUNER_LG_NTSC_TAPE		47

#define TUNER_TNF_8831BGFF		48
#define TUNER_MICROTUNE_4042FI5		49	/* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
#define TUNER_TCL_2002N			50
#define TUNER_PHILIPS_FM1256_IH3	51

#define TUNER_THOMSON_DTT7610		52
#define TUNER_PHILIPS_FQ1286		53
#define TUNER_PHILIPS_TDA8290		54
#define TUNER_TCL_2002MB		55	/* Hauppauge PVR-150 PAL */

#define TUNER_PHILIPS_FQ1216AME_MK4	56	/* Hauppauge PVR-150 PAL */
#define TUNER_PHILIPS_FQ1236A_MK4	57	/* Hauppauge PVR-500MCE NTSC */
#define TUNER_YMEC_TVF_8531MF		58
#define TUNER_YMEC_TVF_5533MF		59	/* Pixelview Pro Ultra NTSC */

#define TUNER_THOMSON_DTT761X		60	/* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
#define TUNER_TENA_9533_DI		61
#define TUNER_TEA5767			62	/* Only FM Radio Tuner */
#define TUNER_PHILIPS_FMD1216ME_MK3	63

#define TUNER_LG_TDVS_H06XF		64	/* TDVS H061F, H062F, H064F */
#define TUNER_YMEC_TVF66T5_B_DFF	65	/* Acorp Y878F */
#define TUNER_LG_TALN			66
#define TUNER_PHILIPS_TD1316		67

#define TUNER_PHILIPS_TUV1236D		68	/* ATI HDTV Wonder */
#define TUNER_TNF_5335MF                69	/* Sabrent Bt848   */
#define TUNER_SAMSUNG_TCPN_2121P30A     70	/* Hauppauge PVR-500MCE NTSC */
#define TUNER_XC2028			71

#define TUNER_THOMSON_FE6600		72	/* DViCO FusionHDTV DVB-T Hybrid */
#define TUNER_SAMSUNG_TCPG_6121P30A     73	/* Hauppauge PVR-500 PAL */
#define TUNER_TDA9887                   74      /* This tuner should be used only internally */
#define TUNER_TEA5761			75	/* Only FM Radio Tuner */
#define TUNER_XC5000			76	/* Xceive Silicon Tuner */
#define TUNER_TCL_MF02GIP_5N		77	/* TCL MF02GIP_5N */
#define TUNER_PHILIPS_FMD1216MEX_MK3	78
#define TUNER_PHILIPS_FM1216MK5		79
#define TUNER_PHILIPS_FQ1216LME_MK3	80	/* Active loopthrough, no FM */

#define TUNER_PARTSNIC_PTI_5NF05	81
#define TUNER_PHILIPS_CU1216L           82
#define TUNER_NXP_TDA18271		83
#define TUNER_SONY_BTF_PXN01Z		84
#define TUNER_PHILIPS_FQ1236_MK5	85	/* NTSC, TDA9885, no FM radio */
#define TUNER_TENA_TNF_5337		86

#define TUNER_XC4000			87	/* Xceive Silicon Tuner */
#define TUNER_XC5000C			88	/* Xceive Silicon Tuner */

#define TUNER_SONY_BTF_PG472Z		89	/* PAL+SECAM */
#define TUNER_SONY_BTF_PK467Z		90	/* NTSC_JP */
#define TUNER_SONY_BTF_PB463Z		91	/* NTSC */

/* tv card specific */
#define TDA9887_PRESENT			(1<<0)
#define TDA9887_PORT1_INACTIVE		(1<<1)
#define TDA9887_PORT2_INACTIVE		(1<<2)
#define TDA9887_QSS			(1<<3)
#define TDA9887_INTERCARRIER		(1<<4)
#define TDA9887_PORT1_ACTIVE		(1<<5)
#define TDA9887_PORT2_ACTIVE		(1<<6)
#define TDA9887_INTERCARRIER_NTSC	(1<<7)
/* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
#define TDA9887_TOP_MASK		(0x3f << 8)
#define TDA9887_TOP_SET			(1 << 13)
#define TDA9887_TOP(top)		(TDA9887_TOP_SET | \
					 (((16 + (top)) & 0x1f) << 8))

/* config options */
#define TDA9887_DEEMPHASIS_MASK		(3<<16)
#define TDA9887_DEEMPHASIS_NONE		(1<<16)
#define TDA9887_DEEMPHASIS_50		(2<<16)
#define TDA9887_DEEMPHASIS_75		(3<<16)
#define TDA9887_AUTOMUTE		(1<<18)
#define TDA9887_GATING_18		(1<<19)
#define TDA9887_GAIN_NORMAL		(1<<20)
#define TDA9887_RIF_41_3		(1<<21)  /* radio IF1 41.3 vs 33.3 */

/**
 * enum tuner_mode      - Mode of the tuner
 *
 * @T_RADIO:        Tuner core will work in radio mode
 * @T_ANALOG_TV:    Tuner core will work in analog TV mode
 *
 * Older boards only had a single tuner device, but some devices have a
 * separate tuner for radio. In any case, the tuner-core needs to know if
 * the tuner chip(s) will be used in radio mode or analog TV mode, as, on
 * radio mode, frequencies are specified on a different range than on TV
 * mode. This enum is used by the tuner core in order to work with the
 * proper tuner range and eventually use a different tuner chip while in
 * radio mode.
 */
enum tuner_mode {
	T_RADIO		= 1 << V4L2_TUNER_RADIO,
	T_ANALOG_TV     = 1 << V4L2_TUNER_ANALOG_TV,
	/* Don't map V4L2_TUNER_DIGITAL_TV, as tuner-core won't use it */
};

/**
 * struct tuner_setup   - setup the tuner chipsets
 *
 * @addr:		I2C address used to control the tuner device/chipset
 * @type:		Type of the tuner, as defined at the TUNER_* macros.
 *			Each different tuner model should have an unique
 *			identifier.
 * @mode_mask:		Mask with the allowed tuner modes: V4L2_TUNER_RADIO,
 *			V4L2_TUNER_ANALOG_TV and/or V4L2_TUNER_DIGITAL_TV,
 *			describing if the tuner should be used to support
 *			Radio, analog TV and/or digital TV.
 * @config:		Used to send tuner-specific configuration for complex
 *			tuners that require extra parameters to be set.
 *			Only a very few tuners require it and its usage on
 *			newer tuners should be avoided.
 * @tuner_callback:	Some tuners require to call back the bridge driver,
 *			in order to do some tasks like rising a GPIO at the
 *			bridge chipset, in order to do things like resetting
 *			the device.
 *
 * Older boards only had a single tuner device. Nowadays multiple tuner
 * devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
 * to pass the tuner_setup structure it is possible to setup each tuner
 * device in turn.
 *
 * Since multiple devices may be present it is no longer sufficient to
 * send a command to a single i2c device. Instead you should broadcast
 * the command to all i2c devices.
 *
 * By setting the mode_mask correctly you can select which commands are
 * accepted by a specific tuner device. For example, set mode_mask to
 * T_RADIO if the device is a radio-only tuner. That specific tuner will
 * only accept commands when the tuner is in radio mode and ignore them
 * when the tuner is set to TV mode.
 */

struct tuner_setup {
	unsigned short	addr;
	unsigned int	type;
	unsigned int	mode_mask;
	void		*config;
	int (*tuner_callback)(void *dev, int component, int cmd, int arg);
};

#endif /* __KERNEL__ */

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