Commit 34eb9751 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

media: drxj and drxk: don't produce kernel-doc warnings

Those drivers use a different notation for comments. While
it is not worth converting to kernel-doc, removing it is also
not an option.

So, just replace /** by /* and be happy :-)
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 86850b9a
...@@ -73,7 +73,7 @@ INCLUDE FILES ...@@ -73,7 +73,7 @@ INCLUDE FILES
#define DRX39XX_MAIN_FIRMWARE "dvb-fe-drxj-mc-1.0.8.fw" #define DRX39XX_MAIN_FIRMWARE "dvb-fe-drxj-mc-1.0.8.fw"
/** /*
* \brief Maximum u32 value. * \brief Maximum u32 value.
*/ */
#ifndef MAX_U32 #ifndef MAX_U32
...@@ -100,8 +100,8 @@ INCLUDE FILES ...@@ -100,8 +100,8 @@ INCLUDE FILES
#ifndef OOB_DRX_DRIVE_STRENGTH #ifndef OOB_DRX_DRIVE_STRENGTH
#define OOB_DRX_DRIVE_STRENGTH 0x02 #define OOB_DRX_DRIVE_STRENGTH 0x02
#endif #endif
/**** START DJCOMBO patches to DRXJ registermap constants *********************/ /*** START DJCOMBO patches to DRXJ registermap constants *********************/
/**** registermap 200706071303 from drxj **************************************/ /*** registermap 200706071303 from drxj **************************************/
#define ATV_TOP_CR_AMP_TH_FM 0x0 #define ATV_TOP_CR_AMP_TH_FM 0x0
#define ATV_TOP_CR_AMP_TH_L 0xA #define ATV_TOP_CR_AMP_TH_L 0xA
#define ATV_TOP_CR_AMP_TH_LP 0xA #define ATV_TOP_CR_AMP_TH_LP 0xA
...@@ -188,7 +188,7 @@ INCLUDE FILES ...@@ -188,7 +188,7 @@ INCLUDE FILES
#define IQM_RC_ADJ_SEL_B_OFF 0x0 #define IQM_RC_ADJ_SEL_B_OFF 0x0
#define IQM_RC_ADJ_SEL_B_QAM 0x1 #define IQM_RC_ADJ_SEL_B_QAM 0x1
#define IQM_RC_ADJ_SEL_B_VSB 0x2 #define IQM_RC_ADJ_SEL_B_VSB 0x2
/**** END DJCOMBO patches to DRXJ registermap *********************************/ /*** END DJCOMBO patches to DRXJ registermap *********************************/
#include "drx_driver_version.h" #include "drx_driver_version.h"
...@@ -208,25 +208,25 @@ DEFINES ...@@ -208,25 +208,25 @@ DEFINES
#define DRXJ_WAKE_UP_KEY (demod->my_i2c_dev_addr->i2c_addr) #define DRXJ_WAKE_UP_KEY (demod->my_i2c_dev_addr->i2c_addr)
#endif #endif
/** /*
* \def DRXJ_DEF_I2C_ADDR * \def DRXJ_DEF_I2C_ADDR
* \brief Default I2C address of a demodulator instance. * \brief Default I2C address of a demodulator instance.
*/ */
#define DRXJ_DEF_I2C_ADDR (0x52) #define DRXJ_DEF_I2C_ADDR (0x52)
/** /*
* \def DRXJ_DEF_DEMOD_DEV_ID * \def DRXJ_DEF_DEMOD_DEV_ID
* \brief Default device identifier of a demodultor instance. * \brief Default device identifier of a demodultor instance.
*/ */
#define DRXJ_DEF_DEMOD_DEV_ID (1) #define DRXJ_DEF_DEMOD_DEV_ID (1)
/** /*
* \def DRXJ_SCAN_TIMEOUT * \def DRXJ_SCAN_TIMEOUT
* \brief Timeout value for waiting on demod lock during channel scan (millisec). * \brief Timeout value for waiting on demod lock during channel scan (millisec).
*/ */
#define DRXJ_SCAN_TIMEOUT 1000 #define DRXJ_SCAN_TIMEOUT 1000
/** /*
* \def HI_I2C_DELAY * \def HI_I2C_DELAY
* \brief HI timing delay for I2C timing (in nano seconds) * \brief HI timing delay for I2C timing (in nano seconds)
* *
...@@ -234,7 +234,7 @@ DEFINES ...@@ -234,7 +234,7 @@ DEFINES
*/ */
#define HI_I2C_DELAY 42 #define HI_I2C_DELAY 42
/** /*
* \def HI_I2C_BRIDGE_DELAY * \def HI_I2C_BRIDGE_DELAY
* \brief HI timing delay for I2C timing (in nano seconds) * \brief HI timing delay for I2C timing (in nano seconds)
* *
...@@ -242,13 +242,13 @@ DEFINES ...@@ -242,13 +242,13 @@ DEFINES
*/ */
#define HI_I2C_BRIDGE_DELAY 750 #define HI_I2C_BRIDGE_DELAY 750
/** /*
* \brief Time Window for MER and SER Measurement in Units of Segment duration. * \brief Time Window for MER and SER Measurement in Units of Segment duration.
*/ */
#define VSB_TOP_MEASUREMENT_PERIOD 64 #define VSB_TOP_MEASUREMENT_PERIOD 64
#define SYMBOLS_PER_SEGMENT 832 #define SYMBOLS_PER_SEGMENT 832
/** /*
* \brief bit rate and segment rate constants used for SER and BER. * \brief bit rate and segment rate constants used for SER and BER.
*/ */
/* values taken from the QAM microcode */ /* values taken from the QAM microcode */
...@@ -260,21 +260,21 @@ DEFINES ...@@ -260,21 +260,21 @@ DEFINES
#define DRXJ_QAM_SL_SIG_POWER_QAM64 43008 #define DRXJ_QAM_SL_SIG_POWER_QAM64 43008
#define DRXJ_QAM_SL_SIG_POWER_QAM128 20992 #define DRXJ_QAM_SL_SIG_POWER_QAM128 20992
#define DRXJ_QAM_SL_SIG_POWER_QAM256 43520 #define DRXJ_QAM_SL_SIG_POWER_QAM256 43520
/** /*
* \brief Min supported symbolrates. * \brief Min supported symbolrates.
*/ */
#ifndef DRXJ_QAM_SYMBOLRATE_MIN #ifndef DRXJ_QAM_SYMBOLRATE_MIN
#define DRXJ_QAM_SYMBOLRATE_MIN (520000) #define DRXJ_QAM_SYMBOLRATE_MIN (520000)
#endif #endif
/** /*
* \brief Max supported symbolrates. * \brief Max supported symbolrates.
*/ */
#ifndef DRXJ_QAM_SYMBOLRATE_MAX #ifndef DRXJ_QAM_SYMBOLRATE_MAX
#define DRXJ_QAM_SYMBOLRATE_MAX (7233000) #define DRXJ_QAM_SYMBOLRATE_MAX (7233000)
#endif #endif
/** /*
* \def DRXJ_QAM_MAX_WAITTIME * \def DRXJ_QAM_MAX_WAITTIME
* \brief Maximal wait time for QAM auto constellation in ms * \brief Maximal wait time for QAM auto constellation in ms
*/ */
...@@ -290,7 +290,7 @@ DEFINES ...@@ -290,7 +290,7 @@ DEFINES
#define DRXJ_QAM_DEMOD_LOCK_EXT_WAITTIME 200 #define DRXJ_QAM_DEMOD_LOCK_EXT_WAITTIME 200
#endif #endif
/** /*
* \def SCU status and results * \def SCU status and results
* \brief SCU * \brief SCU
*/ */
...@@ -299,7 +299,7 @@ DEFINES ...@@ -299,7 +299,7 @@ DEFINES
#define FEC_RS_MEASUREMENT_PERIOD 12894 /* 1 sec */ #define FEC_RS_MEASUREMENT_PERIOD 12894 /* 1 sec */
#define FEC_RS_MEASUREMENT_PRESCALE 1 /* n sec */ #define FEC_RS_MEASUREMENT_PRESCALE 1 /* n sec */
/** /*
* \def DRX_AUD_MAX_DEVIATION * \def DRX_AUD_MAX_DEVIATION
* \brief Needed for calculation of prescale feature in AUD * \brief Needed for calculation of prescale feature in AUD
*/ */
...@@ -307,14 +307,14 @@ DEFINES ...@@ -307,14 +307,14 @@ DEFINES
#define DRXJ_AUD_MAX_FM_DEVIATION 100 /* kHz */ #define DRXJ_AUD_MAX_FM_DEVIATION 100 /* kHz */
#endif #endif
/** /*
* \brief Needed for calculation of NICAM prescale feature in AUD * \brief Needed for calculation of NICAM prescale feature in AUD
*/ */
#ifndef DRXJ_AUD_MAX_NICAM_PRESCALE #ifndef DRXJ_AUD_MAX_NICAM_PRESCALE
#define DRXJ_AUD_MAX_NICAM_PRESCALE (9) /* dB */ #define DRXJ_AUD_MAX_NICAM_PRESCALE (9) /* dB */
#endif #endif
/** /*
* \brief Needed for calculation of NICAM prescale feature in AUD * \brief Needed for calculation of NICAM prescale feature in AUD
*/ */
#ifndef DRXJ_AUD_MAX_WAITTIME #ifndef DRXJ_AUD_MAX_WAITTIME
...@@ -371,21 +371,21 @@ DEFINES ...@@ -371,21 +371,21 @@ DEFINES
/*============================================================================*/ /*============================================================================*/
/*=== GLOBAL VARIABLEs =======================================================*/ /*=== GLOBAL VARIABLEs =======================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
*/ */
/** /*
* \brief Temporary register definitions. * \brief Temporary register definitions.
* (register definitions that are not yet available in register master) * (register definitions that are not yet available in register master)
*/ */
/******************************************************************************/ /*****************************************************************************/
/* Audio block 0x103 is write only. To avoid shadowing in driver accessing */ /* Audio block 0x103 is write only. To avoid shadowing in driver accessing */
/* RAM adresses directly. This must be READ ONLY to avoid problems. */ /* RAM adresses directly. This must be READ ONLY to avoid problems. */
/* Writing to the interface adresses is more than only writing the RAM */ /* Writing to the interface adresses is more than only writing the RAM */
/* locations */ /* locations */
/******************************************************************************/ /*****************************************************************************/
/** /*
* \brief RAM location of MODUS registers * \brief RAM location of MODUS registers
*/ */
#define AUD_DEM_RAM_MODUS_HI__A 0x10204A3 #define AUD_DEM_RAM_MODUS_HI__A 0x10204A3
...@@ -394,13 +394,13 @@ DEFINES ...@@ -394,13 +394,13 @@ DEFINES
#define AUD_DEM_RAM_MODUS_LO__A 0x10204A4 #define AUD_DEM_RAM_MODUS_LO__A 0x10204A4
#define AUD_DEM_RAM_MODUS_LO__M 0x0FFF #define AUD_DEM_RAM_MODUS_LO__M 0x0FFF
/** /*
* \brief RAM location of I2S config registers * \brief RAM location of I2S config registers
*/ */
#define AUD_DEM_RAM_I2S_CONFIG1__A 0x10204B1 #define AUD_DEM_RAM_I2S_CONFIG1__A 0x10204B1
#define AUD_DEM_RAM_I2S_CONFIG2__A 0x10204B2 #define AUD_DEM_RAM_I2S_CONFIG2__A 0x10204B2
/** /*
* \brief RAM location of DCO config registers * \brief RAM location of DCO config registers
*/ */
#define AUD_DEM_RAM_DCO_B_HI__A 0x1020461 #define AUD_DEM_RAM_DCO_B_HI__A 0x1020461
...@@ -408,20 +408,20 @@ DEFINES ...@@ -408,20 +408,20 @@ DEFINES
#define AUD_DEM_RAM_DCO_A_HI__A 0x1020463 #define AUD_DEM_RAM_DCO_A_HI__A 0x1020463
#define AUD_DEM_RAM_DCO_A_LO__A 0x1020464 #define AUD_DEM_RAM_DCO_A_LO__A 0x1020464
/** /*
* \brief RAM location of Threshold registers * \brief RAM location of Threshold registers
*/ */
#define AUD_DEM_RAM_NICAM_THRSHLD__A 0x102045A #define AUD_DEM_RAM_NICAM_THRSHLD__A 0x102045A
#define AUD_DEM_RAM_A2_THRSHLD__A 0x10204BB #define AUD_DEM_RAM_A2_THRSHLD__A 0x10204BB
#define AUD_DEM_RAM_BTSC_THRSHLD__A 0x10204A6 #define AUD_DEM_RAM_BTSC_THRSHLD__A 0x10204A6
/** /*
* \brief RAM location of Carrier Threshold registers * \brief RAM location of Carrier Threshold registers
*/ */
#define AUD_DEM_RAM_CM_A_THRSHLD__A 0x10204AF #define AUD_DEM_RAM_CM_A_THRSHLD__A 0x10204AF
#define AUD_DEM_RAM_CM_B_THRSHLD__A 0x10204B0 #define AUD_DEM_RAM_CM_B_THRSHLD__A 0x10204B0
/** /*
* \brief FM Matrix register fix * \brief FM Matrix register fix
*/ */
#ifdef AUD_DEM_WR_FM_MATRIX__A #ifdef AUD_DEM_WR_FM_MATRIX__A
...@@ -430,7 +430,7 @@ DEFINES ...@@ -430,7 +430,7 @@ DEFINES
#define AUD_DEM_WR_FM_MATRIX__A 0x105006F #define AUD_DEM_WR_FM_MATRIX__A 0x105006F
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Defines required for audio * \brief Defines required for audio
*/ */
#define AUD_VOLUME_ZERO_DB 115 #define AUD_VOLUME_ZERO_DB 115
...@@ -443,14 +443,14 @@ DEFINES ...@@ -443,14 +443,14 @@ DEFINES
#define AUD_I2S_FREQUENCY_MIN 12000UL #define AUD_I2S_FREQUENCY_MIN 12000UL
#define AUD_RDS_ARRAY_SIZE 18 #define AUD_RDS_ARRAY_SIZE 18
/** /*
* \brief Needed for calculation of prescale feature in AUD * \brief Needed for calculation of prescale feature in AUD
*/ */
#ifndef DRX_AUD_MAX_FM_DEVIATION #ifndef DRX_AUD_MAX_FM_DEVIATION
#define DRX_AUD_MAX_FM_DEVIATION (100) /* kHz */ #define DRX_AUD_MAX_FM_DEVIATION (100) /* kHz */
#endif #endif
/** /*
* \brief Needed for calculation of NICAM prescale feature in AUD * \brief Needed for calculation of NICAM prescale feature in AUD
*/ */
#ifndef DRX_AUD_MAX_NICAM_PRESCALE #ifndef DRX_AUD_MAX_NICAM_PRESCALE
...@@ -478,7 +478,7 @@ DEFINES ...@@ -478,7 +478,7 @@ DEFINES
/*=== REGISTER ACCESS MACROS =================================================*/ /*=== REGISTER ACCESS MACROS =================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* This macro is used to create byte arrays for block writes. * This macro is used to create byte arrays for block writes.
* Block writes speed up I2C traffic between host and demod. * Block writes speed up I2C traffic between host and demod.
* The macro takes care of the required byte order in a 16 bits word. * The macro takes care of the required byte order in a 16 bits word.
...@@ -486,7 +486,7 @@ DEFINES ...@@ -486,7 +486,7 @@ DEFINES
*/ */
#define DRXJ_16TO8(x) ((u8) (((u16)x) & 0xFF)), \ #define DRXJ_16TO8(x) ((u8) (((u16)x) & 0xFF)), \
((u8)((((u16)x)>>8)&0xFF)) ((u8)((((u16)x)>>8)&0xFF))
/** /*
* This macro is used to convert byte array to 16 bit register value for block read. * This macro is used to convert byte array to 16 bit register value for block read.
* Block read speed up I2C traffic between host and demod. * Block read speed up I2C traffic between host and demod.
* The macro takes care of the required byte order in a 16 bits word. * The macro takes care of the required byte order in a 16 bits word.
...@@ -501,7 +501,7 @@ DEFINES ...@@ -501,7 +501,7 @@ DEFINES
/*=== HI COMMAND RELATED DEFINES =============================================*/ /*=== HI COMMAND RELATED DEFINES =============================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief General maximum number of retries for ucode command interfaces * \brief General maximum number of retries for ucode command interfaces
*/ */
#define DRXJ_MAX_RETRIES (100) #define DRXJ_MAX_RETRIES (100)
...@@ -807,7 +807,7 @@ static struct drxj_data drxj_data_g = { ...@@ -807,7 +807,7 @@ static struct drxj_data drxj_data_g = {
}, },
}; };
/** /*
* \var drxj_default_addr_g * \var drxj_default_addr_g
* \brief Default I2C address and device identifier. * \brief Default I2C address and device identifier.
*/ */
...@@ -816,7 +816,7 @@ static struct i2c_device_addr drxj_default_addr_g = { ...@@ -816,7 +816,7 @@ static struct i2c_device_addr drxj_default_addr_g = {
DRXJ_DEF_DEMOD_DEV_ID /* device id */ DRXJ_DEF_DEMOD_DEV_ID /* device id */
}; };
/** /*
* \var drxj_default_comm_attr_g * \var drxj_default_comm_attr_g
* \brief Default common attributes of a drxj demodulator instance. * \brief Default common attributes of a drxj demodulator instance.
*/ */
...@@ -887,7 +887,7 @@ static struct drx_common_attr drxj_default_comm_attr_g = { ...@@ -887,7 +887,7 @@ static struct drx_common_attr drxj_default_comm_attr_g = {
0 /* mfx */ 0 /* mfx */
}; };
/** /*
* \var drxj_default_demod_g * \var drxj_default_demod_g
* \brief Default drxj demodulator instance. * \brief Default drxj demodulator instance.
*/ */
...@@ -897,7 +897,7 @@ static struct drx_demod_instance drxj_default_demod_g = { ...@@ -897,7 +897,7 @@ static struct drx_demod_instance drxj_default_demod_g = {
&drxj_data_g /* demod device specific attributes */ &drxj_data_g /* demod device specific attributes */
}; };
/** /*
* \brief Default audio data structure for DRK demodulator instance. * \brief Default audio data structure for DRK demodulator instance.
* *
* This structure is DRXK specific. * This structure is DRXK specific.
...@@ -997,7 +997,7 @@ struct drxj_hi_cmd { ...@@ -997,7 +997,7 @@ struct drxj_hi_cmd {
/*=== MICROCODE RELATED STRUCTURES ===========================================*/ /*=== MICROCODE RELATED STRUCTURES ===========================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* struct drxu_code_block_hdr - Structure of the microcode block headers * struct drxu_code_block_hdr - Structure of the microcode block headers
* *
* @addr: Destination address of the data in this block * @addr: Destination address of the data in this block
...@@ -1086,7 +1086,7 @@ static u32 frac28(u32 N, u32 D) ...@@ -1086,7 +1086,7 @@ static u32 frac28(u32 N, u32 D)
return Q1; return Q1;
} }
/** /*
* \fn u32 log1_times100( u32 x) * \fn u32 log1_times100( u32 x)
* \brief Compute: 100*log10(x) * \brief Compute: 100*log10(x)
* \param x 32 bits * \param x 32 bits
...@@ -1198,7 +1198,7 @@ static u32 log1_times100(u32 x) ...@@ -1198,7 +1198,7 @@ static u32 log1_times100(u32 x)
} }
/** /*
* \fn u32 frac_times1e6( u16 N, u32 D) * \fn u32 frac_times1e6( u16 N, u32 D)
* \brief Compute: (N/D) * 1000000. * \brief Compute: (N/D) * 1000000.
* \param N nominator 16-bits. * \param N nominator 16-bits.
...@@ -1235,7 +1235,7 @@ static u32 frac_times1e6(u32 N, u32 D) ...@@ -1235,7 +1235,7 @@ static u32 frac_times1e6(u32 N, u32 D)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Values for NICAM prescaler gain. Computed from dB to integer * \brief Values for NICAM prescaler gain. Computed from dB to integer
* and rounded. For calc used formula: 16*10^(prescaleGain[dB]/20). * and rounded. For calc used formula: 16*10^(prescaleGain[dB]/20).
* *
...@@ -1280,7 +1280,7 @@ static const u16 nicam_presc_table_val[43] = { ...@@ -1280,7 +1280,7 @@ static const u16 nicam_presc_table_val[43] = {
#define DRXJ_DAP_AUDTRIF_TIMEOUT 80 /* millisec */ #define DRXJ_DAP_AUDTRIF_TIMEOUT 80 /* millisec */
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn bool is_handled_by_aud_tr_if( u32 addr ) * \fn bool is_handled_by_aud_tr_if( u32 addr )
* \brief Check if this address is handled by the audio token ring interface. * \brief Check if this address is handled by the audio token ring interface.
* \param addr * \param addr
...@@ -1386,7 +1386,7 @@ int drxbsp_i2c_write_read(struct i2c_device_addr *w_dev_addr, ...@@ -1386,7 +1386,7 @@ int drxbsp_i2c_write_read(struct i2c_device_addr *w_dev_addr,
/*============================================================================*/ /*============================================================================*/
/****************************** /*****************************
* *
* int drxdap_fasi_read_block ( * int drxdap_fasi_read_block (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1498,7 +1498,7 @@ static int drxdap_fasi_read_block(struct i2c_device_addr *dev_addr, ...@@ -1498,7 +1498,7 @@ static int drxdap_fasi_read_block(struct i2c_device_addr *dev_addr,
} }
/****************************** /*****************************
* *
* int drxdap_fasi_read_reg16 ( * int drxdap_fasi_read_reg16 (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1531,7 +1531,7 @@ static int drxdap_fasi_read_reg16(struct i2c_device_addr *dev_addr, ...@@ -1531,7 +1531,7 @@ static int drxdap_fasi_read_reg16(struct i2c_device_addr *dev_addr,
return rc; return rc;
} }
/****************************** /*****************************
* *
* int drxdap_fasi_read_reg32 ( * int drxdap_fasi_read_reg32 (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1566,7 +1566,7 @@ static int drxdap_fasi_read_reg32(struct i2c_device_addr *dev_addr, ...@@ -1566,7 +1566,7 @@ static int drxdap_fasi_read_reg32(struct i2c_device_addr *dev_addr,
return rc; return rc;
} }
/****************************** /*****************************
* *
* int drxdap_fasi_write_block ( * int drxdap_fasi_write_block (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1705,7 +1705,7 @@ static int drxdap_fasi_write_block(struct i2c_device_addr *dev_addr, ...@@ -1705,7 +1705,7 @@ static int drxdap_fasi_write_block(struct i2c_device_addr *dev_addr,
return first_err; return first_err;
} }
/****************************** /*****************************
* *
* int drxdap_fasi_write_reg16 ( * int drxdap_fasi_write_reg16 (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1734,7 +1734,7 @@ static int drxdap_fasi_write_reg16(struct i2c_device_addr *dev_addr, ...@@ -1734,7 +1734,7 @@ static int drxdap_fasi_write_reg16(struct i2c_device_addr *dev_addr,
return drxdap_fasi_write_block(dev_addr, addr, sizeof(data), buf, flags); return drxdap_fasi_write_block(dev_addr, addr, sizeof(data), buf, flags);
} }
/****************************** /*****************************
* *
* int drxdap_fasi_read_modify_write_reg16 ( * int drxdap_fasi_read_modify_write_reg16 (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1778,7 +1778,7 @@ static int drxdap_fasi_read_modify_write_reg16(struct i2c_device_addr *dev_addr, ...@@ -1778,7 +1778,7 @@ static int drxdap_fasi_read_modify_write_reg16(struct i2c_device_addr *dev_addr,
return rc; return rc;
} }
/****************************** /*****************************
* *
* int drxdap_fasi_write_reg32 ( * int drxdap_fasi_write_reg32 (
* struct i2c_device_addr *dev_addr, -- address of I2C device * struct i2c_device_addr *dev_addr, -- address of I2C device
...@@ -1811,7 +1811,7 @@ static int drxdap_fasi_write_reg32(struct i2c_device_addr *dev_addr, ...@@ -1811,7 +1811,7 @@ static int drxdap_fasi_write_reg32(struct i2c_device_addr *dev_addr,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int drxj_dap_rm_write_reg16short * \fn int drxj_dap_rm_write_reg16short
* \brief Read modify write 16 bits audio register using short format only. * \brief Read modify write 16 bits audio register using short format only.
* \param dev_addr * \param dev_addr
...@@ -1890,7 +1890,7 @@ static int drxj_dap_read_modify_write_reg16(struct i2c_device_addr *dev_addr, ...@@ -1890,7 +1890,7 @@ static int drxj_dap_read_modify_write_reg16(struct i2c_device_addr *dev_addr,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int drxj_dap_read_aud_reg16 * \fn int drxj_dap_read_aud_reg16
* \brief Read 16 bits audio register * \brief Read 16 bits audio register
* \param dev_addr * \param dev_addr
...@@ -1997,7 +1997,7 @@ static int drxj_dap_read_reg16(struct i2c_device_addr *dev_addr, ...@@ -1997,7 +1997,7 @@ static int drxj_dap_read_reg16(struct i2c_device_addr *dev_addr,
} }
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int drxj_dap_write_aud_reg16 * \fn int drxj_dap_write_aud_reg16
* \brief Write 16 bits audio register * \brief Write 16 bits audio register
* \param dev_addr * \param dev_addr
...@@ -2086,7 +2086,7 @@ static int drxj_dap_write_reg16(struct i2c_device_addr *dev_addr, ...@@ -2086,7 +2086,7 @@ static int drxj_dap_write_reg16(struct i2c_device_addr *dev_addr,
#define DRXJ_HI_ATOMIC_READ SIO_HI_RA_RAM_PAR_3_ACP_RW_READ #define DRXJ_HI_ATOMIC_READ SIO_HI_RA_RAM_PAR_3_ACP_RW_READ
#define DRXJ_HI_ATOMIC_WRITE SIO_HI_RA_RAM_PAR_3_ACP_RW_WRITE #define DRXJ_HI_ATOMIC_WRITE SIO_HI_RA_RAM_PAR_3_ACP_RW_WRITE
/** /*
* \fn int drxj_dap_atomic_read_write_block() * \fn int drxj_dap_atomic_read_write_block()
* \brief Basic access routine for atomic read or write access * \brief Basic access routine for atomic read or write access
* \param dev_addr pointer to i2c dev address * \param dev_addr pointer to i2c dev address
...@@ -2168,7 +2168,7 @@ int drxj_dap_atomic_read_write_block(struct i2c_device_addr *dev_addr, ...@@ -2168,7 +2168,7 @@ int drxj_dap_atomic_read_write_block(struct i2c_device_addr *dev_addr,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int drxj_dap_atomic_read_reg32() * \fn int drxj_dap_atomic_read_reg32()
* \brief Atomic read of 32 bits words * \brief Atomic read of 32 bits words
*/ */
...@@ -2215,7 +2215,7 @@ int drxj_dap_atomic_read_reg32(struct i2c_device_addr *dev_addr, ...@@ -2215,7 +2215,7 @@ int drxj_dap_atomic_read_reg32(struct i2c_device_addr *dev_addr,
/*============================================================================*/ /*============================================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int hi_cfg_command() * \fn int hi_cfg_command()
* \brief Configure HI with settings stored in the demod structure. * \brief Configure HI with settings stored in the demod structure.
* \param demod Demodulator. * \param demod Demodulator.
...@@ -2258,7 +2258,7 @@ static int hi_cfg_command(const struct drx_demod_instance *demod) ...@@ -2258,7 +2258,7 @@ static int hi_cfg_command(const struct drx_demod_instance *demod)
return rc; return rc;
} }
/** /*
* \fn int hi_command() * \fn int hi_command()
* \brief Configure HI with settings stored in the demod structure. * \brief Configure HI with settings stored in the demod structure.
* \param dev_addr I2C address. * \param dev_addr I2C address.
...@@ -2369,7 +2369,7 @@ hi_command(struct i2c_device_addr *dev_addr, const struct drxj_hi_cmd *cmd, u16 ...@@ -2369,7 +2369,7 @@ hi_command(struct i2c_device_addr *dev_addr, const struct drxj_hi_cmd *cmd, u16
return rc; return rc;
} }
/** /*
* \fn int init_hi( const struct drx_demod_instance *demod ) * \fn int init_hi( const struct drx_demod_instance *demod )
* \brief Initialise and configurate HI. * \brief Initialise and configurate HI.
* \param demod pointer to demod data. * \param demod pointer to demod data.
...@@ -2450,7 +2450,7 @@ static int init_hi(const struct drx_demod_instance *demod) ...@@ -2450,7 +2450,7 @@ static int init_hi(const struct drx_demod_instance *demod)
/*============================================================================*/ /*============================================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int get_device_capabilities() * \fn int get_device_capabilities()
* \brief Get and store device capabilities. * \brief Get and store device capabilities.
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
...@@ -2656,7 +2656,7 @@ static int get_device_capabilities(struct drx_demod_instance *demod) ...@@ -2656,7 +2656,7 @@ static int get_device_capabilities(struct drx_demod_instance *demod)
return rc; return rc;
} }
/** /*
* \fn int power_up_device() * \fn int power_up_device()
* \brief Power up device. * \brief Power up device.
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
...@@ -2710,7 +2710,7 @@ static int power_up_device(struct drx_demod_instance *demod) ...@@ -2710,7 +2710,7 @@ static int power_up_device(struct drx_demod_instance *demod)
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/* MPEG Output Configuration Functions - begin */ /* MPEG Output Configuration Functions - begin */
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int ctrl_set_cfg_mpeg_output() * \fn int ctrl_set_cfg_mpeg_output()
* \brief Set MPEG output configuration of the device. * \brief Set MPEG output configuration of the device.
* \param devmod Pointer to demodulator instance. * \param devmod Pointer to demodulator instance.
...@@ -3356,7 +3356,7 @@ ctrl_set_cfg_mpeg_output(struct drx_demod_instance *demod, struct drx_cfg_mpeg_o ...@@ -3356,7 +3356,7 @@ ctrl_set_cfg_mpeg_output(struct drx_demod_instance *demod, struct drx_cfg_mpeg_o
/* miscellaneous configurations - begin */ /* miscellaneous configurations - begin */
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int set_mpegtei_handling() * \fn int set_mpegtei_handling()
* \brief Activate MPEG TEI handling settings. * \brief Activate MPEG TEI handling settings.
* \param devmod Pointer to demodulator instance. * \param devmod Pointer to demodulator instance.
...@@ -3429,7 +3429,7 @@ static int set_mpegtei_handling(struct drx_demod_instance *demod) ...@@ -3429,7 +3429,7 @@ static int set_mpegtei_handling(struct drx_demod_instance *demod)
} }
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int bit_reverse_mpeg_output() * \fn int bit_reverse_mpeg_output()
* \brief Set MPEG output bit-endian settings. * \brief Set MPEG output bit-endian settings.
* \param devmod Pointer to demodulator instance. * \param devmod Pointer to demodulator instance.
...@@ -3472,7 +3472,7 @@ static int bit_reverse_mpeg_output(struct drx_demod_instance *demod) ...@@ -3472,7 +3472,7 @@ static int bit_reverse_mpeg_output(struct drx_demod_instance *demod)
} }
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int set_mpeg_start_width() * \fn int set_mpeg_start_width()
* \brief Set MPEG start width. * \brief Set MPEG start width.
* \param devmod Pointer to demodulator instance. * \param devmod Pointer to demodulator instance.
...@@ -3522,7 +3522,7 @@ static int set_mpeg_start_width(struct drx_demod_instance *demod) ...@@ -3522,7 +3522,7 @@ static int set_mpeg_start_width(struct drx_demod_instance *demod)
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/* UIO Configuration Functions - begin */ /* UIO Configuration Functions - begin */
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int ctrl_set_uio_cfg() * \fn int ctrl_set_uio_cfg()
* \brief Configure modus oprandi UIO. * \brief Configure modus oprandi UIO.
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
...@@ -3659,7 +3659,7 @@ static int ctrl_set_uio_cfg(struct drx_demod_instance *demod, struct drxuio_cfg ...@@ -3659,7 +3659,7 @@ static int ctrl_set_uio_cfg(struct drx_demod_instance *demod, struct drxuio_cfg
return rc; return rc;
} }
/** /*
* \fn int ctrl_uio_write() * \fn int ctrl_uio_write()
* \brief Write to a UIO. * \brief Write to a UIO.
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
...@@ -3868,7 +3868,7 @@ ctrl_uio_write(struct drx_demod_instance *demod, struct drxuio_data *uio_data) ...@@ -3868,7 +3868,7 @@ ctrl_uio_write(struct drx_demod_instance *demod, struct drxuio_data *uio_data)
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/* I2C Bridge Functions - begin */ /* I2C Bridge Functions - begin */
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int ctrl_i2c_bridge() * \fn int ctrl_i2c_bridge()
* \brief Open or close the I2C switch to tuner. * \brief Open or close the I2C switch to tuner.
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
...@@ -3903,7 +3903,7 @@ ctrl_i2c_bridge(struct drx_demod_instance *demod, bool *bridge_closed) ...@@ -3903,7 +3903,7 @@ ctrl_i2c_bridge(struct drx_demod_instance *demod, bool *bridge_closed)
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/* Smart antenna Functions - begin */ /* Smart antenna Functions - begin */
/*----------------------------------------------------------------------------*/ /*----------------------------------------------------------------------------*/
/** /*
* \fn int smart_ant_init() * \fn int smart_ant_init()
* \brief Initialize Smart Antenna. * \brief Initialize Smart Antenna.
* \param pointer to struct drx_demod_instance. * \param pointer to struct drx_demod_instance.
...@@ -4116,7 +4116,7 @@ static int scu_command(struct i2c_device_addr *dev_addr, struct drxjscu_cmd *cmd ...@@ -4116,7 +4116,7 @@ static int scu_command(struct i2c_device_addr *dev_addr, struct drxjscu_cmd *cmd
return rc; return rc;
} }
/** /*
* \fn int DRXJ_DAP_SCUAtomicReadWriteBlock() * \fn int DRXJ_DAP_SCUAtomicReadWriteBlock()
* \brief Basic access routine for SCU atomic read or write access * \brief Basic access routine for SCU atomic read or write access
* \param dev_addr pointer to i2c dev address * \param dev_addr pointer to i2c dev address
...@@ -4188,7 +4188,7 @@ int drxj_dap_scu_atomic_read_write_block(struct i2c_device_addr *dev_addr, u32 a ...@@ -4188,7 +4188,7 @@ int drxj_dap_scu_atomic_read_write_block(struct i2c_device_addr *dev_addr, u32 a
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int DRXJ_DAP_AtomicReadReg16() * \fn int DRXJ_DAP_AtomicReadReg16()
* \brief Atomic read of 16 bits words * \brief Atomic read of 16 bits words
*/ */
...@@ -4216,7 +4216,7 @@ int drxj_dap_scu_atomic_read_reg16(struct i2c_device_addr *dev_addr, ...@@ -4216,7 +4216,7 @@ int drxj_dap_scu_atomic_read_reg16(struct i2c_device_addr *dev_addr,
} }
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int drxj_dap_scu_atomic_write_reg16() * \fn int drxj_dap_scu_atomic_write_reg16()
* \brief Atomic read of 16 bits words * \brief Atomic read of 16 bits words
*/ */
...@@ -4237,7 +4237,7 @@ int drxj_dap_scu_atomic_write_reg16(struct i2c_device_addr *dev_addr, ...@@ -4237,7 +4237,7 @@ int drxj_dap_scu_atomic_write_reg16(struct i2c_device_addr *dev_addr,
} }
/* -------------------------------------------------------------------------- */ /* -------------------------------------------------------------------------- */
/** /*
* \brief Measure result of ADC synchronisation * \brief Measure result of ADC synchronisation
* \param demod demod instance * \param demod demod instance
* \param count (returned) count * \param count (returned) count
...@@ -4297,7 +4297,7 @@ static int adc_sync_measurement(struct drx_demod_instance *demod, u16 *count) ...@@ -4297,7 +4297,7 @@ static int adc_sync_measurement(struct drx_demod_instance *demod, u16 *count)
return rc; return rc;
} }
/** /*
* \brief Synchronize analog and digital clock domains * \brief Synchronize analog and digital clock domains
* \param demod demod instance * \param demod demod instance
* \return int. * \return int.
...@@ -4365,7 +4365,7 @@ static int adc_synchronization(struct drx_demod_instance *demod) ...@@ -4365,7 +4365,7 @@ static int adc_synchronization(struct drx_demod_instance *demod)
/*== 8VSB & QAM COMMON DATAPATH FUNCTIONS ==*/ /*== 8VSB & QAM COMMON DATAPATH FUNCTIONS ==*/
/*============================================================================*/ /*============================================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int init_agc () * \fn int init_agc ()
* \brief Initialize AGC for all standards. * \brief Initialize AGC for all standards.
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -4741,7 +4741,7 @@ static int init_agc(struct drx_demod_instance *demod) ...@@ -4741,7 +4741,7 @@ static int init_agc(struct drx_demod_instance *demod)
return rc; return rc;
} }
/** /*
* \fn int set_frequency () * \fn int set_frequency ()
* \brief Set frequency shift. * \brief Set frequency shift.
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -4839,7 +4839,7 @@ set_frequency(struct drx_demod_instance *demod, ...@@ -4839,7 +4839,7 @@ set_frequency(struct drx_demod_instance *demod,
return rc; return rc;
} }
/** /*
* \fn int get_acc_pkt_err() * \fn int get_acc_pkt_err()
* \brief Retrieve signal strength for VSB and QAM. * \brief Retrieve signal strength for VSB and QAM.
* \param demod Pointer to demod instance * \param demod Pointer to demod instance
...@@ -4891,7 +4891,7 @@ static int get_acc_pkt_err(struct drx_demod_instance *demod, u16 *packet_err) ...@@ -4891,7 +4891,7 @@ static int get_acc_pkt_err(struct drx_demod_instance *demod, u16 *packet_err)
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_agc_rf () * \fn int set_agc_rf ()
* \brief Configure RF AGC * \brief Configure RF AGC
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -5105,7 +5105,7 @@ set_agc_rf(struct drx_demod_instance *demod, struct drxj_cfg_agc *agc_settings, ...@@ -5105,7 +5105,7 @@ set_agc_rf(struct drx_demod_instance *demod, struct drxj_cfg_agc *agc_settings,
return rc; return rc;
} }
/** /*
* \fn int set_agc_if () * \fn int set_agc_if ()
* \brief Configure If AGC * \brief Configure If AGC
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -5334,7 +5334,7 @@ set_agc_if(struct drx_demod_instance *demod, struct drxj_cfg_agc *agc_settings, ...@@ -5334,7 +5334,7 @@ set_agc_if(struct drx_demod_instance *demod, struct drxj_cfg_agc *agc_settings,
return rc; return rc;
} }
/** /*
* \fn int set_iqm_af () * \fn int set_iqm_af ()
* \brief Configure IQM AF registers * \brief Configure IQM AF registers
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -5380,7 +5380,7 @@ static int set_iqm_af(struct drx_demod_instance *demod, bool active) ...@@ -5380,7 +5380,7 @@ static int set_iqm_af(struct drx_demod_instance *demod, bool active)
/*============================================================================*/ /*============================================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int power_down_vsb () * \fn int power_down_vsb ()
* \brief Powr down QAM related blocks. * \brief Powr down QAM related blocks.
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -5478,7 +5478,7 @@ static int power_down_vsb(struct drx_demod_instance *demod, bool primary) ...@@ -5478,7 +5478,7 @@ static int power_down_vsb(struct drx_demod_instance *demod, bool primary)
return rc; return rc;
} }
/** /*
* \fn int set_vsb_leak_n_gain () * \fn int set_vsb_leak_n_gain ()
* \brief Set ATSC demod. * \brief Set ATSC demod.
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -5694,7 +5694,7 @@ static int set_vsb_leak_n_gain(struct drx_demod_instance *demod) ...@@ -5694,7 +5694,7 @@ static int set_vsb_leak_n_gain(struct drx_demod_instance *demod)
return rc; return rc;
} }
/** /*
* \fn int set_vsb() * \fn int set_vsb()
* \brief Set 8VSB demod. * \brief Set 8VSB demod.
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -6200,7 +6200,7 @@ static int set_vsb(struct drx_demod_instance *demod) ...@@ -6200,7 +6200,7 @@ static int set_vsb(struct drx_demod_instance *demod)
return rc; return rc;
} }
/** /*
* \fn static short get_vsb_post_rs_pck_err(struct i2c_device_addr *dev_addr, u16 *PckErrs) * \fn static short get_vsb_post_rs_pck_err(struct i2c_device_addr *dev_addr, u16 *PckErrs)
* \brief Get the values of packet error in 8VSB mode * \brief Get the values of packet error in 8VSB mode
* \return Error code * \return Error code
...@@ -6239,7 +6239,7 @@ static int get_vsb_post_rs_pck_err(struct i2c_device_addr *dev_addr, ...@@ -6239,7 +6239,7 @@ static int get_vsb_post_rs_pck_err(struct i2c_device_addr *dev_addr,
return rc; return rc;
} }
/** /*
* \fn static short GetVSBBer(struct i2c_device_addr *dev_addr, u32 *ber) * \fn static short GetVSBBer(struct i2c_device_addr *dev_addr, u32 *ber)
* \brief Get the values of ber in VSB mode * \brief Get the values of ber in VSB mode
* \return Error code * \return Error code
...@@ -6284,7 +6284,7 @@ static int get_vs_bpost_viterbi_ber(struct i2c_device_addr *dev_addr, ...@@ -6284,7 +6284,7 @@ static int get_vs_bpost_viterbi_ber(struct i2c_device_addr *dev_addr,
return rc; return rc;
} }
/** /*
* \fn static short get_vs_bpre_viterbi_ber(struct i2c_device_addr *dev_addr, u32 *ber) * \fn static short get_vs_bpre_viterbi_ber(struct i2c_device_addr *dev_addr, u32 *ber)
* \brief Get the values of ber in VSB mode * \brief Get the values of ber in VSB mode
* \return Error code * \return Error code
...@@ -6306,7 +6306,7 @@ static int get_vs_bpre_viterbi_ber(struct i2c_device_addr *dev_addr, ...@@ -6306,7 +6306,7 @@ static int get_vs_bpre_viterbi_ber(struct i2c_device_addr *dev_addr,
return 0; return 0;
} }
/** /*
* \fn static int get_vsbmer(struct i2c_device_addr *dev_addr, u16 *mer) * \fn static int get_vsbmer(struct i2c_device_addr *dev_addr, u16 *mer)
* \brief Get the values of MER * \brief Get the values of MER
* \return Error code * \return Error code
...@@ -6340,7 +6340,7 @@ static int get_vsbmer(struct i2c_device_addr *dev_addr, u16 *mer) ...@@ -6340,7 +6340,7 @@ static int get_vsbmer(struct i2c_device_addr *dev_addr, u16 *mer)
/*============================================================================*/ /*============================================================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int power_down_qam () * \fn int power_down_qam ()
* \brief Powr down QAM related blocks. * \brief Powr down QAM related blocks.
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -6444,7 +6444,7 @@ static int power_down_qam(struct drx_demod_instance *demod, bool primary) ...@@ -6444,7 +6444,7 @@ static int power_down_qam(struct drx_demod_instance *demod, bool primary)
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_qam_measurement () * \fn int set_qam_measurement ()
* \brief Setup of the QAM Measuremnt intervals for signal quality * \brief Setup of the QAM Measuremnt intervals for signal quality
* \param demod instance of demod. * \param demod instance of demod.
...@@ -6656,7 +6656,7 @@ set_qam_measurement(struct drx_demod_instance *demod, ...@@ -6656,7 +6656,7 @@ set_qam_measurement(struct drx_demod_instance *demod,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_qam16 () * \fn int set_qam16 ()
* \brief QAM16 specific setup * \brief QAM16 specific setup
* \param demod instance of demod. * \param demod instance of demod.
...@@ -6891,7 +6891,7 @@ static int set_qam16(struct drx_demod_instance *demod) ...@@ -6891,7 +6891,7 @@ static int set_qam16(struct drx_demod_instance *demod)
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_qam32 () * \fn int set_qam32 ()
* \brief QAM32 specific setup * \brief QAM32 specific setup
* \param demod instance of demod. * \param demod instance of demod.
...@@ -7126,7 +7126,7 @@ static int set_qam32(struct drx_demod_instance *demod) ...@@ -7126,7 +7126,7 @@ static int set_qam32(struct drx_demod_instance *demod)
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_qam64 () * \fn int set_qam64 ()
* \brief QAM64 specific setup * \brief QAM64 specific setup
* \param demod instance of demod. * \param demod instance of demod.
...@@ -7362,7 +7362,7 @@ static int set_qam64(struct drx_demod_instance *demod) ...@@ -7362,7 +7362,7 @@ static int set_qam64(struct drx_demod_instance *demod)
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_qam128 () * \fn int set_qam128 ()
* \brief QAM128 specific setup * \brief QAM128 specific setup
* \param demod: instance of demod. * \param demod: instance of demod.
...@@ -7597,7 +7597,7 @@ static int set_qam128(struct drx_demod_instance *demod) ...@@ -7597,7 +7597,7 @@ static int set_qam128(struct drx_demod_instance *demod)
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int set_qam256 () * \fn int set_qam256 ()
* \brief QAM256 specific setup * \brief QAM256 specific setup
* \param demod: instance of demod. * \param demod: instance of demod.
...@@ -7835,7 +7835,7 @@ static int set_qam256(struct drx_demod_instance *demod) ...@@ -7835,7 +7835,7 @@ static int set_qam256(struct drx_demod_instance *demod)
#define QAM_SET_OP_CONSTELLATION 0x2 #define QAM_SET_OP_CONSTELLATION 0x2
#define QAM_SET_OP_SPECTRUM 0X4 #define QAM_SET_OP_SPECTRUM 0X4
/** /*
* \fn int set_qam () * \fn int set_qam ()
* \brief Set QAM demod. * \brief Set QAM demod.
* \param demod: instance of demod. * \param demod: instance of demod.
...@@ -8845,7 +8845,7 @@ static int qam_flip_spec(struct drx_demod_instance *demod, struct drx_channel *c ...@@ -8845,7 +8845,7 @@ static int qam_flip_spec(struct drx_demod_instance *demod, struct drx_channel *c
#define DEMOD_LOCKED 0x1 #define DEMOD_LOCKED 0x1
#define SYNC_FLIPPED 0x2 #define SYNC_FLIPPED 0x2
#define SPEC_MIRRORED 0x4 #define SPEC_MIRRORED 0x4
/** /*
* \fn int qam64auto () * \fn int qam64auto ()
* \brief auto do sync pattern switching and mirroring. * \brief auto do sync pattern switching and mirroring.
* \param demod: instance of demod. * \param demod: instance of demod.
...@@ -8993,7 +8993,7 @@ qam64auto(struct drx_demod_instance *demod, ...@@ -8993,7 +8993,7 @@ qam64auto(struct drx_demod_instance *demod,
return rc; return rc;
} }
/** /*
* \fn int qam256auto () * \fn int qam256auto ()
* \brief auto do sync pattern switching and mirroring. * \brief auto do sync pattern switching and mirroring.
* \param demod: instance of demod. * \param demod: instance of demod.
...@@ -9077,7 +9077,7 @@ qam256auto(struct drx_demod_instance *demod, ...@@ -9077,7 +9077,7 @@ qam256auto(struct drx_demod_instance *demod,
return rc; return rc;
} }
/** /*
* \fn int set_qam_channel () * \fn int set_qam_channel ()
* \brief Set QAM channel according to the requested constellation. * \brief Set QAM channel according to the requested constellation.
* \param demod: instance of demod. * \param demod: instance of demod.
...@@ -9284,7 +9284,7 @@ set_qam_channel(struct drx_demod_instance *demod, ...@@ -9284,7 +9284,7 @@ set_qam_channel(struct drx_demod_instance *demod,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn static short get_qamrs_err_count(struct i2c_device_addr *dev_addr) * \fn static short get_qamrs_err_count(struct i2c_device_addr *dev_addr)
* \brief Get RS error count in QAM mode (used for post RS BER calculation) * \brief Get RS error count in QAM mode (used for post RS BER calculation)
* \return Error code * \return Error code
...@@ -9355,7 +9355,7 @@ get_qamrs_err_count(struct i2c_device_addr *dev_addr, ...@@ -9355,7 +9355,7 @@ get_qamrs_err_count(struct i2c_device_addr *dev_addr,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int get_sig_strength() * \fn int get_sig_strength()
* \brief Retrieve signal strength for VSB and QAM. * \brief Retrieve signal strength for VSB and QAM.
* \param demod Pointer to demod instance * \param demod Pointer to demod instance
...@@ -9435,7 +9435,7 @@ static int get_sig_strength(struct drx_demod_instance *demod, u16 *sig_strength) ...@@ -9435,7 +9435,7 @@ static int get_sig_strength(struct drx_demod_instance *demod, u16 *sig_strength)
return rc; return rc;
} }
/** /*
* \fn int ctrl_get_qam_sig_quality() * \fn int ctrl_get_qam_sig_quality()
* \brief Retrieve QAM signal quality from device. * \brief Retrieve QAM signal quality from device.
* \param devmod Pointer to demodulator instance. * \param devmod Pointer to demodulator instance.
...@@ -9721,7 +9721,7 @@ ctrl_get_qam_sig_quality(struct drx_demod_instance *demod) ...@@ -9721,7 +9721,7 @@ ctrl_get_qam_sig_quality(struct drx_demod_instance *demod)
*/ */
/* -------------------------------------------------------------------------- */ /* -------------------------------------------------------------------------- */
/** /*
* \fn int power_down_atv () * \fn int power_down_atv ()
* \brief Power down ATV. * \brief Power down ATV.
* \param demod instance of demodulator * \param demod instance of demodulator
...@@ -9822,7 +9822,7 @@ power_down_atv(struct drx_demod_instance *demod, enum drx_standard standard, boo ...@@ -9822,7 +9822,7 @@ power_down_atv(struct drx_demod_instance *demod, enum drx_standard standard, boo
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Power up AUD. * \brief Power up AUD.
* \param demod instance of demodulator * \param demod instance of demodulator
* \return int. * \return int.
...@@ -9850,7 +9850,7 @@ static int power_down_aud(struct drx_demod_instance *demod) ...@@ -9850,7 +9850,7 @@ static int power_down_aud(struct drx_demod_instance *demod)
return rc; return rc;
} }
/** /*
* \fn int set_orx_nsu_aox() * \fn int set_orx_nsu_aox()
* \brief Configure OrxNsuAox for OOB * \brief Configure OrxNsuAox for OOB
* \param demod instance of demodulator. * \param demod instance of demodulator.
...@@ -9884,7 +9884,7 @@ static int set_orx_nsu_aox(struct drx_demod_instance *demod, bool active) ...@@ -9884,7 +9884,7 @@ static int set_orx_nsu_aox(struct drx_demod_instance *demod, bool active)
return rc; return rc;
} }
/** /*
* \fn int ctrl_set_oob() * \fn int ctrl_set_oob()
* \brief Set OOB channel to be used. * \brief Set OOB channel to be used.
* \param demod instance of demodulator * \param demod instance of demodulator
...@@ -9986,9 +9986,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par ...@@ -9986,9 +9986,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par
20; 20;
} }
/*********/ /********/
/* Stop */ /* Stop */
/*********/ /********/
rc = drxj_dap_write_reg16(dev_addr, ORX_COMM_EXEC__A, ORX_COMM_EXEC_STOP, 0); rc = drxj_dap_write_reg16(dev_addr, ORX_COMM_EXEC__A, ORX_COMM_EXEC_STOP, 0);
if (rc != 0) { if (rc != 0) {
pr_err("error %d\n", rc); pr_err("error %d\n", rc);
...@@ -10004,9 +10004,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par ...@@ -10004,9 +10004,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par
pr_err("error %d\n", rc); pr_err("error %d\n", rc);
goto rw_error; goto rw_error;
} }
/*********/ /********/
/* Reset */ /* Reset */
/*********/ /********/
scu_cmd.command = SCU_RAM_COMMAND_STANDARD_OOB scu_cmd.command = SCU_RAM_COMMAND_STANDARD_OOB
| SCU_RAM_COMMAND_CMD_DEMOD_RESET; | SCU_RAM_COMMAND_CMD_DEMOD_RESET;
scu_cmd.parameter_len = 0; scu_cmd.parameter_len = 0;
...@@ -10017,9 +10017,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par ...@@ -10017,9 +10017,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par
pr_err("error %d\n", rc); pr_err("error %d\n", rc);
goto rw_error; goto rw_error;
} }
/***********/ /**********/
/* SET_ENV */ /* SET_ENV */
/***********/ /**********/
/* set frequency, spectrum inversion and data rate */ /* set frequency, spectrum inversion and data rate */
scu_cmd.command = SCU_RAM_COMMAND_STANDARD_OOB scu_cmd.command = SCU_RAM_COMMAND_STANDARD_OOB
| SCU_RAM_COMMAND_CMD_DEMOD_SET_ENV; | SCU_RAM_COMMAND_CMD_DEMOD_SET_ENV;
...@@ -10376,9 +10376,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par ...@@ -10376,9 +10376,9 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par
pr_err("error %d\n", rc); pr_err("error %d\n", rc);
goto rw_error; goto rw_error;
} }
/*********/ /********/
/* Start */ /* Start */
/*********/ /********/
scu_cmd.command = SCU_RAM_COMMAND_STANDARD_OOB scu_cmd.command = SCU_RAM_COMMAND_STANDARD_OOB
| SCU_RAM_COMMAND_CMD_DEMOD_START; | SCU_RAM_COMMAND_CMD_DEMOD_START;
scu_cmd.parameter_len = 0; scu_cmd.parameter_len = 0;
...@@ -10419,7 +10419,7 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par ...@@ -10419,7 +10419,7 @@ static int ctrl_set_oob(struct drx_demod_instance *demod, struct drxoob *oob_par
/*============================================================================= /*=============================================================================
===== ctrl_set_channel() ========================================================== ===== ctrl_set_channel() ==========================================================
===========================================================================*/ ===========================================================================*/
/** /*
* \fn int ctrl_set_channel() * \fn int ctrl_set_channel()
* \brief Select a new transmission channel. * \brief Select a new transmission channel.
* \param demod instance of demod. * \param demod instance of demod.
...@@ -10652,7 +10652,7 @@ ctrl_set_channel(struct drx_demod_instance *demod, struct drx_channel *channel) ...@@ -10652,7 +10652,7 @@ ctrl_set_channel(struct drx_demod_instance *demod, struct drx_channel *channel)
===== SigQuality() ========================================================== ===== SigQuality() ==========================================================
===========================================================================*/ ===========================================================================*/
/** /*
* \fn int ctrl_sig_quality() * \fn int ctrl_sig_quality()
* \brief Retrieve signal quality form device. * \brief Retrieve signal quality form device.
* \param devmod Pointer to demodulator instance. * \param devmod Pointer to demodulator instance.
...@@ -10768,7 +10768,7 @@ ctrl_sig_quality(struct drx_demod_instance *demod, ...@@ -10768,7 +10768,7 @@ ctrl_sig_quality(struct drx_demod_instance *demod,
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int ctrl_lock_status() * \fn int ctrl_lock_status()
* \brief Retrieve lock status . * \brief Retrieve lock status .
* \param dev_addr Pointer to demodulator device address. * \param dev_addr Pointer to demodulator device address.
...@@ -10856,7 +10856,7 @@ ctrl_lock_status(struct drx_demod_instance *demod, enum drx_lock_status *lock_st ...@@ -10856,7 +10856,7 @@ ctrl_lock_status(struct drx_demod_instance *demod, enum drx_lock_status *lock_st
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int ctrl_set_standard() * \fn int ctrl_set_standard()
* \brief Set modulation standard to be used. * \brief Set modulation standard to be used.
* \param standard Modulation standard. * \param standard Modulation standard.
...@@ -11012,7 +11012,7 @@ static void drxj_reset_mode(struct drxj_data *ext_attr) ...@@ -11012,7 +11012,7 @@ static void drxj_reset_mode(struct drxj_data *ext_attr)
ext_attr->vsb_pre_saw_cfg.use_pre_saw = true; ext_attr->vsb_pre_saw_cfg.use_pre_saw = true;
} }
/** /*
* \fn int ctrl_power_mode() * \fn int ctrl_power_mode()
* \brief Set the power mode of the device to the specified power mode * \brief Set the power mode of the device to the specified power mode
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
...@@ -11171,7 +11171,7 @@ ctrl_power_mode(struct drx_demod_instance *demod, enum drx_power_mode *mode) ...@@ -11171,7 +11171,7 @@ ctrl_power_mode(struct drx_demod_instance *demod, enum drx_power_mode *mode)
/*== CTRL Set/Get Config related functions ===================================*/ /*== CTRL Set/Get Config related functions ===================================*/
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int ctrl_set_cfg_pre_saw() * \fn int ctrl_set_cfg_pre_saw()
* \brief Set Pre-saw reference. * \brief Set Pre-saw reference.
* \param demod demod instance * \param demod demod instance
...@@ -11234,7 +11234,7 @@ ctrl_set_cfg_pre_saw(struct drx_demod_instance *demod, struct drxj_cfg_pre_saw * ...@@ -11234,7 +11234,7 @@ ctrl_set_cfg_pre_saw(struct drx_demod_instance *demod, struct drxj_cfg_pre_saw *
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn int ctrl_set_cfg_afe_gain() * \fn int ctrl_set_cfg_afe_gain()
* \brief Set AFE Gain. * \brief Set AFE Gain.
* \param demod demod instance * \param demod demod instance
...@@ -11324,7 +11324,7 @@ static int drx_ctrl_u_code(struct drx_demod_instance *demod, ...@@ -11324,7 +11324,7 @@ static int drx_ctrl_u_code(struct drx_demod_instance *demod,
enum drxu_code_action action); enum drxu_code_action action);
static int drxj_set_lna_state(struct drx_demod_instance *demod, bool state); static int drxj_set_lna_state(struct drx_demod_instance *demod, bool state);
/** /*
* \fn drxj_open() * \fn drxj_open()
* \brief Open the demod instance, configure device, configure drxdriver * \brief Open the demod instance, configure device, configure drxdriver
* \return Status_t Return status. * \return Status_t Return status.
...@@ -11543,7 +11543,7 @@ static int drxj_open(struct drx_demod_instance *demod) ...@@ -11543,7 +11543,7 @@ static int drxj_open(struct drx_demod_instance *demod)
} }
/*============================================================================*/ /*============================================================================*/
/** /*
* \fn drxj_close() * \fn drxj_close()
* \brief Close the demod instance, power down the device * \brief Close the demod instance, power down the device
* \return Status_t Return status. * \return Status_t Return status.
...@@ -11594,7 +11594,7 @@ static int drxj_close(struct drx_demod_instance *demod) ...@@ -11594,7 +11594,7 @@ static int drxj_close(struct drx_demod_instance *demod)
* Microcode related functions * Microcode related functions
*/ */
/** /*
* drx_u_code_compute_crc - Compute CRC of block of microcode data. * drx_u_code_compute_crc - Compute CRC of block of microcode data.
* @block_data: Pointer to microcode data. * @block_data: Pointer to microcode data.
* @nr_words: Size of microcode block (number of 16 bits words). * @nr_words: Size of microcode block (number of 16 bits words).
...@@ -11622,7 +11622,7 @@ static u16 drx_u_code_compute_crc(u8 *block_data, u16 nr_words) ...@@ -11622,7 +11622,7 @@ static u16 drx_u_code_compute_crc(u8 *block_data, u16 nr_words)
return (u16)(crc_word >> 16); return (u16)(crc_word >> 16);
} }
/** /*
* drx_check_firmware - checks if the loaded firmware is valid * drx_check_firmware - checks if the loaded firmware is valid
* *
* @demod: demod structure * @demod: demod structure
...@@ -11708,7 +11708,7 @@ static int drx_check_firmware(struct drx_demod_instance *demod, u8 *mc_data, ...@@ -11708,7 +11708,7 @@ static int drx_check_firmware(struct drx_demod_instance *demod, u8 *mc_data,
return -EINVAL; return -EINVAL;
} }
/** /*
* drx_ctrl_u_code - Handle microcode upload or verify. * drx_ctrl_u_code - Handle microcode upload or verify.
* @dev_addr: Address of device. * @dev_addr: Address of device.
* @mc_info: Pointer to information about microcode data. * @mc_info: Pointer to information about microcode data.
......
...@@ -207,9 +207,9 @@ static inline u32 log10times100(u32 value) ...@@ -207,9 +207,9 @@ static inline u32 log10times100(u32 value)
return (100L * intlog10(value)) >> 24; return (100L * intlog10(value)) >> 24;
} }
/****************************************************************************/ /***************************************************************************/
/* I2C **********************************************************************/ /* I2C **********************************************************************/
/****************************************************************************/ /***************************************************************************/
static int drxk_i2c_lock(struct drxk_state *state) static int drxk_i2c_lock(struct drxk_state *state)
{ {
...@@ -3444,7 +3444,7 @@ static int dvbt_ctrl_set_sqi_speed(struct drxk_state *state, ...@@ -3444,7 +3444,7 @@ static int dvbt_ctrl_set_sqi_speed(struct drxk_state *state,
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Activate DVBT specific presets * \brief Activate DVBT specific presets
* \param demod instance of demodulator. * \param demod instance of demodulator.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -3484,7 +3484,7 @@ static int dvbt_activate_presets(struct drxk_state *state) ...@@ -3484,7 +3484,7 @@ static int dvbt_activate_presets(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Initialize channelswitch-independent settings for DVBT. * \brief Initialize channelswitch-independent settings for DVBT.
* \param demod instance of demodulator. * \param demod instance of demodulator.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -3696,7 +3696,7 @@ static int set_dvbt_standard(struct drxk_state *state, ...@@ -3696,7 +3696,7 @@ static int set_dvbt_standard(struct drxk_state *state,
} }
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief start dvbt demodulating for channel. * \brief start dvbt demodulating for channel.
* \param demod instance of demodulator. * \param demod instance of demodulator.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -3732,7 +3732,7 @@ static int dvbt_start(struct drxk_state *state) ...@@ -3732,7 +3732,7 @@ static int dvbt_start(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Set up dvbt demodulator for channel. * \brief Set up dvbt demodulator for channel.
* \param demod instance of demodulator. * \param demod instance of demodulator.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -4086,7 +4086,7 @@ static int set_dvbt(struct drxk_state *state, u16 intermediate_freqk_hz, ...@@ -4086,7 +4086,7 @@ static int set_dvbt(struct drxk_state *state, u16 intermediate_freqk_hz,
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Retrieve lock status . * \brief Retrieve lock status .
* \param demod Pointer to demodulator instance. * \param demod Pointer to demodulator instance.
* \param lockStat Pointer to lock status structure. * \param lockStat Pointer to lock status structure.
...@@ -4148,7 +4148,7 @@ static int power_up_qam(struct drxk_state *state) ...@@ -4148,7 +4148,7 @@ static int power_up_qam(struct drxk_state *state)
} }
/** Power Down QAM */ /* Power Down QAM */
static int power_down_qam(struct drxk_state *state) static int power_down_qam(struct drxk_state *state)
{ {
u16 data = 0; u16 data = 0;
...@@ -4186,7 +4186,7 @@ static int power_down_qam(struct drxk_state *state) ...@@ -4186,7 +4186,7 @@ static int power_down_qam(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Setup of the QAM Measurement intervals for signal quality * \brief Setup of the QAM Measurement intervals for signal quality
* \param demod instance of demod. * \param demod instance of demod.
* \param modulation current modulation. * \param modulation current modulation.
...@@ -4461,7 +4461,7 @@ static int set_qam16(struct drxk_state *state) ...@@ -4461,7 +4461,7 @@ static int set_qam16(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief QAM32 specific setup * \brief QAM32 specific setup
* \param demod instance of demod. * \param demod instance of demod.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -4657,7 +4657,7 @@ static int set_qam32(struct drxk_state *state) ...@@ -4657,7 +4657,7 @@ static int set_qam32(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief QAM64 specific setup * \brief QAM64 specific setup
* \param demod instance of demod. * \param demod instance of demod.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -4852,7 +4852,7 @@ static int set_qam64(struct drxk_state *state) ...@@ -4852,7 +4852,7 @@ static int set_qam64(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief QAM128 specific setup * \brief QAM128 specific setup
* \param demod: instance of demod. * \param demod: instance of demod.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -5049,7 +5049,7 @@ static int set_qam128(struct drxk_state *state) ...@@ -5049,7 +5049,7 @@ static int set_qam128(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief QAM256 specific setup * \brief QAM256 specific setup
* \param demod: instance of demod. * \param demod: instance of demod.
* \return DRXStatus_t. * \return DRXStatus_t.
...@@ -5244,7 +5244,7 @@ static int set_qam256(struct drxk_state *state) ...@@ -5244,7 +5244,7 @@ static int set_qam256(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Reset QAM block. * \brief Reset QAM block.
* \param demod: instance of demod. * \param demod: instance of demod.
* \param channel: pointer to channel data. * \param channel: pointer to channel data.
...@@ -5272,7 +5272,7 @@ static int qam_reset_qam(struct drxk_state *state) ...@@ -5272,7 +5272,7 @@ static int qam_reset_qam(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Set QAM symbolrate. * \brief Set QAM symbolrate.
* \param demod: instance of demod. * \param demod: instance of demod.
* \param channel: pointer to channel data. * \param channel: pointer to channel data.
...@@ -5341,7 +5341,7 @@ static int qam_set_symbolrate(struct drxk_state *state) ...@@ -5341,7 +5341,7 @@ static int qam_set_symbolrate(struct drxk_state *state)
/*============================================================================*/ /*============================================================================*/
/** /*
* \brief Get QAM lock status. * \brief Get QAM lock status.
* \param demod: instance of demod. * \param demod: instance of demod.
* \param channel: pointer to channel data. * \param channel: pointer to channel data.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment