/** @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 RTL2832 MxL5007T NIM module builder Use BuildRtl2832Mxl5007tModule() to build RTL2832 MxL5007T NIM module, set all module function pointers with the corresponding functions, and initialize module private variables. @param [in] ppNim Pointer to RTL2832 MxL5007T NIM module pointer @param [in] pDvbtNimModuleMemory Pointer to an allocated DVB-T 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] pRtl2832ExtraModuleMemory Pointer to an allocated RTL2832 extra module memory @param [in] DemodDeviceAddr RTL2832 I2C device address @param [in] DemodCrystalFreqHz RTL2832 crystal frequency in Hz @param [in] DemodAppMode RTL2832 application mode for setting @param [in] DemodTsInterfaceMode RTL2832 TS interface mode for setting @param [in] DemodUpdateFuncRefPeriodMs RTL2832 update function reference period in millisecond for setting @param [in] DemodIsFunc1Enabled RTL2832 Function 1 enabling status for setting @param [in] pMxl5007tExtraModuleMemory Pointer to an allocated Mxl5007T extra module memory @param [in] TunerDeviceAddr Mxl5007T I2C device address @param [in] TunerAgcMode Mxl5007T AGC mode @note -# One should call BuildRtl2832Mxl5007tModule() to build RTL2832 MxL5007T NIM module before using it. */ void BuildRtl2832Mxl5007tModule( DVBT_NIM_MODULE **ppNim, // DVB-T NIM dependence DVBT_NIM_MODULE *pDvbtNimModuleMemory, unsigned char I2cReadingByteNumMax, // Base interface dependence unsigned char I2cWritingByteNumMax, BASE_FP_I2C_READ I2cRead, BASE_FP_I2C_WRITE I2cWrite, BASE_FP_WAIT_MS WaitMs, RTL2832_EXTRA_MODULE *pRtl2832ExtraModuleMemory, // Demod dependence unsigned char DemodDeviceAddr, unsigned long DemodCrystalFreqHz, int DemodAppMode, int DemodTsInterfaceMode, unsigned long DemodUpdateFuncRefPeriodMs, int DemodIsFunc1Enabled, MXL5007T_EXTRA_MODULE *pMxl5007tExtraModuleMemory, // Tuner dependence unsigned char TunerDeviceAddr, unsigned long TunerCrystalFreqHz, int TunerClkOutMode, int TunerClkOutAmpMode ) { DVBT_NIM_MODULE *pNim; // Set NIM module pointer with NIM module memory. *ppNim = pDvbtNimModuleMemory; // Get NIM module. pNim = *ppNim; // Set I2C bridge module pointer with I2C bridge module memory. pNim->pI2cBridge = &pNim->I2cBridgeModuleMemory; // Set NIM extra module pointer. pNim->pExtra = INVALID_POINTER_VALUE; // Set NIM type. pNim->NimType = DVBT_NIM_RTL2832_MXL5007T; // Build base interface module. BuildBaseInterface( &pNim->pBaseInterface, &pNim->BaseInterfaceModuleMemory, I2cReadingByteNumMax, I2cWritingByteNumMax, I2cRead, I2cWrite, WaitMs ); // Build RTL2832 demod module. BuildRtl2832Module( &pNim->pDemod, &pNim->DvbtDemodModuleMemory, pRtl2832ExtraModuleMemory, &pNim->BaseInterfaceModuleMemory, &pNim->I2cBridgeModuleMemory, DemodDeviceAddr, DemodCrystalFreqHz, DemodAppMode, DemodUpdateFuncRefPeriodMs, DemodIsFunc1Enabled ); // Build Mxl5007T tuner module. BuildMxl5007tModule( &pNim->pTuner, &pNim->TunerModuleMemory, pMxl5007tExtraModuleMemory, &pNim->BaseInterfaceModuleMemory, &pNim->I2cBridgeModuleMemory, TunerDeviceAddr, TunerCrystalFreqHz, RTL2832_MXL5007T_STANDARD_MODE_DEFAULT, RTL2832_MXL5007T_IF_FREQ_HZ_DEFAULT, RTL2832_MXL5007T_SPECTRUM_MODE_DEFAULT, TunerClkOutMode, TunerClkOutAmpMode, RTL2832_MXL5007T_QAM_IF_DIFF_OUT_LEVEL_DEFAULT ); // Set NIM module variables. pNim->DemodTsInterfaceMode = DemodTsInterfaceMode; // Set NIM module function pointers with default functions. pNim->GetNimType = dvbt_nim_default_GetNimType; pNim->GetParameters = dvbt_nim_default_GetParameters; pNim->IsSignalPresent = dvbt_nim_default_IsSignalPresent; pNim->IsSignalLocked = dvbt_nim_default_IsSignalLocked; pNim->GetSignalStrength = dvbt_nim_default_GetSignalStrength; pNim->GetSignalQuality = dvbt_nim_default_GetSignalQuality; pNim->GetBer = dvbt_nim_default_GetBer; pNim->GetSnrDb = dvbt_nim_default_GetSnrDb; pNim->GetTrOffsetPpm = dvbt_nim_default_GetTrOffsetPpm; pNim->GetCrOffsetHz = dvbt_nim_default_GetCrOffsetHz; pNim->GetTpsInfo = dvbt_nim_default_GetTpsInfo; pNim->UpdateFunction = dvbt_nim_default_UpdateFunction; // Set NIM module function pointers with particular functions. pNim->Initialize = rtl2832_mxl5007t_Initialize; pNim->SetParameters = rtl2832_mxl5007t_SetParameters; return; }