本文转载自：Vuko-wxh的CSDN博客
前言
本文主要介绍关于RF数据转换器的ADC状态指示函数的相关使用方法。
获取ADC相关工作状态
XRFdc_GetDecimationFactor
函数原型
u32 XRFdc_GetDecimationFactor(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *DecimationFactorPtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Tile_Id：RF-ADCtile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC块编号。 有效值为 0-3。
*u32 DecimationFactorPtr：返回RF-ADC 抽取因子的指针。
说明
请求的 RF-ADC 的抽取因子返回给调用者。此 API 函数仅适用于 RF-ADC。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetDecimaionFactorObs (Gen 3)
函数原型
u32 XRFdc_GetDecimationFactorObs(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *DecimationFactorPtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Tile_Id：RF-ADCtile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC块编号。 有效值为 0-3。
*u32 DecimationFactorPtr：返回RF-ADC 抽取因子的指针。
说明
请求的 RF-ADC 的观察通道的抽取因子返回给调用者。此 API 函数仅适用于 RF-ADC。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFabWrVldWordsObs (Gen 3)
函数原型
u32 XRFdc_GetFabWrVldWordsObs(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, u32 *FabricWrVldWordsPtr);
参数
*XRFdc InstancePtr: 指向驱动实例的指针。
u32 Type：RF-ADC；0表示RF-ADC。
u32 Tile_Id:RF-ADC编号。有效值为0-3。
u32 Block_Id：RF-ADC编号。有效值为0-3。
*u32 FabricWrVldWordsPtr: 指针，用于返回观测通道的写PL数据率。观察通道的数据率。
描述
将所请求的RF-ADC的观测通道的写PL数据率返回给调用者。这个API函数只适用于RF-ADC。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFabRdVldWordsObs (Gen 3)
函数原型
u32 XRFdc_GetFabRdVldWordsObs(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, u32 *FabricRdVldWordsPtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Type：RF-ADC 或 RF-DAC； RF-ADC 为 0，RF-DAC 为 1。
u32 Tile_Id：RF-ADC/RF-DAC tile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC/RF-DAC 块编号。 有效值为 0-3。
*u32 FabricRdVldWordsPtr: 用于返回RF-ADC观察通道的读取PL数据率的指针。
说明
读取所请求的RF-ADC的观测通道的PL数据率，并返回给调用者。这个API函数只适用于RF-ADC。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetThresholdSettings
函数原型
u32 XRFdc_GetThresholdSettings(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, XRFdc_Threshold_Settings *ThresholdSettingsPtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Tile_Id：RF-ADC tile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC 块编号。 有效值为 0-3。
*XRFdc_Threshold_Settings ThresholdSettingsPtr : 指针，阈值的寄存器设置通过它被传递回来。
说明
该API函数从相应的寄存器中读取阈值设置。这个API函数只适用于RF-ADCs。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFIFOStatusObs (Gen 3)
函数原型
u32 XRFdc_GetFIFOStatusObs(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u8 *EnablePtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Type：RF-ADC：0表示RF-ADC。
u32 Tile_Id：RF-ADC的片编号。有效值为0-3。
*u8 EnablePtr : 有效值为1（FIFO enable）和0（FIFO Disable）。
说明
这个API函数获取RF-ADC观察FIFO的当前状态。这个API函数只适用于RF-ADC。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetCalibrationMode
函数原型
u32 XRFdc_GetCalibrationMode(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u8 *CalibrationModePtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Tile_Id：RF-ADC tile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC 块编号。 有效值为 0-3。
*u8 CalibrationModePtr : 用于获取校准模式的指针。
说明
这个API函数设置RF-ADC的校准模式。这个API函数只用于RF-ADCs。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetCalCoefficients
函数原型
u32 XRFdc_GetCalCoefficients(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 CalibrationBlock, XRFdc_Calibration_Coefficients *CoeffPtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Tile_Id：RF-ADC tile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC 块编号。 有效值为 0-3。
u32 CalibrationBlock：校准块，其覆盖功能将被禁用。有效值为0（仅适用于第三代设备），1-3代表OCB1、OCB2、GCB和TSCB
分别代表OCB1、OCB2、GCB和TSCB。
*XRFdc_Calibration_Coefficients CoeffPtr : 指向通用校准系数结构的指针。
说明
该API函数为所选块填充提供的系数结构体。该块是通过校准块参数选择的。OCB1仅适用于第三代设备。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetCalFreeze
函数原型
XRFDC_FAILUREu32 XRFdc_GetCalFreeze(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, XRFdc_Cal_Freeze_Settings *CalFreezePtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Tile_Id：RF-ADC tile 编号。 有效值为 0-3。
u32 Block_Id：块内的RF-ADC 块编号。 有效值为 0-3。
**XRFdc_Cal_Freeze_Settings *CalFreezePtr ** : 指向通用校准冻结设置的结构体。
说明
该API函数用校准冻结设置/状态来填充所提供的设置结构体。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetDither
函数原型
u32 XRFdc_GetDither(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *ModePtr);
参数
u32 *ModePtr : 将被填充到模式中的指针。
说明
这个API函数用抖动模式来填充所提供的指针。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFDC_GETLINKCOUPLING
函数原型
u32 XRFdc_GetLinkCoupling(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id,u32 *ModePtr)
参数
u32 *ModePtr: 指向用于获取链接耦合模式的指针。
说明
此API函数获取RF-ADC块的链路耦合模式。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetDSA (Gen 3)
函数原型
u32 XRFdc_GetDSA(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, XRFdc_DSA_Settings *SettingsPtr);
参数
XRFdc_DSA_Settings *SettingsPtr: 指向由DSA设置填充的XRFdc_DSA_Settings的指针。
说明
传递的DSA设置被用来更新相应的块级寄存器。这是一个只针对RF-ADC的API函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetSignalDetector (Gen 3)
函数原型
u32 XRFdc_GetSignalDetector(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, XRFdc_Signal_Detector_Settings *SettingsPtr);
参数
XRFdc_Signal_Detector_Settings *SettingsPtr : 指向XRFdc_Signal_Detector_Settings结构的指针，该结构被填充了信号检测器设置。
Valid Macros for SettingsPtr->Mode Argument
Valid Macros for SettingsPtr->TimeConstant Argument
说明
从寄存器中读取信号检测器的设置，并填充XRFdc_Signal_Detector_Settings结构。这是一个只针对RF-ADC的API函数。只适用于第三代设备。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetNoOfADCBlocks
函数原型
u32 XRFdc_GetNoOfADCBlocks(XRFdc *InstancePtr, u32 Tile_Id);
返回值
该函数返回该瓦片中启用的RF-ADC的数量。
XRFdc_IsADCBlockEnabled
函数原型
u32 XRFdc_IsADCBlockEnabled(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id)
返回值
如果请求的RF-ADC被启用，函数返回1；否则，返回0。
XRFdc_IsHighSpeedADC
函数原型
u32 XRFdc_IsHighSpeedADC(XRFdc *InstancePtr, int Tile)
说明
返回该瓦片是否为高速瓦片。
返回值
如果是高速，则为1，否则为0。
XRFdc_IsADCDigitalPathEnabled
函数原型
u32 XRFdc_IsADCDigitalPathEnabled(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id)
说明
该API检查ADC数字路径是否被启用或禁用。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
