cregit-Linux how code gets into the kernel

Release 4.12 include/media/tuner-types.h

Directory: include/media
/*
 * descriptions for simple tuners.
 */

#ifndef __TUNER_TYPES_H__

#define __TUNER_TYPES_H__

/**
 * enum param_type - type of the tuner pameters
 *
 * @TUNER_PARAM_TYPE_RADIO:     Tuner params are for FM and/or AM radio
 * @TUNER_PARAM_TYPE_PAL:       Tuner params are for PAL color TV standard
 * @TUNER_PARAM_TYPE_SECAM:     Tuner params are for SECAM color TV standard
 * @TUNER_PARAM_TYPE_NTSC:      Tuner params are for NTSC color TV standard
 * @TUNER_PARAM_TYPE_DIGITAL:   Tuner params are for digital TV
 */

enum param_type {
	
TUNER_PARAM_TYPE_RADIO,
	
TUNER_PARAM_TYPE_PAL,
	
TUNER_PARAM_TYPE_SECAM,
	
TUNER_PARAM_TYPE_NTSC,
	
TUNER_PARAM_TYPE_DIGITAL,
};

/**
 * struct tuner_range - define the frequencies supported by the tuner
 *
 * @limit:              Max frequency supported by that range, in 62.5 kHz
 *                      (TV) or 62.5 Hz (Radio), as defined by
 *                      V4L2_TUNER_CAP_LOW.
 * @config:             Value of the band switch byte (BB) to setup this mode.
 * @cb:                 Value of the CB byte to setup this mode.
 *
 * Please notice that digital tuners like xc3028/xc4000/xc5000 don't use
 * those ranges, as they're defined inside the driver. This is used by
 * analog tuners that are compatible with the "Philips way" to setup the
 * tuners. On those devices, the tuner set is done via 4 bytes:
 *
 *      #) divider byte1 (DB1)
 *      #) divider byte 2 (DB2)
 *      #) Control byte (CB)
 *      #) band switch byte (BB)
 *
 * Some tuners also have an additional optional Auxiliary byte (AB).
 */

struct tuner_range {
	
unsigned short limit;
	
unsigned char config;
	
unsigned char cb;
};

/**
 * struct tuner_params - Parameters to be used to setup the tuner. Those
 *                       are used by drivers/media/tuners/tuner-types.c in
 *                       order to specify the tuner properties. Most of
 *                       the parameters are for tuners based on tda9887 IF-PLL
 *                       multi-standard analog TV/Radio demodulator, with is
 *                       very common on legacy analog tuners.
 *
 * @type:                       Type of the tuner parameters, as defined at
 *                              enum param_type. If the tuner supports multiple
 *                              standards, an array should be used, with one
 *                              row per different standard.
 * @cb_first_if_lower_freq:     Many Philips-based tuners have a comment in
 *                              their datasheet like
 *                              "For channel selection involving band
 *                              switching, and to ensure smooth tuning to the
 *                              desired channel without causing unnecessary
 *                              charge pump action, it is recommended to
 *                              consider the difference between wanted channel
 *                              frequency and the current channel frequency.
 *                              Unnecessary charge pump action will result
 *                              in very low tuning voltage which may drive the
 *                              oscillator to extreme conditions".
 *                              Set cb_first_if_lower_freq to 1, if this check
 *                              is required for this tuner. I tested this for
 *                              PAL by first setting the TV frequency to
 *                              203 MHz and then switching to 96.6 MHz FM
 *                              radio. The result was static unless the
 *                              control byte was sent first.
 * @has_tda9887:                Set to 1 if this tuner uses a tda9887
 * @port1_fm_high_sensitivity:  Many Philips tuners use tda9887 PORT1 to select
 *                              the FM radio sensitivity. If this setting is 1,
 *                              then set PORT1 to 1 to get proper FM reception.
 * @port2_fm_high_sensitivity:  Some Philips tuners use tda9887 PORT2 to select
 *                              the FM radio sensitivity. If this setting is 1,
 *                              then set PORT2 to 1 to get proper FM reception.
 * @fm_gain_normal:             Some Philips tuners use tda9887 cGainNormal to
 *                              select the FM radio sensitivity. If this
 *                              setting is 1, e register will use cGainNormal
 *                              instead of cGainLow.
 * @intercarrier_mode:          Most tuners with a tda9887 use QSS mode.
 *                              Some (cheaper) tuners use Intercarrier mode.
 *                              If this setting is 1, then the tuner needs to
 *                              be set to intercarrier mode.
 * @port1_active:               This setting sets the default value for PORT1.
 *                              0 means inactive, 1 means active. Note: the
 *                              actual bit value written to the tda9887 is
 *                              inverted. So a 0 here means a 1 in the B6 bit.
 * @port2_active:               This setting sets the default value for PORT2.
 *                              0 means inactive, 1 means active. Note: the
 *                              actual bit value written to the tda9887 is
 *                              inverted. So a 0 here means a 1 in the B7 bit.
 * @port1_invert_for_secam_lc:  Sometimes PORT1 is inverted when the SECAM-L'
 *                              standard is selected. Set this bit to 1 if this
 *                              is needed.
 * @port2_invert_for_secam_lc:  Sometimes PORT2 is inverted when the SECAM-L'
 *                              standard is selected. Set this bit to 1 if this
 *                              is needed.
 * @port1_set_for_fm_mono:      Some cards require PORT1 to be 1 for mono Radio
 *                              FM and 0 for stereo.
 * @default_pll_gating_18:      Select 18% (or according to datasheet 0%)
 *                              L standard PLL gating, vs the driver default
 *                              of 36%.
 * @radio_if:                   IF to use in radio mode.  Tuners with a
 *                              separate radio IF filter seem to use 10.7,
 *                              while those without use 33.3 for PAL/SECAM
 *                              tuners and 41.3 for NTSC tuners.
 *                              0 = 10.7, 1 = 33.3, 2 = 41.3
 * @default_top_low:            Default tda9887 TOP value in dB for the low
 *                              band. Default is 0. Range: -16:+15
 * @default_top_mid:            Default tda9887 TOP value in dB for the mid
 *                              band. Default is 0. Range: -16:+15
 * @default_top_high:           Default tda9887 TOP value in dB for the high
 *                              band. Default is 0. Range: -16:+15
 * @default_top_secam_low:      Default tda9887 TOP value in dB for SECAM-L/L'
 *                              for the low band. Default is 0. Several tuners
 *                              require a different TOP value for the
 *                              SECAM-L/L' standards. Range: -16:+15
 * @default_top_secam_mid:      Default tda9887 TOP value in dB for SECAM-L/L'
 *                              for the mid band. Default is 0. Several tuners
 *                              require a different TOP value for the
 *                              SECAM-L/L' standards. Range: -16:+15
 * @default_top_secam_high:     Default tda9887 TOP value in dB for SECAM-L/L'
 *                              for the high band. Default is 0. Several tuners
 *                              require a different TOP value for the
 *                              SECAM-L/L' standards. Range: -16:+15
 * @iffreq:                     Intermediate frequency (IF) used by the tuner
 *                              on digital mode.
 * @count:                      Size of the ranges array.
 * @ranges:                     Array with the frequency ranges supported by
 *                              the tuner.
 */

struct tuner_params {
	
enum param_type type;

	
unsigned int cb_first_if_lower_freq:1;
	
unsigned int has_tda9887:1;
	
unsigned int port1_fm_high_sensitivity:1;
	
unsigned int port2_fm_high_sensitivity:1;
	
unsigned int fm_gain_normal:1;
	
unsigned int intercarrier_mode:1;
	
unsigned int port1_active:1;
	
unsigned int port2_active:1;
	
unsigned int port1_invert_for_secam_lc:1;
	
unsigned int port2_invert_for_secam_lc:1;
	
unsigned int port1_set_for_fm_mono:1;
	
unsigned int default_pll_gating_18:1;
	
unsigned int radio_if:2;
	
signed int default_top_low:5;
	
signed int default_top_mid:5;
	
signed int default_top_high:5;
	
signed int default_top_secam_low:5;
	
signed int default_top_secam_mid:5;
	
signed int default_top_secam_high:5;

	
u16 iffreq;

	
unsigned int count;
	
struct tuner_range *ranges;
};


struct tunertype {
	
char *name;
	
unsigned int count;
	
struct tuner_params *params;

	
u16 min;
	
u16 max;
	
u32 stepsize;

	
u8 *initdata;
	
u8 *sleepdata;
};

extern struct tunertype tuners[];
extern unsigned const int tuner_count;

#endif

Overall Contributors

PersonTokensPropCommitsCommitProp
Michael Ira Krufky10848.00%642.86%
Hans Verkuil9642.67%214.29%
Trent Piepho125.33%214.29%
Mauro Carvalho Chehab94.00%428.57%
Total225100.00%14100.00%
Directory: include/media
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
Created with cregit.