V4L/DVB (7864): mxl5005s: Cleanup #1

Cleanup #1

Signed-off-by: Steven Toth <stoth@hauppauge.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>

1 files changed, 259 insertions, 514 deletions

diff --git a/drivers/media/common/tuners/mxl5005s.h b/drivers/media/common/tuners/mxl5005s.h
index 8542fc10a9b..1944d9e9442 100644
--- a/drivers/media/common/tuners/mxl5005s.h
+++ b/drivers/media/common/tuners/mxl5005s.h
@@ -23,138 +23,104 @@
  */
 
 
-#ifndef __TUNER_MXL5005S_H
-#define __TUNER_MXL5005S_H
+#ifndef __MXL5005S_H
+#define __MXL5005S_H
 
+/*
+ * The following context is source code provided by MaxLinear.
+ * MaxLinear source code - Common.h
+ */
 
-
-// The following context is source code provided by MaxLinear.
-
-
-// MaxLinear source code - Common.h
-
-
-
-//#pragma once
-
-typedef unsigned char		_u8;						// At least 1 Byte
-typedef unsigned short		_u16;						// At least 2 Bytes
-typedef signed short		_s16;
-typedef unsigned long		_u32;						// At least 4 Bytes
-typedef void *				HANDLE;						// Pointer to memory location
+typedef void *HANDLE; /* Pointer to memory location */
 
 #define TUNER_REGS_NUM		104
 #define INITCTRL_NUM		40
+
 #ifdef _MXL_PRODUCTION
-#define CHCTRL_NUM			39
+#define CHCTRL_NUM		39
 #else
-#define CHCTRL_NUM			36
+#define CHCTRL_NUM		36
 #endif
 
-#define MXLCTRL_NUM			189
-
-#define MASTER_CONTROL_ADDR		9
-
+#define MXLCTRL_NUM		189
+#define MASTER_CONTROL_ADDR	9
 
-
-
-// Enumeration of AGC Mode
+/* Enumeration of AGC Mode */
 typedef enum
 {
-	MXL_DUAL_AGC = 0 ,
+	MXL_DUAL_AGC = 0,
 	MXL_SINGLE_AGC
-} AGC_Mode ;
+} AGC_Mode;
 
-//
-// Enumeration of Master Control Register State
-//
+/* Enumeration of Master Control Register State */
 typedef enum
 {
-	MC_LOAD_START = 1 ,
-	MC_POWER_DOWN ,
-	MC_SYNTH_RESET ,
+	MC_LOAD_START = 1,
+	MC_POWER_DOWN,
+	MC_SYNTH_RESET,
 	MC_SEQ_OFF
-} Master_Control_State ;
+} Master_Control_State;
 
-//
-// Enumeration of MXL5005 Tuner Mode
-//
+/* Enumeration of MXL5005 Tuner Mode */
 typedef enum
 {
-	MXL_ANALOG_MODE = 0 ,
+	MXL_ANALOG_MODE = 0,
 	MXL_DIGITAL_MODE
+} Tuner_Mode;
 
-} Tuner_Mode ;
-
-//
-// Enumeration of MXL5005 Tuner IF Mode
-//
+/* Enumeration of MXL5005 Tuner IF Mode */
 typedef enum
 {
-	MXL_ZERO_IF = 0 ,
+	MXL_ZERO_IF = 0,
 	MXL_LOW_IF
+} Tuner_IF_Mode;
 
-} Tuner_IF_Mode ;
-
-//
-// Enumeration of MXL5005 Tuner Clock Out Mode
-//
+/* Enumeration of MXL5005 Tuner Clock Out Mode */
 typedef enum
 {
-	MXL_CLOCK_OUT_DISABLE = 0 ,
+	MXL_CLOCK_OUT_DISABLE = 0,
 	MXL_CLOCK_OUT_ENABLE
-} Tuner_Clock_Out ;
+} Tuner_Clock_Out;
 
-//
-// Enumeration of MXL5005 Tuner Div Out Mode
-//
+/* Enumeration of MXL5005 Tuner Div Out Mode */
 typedef enum
 {
-	MXL_DIV_OUT_1 = 0 ,
+	MXL_DIV_OUT_1 = 0,
 	MXL_DIV_OUT_4
 
-} Tuner_Div_Out ;
+} Tuner_Div_Out;
 
-//
-// Enumeration of MXL5005 Tuner Pull-up Cap Select Mode
-//
+/* Enumeration of MXL5005 Tuner Pull-up Cap Select Mode */
 typedef enum
 {
-	MXL_CAP_SEL_DISABLE = 0 ,
+	MXL_CAP_SEL_DISABLE = 0,
 	MXL_CAP_SEL_ENABLE
 
-} Tuner_Cap_Select ;
+} Tuner_Cap_Select;
 
-//
-// Enumeration of MXL5005 Tuner RSSI Mode
-//
+/* Enumeration of MXL5005 Tuner RSSI Mode */
 typedef enum
 {
-	MXL_RSSI_DISABLE = 0 ,
+	MXL_RSSI_DISABLE = 0,
 	MXL_RSSI_ENABLE
 
-} Tuner_RSSI ;
+} Tuner_RSSI;
 
-//
-// Enumeration of MXL5005 Tuner Modulation Type
-//
+/* Enumeration of MXL5005 Tuner Modulation Type */
 typedef enum
 {
-	MXL_DEFAULT_MODULATION = 0 ,
+	MXL_DEFAULT_MODULATION = 0,
 	MXL_DVBT,
 	MXL_ATSC,
 	MXL_QAM,
 	MXL_ANALOG_CABLE,
 	MXL_ANALOG_OTA
+} Tuner_Modu_Type;
 
-} Tuner_Modu_Type ;
-
-//
-// Enumeration of MXL5005 Tuner Tracking Filter Type
-//
+/* Enumeration of MXL5005 Tuner Tracking Filter Type */
 typedef enum
 {
-	MXL_TF_DEFAULT = 0 ,
+	MXL_TF_DEFAULT = 0,
 	MXL_TF_OFF,
 	MXL_TF_C,
 	MXL_TF_C_H,
@@ -165,316 +131,233 @@ typedef enum
 	MXL_TF_E_2,
 	MXL_TF_E_NA,
 	MXL_TF_G
+} Tuner_TF_Type;
 
-
-} Tuner_TF_Type ;
-
-
-//
-// MXL5005 Tuner Register Struct
-//
+/* MXL5005 Tuner Register Struct */
 typedef struct _TunerReg_struct
 {
-	_u16 	Reg_Num ;							// Tuner Register Address
-	_u16	Reg_Val ;							// Current sofware programmed value waiting to be writen
-} TunerReg_struct ;
+	u16 Reg_Num;	/* Tuner Register Address */
+	u16 Reg_Val;	/* Current sofware programmed value waiting to be writen */
+} TunerReg_struct;
 
-//
-// MXL5005 Tuner Control Struct
-//
+/* MXL5005 Tuner Control Struct */
 typedef struct _TunerControl_struct {
-	_u16	Ctrl_Num ;							// Control Number
-	_u16	size ;								// Number of bits to represent Value
-	_u16 	addr[25] ;							// Array of Tuner Register Address for each bit position
-	_u16 	bit[25] ;							// Array of bit position in Register Address for each bit position
-	_u16 	val[25] ;							// Binary representation of Value
-} TunerControl_struct ;
-
-//
-// MXL5005 Tuner Struct
-//
+	u16 Ctrl_Num;	/* Control Number */
+	u16 size;	/* Number of bits to represent Value */
+	u16 addr[25];	/* Array of Tuner Register Address for each bit position */
+	u16 bit[25];	/* Array of bit position in Register Address for each bit position */
+	u16 val[25];	/* Binary representation of Value */
+} TunerControl_struct;
+
+/* MXL5005 Tuner Struct */
 typedef struct _Tuner_struct
 {
-	_u8			Mode ;				// 0: Analog Mode ; 1: Digital Mode
-	_u8			IF_Mode ;			// for Analog Mode, 0: zero IF; 1: low IF
-	_u32			Chan_Bandwidth ;	// filter  channel bandwidth (6, 7, 8)
-	_u32			IF_OUT ;			// Desired IF Out Frequency
-	_u16			IF_OUT_LOAD ;		// IF Out Load Resistor (200/300 Ohms)
-	_u32			RF_IN ;				// RF Input Frequency
-	_u32			Fxtal ;				// XTAL Frequency
-	_u8			AGC_Mode ;			// AGC Mode 0: Dual AGC; 1: Single AGC
-	_u16			TOP ;				// Value: take over point
-	_u8			CLOCK_OUT ;			// 0: turn off clock out; 1: turn on clock out
-	_u8			DIV_OUT ;			// 4MHz or 16MHz
-	_u8			CAPSELECT ;			// 0: disable On-Chip pulling cap; 1: enable
-	_u8			EN_RSSI ;			// 0: disable RSSI; 1: enable RSSI
-	_u8			Mod_Type ;			// Modulation Type;
-										// 0 - Default;	1 - DVB-T; 2 - ATSC; 3 - QAM; 4 - Analog Cable
-	_u8			TF_Type ;			// Tracking Filter Type
-										// 0 - Default; 1 - Off; 2 - Type C; 3 - Type C-H
-
-	// Calculated Settings
-	_u32			RF_LO ;				// Synth RF LO Frequency
-	_u32			IF_LO ;				// Synth IF LO Frequency
-	_u32			TG_LO ;				// Synth TG_LO Frequency
-
-	// Pointers to ControlName Arrays
-	_u16					Init_Ctrl_Num ;					// Number of INIT Control Names
-	TunerControl_struct		Init_Ctrl[INITCTRL_NUM] ;		// INIT Control Names Array Pointer
-	_u16					CH_Ctrl_Num ;					// Number of CH Control Names
-	TunerControl_struct		CH_Ctrl[CHCTRL_NUM] ;			// CH Control Name Array Pointer
-	_u16					MXL_Ctrl_Num ;					// Number of MXL Control Names
-	TunerControl_struct		MXL_Ctrl[MXLCTRL_NUM] ;			// MXL Control Name Array Pointer
-
-	// Pointer to Tuner Register Array
-	_u16					TunerRegs_Num ;		// Number of Tuner Registers
-	TunerReg_struct			TunerRegs[TUNER_REGS_NUM] ;			// Tuner Register Array Pointer
-} Tuner_struct ;
-
-
+	u8	Mode;		/* 0: Analog Mode ; 1: Digital Mode */
+	u8	IF_Mode;	/* for Analog Mode, 0: zero IF; 1: low IF */
+	u32	Chan_Bandwidth;	/* filter  channel bandwidth (6, 7, 8) */
+	u32	IF_OUT;		/* Desired IF Out Frequency */
+	u16	IF_OUT_LOAD;	/* IF Out Load Resistor (200/300 Ohms) */
+	u32	RF_IN;		/* RF Input Frequency */
+	u32	Fxtal;		/* XTAL Frequency */
+	u8	AGC_Mode;	/* AGC Mode 0: Dual AGC; 1: Single AGC */
+	u16	TOP;		/* Value: take over point */
+	u8	CLOCK_OUT;	/* 0: turn off clock out; 1: turn on clock out */
+	u8	DIV_OUT;	/* 4MHz or 16MHz */
+	u8	CAPSELECT;	/* 0: disable On-Chip pulling cap; 1: enable */
+	u8	EN_RSSI;	/* 0: disable RSSI; 1: enable RSSI */
+	u8	Mod_Type;	/* Modulation Type; */
+				/* 0 - Default;	1 - DVB-T; 2 - ATSC; 3 - QAM; 4 - Analog Cable */
+	u8	TF_Type;	/* Tracking Filter Type */
+				/* 0 - Default; 1 - Off; 2 - Type C; 3 - Type C-H */
+
+	/* Calculated Settings */
+	u32	RF_LO;		/* Synth RF LO Frequency */
+	u32	IF_LO;		/* Synth IF LO Frequency */
+	u32	TG_LO;		/* Synth TG_LO Frequency */
+
+	/* Pointers to ControlName Arrays */
+	u16	Init_Ctrl_Num;			/* Number of INIT Control Names */
+	TunerControl_struct
+		Init_Ctrl[INITCTRL_NUM];	/* INIT Control Names Array Pointer */
+
+	u16	CH_Ctrl_Num;			/* Number of CH Control Names */
+	TunerControl_struct
+		CH_Ctrl[CHCTRL_NUM];		/* CH Control Name Array Pointer */
+
+	u16	MXL_Ctrl_Num;			/* Number of MXL Control Names */
+	TunerControl_struct
+		MXL_Ctrl[MXLCTRL_NUM];		/* MXL Control Name Array Pointer */
+
+	/* Pointer to Tuner Register Array */
+	u16	TunerRegs_Num;			/* Number of Tuner Registers */
+	TunerReg_struct
+		TunerRegs[TUNER_REGS_NUM];	/* Tuner Register Array Pointer */
+
+} Tuner_struct;
 
 typedef enum
 {
-	//
-	// Initialization Control Names
-	//
-	DN_IQTN_AMP_CUT = 1 ,       // 1
-	BB_MODE ,                   // 2
-	BB_BUF ,                    // 3
-	BB_BUF_OA ,			// 4
-	BB_ALPF_BANDSELECT ,        // 5
-	BB_IQSWAP ,                 // 6
-	BB_DLPF_BANDSEL ,           // 7
-	RFSYN_CHP_GAIN ,            // 8
-	RFSYN_EN_CHP_HIGAIN ,       // 9
-	AGC_IF ,                    // 10
-	AGC_RF ,                    // 11
-	IF_DIVVAL ,                 // 12
-	IF_VCO_BIAS ,               // 13
-	CHCAL_INT_MOD_IF ,          // 14
-	CHCAL_FRAC_MOD_IF ,         // 15
-	DRV_RES_SEL ,               // 16
-	I_DRIVER ,                  // 17
-	EN_AAF ,                    // 18
-	EN_3P ,                     // 19
-	EN_AUX_3P ,                 // 20
-	SEL_AAF_BAND ,              // 21
-	SEQ_ENCLK16_CLK_OUT ,       // 22
-	SEQ_SEL4_16B ,              // 23
-	XTAL_CAPSELECT ,            // 24
-	IF_SEL_DBL ,                // 25
-	RFSYN_R_DIV ,               // 26
-	SEQ_EXTSYNTHCALIF ,         // 27
-	SEQ_EXTDCCAL ,              // 28
-	AGC_EN_RSSI ,               // 29
-	RFA_ENCLKRFAGC ,            // 30
-	RFA_RSSI_REFH ,             // 31
-	RFA_RSSI_REF ,              // 32
-	RFA_RSSI_REFL ,             // 33
-	RFA_FLR ,                   // 34
-	RFA_CEIL ,                  // 35
-	SEQ_EXTIQFSMPULSE ,         // 36
-	OVERRIDE_1 ,                // 37
-	BB_INITSTATE_DLPF_TUNE,     // 38
-	TG_R_DIV,					// 39
-	EN_CHP_LIN_B ,				// 40
-
-	//
-	// Channel Change Control Names
-	//
-	DN_POLY = 51 ,              // 51
-	DN_RFGAIN ,                 // 52
-	DN_CAP_RFLPF ,              // 53
-	DN_EN_VHFUHFBAR ,           // 54
-	DN_GAIN_ADJUST ,            // 55
-	DN_IQTNBUF_AMP ,            // 56
-	DN_IQTNGNBFBIAS_BST ,       // 57
-	RFSYN_EN_OUTMUX ,           // 58
-	RFSYN_SEL_VCO_OUT ,         // 59
-	RFSYN_SEL_VCO_HI ,          // 60
-	RFSYN_SEL_DIVM ,            // 61
-	RFSYN_RF_DIV_BIAS ,         // 62
-	DN_SEL_FREQ ,               // 63
-	RFSYN_VCO_BIAS ,            // 64
-	CHCAL_INT_MOD_RF ,          // 65
-	CHCAL_FRAC_MOD_RF ,         // 66
-	RFSYN_LPF_R ,               // 67
-	CHCAL_EN_INT_RF ,           // 68
-	TG_LO_DIVVAL ,              // 69
-	TG_LO_SELVAL ,              // 70
-	TG_DIV_VAL ,                // 71
-	TG_VCO_BIAS ,               // 72
-	SEQ_EXTPOWERUP ,            // 73
-	OVERRIDE_2 ,                // 74
-	OVERRIDE_3 ,                // 75
-	OVERRIDE_4 ,                // 76
-	SEQ_FSM_PULSE ,             // 77
-	GPIO_4B,                    // 78
-	GPIO_3B,                    // 79
-	GPIO_4,                     // 80
-	GPIO_3,                     // 81
-	GPIO_1B,                    // 82
-	DAC_A_ENABLE ,              // 83
-	DAC_B_ENABLE ,              // 84
-	DAC_DIN_A ,			// 85
-	DAC_DIN_B ,                 // 86
+	/* Initialization Control Names */
+	DN_IQTN_AMP_CUT = 1,       /* 1 */
+	BB_MODE,                   /* 2 */
+	BB_BUF,                    /* 3 */
+	BB_BUF_OA,                 /* 4 */
+	BB_ALPF_BANDSELECT,        /* 5 */
+	BB_IQSWAP,                 /* 6 */
+	BB_DLPF_BANDSEL,           /* 7 */
+	RFSYN_CHP_GAIN,            /* 8 */
+	RFSYN_EN_CHP_HIGAIN,       /* 9 */
+	AGC_IF,                    /* 10 */
+	AGC_RF,                    /* 11 */
+	IF_DIVVAL,                 /* 12 */
+	IF_VCO_BIAS,               /* 13 */
+	CHCAL_INT_MOD_IF,          /* 14 */
+	CHCAL_FRAC_MOD_IF,         /* 15 */
+	DRV_RES_SEL,               /* 16 */
+	I_DRIVER,                  /* 17 */
+	EN_AAF,                    /* 18 */
+	EN_3P,                     /* 19 */
+	EN_AUX_3P,                 /* 20 */
+	SEL_AAF_BAND,              /* 21 */
+	SEQ_ENCLK16_CLK_OUT,       /* 22 */
+	SEQ_SEL4_16B,              /* 23 */
+	XTAL_CAPSELECT,            /* 24 */
+	IF_SEL_DBL,                /* 25 */
+	RFSYN_R_DIV,               /* 26 */
+	SEQ_EXTSYNTHCALIF,         /* 27 */
+	SEQ_EXTDCCAL,              /* 28 */
+	AGC_EN_RSSI,               /* 29 */
+	RFA_ENCLKRFAGC,            /* 30 */
+	RFA_RSSI_REFH,             /* 31 */
+	RFA_RSSI_REF,              /* 32 */
+	RFA_RSSI_REFL,             /* 33 */
+	RFA_FLR,                   /* 34 */
+	RFA_CEIL,                  /* 35 */
+	SEQ_EXTIQFSMPULSE,         /* 36 */
+	OVERRIDE_1,                /* 37 */
+	BB_INITSTATE_DLPF_TUNE,    /* 38 */
+	TG_R_DIV,                  /* 39 */
+	EN_CHP_LIN_B,              /* 40 */
+
+	/* Channel Change Control Names */
+	DN_POLY = 51,              /* 51 */
+	DN_RFGAIN,                 /* 52 */
+	DN_CAP_RFLPF,              /* 53 */
+	DN_EN_VHFUHFBAR,           /* 54 */
+	DN_GAIN_ADJUST,            /* 55 */
+	DN_IQTNBUF_AMP,            /* 56 */
+	DN_IQTNGNBFBIAS_BST,       /* 57 */
+	RFSYN_EN_OUTMUX,           /* 58 */
+	RFSYN_SEL_VCO_OUT,         /* 59 */
+	RFSYN_SEL_VCO_HI,          /* 60 */
+	RFSYN_SEL_DIVM,            /* 61 */
+	RFSYN_RF_DIV_BIAS,         /* 62 */
+	DN_SEL_FREQ,               /* 63 */
+	RFSYN_VCO_BIAS,            /* 64 */
+	CHCAL_INT_MOD_RF,          /* 65 */
+	CHCAL_FRAC_MOD_RF,         /* 66 */
+	RFSYN_LPF_R,               /* 67 */
+	CHCAL_EN_INT_RF,           /* 68 */
+	TG_LO_DIVVAL,              /* 69 */
+	TG_LO_SELVAL,              /* 70 */
+	TG_DIV_VAL,                /* 71 */
+	TG_VCO_BIAS,               /* 72 */
+	SEQ_EXTPOWERUP,            /* 73 */
+	OVERRIDE_2,                /* 74 */
+	OVERRIDE_3,                /* 75 */
+	OVERRIDE_4,                /* 76 */
+	SEQ_FSM_PULSE,             /* 77 */
+	GPIO_4B,                   /* 78 */
+	GPIO_3B,                   /* 79 */
+	GPIO_4,                    /* 80 */
+	GPIO_3,                    /* 81 */
+	GPIO_1B,                   /* 82 */
+	DAC_A_ENABLE,              /* 83 */
+	DAC_B_ENABLE,              /* 84 */
+	DAC_DIN_A,                 /* 85 */
+	DAC_DIN_B,                 /* 86 */
 #ifdef _MXL_PRODUCTION
-	RFSYN_EN_DIV,				// 87
-	RFSYN_DIVM,					// 88
-	DN_BYPASS_AGC_I2C			// 89
+	RFSYN_EN_DIV,              /* 87 */
+	RFSYN_DIVM,                /* 88 */
+	DN_BYPASS_AGC_I2C          /* 89 */
 #endif
+} MXL5005_ControlName;
 
-} MXL5005_ControlName ;
-
-
+/* End of common.h */
 
+/*
+ * The following context is source code provided by MaxLinear.
+ * MaxLinear source code - Common_MXL.h (?)
+ */
 
-
-
-
-
-
-
-
-
-
-
-
-// MaxLinear source code - MXL5005_c.h
-
-
-
-// MXL5005.h : main header file for the MXL5005 DLL
-//
-//#pragma once
-
-//#include "Common.h"
+void InitTunerControls(Tuner_struct *Tuner);
+u16 MXL_BlockInit(Tuner_struct *Tuner);
+u16 MXL5005_RegisterInit(Tuner_struct *Tuner);
+u16 MXL5005_ControlInit(Tuner_struct *Tuner);
 #ifdef _MXL_INTERNAL
-#include "Common_MXL.h"
+u16 MXL5005_MXLControlInit(Tuner_struct *Tuner);
 #endif
 
-void InitTunerControls( Tuner_struct *Tuner) ;
-
-_u16 MXL_BlockInit( Tuner_struct *Tuner ) ;
-
-_u16 MXL5005_RegisterInit (Tuner_struct * Tuner) ;
-_u16 MXL5005_ControlInit (Tuner_struct *Tuner) ;
-
-#ifdef _MXL_INTERNAL
-	_u16 MXL5005_MXLControlInit(Tuner_struct *Tuner) ;
-#endif
+u16 MXL5005_TunerConfig(Tuner_struct *Tuner,
+	u8	Mode,		/* 0: Analog Mode ; 1: Digital Mode */
+	u8	IF_mode,	/* for Analog Mode, 0: zero IF; 1: low IF */
+	u32	Bandwidth,	/* filter  channel bandwidth (6, 7, 8) */
+	u32	IF_out,		/* Desired IF Out Frequency */
+	u32	Fxtal,		/* XTAL Frequency */
+	u8	AGC_Mode,	/* AGC Mode - Dual AGC: 0, Single AGC: 1 */
+	u16	TOP,		/* 0: Dual AGC; Value: take over point */
+	u16	IF_OUT_LOAD,	/* IF Out Load Resistor (200 / 300 Ohms) */
+	u8	CLOCK_OUT, 	/* 0: turn off clock out; 1: turn on clock out */
+	u8	DIV_OUT,	/* 4MHz or 16MHz */
+	u8	CAPSELECT, 	/* 0: disable On-Chip pulling cap; 1: enable */
+	u8	EN_RSSI, 	/* 0: disable RSSI; 1: enable RSSI */
+	u8	Mod_Type,	/* Modulation Type; */
+				/* 0 - Default; 1 - DVB-T; 2 - ATSC; 3 - QAM; 4 - Analog Cable */
+	u8	TF_Type		/* Tracking Filter Type */
+				/* 0 - Default; 1 - Off; 2 - Type C; 3 - Type C-H */
+	);
 
-_u16 MXL5005_TunerConfig(Tuner_struct *Tuner,
-	_u8		Mode,		// 0: Analog Mode ; 1: Digital Mode
-	_u8		IF_mode,	// for Analog Mode, 0: zero IF; 1: low IF
-	_u32	Bandwidth,	// filter  channel bandwidth (6, 7, 8)
-	_u32	IF_out,		// Desired IF Out Frequency
-	_u32	Fxtal,		// XTAL Frequency
-	_u8		AGC_Mode,	// AGC Mode - Dual AGC: 0, Single AGC: 1
-	_u16	TOP,        // 0: Dual AGC; Value: take over point
-	_u16	IF_OUT_LOAD,// IF Out Load Resistor (200 / 300 Ohms)
-	_u8		CLOCK_OUT, 	// 0: turn off clock out; 1: turn on clock out
-	_u8		DIV_OUT,	// 4MHz or 16MHz
-	_u8		CAPSELECT, 	// 0: disable On-Chip pulling cap; 1: enable
-	_u8		EN_RSSI, 	// 0: disable RSSI; 1: enable RSSI
-	_u8		Mod_Type,	// Modulation Type;
-						// 0 - Default;		1 - DVB-T;	2 - ATSC;	3 - QAM; 4 - Analog Cable
-	_u8		TF_Type		// Tracking Filter Type
-						// 0 - Default; 1 - Off; 2 - Type C; 3 - Type C-H
-	) ;
-
-void MXL_SynthIFLO_Calc(Tuner_struct *Tuner) ;
-void MXL_SynthRFTGLO_Calc(Tuner_struct *Tuner) ;
-_u16 MXL_RegWrite(Tuner_struct *Tuner, _u8 RegNum, _u8 RegVal) ;
-_u16 MXL_RegRead(Tuner_struct *Tuner, _u8 RegNum, _u8 *RegVal) ;
-_u16 MXL_ControlWrite(Tuner_struct *Tuner, _u16 ControlNum, _u32 value) ;
-_u16 MXL_ControlWrite_Group(Tuner_struct *Tuner, _u16 ControlNum, _u32 value, _u16 controlGroup) ;
-_u16 MXL_ControlRead(Tuner_struct *Tuner, _u16 ControlNum, _u32 * value) ;
-_u16 MXL_ControlRegRead(Tuner_struct *Tuner, _u16 ControlNum, _u8 *RegNum, int * count) ;
-void MXL_RegWriteBit(Tuner_struct *Tuner, _u8 address, _u8 bit, _u8 bitVal);
-_u16 MXL_IFSynthInit( Tuner_struct * Tuner ) ;
-_u16 MXL_TuneRF(Tuner_struct *Tuner, _u32 RF_Freq) ;
-_u16 MXL_OverwriteICDefault( Tuner_struct *Tuner) ;
-_u16 MXL_SetGPIO(Tuner_struct *Tuner, _u8 GPIO_Num, _u8 GPIO_Val) ;
-_u32 MXL_Ceiling( _u32 value, _u32 resolution ) ;
-_u32 MXL_GetXtalInt(_u32 Xtal_Freq) ;
-
-_u16 MXL_GetInitRegister(Tuner_struct *Tuner, _u8 * RegNum, _u8 *RegVal, int *count) ;
-_u16 MXL_GetCHRegister(Tuner_struct *Tuner, _u8 * RegNum, _u8 *RegVal, int *count) ;
-_u16 MXL_GetCHRegister_ZeroIF(Tuner_struct *Tuner, _u8 * RegNum, _u8 *RegVal, int *count) ;
-_u16 MXL_GetCHRegister_LowIF(Tuner_struct *Tuner, _u8 * RegNum, _u8 *RegVal, int *count) ;
-_u16 MXL_GetMasterControl(_u8 *MasterReg, int state) ;
+void MXL_SynthIFLO_Calc(Tuner_struct *Tuner);
+void MXL_SynthRFTGLO_Calc(Tuner_struct *Tuner);
+u16 MXL_RegWrite(Tuner_struct *Tuner, u8 RegNum, u8 RegVal);
+u16 MXL_RegRead(Tuner_struct *Tuner, u8 RegNum, u8 *RegVal);
+u16 MXL_ControlWrite(Tuner_struct *Tuner, u16 ControlNum, u32 value);
+u16 MXL_ControlWrite_Group(Tuner_struct *Tuner, u16 ControlNum, u32 value, u16 controlGroup);
+u16 MXL_ControlRead(Tuner_struct *Tuner, u16 ControlNum, u32 * value);
+u16 MXL_ControlRegRead(Tuner_struct *Tuner, u16 ControlNum, u8 *RegNum, int *count);
+void MXL_RegWriteBit(Tuner_struct *Tuner, u8 address, u8 bit, u8 bitVal);
+u16 MXL_IFSynthInit(Tuner_struct * Tuner );
+u16 MXL_TuneRF(Tuner_struct *Tuner, u32 RF_Freq);
+u16 MXL_OverwriteICDefault(Tuner_struct *Tuner);
+u16 MXL_SetGPIO(Tuner_struct *Tuner, u8 GPIO_Num, u8 GPIO_Val);
+u32 MXL_Ceiling(u32 value, u32 resolution);
+u32 MXL_GetXtalInt(u32 Xtal_Freq);
+
+u16 MXL_GetInitRegister(Tuner_struct *Tuner, u8 * RegNum, u8 *RegVal, int *count);
+u16 MXL_GetCHRegister(Tuner_struct *Tuner, u8 * RegNum, u8 *RegVal, int *count);
+u16 MXL_GetCHRegister_ZeroIF(Tuner_struct *Tuner, u8 * RegNum, u8 *RegVal, int *count);
+u16 MXL_GetCHRegister_LowIF(Tuner_struct *Tuner, u8 * RegNum, u8 *RegVal, int *count);
+u16 MXL_GetMasterControl(u8 *MasterReg, int state);
 
 #ifdef _MXL_PRODUCTION
-_u16 MXL_VCORange_Test(Tuner_struct *Tuner, int VCO_Range) ;
-_u16 MXL_Hystersis_Test(Tuner_struct *Tuner, int Hystersis) ;
+u16 MXL_VCORange_Test(Tuner_struct *Tuner, int VCO_Range);
+u16 MXL_Hystersis_Test(Tuner_struct *Tuner, int Hystersis);
 #endif
 
+/* Constants */
+#define MXL5005S_REG_WRITING_TABLE_LEN_MAX	104
+#define MXL5005S_LATCH_BYTE			0xfe
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-// The following context is MxL5005S tuner API source code
-
-
-
-
-
-/**
-
-@file
-
-@brief   MxL5005S tuner module declaration
-
-One can manipulate MxL5005S tuner through MxL5005S module.
-MxL5005S module is derived from tuner module.
-
-*/
-
-
-
-#include "tuner_base.h"
-
-
-
-
-
-// Definitions
-
-// Constants
-#define MXL5005S_REG_WRITING_TABLE_LEN_MAX		104
-#define MXL5005S_LATCH_BYTE						0xfe
-
-// Register address, MSB, and LSB
-#define MXL5005S_BB_IQSWAP_ADDR				59
-#define MXL5005S_BB_IQSWAP_MSB				0
-#define MXL5005S_BB_IQSWAP_LSB				0
+/* Register address, MSB, and LSB */
+#define MXL5005S_BB_IQSWAP_ADDR			59
+#define MXL5005S_BB_IQSWAP_MSB			0
+#define MXL5005S_BB_IQSWAP_LSB			0
 
 #define MXL5005S_BB_DLPF_BANDSEL_ADDR		53
 #define MXL5005S_BB_DLPF_BANDSEL_MSB		4
 #define MXL5005S_BB_DLPF_BANDSEL_LSB		3
 
-
-
-// Standard modes
+/* Standard modes */
 enum
 {
 	MXL5005S_STANDARD_DVBT,
@@ -482,8 +365,7 @@ enum
 };
 #define MXL5005S_STANDARD_MODE_NUM		2
 
-
-// Bandwidth modes
+/* Bandwidth modes */
 enum
 {
 	MXL5005S_BANDWIDTH_6MHZ = 6000000,
@@ -492,8 +374,7 @@ enum
 };
 #define MXL5005S_BANDWIDTH_MODE_NUM		3
 
-
-// Top modes
+/* Top modes */
 enum
 {
 	MXL5005S_TOP_5P5  =  55,
@@ -513,29 +394,20 @@ enum
 	MXL5005S_TOP_34P9 = 349,
 };
 
-
-// IF output load
+/* IF output load */
 enum
 {
 	MXL5005S_IF_OUTPUT_LOAD_200_OHM = 200,
 	MXL5005S_IF_OUTPUT_LOAD_300_OHM = 300,
 };
 
-
-
-
-
-/// MxL5005S extra module alias
+/* MxL5005S extra module alias */
 typedef struct MXL5005S_EXTRA_MODULE_TAG MXL5005S_EXTRA_MODULE;
 
-
-
-
-
-// MxL5005S register setting function pointer
+/* MxL5005S register setting function pointer */
 typedef int
 (*MXL5005S_FP_SET_REGS_WITH_TABLE)(
-	struct dvb_usb_device*        dib,
+	struct dvb_usb_device* dib,
 	TUNER_MODULE *pTuner,
 	unsigned char *pAddrTable,
 	unsigned char *pByteTable,
@@ -543,10 +415,10 @@ typedef int
 	);
 
 
-// MxL5005S register mask bits setting function pointer
+/* MxL5005S register mask bits setting function pointer */
 typedef int
 (*MXL5005S_FP_SET_REG_MASK_BITS)(
-	struct dvb_usb_device*        dib,
+	struct dvb_usb_device* dib,
 	TUNER_MODULE *pTuner,
 	unsigned char RegAddr,
 	unsigned char Msb,
@@ -554,17 +426,15 @@ typedef int
 	const unsigned char WritingValue
 	);
 
-
-// MxL5005S spectrum mode setting function pointer
+/* MxL5005S spectrum mode setting function pointer */
 typedef int
 (*MXL5005S_FP_SET_SPECTRUM_MODE)(
-	struct dvb_usb_device*        dib,
+	struct dvb_usb_device* dib,
 	TUNER_MODULE *pTuner,
 	int SpectrumMode
 	);
 
-
-// MxL5005S bandwidth setting function pointer
+/* MxL5005S bandwidth setting function pointer */
 typedef int
 (*MXL5005S_FP_SET_BANDWIDTH_HZ)(
 	struct dvb_usb_device*        dib,
@@ -572,147 +442,22 @@ typedef int
 	unsigned long BandwidthHz
 	);
 
-
-
-
-
-// MxL5005S extra module
+/* MxL5005S extra module */
 struct MXL5005S_EXTRA_MODULE_TAG
 {
-	// MxL5005S function pointers
+	/* MxL5005S function pointers */
 	MXL5005S_FP_SET_REGS_WITH_TABLE   SetRegsWithTable;
 	MXL5005S_FP_SET_REG_MASK_BITS     SetRegMaskBits;
 	MXL5005S_FP_SET_SPECTRUM_MODE     SetSpectrumMode;
 	MXL5005S_FP_SET_BANDWIDTH_HZ      SetBandwidthHz;
 
+	/* MxL5005S extra data */
+	unsigned char AgcMasterByte; /* Variable name in MaxLinear source code: AGC_MASTER_BYTE */
 
-	// MxL5005S extra data
-	unsigned char AgcMasterByte;			//   Variable name in MaxLinear source code: AGC_MASTER_BYTE
-
-	// MaxLinear defined struct
+	/* MaxLinear defined struct */
 	Tuner_struct MxlDefinedTunerStructure;
 };
+/* End of common_mxl.h (?) */
 
-
-
-
-
-// Builder
-void
-BuildMxl5005sModule(
-	TUNER_MODULE **ppTuner,
-	TUNER_MODULE *pTunerModuleMemory,
-	MXL5005S_EXTRA_MODULE *pMxl5005sExtraModuleMemory,
-	BASE_INTERFACE_MODULE *pBaseInterfaceModuleMemory,
-	I2C_BRIDGE_MODULE *pI2cBridgeModuleMemory,
-	unsigned char DeviceAddr,
-	int StandardMode
-	);
-
-
-
-
-
-// Manipulaing functions
-void
-mxl5005s_SetDeviceAddr(
-	TUNER_MODULE *pTuner,
-	unsigned char DeviceAddr
-	);
-
-void
-mxl5005s_GetTunerType(
-	TUNER_MODULE *pTuner,
-	int *pTunerType
-	);
-
-int
-mxl5005s_GetDeviceAddr(
-	TUNER_MODULE *pTuner,
-	unsigned char *pDeviceAddr
-	);
-
-int
-mxl5005s_Initialize(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner
-	);
-
-int
-mxl5005s_SetRfFreqHz(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner,
-	unsigned long RfFreqHz
-	);
-
-int
-mxl5005s_GetRfFreqHz(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner,
-	unsigned long *pRfFreqHz
-	);
-
-
-
-
-
-// Extra manipulaing functions
-int
-mxl5005s_SetRegsWithTable(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner,
-	unsigned char *pAddrTable,
-	unsigned char *pByteTable,
-	int TableLen
-	);
-
-int
-mxl5005s_SetRegMaskBits(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner,
-	unsigned char RegAddr,
-	unsigned char Msb,
-	unsigned char Lsb,
-	const unsigned char WritingValue
-	);
-
-int
-mxl5005s_SetSpectrumMode(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner,
-	int SpectrumMode
-	);
-
-int
-mxl5005s_SetBandwidthHz(
-	struct dvb_usb_device*        dib,
-	TUNER_MODULE *pTuner,
-	unsigned long BandwidthHz
-	);
-
-
-
-
-
-// I2C birdge module demod argument setting
-void
-mxl5005s_SetI2cBridgeModuleTunerArg(
-	TUNER_MODULE *pTuner
-	);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-#endif
+#endif /* __MXL5005S_H */