/**
@brief RTL2836 MxL5007T NIM module builder
Use BuildRtl2836Mxl5007tModule() to build RTL2836 MxL5007T NIM module, set all module function pointers with the
corresponding functions, and initialize module private variables.
@param [in] ppNim Pointer to RTL2836 MxL5007T NIM module pointer
@param [in] pDtmbNimModuleMemory Pointer to an allocated DTMB NIM module memory
@param [in] I2cReadingByteNumMax Maximum I2C reading byte number for basic I2C reading function
@param [in] I2cWritingByteNumMax Maximum I2C writing byte number for basic I2C writing function
@param [in] I2cRead Basic I2C reading function pointer
@param [in] I2cWrite Basic I2C writing function pointer
@param [in] WaitMs Basic waiting function pointer
@param [in] DemodDeviceAddr RTL2836 I2C device address
@param [in] DemodCrystalFreqHz RTL2836 crystal frequency in Hz
@param [in] DemodTsInterfaceMode RTL2836 TS interface mode
@param [in] DemodUpdateFuncRefPeriodMs RTL2836 update function reference period in millisecond
@param [in] DemodIsFunc1Enabled RTL2836 Function 1 enabling status for setting
@param [in] DemodIsFunc2Enabled RTL2836 Function 2 enabling status for setting
@param [in] TunerDeviceAddr MxL5007T I2C device address
@param [in] TunerCrystalFreqHz MxL5007T crystal frequency in Hz
@param [in] TunerLoopThroughMode MxL5007T loop-through mode
@param [in] TunerClkOutMode MxL5007T clock output mode
@param [in] TunerClkOutAmpMode MxL5007T clock output amplitude mode
@note
-# One should call BuildRtl2836Mxl5007tModule() to build RTL2836 MxL5007T NIM module before using it.
*/
void
BuildRtl2836Mxl5007tModule(
DTMB_NIM_MODULE **ppNim, // DTMB NIM dependence
DTMB_NIM_MODULE *pDtmbNimModuleMemory,
u64 I2cReadingByteNumMax, // Base interface dependence
u64 I2cWritingByteNumMax,
BASE_FP_I2C_READ I2cRead,
BASE_FP_I2C_WRITE I2cWrite,
BASE_FP_WAIT_MS WaitMs,
u8 DemodDeviceAddr, // Demod dependence
u64 DemodCrystalFreqHz,
s32 DemodTsInterfaceMode,
u64 DemodUpdateFuncRefPeriodMs,
s32 DemodIsFunc1Enabled,
s32 DemodIsFunc2Enabled,
u8 TunerDeviceAddr, // Tuner dependence
u64 TunerCrystalFreqHz,
s32 TunerLoopThroughMode,
s32 TunerClkOutMode,
s32 TunerClkOutAmpMode
)
{
DTMB_NIM_MODULE *pNim;
// Set NIM module pointer with NIM module memory.
*ppNim = pDtmbNimModuleMemory;
// Get NIM module.
pNim = *ppNim;
// Set I2C bridge module pointer with I2C bridge module memory.
pNim->pI2cBridge = &pNim->I2cBridgeModuleMemory;
// Set NIM type.
pNim->NimType = DTMB_NIM_RTL2836_MXL5007T;
// Build base interface module.
BuildBaseInterface(
&pNim->pBaseInterface,
&pNim->BaseInterfaceModuleMemory,
I2cReadingByteNumMax,
I2cWritingByteNumMax,
I2cRead,
I2cWrite,
WaitMs
);
// Build RTL2836 demod module.
BuildRtl2836Module(
&pNim->pDemod,
&pNim->DtmbDemodModuleMemory,
&pNim->BaseInterfaceModuleMemory,
&pNim->I2cBridgeModuleMemory,
DemodDeviceAddr,
DemodCrystalFreqHz,
DemodTsInterfaceMode,
DemodUpdateFuncRefPeriodMs,
DemodIsFunc1Enabled,
DemodIsFunc2Enabled
);
// Build MxL5007T tuner module.
BuildMxl5007tModule(
&pNim->pTuner,
&pNim->TunerModuleMemory,
&pNim->BaseInterfaceModuleMemory,
&pNim->I2cBridgeModuleMemory,
TunerDeviceAddr,
TunerCrystalFreqHz,
RTL2836_MXL5007T_STANDARD_MODE_DEFAULT,
RTL2836_MXL5007T_IF_FREQ_HZ_DEFAULT,
RTL2836_MXL5007T_SPECTRUM_MODE_DEFAULT,
TunerLoopThroughMode,
TunerClkOutMode,
TunerClkOutAmpMode,
RTL2836_MXL5007T_QAM_IF_DIFF_OUT_LEVEL_DEFAULT
);
// Set NIM module function pointers with default functions.
pNim->GetNimType = dtmb_nim_default_GetNimType;
pNim->GetParameters = dtmb_nim_default_GetParameters;
pNim->IsSignalPresent = dtmb_nim_default_IsSignalPresent;
pNim->IsSignalLocked = dtmb_nim_default_IsSignalLocked;
pNim->GetSignalStrength = dtmb_nim_default_GetSignalStrength;
pNim->GetSignalQuality = dtmb_nim_default_GetSignalQuality;
pNim->GetBer = dtmb_nim_default_GetBer;
pNim->GetPer = dtmb_nim_default_GetPer;
pNim->GetSnrDb = dtmb_nim_default_GetSnrDb;
pNim->GetTrOffsetPpm = dtmb_nim_default_GetTrOffsetPpm;
pNim->GetCrOffsetHz = dtmb_nim_default_GetCrOffsetHz;
pNim->GetSignalInfo = dtmb_nim_default_GetSignalInfo;
pNim->UpdateFunction = dtmb_nim_default_UpdateFunction;
// Set NIM module function pointers with particular functions.
pNim->Initialize = rtl2836_mxl5007t_Initialize;
pNim->SetParameters = rtl2836_mxl5007t_SetParameters;
return;
}
/**
@brief RTL2836 FC2580 NIM module builder
Use BuildRtl2836Fc2580Module() to build RTL2836 FC2580 NIM module, set all module function pointers with the
corresponding functions, and initialize module private variables.
@param [in] ppNim Pointer to RTL2836 FC2580 NIM module pointer
@param [in] pDtmbNimModuleMemory Pointer to an allocated DTMB NIM module memory
@param [in] I2cReadingByteNumMax Maximum I2C reading byte number for basic I2C reading function
@param [in] I2cWritingByteNumMax Maximum I2C writing byte number for basic I2C writing function
@param [in] I2cRead Basic I2C reading function pointer
@param [in] I2cWrite Basic I2C writing function pointer
@param [in] WaitMs Basic waiting function pointer
@param [in] DemodDeviceAddr RTL2836 I2C device address
@param [in] DemodCrystalFreqHz RTL2836 crystal frequency in Hz
@param [in] DemodTsInterfaceMode RTL2836 TS interface mode
@param [in] DemodUpdateFuncRefPeriodMs RTL2836 update function reference period in millisecond
@param [in] DemodIsFunc1Enabled RTL2836 Function 1 enabling status for setting
@param [in] DemodIsFunc2Enabled RTL2836 Function 2 enabling status for setting
@param [in] TunerDeviceAddr FC2580 I2C device address
@param [in] TunerCrystalFreqHz FC2580 crystal frequency in Hz
@param [in] TunerAgcMode FC2580 AGC mode
@note
-# One should call BuildRtl2836Fc2580Module() to build RTL2836 FC2580 NIM module before using it.
*/
void
BuildRtl2836Fc2580Module(
DTMB_NIM_MODULE **ppNim, // DTMB NIM dependence
DTMB_NIM_MODULE *pDtmbNimModuleMemory,
unsigned long I2cReadingByteNumMax, // Base interface dependence
unsigned long I2cWritingByteNumMax,
BASE_FP_I2C_READ I2cRead,
BASE_FP_I2C_WRITE I2cWrite,
BASE_FP_WAIT_MS WaitMs,
unsigned char DemodDeviceAddr, // Demod dependence
unsigned long DemodCrystalFreqHz,
int DemodTsInterfaceMode,
unsigned long DemodUpdateFuncRefPeriodMs,
int DemodIsFunc1Enabled,
int DemodIsFunc2Enabled,
unsigned char TunerDeviceAddr, // Tuner dependence
unsigned long TunerCrystalFreqHz,
int TunerAgcMode
)
{
DTMB_NIM_MODULE *pNim;
// Set NIM module pointer with NIM module memory.
*ppNim = pDtmbNimModuleMemory;
// Get NIM module.
pNim = *ppNim;
// Set I2C bridge module pointer with I2C bridge module memory.
pNim->pI2cBridge = &pNim->I2cBridgeModuleMemory;
// Set NIM type.
pNim->NimType = DTMB_NIM_RTL2836_FC2580;
// Build base interface module.
BuildBaseInterface(
&pNim->pBaseInterface,
&pNim->BaseInterfaceModuleMemory,
I2cReadingByteNumMax,
I2cWritingByteNumMax,
I2cRead,
I2cWrite,
WaitMs
);
// Build RTL2836 demod module.
BuildRtl2836Module(
&pNim->pDemod,
&pNim->DtmbDemodModuleMemory,
&pNim->BaseInterfaceModuleMemory,
&pNim->I2cBridgeModuleMemory,
DemodDeviceAddr,
DemodCrystalFreqHz,
DemodTsInterfaceMode,
DemodUpdateFuncRefPeriodMs,
DemodIsFunc1Enabled,
DemodIsFunc2Enabled
);
// Build FC2580 tuner module.
BuildFc2580Module(
&pNim->pTuner,
&pNim->TunerModuleMemory,
&pNim->BaseInterfaceModuleMemory,
&pNim->I2cBridgeModuleMemory,
TunerDeviceAddr,
TunerCrystalFreqHz,
TunerAgcMode
);
// Set NIM module function pointers with default functions.
pNim->GetNimType = dtmb_nim_default_GetNimType;
pNim->GetParameters = dtmb_nim_default_GetParameters;
pNim->IsSignalPresent = dtmb_nim_default_IsSignalPresent;
pNim->IsSignalLocked = dtmb_nim_default_IsSignalLocked;
pNim->GetSignalStrength = dtmb_nim_default_GetSignalStrength;
pNim->GetSignalQuality = dtmb_nim_default_GetSignalQuality;
pNim->GetBer = dtmb_nim_default_GetBer;
pNim->GetPer = dtmb_nim_default_GetPer;
pNim->GetSnrDb = dtmb_nim_default_GetSnrDb;
pNim->GetTrOffsetPpm = dtmb_nim_default_GetTrOffsetPpm;
pNim->GetCrOffsetHz = dtmb_nim_default_GetCrOffsetHz;
pNim->GetSignalInfo = dtmb_nim_default_GetSignalInfo;
pNim->UpdateFunction = dtmb_nim_default_UpdateFunction;
// Set NIM module function pointers with particular functions.
pNim->Initialize = rtl2836_fc2580_Initialize;
pNim->SetParameters = rtl2836_fc2580_SetParameters;
return;
}