17b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky/* 27b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky * descriptions for simple tuners. 37b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky */ 47b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 57b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky#ifndef __TUNER_TYPES_H__ 67b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky#define __TUNER_TYPES_H__ 77b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 87b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufkyenum param_type { 962325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky TUNER_PARAM_TYPE_RADIO, 1062325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky TUNER_PARAM_TYPE_PAL, 1162325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky TUNER_PARAM_TYPE_SECAM, 1262325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky TUNER_PARAM_TYPE_NTSC, 1362325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky TUNER_PARAM_TYPE_DIGITAL, 147b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky}; 157b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 167b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufkystruct tuner_range { 177b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky unsigned short limit; 183fc46d35b30cfae018c4903228a270c9543f4d7aMichael Krufky unsigned char config; 197b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky unsigned char cb; 207b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky}; 217b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 227b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufkystruct tuner_params { 237b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky enum param_type type; 24ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil 2527487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil /* Many Philips based tuners have a comment like this in their 2627487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * datasheet: 2727487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * 2827487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * For channel selection involving band switching, and to ensure 2927487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * smooth tuning to the desired channel without causing 3027487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * unnecessary charge pump action, it is recommended to consider 3127487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * the difference between wanted channel frequency and the 3227487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * current channel frequency. Unnecessary charge pump action 3327487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * will result in very low tuning voltage which may drive the 3427487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * oscillator to extreme conditions. 3527487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * 36de03d21b908bd4c49f1fe7b0c4dc5876551cf819Michael Krufky * Set cb_first_if_lower_freq to 1, if this check is 3701872c5d253298b9f360c7c9b9f33504b6ad5469Michael Krufky * required for this tuner. 3827487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * 3927487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * I tested this for PAL by first setting the TV frequency to 4027487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * 203 MHz and then switching to 96.6 MHz FM radio. The result was 4127487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil * static unless the control byte was sent first. 4227487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil */ 4327487d44712aaa37710cc508d5bd6119f5e9f976Hans Verkuil unsigned int cb_first_if_lower_freq:1; 44ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Set to 1 if this tuner uses a tda9887 */ 45ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int has_tda9887:1; 46ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Many Philips tuners use tda9887 PORT1 to select the FM radio 47ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil sensitivity. If this setting is 1, then set PORT1 to 1 to 48ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil get proper FM reception. */ 49ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port1_fm_high_sensitivity:1; 50ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Some Philips tuners use tda9887 PORT2 to select the FM radio 51ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil sensitivity. If this setting is 1, then set PORT2 to 1 to 52ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil get proper FM reception. */ 53ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port2_fm_high_sensitivity:1; 54483deb0f2b38060c1f2de216c09f05b1869b0d52Mauro Carvalho Chehab /* Some Philips tuners use tda9887 cGainNormal to select the FM radio 55483deb0f2b38060c1f2de216c09f05b1869b0d52Mauro Carvalho Chehab sensitivity. If this setting is 1, e register will use cGainNormal 56483deb0f2b38060c1f2de216c09f05b1869b0d52Mauro Carvalho Chehab instead of cGainLow. */ 57483deb0f2b38060c1f2de216c09f05b1869b0d52Mauro Carvalho Chehab unsigned int fm_gain_normal:1; 58ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Most tuners with a tda9887 use QSS mode. Some (cheaper) tuners 59ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil use Intercarrier mode. If this setting is 1, then the tuner 60ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil needs to be set to intercarrier mode. */ 61ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int intercarrier_mode:1; 62ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* This setting sets the default value for PORT1. 63ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil 0 means inactive, 1 means active. Note: the actual bit 64ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil value written to the tda9887 is inverted. So a 0 here 65ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil means a 1 in the B6 bit. */ 66ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port1_active:1; 67ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* This setting sets the default value for PORT2. 68ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil 0 means inactive, 1 means active. Note: the actual bit 69ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil value written to the tda9887 is inverted. So a 0 here 70ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil means a 1 in the B7 bit. */ 71ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port2_active:1; 72ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Sometimes PORT1 is inverted when the SECAM-L' standard is selected. 73ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Set this bit to 1 if this is needed. */ 74ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port1_invert_for_secam_lc:1; 75ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Sometimes PORT2 is inverted when the SECAM-L' standard is selected. 76ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Set this bit to 1 if this is needed. */ 77ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port2_invert_for_secam_lc:1; 78ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Some cards require PORT1 to be 1 for mono Radio FM and 0 for stereo. */ 79ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil unsigned int port1_set_for_fm_mono:1; 80d7304dee3b7e29e801ba59bbf9a47440c196263dTrent Piepho /* Select 18% (or according to datasheet 0%) L standard PLL gating, 81d7304dee3b7e29e801ba59bbf9a47440c196263dTrent Piepho vs the driver default of 36%. */ 82d7304dee3b7e29e801ba59bbf9a47440c196263dTrent Piepho unsigned int default_pll_gating_18:1; 835e082f1521598a91c9194b2356b157cade9b6e87Trent Piepho /* IF to use in radio mode. Tuners with a separate radio IF filter 845e082f1521598a91c9194b2356b157cade9b6e87Trent Piepho seem to use 10.7, while those without use 33.3 for PAL/SECAM tuners 855e082f1521598a91c9194b2356b157cade9b6e87Trent Piepho and 41.3 for NTSC tuners. 0 = 10.7, 1 = 33.3, 2 = 41.3 */ 865e082f1521598a91c9194b2356b157cade9b6e87Trent Piepho unsigned int radio_if:2; 87ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Default tda9887 TOP value in dB for the low band. Default is 0. 88ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Range: -16:+15 */ 89ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil signed int default_top_low:5; 90ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Default tda9887 TOP value in dB for the mid band. Default is 0. 91ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Range: -16:+15 */ 92ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil signed int default_top_mid:5; 93ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Default tda9887 TOP value in dB for the high band. Default is 0. 94ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Range: -16:+15 */ 95ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil signed int default_top_high:5; 96ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Default tda9887 TOP value in dB for SECAM-L/L' for the low band. 97ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Default is 0. Several tuners require a different TOP value for 98ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil the SECAM-L/L' standards. Range: -16:+15 */ 99ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil signed int default_top_secam_low:5; 100ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Default tda9887 TOP value in dB for SECAM-L/L' for the mid band. 101ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Default is 0. Several tuners require a different TOP value for 102ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil the SECAM-L/L' standards. Range: -16:+15 */ 103ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil signed int default_top_secam_mid:5; 104ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil /* Default tda9887 TOP value in dB for SECAM-L/L' for the high band. 105ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil Default is 0. Several tuners require a different TOP value for 106ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil the SECAM-L/L' standards. Range: -16:+15 */ 107ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil signed int default_top_secam_high:5; 108ba8fc39954bf3bc51f502e8a02f959d45edd096cHans Verkuil 10962325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky u16 iffreq; 1107b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 1117b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky unsigned int count; 1127b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky struct tuner_range *ranges; 1137b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky}; 1147b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 1157b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufkystruct tunertype { 1167b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky char *name; 117bbab6fd81f26b210f0815d79064a3387c3a1ade3Michael Krufky unsigned int count; 1187b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky struct tuner_params *params; 11962325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky 12062325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky u16 min; 12162325497db6ef3b13cae41d5038e2693997d7d3eMichael Krufky u16 max; 12223a88108cf6d5fa8073a3b2af804fff7305e86e3Michael Krufky u32 stepsize; 1236f4a57292f4f0a0fef5e4e39cb394fedcf2acf9fMichael Krufky 1246f4a57292f4f0a0fef5e4e39cb394fedcf2acf9fMichael Krufky u8 *initdata; 1256f4a57292f4f0a0fef5e4e39cb394fedcf2acf9fMichael Krufky u8 *sleepdata; 1267b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky}; 1277b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 1287b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufkyextern struct tunertype tuners[]; 1297b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufkyextern unsigned const int tuner_count; 1307b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky 1317b0ac9cdd42b254ae2ec0f6c1cc6389655e4ba96Michael Krufky#endif 132