1c942fddfSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */ 210b89ee3SMauro Carvalho Chehab /* 362e93f09SMauro Carvalho Chehab * tuner.h - definition for different tuners 462e93f09SMauro Carvalho Chehab * 562e93f09SMauro Carvalho Chehab * Copyright (C) 1997 Markus Schroeder (schroedm@uni-duesseldorf.de) 662e93f09SMauro Carvalho Chehab * minor modifications by Ralph Metzler (rjkm@thp.uni-koeln.de) 71da177e4SLinus Torvalds */ 81da177e4SLinus Torvalds 91da177e4SLinus Torvalds #ifndef _TUNER_H 101da177e4SLinus Torvalds #define _TUNER_H 112d351df4SMauro Carvalho Chehab #ifdef __KERNEL__ 121da177e4SLinus Torvalds 13586b0cabSMauro Carvalho Chehab #include <linux/videodev2.h> 146aad127dSMauro Carvalho Chehab #include <media/v4l2-mc.h> 15188d2d55SMauro Carvalho Chehab 1656fc08caSMauro Carvalho Chehab #define ADDR_UNSET (255) 1756fc08caSMauro Carvalho Chehab 181da177e4SLinus Torvalds #define TUNER_TEMIC_PAL 0 /* 4002 FH5 (3X 7756, 9483) */ 191da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL_I 1 201da177e4SLinus Torvalds #define TUNER_PHILIPS_NTSC 2 211da177e4SLinus Torvalds #define TUNER_PHILIPS_SECAM 3 /* you must actively select B/G, L, L` */ 221da177e4SLinus Torvalds 231da177e4SLinus Torvalds #define TUNER_ABSENT 4 241da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL 5 251da177e4SLinus Torvalds #define TUNER_TEMIC_NTSC 6 /* 4032 FY5 (3X 7004, 9498, 9789) */ 261da177e4SLinus Torvalds #define TUNER_TEMIC_PAL_I 7 /* 4062 FY5 (3X 8501, 9957) */ 271da177e4SLinus Torvalds 281da177e4SLinus Torvalds #define TUNER_TEMIC_4036FY5_NTSC 8 /* 4036 FY5 (3X 1223, 1981, 7686) */ 291da177e4SLinus Torvalds #define TUNER_ALPS_TSBH1_NTSC 9 301da177e4SLinus Torvalds #define TUNER_ALPS_TSBE1_PAL 10 311da177e4SLinus Torvalds #define TUNER_ALPS_TSBB5_PAL_I 11 321da177e4SLinus Torvalds 331da177e4SLinus Torvalds #define TUNER_ALPS_TSBE5_PAL 12 341da177e4SLinus Torvalds #define TUNER_ALPS_TSBC5_PAL 13 351da177e4SLinus Torvalds #define TUNER_TEMIC_4006FH5_PAL 14 /* 4006 FH5 (3X 9500, 9501, 7291) */ 361da177e4SLinus Torvalds #define TUNER_ALPS_TSHC6_NTSC 15 371da177e4SLinus Torvalds 381da177e4SLinus Torvalds #define TUNER_TEMIC_PAL_DK 16 /* 4016 FY5 (3X 1392, 1393) */ 391da177e4SLinus Torvalds #define TUNER_PHILIPS_NTSC_M 17 401da177e4SLinus Torvalds #define TUNER_TEMIC_4066FY5_PAL_I 18 /* 4066 FY5 (3X 7032, 7035) */ 411da177e4SLinus Torvalds #define TUNER_TEMIC_4006FN5_MULTI_PAL 19 /* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */ 421da177e4SLinus Torvalds 431da177e4SLinus Torvalds #define TUNER_TEMIC_4009FR5_PAL 20 /* incl. FM radio (3X 7607, 7488, 7711) */ 441da177e4SLinus Torvalds #define TUNER_TEMIC_4039FR5_NTSC 21 /* incl. FM radio (3X 7246, 7578, 7732) */ 451da177e4SLinus Torvalds #define TUNER_TEMIC_4046FM5 22 /* you must actively select B/G, D/K, I, L, L` ! (3X 7804, 7806, 8103, 8104) */ 461da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL_DK 23 471da177e4SLinus Torvalds 481da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1216ME 24 /* you must actively select B/G/D/K, I, L, L` */ 491da177e4SLinus Torvalds #define TUNER_LG_PAL_I_FM 25 501da177e4SLinus Torvalds #define TUNER_LG_PAL_I 26 511da177e4SLinus Torvalds #define TUNER_LG_NTSC_FM 27 521da177e4SLinus Torvalds 531da177e4SLinus Torvalds #define TUNER_LG_PAL_FM 28 541da177e4SLinus Torvalds #define TUNER_LG_PAL 29 551da177e4SLinus Torvalds #define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30 /* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */ 561da177e4SLinus Torvalds #define TUNER_SHARP_2U5JF5540_NTSC 31 571da177e4SLinus Torvalds 581da177e4SLinus Torvalds #define TUNER_Samsung_PAL_TCPM9091PD27 32 591da177e4SLinus Torvalds #define TUNER_MT2032 33 601da177e4SLinus Torvalds #define TUNER_TEMIC_4106FH5 34 /* 4106 FH5 (3X 7808, 7865) */ 611da177e4SLinus Torvalds #define TUNER_TEMIC_4012FY5 35 /* 4012 FY5 (3X 0971, 1099) */ 621da177e4SLinus Torvalds 631da177e4SLinus Torvalds #define TUNER_TEMIC_4136FY5 36 /* 4136 FY5 (3X 7708, 7746) */ 641da177e4SLinus Torvalds #define TUNER_LG_PAL_NEW_TAPC 37 651da177e4SLinus Torvalds #define TUNER_PHILIPS_FM1216ME_MK3 38 661da177e4SLinus Torvalds #define TUNER_LG_NTSC_NEW_TAPC 39 671da177e4SLinus Torvalds 681da177e4SLinus Torvalds #define TUNER_HITACHI_NTSC 40 691da177e4SLinus Torvalds #define TUNER_PHILIPS_PAL_MK 41 70ab8b870eSMichael Krufky #define TUNER_PHILIPS_FCV1236D 42 711da177e4SLinus Torvalds #define TUNER_PHILIPS_FM1236_MK3 43 721da177e4SLinus Torvalds 731da177e4SLinus Torvalds #define TUNER_PHILIPS_4IN1 44 /* ATI TV Wonder Pro - Conexant */ 7462e93f09SMauro Carvalho Chehab /* 7562e93f09SMauro Carvalho Chehab * Microtune merged with Temic 12/31/1999 partially financed by Alps. 7662e93f09SMauro Carvalho Chehab * these may be similar to Temic 7762e93f09SMauro Carvalho Chehab */ 781da177e4SLinus Torvalds #define TUNER_MICROTUNE_4049FM5 45 79174329d9SHans Verkuil #define TUNER_PANASONIC_VP27 46 801da177e4SLinus Torvalds #define TUNER_LG_NTSC_TAPE 47 811da177e4SLinus Torvalds 821da177e4SLinus Torvalds #define TUNER_TNF_8831BGFF 48 83586b0cabSMauro Carvalho Chehab #define TUNER_MICROTUNE_4042FI5 49 /* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */ 841da177e4SLinus Torvalds #define TUNER_TCL_2002N 50 851da177e4SLinus Torvalds #define TUNER_PHILIPS_FM1256_IH3 51 861da177e4SLinus Torvalds 871da177e4SLinus Torvalds #define TUNER_THOMSON_DTT7610 52 881da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1286 53 891da177e4SLinus Torvalds #define TUNER_PHILIPS_TDA8290 54 9020f441f6SHans Verkuil #define TUNER_TCL_2002MB 55 /* Hauppauge PVR-150 PAL */ 911da177e4SLinus Torvalds 921da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1216AME_MK4 56 /* Hauppauge PVR-150 PAL */ 931da177e4SLinus Torvalds #define TUNER_PHILIPS_FQ1236A_MK4 57 /* Hauppauge PVR-500MCE NTSC */ 94391cd727SMauro Carvalho Chehab #define TUNER_YMEC_TVF_8531MF 58 95391cd727SMauro Carvalho Chehab #define TUNER_YMEC_TVF_5533MF 59 /* Pixelview Pro Ultra NTSC */ 961c94aeecSMauro Carvalho Chehab 9783ac8722SMichael Krufky #define TUNER_THOMSON_DTT761X 60 /* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */ 9856fc08caSMauro Carvalho Chehab #define TUNER_TENA_9533_DI 61 9956fc08caSMauro Carvalho Chehab #define TUNER_TEA5767 62 /* Only FM Radio Tuner */ 100586b0cabSMauro Carvalho Chehab #define TUNER_PHILIPS_FMD1216ME_MK3 63 1011c94aeecSMauro Carvalho Chehab 1029c26c8b1SMichael Krufky #define TUNER_LG_TDVS_H06XF 64 /* TDVS H061F, H062F, H064F */ 103fd3113e8SMauro Carvalho Chehab #define TUNER_YMEC_TVF66T5_B_DFF 65 /* Acorp Y878F */ 104f3629be8SMichael Krufky #define TUNER_LG_TALN 66 10593df3413SHartmut Hackmann #define TUNER_PHILIPS_TD1316 67 106793cf9e6SMauro Carvalho Chehab 107e976f937SKirk Lapray #define TUNER_PHILIPS_TUV1236D 68 /* ATI HDTV Wonder */ 108633323ffSBill Pechter #define TUNER_TNF_5335MF 69 /* Sabrent Bt848 */ 109b3d37042SHans Verkuil #define TUNER_SAMSUNG_TCPN_2121P30A 70 /* Hauppauge PVR-500MCE NTSC */ 11012466577SMauro Carvalho Chehab #define TUNER_XC2028 71 1110004fd59SMarkus Rechberger 11291ae3299SMichael Krufky #define TUNER_THOMSON_FE6600 72 /* DViCO FusionHDTV DVB-T Hybrid */ 113c344933aSHans Verkuil #define TUNER_SAMSUNG_TCPG_6121P30A 73 /* Hauppauge PVR-500 PAL */ 11415396236SMauro Carvalho Chehab #define TUNER_TDA9887 74 /* This tuner should be used only internally */ 1158573a9e6SMauro Carvalho Chehab #define TUNER_TEA5761 75 /* Only FM Radio Tuner */ 11627c685a4SSteven Toth #define TUNER_XC5000 76 /* Xceive Silicon Tuner */ 1178f2b7b70SMauro Carvalho Chehab #define TUNER_TCL_MF02GIP_5N 77 /* TCL MF02GIP_5N */ 118953cafc0SDarron Broad #define TUNER_PHILIPS_FMD1216MEX_MK3 78 1198475cbcbSDmitri Belimov #define TUNER_PHILIPS_FM1216MK5 79 1205ddc9b10SAndy Walls #define TUNER_PHILIPS_FQ1216LME_MK3 80 /* Active loopthrough, no FM */ 1218d009a0cSDavide Ferri 122e3e1920bSAndy Walls #define TUNER_PARTSNIC_PTI_5NF05 81 123e558170aSAntti Palosaari #define TUNER_PHILIPS_CU1216L 82 12493463895SMichael Krufky #define TUNER_NXP_TDA18271 83 125dbb9de9bSAndy Walls #define TUNER_SONY_BTF_PXN01Z 84 126095c2471SAndy Walls #define TUNER_PHILIPS_FQ1236_MK5 85 /* NTSC, TDA9885, no FM radio */ 1270cda1255SMauro Carvalho Chehab #define TUNER_TENA_TNF_5337 86 128780dfef3SChris Pascoe 129cd4ca7afSMiroslav Slugen #define TUNER_XC4000 87 /* Xceive Silicon Tuner */ 130f21cfaf6SMichael Krufky #define TUNER_XC5000C 88 /* Xceive Silicon Tuner */ 131cd4ca7afSMiroslav Slugen 132e4d2a616SHans Verkuil #define TUNER_SONY_BTF_PG472Z 89 /* PAL+SECAM */ 133e4d2a616SHans Verkuil #define TUNER_SONY_BTF_PK467Z 90 /* NTSC_JP */ 134e4d2a616SHans Verkuil #define TUNER_SONY_BTF_PB463Z 91 /* NTSC */ 135*c52e7b85SMauro Carvalho Chehab #define TUNER_SI2157 92 136e4d2a616SHans Verkuil 1371da177e4SLinus Torvalds /* tv card specific */ 1381da177e4SLinus Torvalds #define TDA9887_PRESENT (1<<0) 1391da177e4SLinus Torvalds #define TDA9887_PORT1_INACTIVE (1<<1) 1401da177e4SLinus Torvalds #define TDA9887_PORT2_INACTIVE (1<<2) 1411da177e4SLinus Torvalds #define TDA9887_QSS (1<<3) 1421da177e4SLinus Torvalds #define TDA9887_INTERCARRIER (1<<4) 1431da177e4SLinus Torvalds #define TDA9887_PORT1_ACTIVE (1<<5) 1441da177e4SLinus Torvalds #define TDA9887_PORT2_ACTIVE (1<<6) 1453ae1adc6SNickolay V. Shmyrev #define TDA9887_INTERCARRIER_NTSC (1<<7) 146f98c55eaSHans Verkuil /* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */ 147f98c55eaSHans Verkuil #define TDA9887_TOP_MASK (0x3f << 8) 148f98c55eaSHans Verkuil #define TDA9887_TOP_SET (1 << 13) 14962e93f09SMauro Carvalho Chehab #define TDA9887_TOP(top) (TDA9887_TOP_SET | \ 15062e93f09SMauro Carvalho Chehab (((16 + (top)) & 0x1f) << 8)) 151f98c55eaSHans Verkuil 1521da177e4SLinus Torvalds /* config options */ 1531da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_MASK (3<<16) 1541da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_NONE (1<<16) 1551da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_50 (2<<16) 1561da177e4SLinus Torvalds #define TDA9887_DEEMPHASIS_75 (3<<16) 1571da177e4SLinus Torvalds #define TDA9887_AUTOMUTE (1<<18) 158d7304deeSTrent Piepho #define TDA9887_GATING_18 (1<<19) 159cefccc80SMauro Carvalho Chehab #define TDA9887_GAIN_NORMAL (1<<20) 1605e082f15STrent Piepho #define TDA9887_RIF_41_3 (1<<21) /* radio IF1 41.3 vs 33.3 */ 1611da177e4SLinus Torvalds 16207c68a74SMauro Carvalho Chehab /** 16307c68a74SMauro Carvalho Chehab * enum tuner_mode - Mode of the tuner 16407c68a74SMauro Carvalho Chehab * 16507c68a74SMauro Carvalho Chehab * @T_RADIO: Tuner core will work in radio mode 16607c68a74SMauro Carvalho Chehab * @T_ANALOG_TV: Tuner core will work in analog TV mode 16707c68a74SMauro Carvalho Chehab * 16807c68a74SMauro Carvalho Chehab * Older boards only had a single tuner device, but some devices have a 16907c68a74SMauro Carvalho Chehab * separate tuner for radio. In any case, the tuner-core needs to know if 17007c68a74SMauro Carvalho Chehab * the tuner chip(s) will be used in radio mode or analog TV mode, as, on 17107c68a74SMauro Carvalho Chehab * radio mode, frequencies are specified on a different range than on TV 17207c68a74SMauro Carvalho Chehab * mode. This enum is used by the tuner core in order to work with the 17307c68a74SMauro Carvalho Chehab * proper tuner range and eventually use a different tuner chip while in 17407c68a74SMauro Carvalho Chehab * radio mode. 17507c68a74SMauro Carvalho Chehab */ 176f7ce3cc6SMauro Carvalho Chehab enum tuner_mode { 177f7ce3cc6SMauro Carvalho Chehab T_RADIO = 1 << V4L2_TUNER_RADIO, 178f7ce3cc6SMauro Carvalho Chehab T_ANALOG_TV = 1 << V4L2_TUNER_ANALOG_TV, 17962e93f09SMauro Carvalho Chehab /* Don't map V4L2_TUNER_DIGITAL_TV, as tuner-core won't use it */ 180f7ce3cc6SMauro Carvalho Chehab }; 181f7ce3cc6SMauro Carvalho Chehab 18207c68a74SMauro Carvalho Chehab /** 18307c68a74SMauro Carvalho Chehab * struct tuner_setup - setup the tuner chipsets 18407c68a74SMauro Carvalho Chehab * 18507c68a74SMauro Carvalho Chehab * @addr: I2C address used to control the tuner device/chipset 18607c68a74SMauro Carvalho Chehab * @type: Type of the tuner, as defined at the TUNER_* macros. 18707c68a74SMauro Carvalho Chehab * Each different tuner model should have an unique 18807c68a74SMauro Carvalho Chehab * identifier. 18907c68a74SMauro Carvalho Chehab * @mode_mask: Mask with the allowed tuner modes: V4L2_TUNER_RADIO, 19007c68a74SMauro Carvalho Chehab * V4L2_TUNER_ANALOG_TV and/or V4L2_TUNER_DIGITAL_TV, 19107c68a74SMauro Carvalho Chehab * describing if the tuner should be used to support 19207c68a74SMauro Carvalho Chehab * Radio, analog TV and/or digital TV. 19307c68a74SMauro Carvalho Chehab * @config: Used to send tuner-specific configuration for complex 19407c68a74SMauro Carvalho Chehab * tuners that require extra parameters to be set. 19507c68a74SMauro Carvalho Chehab * Only a very few tuners require it and its usage on 19607c68a74SMauro Carvalho Chehab * newer tuners should be avoided. 19707c68a74SMauro Carvalho Chehab * @tuner_callback: Some tuners require to call back the bridge driver, 19807c68a74SMauro Carvalho Chehab * in order to do some tasks like rising a GPIO at the 19907c68a74SMauro Carvalho Chehab * bridge chipset, in order to do things like resetting 20007c68a74SMauro Carvalho Chehab * the device. 20107c68a74SMauro Carvalho Chehab * 20207c68a74SMauro Carvalho Chehab * Older boards only had a single tuner device. Nowadays multiple tuner 20307c68a74SMauro Carvalho Chehab * devices may be present on a single board. Using TUNER_SET_TYPE_ADDR 20407c68a74SMauro Carvalho Chehab * to pass the tuner_setup structure it is possible to setup each tuner 20507c68a74SMauro Carvalho Chehab * device in turn. 20607c68a74SMauro Carvalho Chehab * 20707c68a74SMauro Carvalho Chehab * Since multiple devices may be present it is no longer sufficient to 20807c68a74SMauro Carvalho Chehab * send a command to a single i2c device. Instead you should broadcast 20907c68a74SMauro Carvalho Chehab * the command to all i2c devices. 21007c68a74SMauro Carvalho Chehab * 21107c68a74SMauro Carvalho Chehab * By setting the mode_mask correctly you can select which commands are 21207c68a74SMauro Carvalho Chehab * accepted by a specific tuner device. For example, set mode_mask to 21307c68a74SMauro Carvalho Chehab * T_RADIO if the device is a radio-only tuner. That specific tuner will 21407c68a74SMauro Carvalho Chehab * only accept commands when the tuner is in radio mode and ignore them 21507c68a74SMauro Carvalho Chehab * when the tuner is set to TV mode. 216a544521eSHans Verkuil */ 217a544521eSHans Verkuil 218f7ce3cc6SMauro Carvalho Chehab struct tuner_setup { 21907c68a74SMauro Carvalho Chehab unsigned short addr; 22007c68a74SMauro Carvalho Chehab unsigned int type; 22107c68a74SMauro Carvalho Chehab unsigned int mode_mask; 22207c68a74SMauro Carvalho Chehab void *config; 223d7cba043SMichael Krufky int (*tuner_callback)(void *dev, int component, int cmd, int arg); 224391cd727SMauro Carvalho Chehab }; 225391cd727SMauro Carvalho Chehab 2261da177e4SLinus Torvalds #endif /* __KERNEL__ */ 2271da177e4SLinus Torvalds 2281c94aeecSMauro Carvalho Chehab #endif /* _TUNER_H */ 229