xref: /openbmc/linux/include/media/tuner.h (revision b3d37042)
110b89ee3SMauro Carvalho Chehab /*
21da177e4SLinus Torvalds     tuner.h - definition for different tuners
31da177e4SLinus Torvalds 
41da177e4SLinus Torvalds     Copyright (C) 1997 Markus Schroeder (schroedm@uni-duesseldorf.de)
51da177e4SLinus Torvalds     minor modifications by Ralph Metzler (rjkm@thp.uni-koeln.de)
61da177e4SLinus Torvalds 
71da177e4SLinus Torvalds     This program is free software; you can redistribute it and/or modify
81da177e4SLinus Torvalds     it under the terms of the GNU General Public License as published by
91da177e4SLinus Torvalds     the Free Software Foundation; either version 2 of the License, or
101da177e4SLinus Torvalds     (at your option) any later version.
111da177e4SLinus Torvalds 
121da177e4SLinus Torvalds     This program is distributed in the hope that it will be useful,
131da177e4SLinus Torvalds     but WITHOUT ANY WARRANTY; without even the implied warranty of
141da177e4SLinus Torvalds     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
151da177e4SLinus Torvalds     GNU General Public License for more details.
161da177e4SLinus Torvalds 
171da177e4SLinus Torvalds     You should have received a copy of the GNU General Public License
181da177e4SLinus Torvalds     along with this program; if not, write to the Free Software
191da177e4SLinus Torvalds     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
201da177e4SLinus Torvalds */
211da177e4SLinus Torvalds 
221da177e4SLinus Torvalds #ifndef _TUNER_H
231da177e4SLinus Torvalds #define _TUNER_H
241da177e4SLinus Torvalds 
25586b0cabSMauro Carvalho Chehab #include <linux/videodev2.h>
267b0ac9cdSMichael Krufky #include <media/tuner-types.h>
27586b0cabSMauro Carvalho Chehab 
2856fc08caSMauro Carvalho Chehab #define ADDR_UNSET (255)
2956fc08caSMauro Carvalho Chehab 
301da177e4SLinus Torvalds #define TUNER_TEMIC_PAL			0        /* 4002 FH5 (3X 7756, 9483) */
311da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL_I		1
321da177e4SLinus Torvalds #define TUNER_PHILIPS_NTSC		2
331da177e4SLinus Torvalds #define TUNER_PHILIPS_SECAM		3	/* you must actively select B/G, L, L` */
341da177e4SLinus Torvalds 
351da177e4SLinus Torvalds #define TUNER_ABSENT			4
361da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL		5
371da177e4SLinus Torvalds #define TUNER_TEMIC_NTSC		6	/* 4032 FY5 (3X 7004, 9498, 9789)  */
381da177e4SLinus Torvalds #define TUNER_TEMIC_PAL_I		7	/* 4062 FY5 (3X 8501, 9957) */
391da177e4SLinus Torvalds 
401da177e4SLinus Torvalds #define TUNER_TEMIC_4036FY5_NTSC	8	/* 4036 FY5 (3X 1223, 1981, 7686) */
411da177e4SLinus Torvalds #define TUNER_ALPS_TSBH1_NTSC		9
421da177e4SLinus Torvalds #define TUNER_ALPS_TSBE1_PAL		10
431da177e4SLinus Torvalds #define TUNER_ALPS_TSBB5_PAL_I		11
441da177e4SLinus Torvalds 
451da177e4SLinus Torvalds #define TUNER_ALPS_TSBE5_PAL		12
461da177e4SLinus Torvalds #define TUNER_ALPS_TSBC5_PAL		13
471da177e4SLinus Torvalds #define TUNER_TEMIC_4006FH5_PAL		14	/* 4006 FH5 (3X 9500, 9501, 7291) */
481da177e4SLinus Torvalds #define TUNER_ALPS_TSHC6_NTSC		15
491da177e4SLinus Torvalds 
501da177e4SLinus Torvalds #define TUNER_TEMIC_PAL_DK		16	/* 4016 FY5 (3X 1392, 1393) */
511da177e4SLinus Torvalds #define TUNER_PHILIPS_NTSC_M		17
521da177e4SLinus Torvalds #define TUNER_TEMIC_4066FY5_PAL_I	18	/* 4066 FY5 (3X 7032, 7035) */
531da177e4SLinus Torvalds #define TUNER_TEMIC_4006FN5_MULTI_PAL	19	/* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */
541da177e4SLinus Torvalds 
551da177e4SLinus Torvalds #define TUNER_TEMIC_4009FR5_PAL		20	/* incl. FM radio (3X 7607, 7488, 7711) */
561da177e4SLinus Torvalds #define TUNER_TEMIC_4039FR5_NTSC	21	/* incl. FM radio (3X 7246, 7578, 7732) */
571da177e4SLinus Torvalds #define TUNER_TEMIC_4046FM5		22	/* you must actively select B/G, D/K, I, L, L` !  (3X 7804, 7806, 8103, 8104) */
581da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL_DK		23
591da177e4SLinus Torvalds 
601da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1216ME		24	/* you must actively select B/G/D/K, I, L, L` */
611da177e4SLinus Torvalds #define TUNER_LG_PAL_I_FM		25
621da177e4SLinus Torvalds #define TUNER_LG_PAL_I			26
631da177e4SLinus Torvalds #define TUNER_LG_NTSC_FM		27
641da177e4SLinus Torvalds 
651da177e4SLinus Torvalds #define TUNER_LG_PAL_FM			28
661da177e4SLinus Torvalds #define TUNER_LG_PAL			29
671da177e4SLinus Torvalds #define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30	/* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
681da177e4SLinus Torvalds #define TUNER_SHARP_2U5JF5540_NTSC	31
691da177e4SLinus Torvalds 
701da177e4SLinus Torvalds #define TUNER_Samsung_PAL_TCPM9091PD27	32
711da177e4SLinus Torvalds #define TUNER_MT2032			33
721da177e4SLinus Torvalds #define TUNER_TEMIC_4106FH5		34	/* 4106 FH5 (3X 7808, 7865) */
731da177e4SLinus Torvalds #define TUNER_TEMIC_4012FY5		35	/* 4012 FY5 (3X 0971, 1099) */
741da177e4SLinus Torvalds 
751da177e4SLinus Torvalds #define TUNER_TEMIC_4136FY5		36	/* 4136 FY5 (3X 7708, 7746) */
761da177e4SLinus Torvalds #define TUNER_LG_PAL_NEW_TAPC		37
771da177e4SLinus Torvalds #define TUNER_PHILIPS_FM1216ME_MK3	38
781da177e4SLinus Torvalds #define TUNER_LG_NTSC_NEW_TAPC		39
791da177e4SLinus Torvalds 
801da177e4SLinus Torvalds #define TUNER_HITACHI_NTSC		40
811da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL_MK		41
821da177e4SLinus Torvalds #define TUNER_PHILIPS_ATSC		42
831da177e4SLinus Torvalds #define TUNER_PHILIPS_FM1236_MK3	43
841da177e4SLinus Torvalds 
851da177e4SLinus Torvalds #define TUNER_PHILIPS_4IN1		44	/* ATI TV Wonder Pro - Conexant */
86174329d9SHans Verkuil /* Microtune merged with Temic 12/31/1999 partially financed by Alps - these may be similar to Temic */
871da177e4SLinus Torvalds #define TUNER_MICROTUNE_4049FM5 	45
88174329d9SHans Verkuil #define TUNER_PANASONIC_VP27		46
891da177e4SLinus Torvalds #define TUNER_LG_NTSC_TAPE		47
901da177e4SLinus Torvalds 
911da177e4SLinus Torvalds #define TUNER_TNF_8831BGFF		48
92586b0cabSMauro Carvalho Chehab #define TUNER_MICROTUNE_4042FI5		49	/* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
931da177e4SLinus Torvalds #define TUNER_TCL_2002N			50
941da177e4SLinus Torvalds #define TUNER_PHILIPS_FM1256_IH3	51
951da177e4SLinus Torvalds 
961da177e4SLinus Torvalds #define TUNER_THOMSON_DTT7610		52
971da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1286		53
981da177e4SLinus Torvalds #define TUNER_PHILIPS_TDA8290		54
9920f441f6SHans Verkuil #define TUNER_TCL_2002MB		55	/* Hauppauge PVR-150 PAL */
1001da177e4SLinus Torvalds 
1011da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1216AME_MK4	56	/* Hauppauge PVR-150 PAL */
1021da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1236A_MK4	57	/* Hauppauge PVR-500MCE NTSC */
103391cd727SMauro Carvalho Chehab #define TUNER_YMEC_TVF_8531MF		58
104391cd727SMauro Carvalho Chehab #define TUNER_YMEC_TVF_5533MF		59	/* Pixelview Pro Ultra NTSC */
1051c94aeecSMauro Carvalho Chehab 
10683ac8722SMichael Krufky #define TUNER_THOMSON_DTT761X		60	/* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
10756fc08caSMauro Carvalho Chehab #define TUNER_TENA_9533_DI		61
10856fc08caSMauro Carvalho Chehab #define TUNER_TEA5767			62	/* Only FM Radio Tuner */
109586b0cabSMauro Carvalho Chehab #define TUNER_PHILIPS_FMD1216ME_MK3	63
1101c94aeecSMauro Carvalho Chehab 
111fd3113e8SMauro Carvalho Chehab #define TUNER_LG_TDVS_H062F		64	/* DViCO FusionHDTV 5 */
112fd3113e8SMauro Carvalho Chehab #define TUNER_YMEC_TVF66T5_B_DFF	65	/* Acorp Y878F */
113793cf9e6SMauro Carvalho Chehab #define TUNER_LG_NTSC_TALN_MINI		66
11493df3413SHartmut Hackmann #define TUNER_PHILIPS_TD1316		67
115793cf9e6SMauro Carvalho Chehab 
116e976f937SKirk Lapray #define TUNER_PHILIPS_TUV1236D		68	/* ATI HDTV Wonder */
117633323ffSBill Pechter #define TUNER_TNF_5335MF                69	/* Sabrent Bt848   */
118*b3d37042SHans Verkuil #define TUNER_SAMSUNG_TCPN_2121P30A     70 	/* Hauppauge PVR-500MCE NTSC */
119e976f937SKirk Lapray 
1201da177e4SLinus Torvalds /* tv card specific */
1211da177e4SLinus Torvalds #define TDA9887_PRESENT 		(1<<0)
1221da177e4SLinus Torvalds #define TDA9887_PORT1_INACTIVE 		(1<<1)
1231da177e4SLinus Torvalds #define TDA9887_PORT2_INACTIVE 		(1<<2)
1241da177e4SLinus Torvalds #define TDA9887_QSS 			(1<<3)
1251da177e4SLinus Torvalds #define TDA9887_INTERCARRIER 		(1<<4)
1261da177e4SLinus Torvalds #define TDA9887_PORT1_ACTIVE 		(1<<5)
1271da177e4SLinus Torvalds #define TDA9887_PORT2_ACTIVE 		(1<<6)
1283ae1adc6SNickolay V. Shmyrev #define TDA9887_INTERCARRIER_NTSC 	(1<<7)
129f98c55eaSHans Verkuil /* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
130f98c55eaSHans Verkuil #define TDA9887_TOP_MASK 		(0x3f << 8)
131f98c55eaSHans Verkuil #define TDA9887_TOP_SET 		(1 << 13)
132f98c55eaSHans Verkuil #define TDA9887_TOP(top) 		(TDA9887_TOP_SET | (((16 + (top)) & 0x1f) << 8))
133f98c55eaSHans Verkuil 
1341da177e4SLinus Torvalds /* config options */
1351da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_MASK 	(3<<16)
1361da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_NONE 	(1<<16)
1371da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_50 		(2<<16)
1381da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_75 		(3<<16)
1391da177e4SLinus Torvalds #define TDA9887_AUTOMUTE 		(1<<18)
1401da177e4SLinus Torvalds 
1411da177e4SLinus Torvalds #ifdef __KERNEL__
1421da177e4SLinus Torvalds 
143f7ce3cc6SMauro Carvalho Chehab enum tuner_mode {
144f7ce3cc6SMauro Carvalho Chehab 	T_UNINITIALIZED = 0,
145f7ce3cc6SMauro Carvalho Chehab 	T_RADIO		= 1 << V4L2_TUNER_RADIO,
146f7ce3cc6SMauro Carvalho Chehab 	T_ANALOG_TV     = 1 << V4L2_TUNER_ANALOG_TV,
147f7ce3cc6SMauro Carvalho Chehab 	T_DIGITAL_TV    = 1 << V4L2_TUNER_DIGITAL_TV,
148f7ce3cc6SMauro Carvalho Chehab 	T_STANDBY	= 1 << 31
149f7ce3cc6SMauro Carvalho Chehab };
150f7ce3cc6SMauro Carvalho Chehab 
151a544521eSHans Verkuil /* Older boards only had a single tuner device. Nowadays multiple tuner
152a544521eSHans Verkuil    devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
153a544521eSHans Verkuil    to pass the tuner_setup structure it is possible to setup each tuner
154a544521eSHans Verkuil    device in turn.
155a544521eSHans Verkuil 
156a544521eSHans Verkuil    Since multiple devices may be present it is no longer sufficient to
157a544521eSHans Verkuil    send a command to a single i2c device. Instead you should broadcast
158a544521eSHans Verkuil    the command to all i2c devices.
159a544521eSHans Verkuil 
160a544521eSHans Verkuil    By setting the mode_mask correctly you can select which commands are
161a544521eSHans Verkuil    accepted by a specific tuner device. For example, set mode_mask to
162a544521eSHans Verkuil    T_RADIO if the device is a radio-only tuner. That specific tuner will
163a544521eSHans Verkuil    only accept commands when the tuner is in radio mode and ignore them
164a544521eSHans Verkuil    when the tuner is set to TV mode.
165a544521eSHans Verkuil  */
166a544521eSHans Verkuil 
167f7ce3cc6SMauro Carvalho Chehab struct tuner_setup {
168a544521eSHans Verkuil 	unsigned short	addr; 	/* I2C address */
169a544521eSHans Verkuil 	unsigned int	type;   /* Tuner type */
170a544521eSHans Verkuil 	unsigned int	mode_mask;  /* Allowed tuner modes */
171391cd727SMauro Carvalho Chehab };
172391cd727SMauro Carvalho Chehab 
1731da177e4SLinus Torvalds struct tuner {
1741da177e4SLinus Torvalds 	/* device */
1751da177e4SLinus Torvalds 	struct i2c_client i2c;
1761da177e4SLinus Torvalds 
1771da177e4SLinus Torvalds 	unsigned int type;	/* chip type */
1781da177e4SLinus Torvalds 
179f7ce3cc6SMauro Carvalho Chehab 	unsigned int mode;
180f7ce3cc6SMauro Carvalho Chehab 	unsigned int mode_mask;	/* Combination of allowable modes */
181f7ce3cc6SMauro Carvalho Chehab 
182f7ce3cc6SMauro Carvalho Chehab 	unsigned int freq;	/* keep track of the current settings */
183f7ce3cc6SMauro Carvalho Chehab 	unsigned int audmode;
184f7ce3cc6SMauro Carvalho Chehab 	v4l2_std_id  std;
185f7ce3cc6SMauro Carvalho Chehab 
186f7ce3cc6SMauro Carvalho Chehab 	int          using_v4l2;
1871da177e4SLinus Torvalds 
1881da177e4SLinus Torvalds 	/* used by MT2032 */
1891da177e4SLinus Torvalds 	unsigned int xogc;
1901da177e4SLinus Torvalds 	unsigned int radio_if2;
1911da177e4SLinus Torvalds 
1921da177e4SLinus Torvalds 	/* used by tda8290 */
193de48eebcSHartmut Hackmann 	unsigned char tda8290_easy_mode;
194de48eebcSHartmut Hackmann 	unsigned char tda827x_lpsel;
195de48eebcSHartmut Hackmann 	unsigned char tda827x_addr;
196de48eebcSHartmut Hackmann 	unsigned char tda827x_ver;
19770b6934aSNickolay V. Shmyrev 	unsigned int sgIF;
1981da177e4SLinus Torvalds 
1991da177e4SLinus Torvalds 	/* function ptrs */
2001da177e4SLinus Torvalds 	void (*tv_freq)(struct i2c_client *c, unsigned int freq);
2011da177e4SLinus Torvalds 	void (*radio_freq)(struct i2c_client *c, unsigned int freq);
2021da177e4SLinus Torvalds 	int  (*has_signal)(struct i2c_client *c);
2031da177e4SLinus Torvalds 	int  (*is_stereo)(struct i2c_client *c);
204793cf9e6SMauro Carvalho Chehab 	void (*standby)(struct i2c_client *c);
2051da177e4SLinus Torvalds };
2061da177e4SLinus Torvalds 
2071da177e4SLinus Torvalds extern unsigned const int tuner_count;
2081da177e4SLinus Torvalds 
2091da177e4SLinus Torvalds extern int microtune_init(struct i2c_client *c);
2101da177e4SLinus Torvalds extern int tda8290_init(struct i2c_client *c);
21190e9df7fSHartmut Hackmann extern int tda8290_probe(struct i2c_client *c);
212586b0cabSMauro Carvalho Chehab extern int tea5767_tuner_init(struct i2c_client *c);
2131da177e4SLinus Torvalds extern int default_tuner_init(struct i2c_client *c);
214f7ce3cc6SMauro Carvalho Chehab extern int tea5767_autodetection(struct i2c_client *c);
2151da177e4SLinus Torvalds 
216793cf9e6SMauro Carvalho Chehab #define tuner_warn(fmt, arg...) do {\
217604f28e2SLaurent Riffard 	printk(KERN_WARNING "%s %d-%04x: " fmt, t->i2c.driver->driver.name, \
2187e578191SMauro Carvalho Chehab 			i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
219793cf9e6SMauro Carvalho Chehab #define tuner_info(fmt, arg...) do {\
220604f28e2SLaurent Riffard 	printk(KERN_INFO "%s %d-%04x: " fmt, t->i2c.driver->driver.name, \
2217e578191SMauro Carvalho Chehab 			i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
222793cf9e6SMauro Carvalho Chehab #define tuner_dbg(fmt, arg...) do {\
223f9195dedSHans Verkuil 	extern int tuner_debug; \
224f9195dedSHans Verkuil 	if (tuner_debug) \
2257e578191SMauro Carvalho Chehab 		printk(KERN_DEBUG "%s %d-%04x: " fmt, t->i2c.driver->driver.name, \
2267e578191SMauro Carvalho Chehab 			i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
2271da177e4SLinus Torvalds 
2281da177e4SLinus Torvalds #endif /* __KERNEL__ */
2291da177e4SLinus Torvalds 
2301c94aeecSMauro Carvalho Chehab #endif /* _TUNER_H */
2311da177e4SLinus Torvalds 
2321da177e4SLinus Torvalds /*
2331da177e4SLinus Torvalds  * Overrides for Emacs so that we follow Linus's tabbing style.
2341da177e4SLinus Torvalds  * ---------------------------------------------------------------------------
2351da177e4SLinus Torvalds  * Local variables:
2361da177e4SLinus Torvalds  * c-basic-offset: 8
2371da177e4SLinus Torvalds  * End:
2381da177e4SLinus Torvalds  */
239