本文转载自：Vuko-wxh的CSDN博客
前言
本文主要介绍关于RF数据转换器的ADC和DAC均适用的状态指示函数的相关使用方法。
获取RFDC工作状态（ADC、DAC均适用）
XRFdc_GetIPStatus
函数原型
u32 XRFdc_GetIPStatus(XRFdc *InstancePtr, XRFdc_IPStatus *IPStatusPtr);
参数
*XRFdc InstancePtr: 指向驱动程序实例的指针。
*XRFdc_IPStatus IPStatusPtr : 指向 XRFdc_IPStatus 结构的指针，标识该结构返回状态。
描述
此 API 函数返回 IP 状态。
返回值
XRFDC_SUCCESS
XRFdc_GetBlockStatus
函数原型
u32 XRFdc_GetBlockStatus(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, XRFdc_BlockStatus *BlockStatusPtr);
参数
*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。
*XRFdc_BlockStatus BlockStatusPtr：指向 XRFdc_BlockStatus 结构的指针，标识该结构返回 RF-ADC/RF-DAC 块状态。
描述
该 API 函数返回请求的块状态。这是 RF-ADC/RF-DAC 的常用 API 函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE（转换器未启用）
XRFdc_GetMixerSettings
函数原型
u32 XRFdc_GetMixerSettings(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, XRFdc_Mixer_Settings *MixerSettingsPtr);
参数
*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。
*XRFdc_Mixer_Settings MixerSettingsPtr : 指向传递混频器/NCO 设置的 XRFdc_Mixer_Settings 结构的指针。
描述
来自相应寄存器的混频器/NCO 设置返回给调用者。这是 RF-ADC/RF-DAC 的常用 API 函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetQMCSettings
函数原型
u32 XRFdc_GetQMCSettings(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, XRFdc_QMC_Settings *QMCSettingsPtr);
参数
*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。
*XRFdc_QMC_Settings QMCSettingsPtr：指向返回相应寄存器值的 XRFdc_QMC_Settings 结构的指针。
描述
来自相关寄存器的 QMC 设置返回给调用者。这是 RF-ADC/RF-DAC 的常用 API 函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetCoarseDelaySettings
函数原型
u32 XRFdc_GetCoarseDelaySettings(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, XRFdc_CoarseDelay_Settings *CoarseDelaySettingsPtr);
参数
*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。
*XRFdc_CoarseDelay_Settings CoarseDelaySettingsPtr：指向返回相应寄存器值的XRFdc_CoarseDelay_Settings 结构的指针。
描述
来自相关寄存器的粗略延迟设置返回给调用者。这是 RF-ADC/RF-DAC 的常用 API 函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFabClkOutDiv
函数原型
u32 XRFdc_GetFabClkOutDiv(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u16 *FabClkDivPtr);
参数
*XRFdc InstancePtr：指向驱动程序实例的指针。
u32 Type：RF-ADC 或 RF-DAC； RF-ADC 为 0，RF-DAC 为 1。
u32 Tile_Id：RF-ADC/RF-DAC tile 编号。 有效值为 0-3。
*u16 FabClkDivPtr：获取块的PL 时钟分频器的指针。
说明
使用该函数获取 PL 的时钟分频器。这是 RF-ADC 和 RF-DAC 的通用功能。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFabWrVldWords
函数原型
u32 XRFdc_GetFabWrVldWords(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, u32 *FabricWrVldWordsPtr);
参数
*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 FabricWrVldWordsPtr: 用于返回RF-ADC/RFDACs的写PL数据率的指针。
说明
将请求的RF-ADC/RF-DAC的PL数据率写回给调用者。这是RF-ADC和RF-DAC的一个通用API函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFabRdVldWords
函数原型
u32 XRFdc_GetFabRdVldWords(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/RF-DAC的读取PL数据率。
说明
读取请求的RF-ADC/RF-DAC的PL数据率，并返回给调用者。这是RF-ADC和RF-DAC的一个通用API函数。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetFIFOStatus
函数原型
u32 XRFdc_GetFIFOStatus(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u8 *EnablePtr);
参数
*u8 EnablePtr : 有效值为1（FIFO启用）和0（FIFO禁用）。
说明
这个API函数获取RF-ADC/RF-DAC FIFO的当前状态。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetNyquistZone
函数原型
u32 XRFdc_GetNyquistZone(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, u32 *NyquistZonePtr);
参数
*u32 NyquistZonePtr: 指向返回奈奎斯特区的指针。
说明
这个API函数获取RF-ADCs/RF-DACs的奈奎斯特区。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetClockSource
函数原型
u32 XRFdc_GetClockSource(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 *ClockSourcePtr);
参数
*u32 ClockSourcePtr: 用于返回时钟源的指针。
说明
这个API函数获取RF-ADC/RF-DAC的时钟源。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetPLLConfig
函数原型
u32 XRFdc_GetPLLConfig(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, XRFdc_PLL_Settings *PLLSettings);
参数
*XRFdc_PLL_Settings PLLSettings：指向XRFdc_PLL_Settings的指针，用于填充PLL设置。
说明
这个API函数从寄存器中读取PLL设置，并将其填充到XRFdc_PLL_Settings结构体。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetPLLLockStatus
函数原型
u32 XRFdc_GetPLLLockStatus(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 *LockStatusPtr)；
参数
*u32 LockStatusPtr : 用于返回PLL锁定状态的指针。
说明
这个API函数获取RF-ADCs/RF-DACs的PLL锁定状态。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetClkDistribution (Gen 3)
函数原型
u32 XRFdc_GetClkDistribution(XRFdc *InstancePtr, XRFdc_Distribution_System_Settings *DistributionArrayPtr)；
参数
*XRFdc InstancePtr: 指向驱动实例的指针。
*XRFdc_Distribution_System_Settings DistributionArrayPtr: 指向XRFdc_Distribution_System_Settings结构的指针，用于填充分布设置。
说明
这个API函数读取寄存器，并将其填充到XRFdc_Distribution_System_Settings结构。只适用于第三代设备。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetPwrMode (Gen 3)
函数原型
u32 XRFdc_GetPwrMode(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id, XRFdc_Pwr_Mode_Settings *SettingsPtr);
参数
*XRFdc_Pwr_Mode_Settings SettingsPtr: 一个指针，用于填充当前的电源模式设置。
说明
该API函数获取给定RF-ADC/RF-DAC块的电源模式。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_Get_TileBaseAddr
函数原型
u32 XRFdc_Get_TileBaseAddr(XRFdc *InstancePtr, u32 Type, u32 Tile_Id);
返回值
请求的片的基地址。
XRFdc_Get_BlockBaseAddr
函数原型
u32 XRFdc_Get_BlockBaseAddr(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id）
返回值
请求的转换器的基地址。
XRFdc_GetDataType
函数原型
u32 XRFdc_GetDataType(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id）
返回值
如果数据类型为实数，函数返回0；否则，返回1。
XRFdc_GetDataWidth
函数原型
u32 XRFdc_GetDataWidth(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id);
返回值
该函数返回RF-ADC的编程数据宽度。
XRFdc_GetMasterTile
函数原型
u32 XRFdc_GetMasterTile(XRFdc *InstancePtr, u32 Type)
返回值
该函数返回主瓦片ID。
XRFdc_GetSysRefSource
函数原型
u32 XRFdc_GetSysRefSource(XRFdc *InstancePtr, u32 Type)
返回值
该函数返回 SYSREF 的来源（内部或外部）。
XRFdc_Get_IPBaseAddr
函数原型
u32 XRFdc_Get_IPBaseAddr(XRFdc *InstancePtr)
返回值
IP的基地址。
XRFdc_GetFabClFreq
函数原型
double XRFdc_GetFabClkFreq(XRFdc *InstancePtr, u32 Type, u32 Tile_Id)
返回值
该函数返回已编程的PL时钟频率。
XRFdc_IsFifoEnabled
函数原型
u32 XRFdc_IsFifoEnabled（XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id)
返回值
如果FIFO被启用，该函数返回1；否则，返回0。
XRFdc_GetDriverVersion
函数原型
double XRFdc_GetDriverVersion()
说明
获取驱动程序的版本。
返回值
驱动程序的版本号。
XRFdc_GetConnectedIData
函数原型
int XRFdc_GetConnectedIData(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id);
描述
获取I数字数据路径的转换器。
返回值
转换器编号。
XRFdc_GetConnectedQData
函数原型
int XRFdc_GetConnectedQData(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id)
说明
获取Q数字数据路径连接的转换器。
返回值
转换器编号。
XRFdc_RDReg
函数原型
u16 XRFdc_RDReg(XRFdc *InstancePtr, u32 BaseAddr, u32 RegAddr, u16 Mask)
参数
u32 BaseAddr: 一个块的基地址。
u32 RegAddr: 寄存器的偏移值。
u16 Mask: 位掩码值。
说明
该API对值进行读取和屏蔽。
XRFdc_CheckDigitalPathEnabled
函数原型
u32 XRFdc_CheckDigitalPathEnabled(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id)
说明
该API检查RF-ADC/RF-DAC数字路径是否被激活。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetMultibandConfig
函数原型
u32 XRFdc_GetMultibandConfig(XRFdc *InstancePtr, u32 Type, u32 Tile_Id)
说明
该API用于获取多频段配置数据。
返回值
该API返回多频段配置。
XRFdc_CheckBlockEnabled
函数原型
u32 XRFdc_CheckBlockEnabled(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, u32 Block_Id)
说明
该API检查RF-ADC/RF-DAC块是否被激活或禁用。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_CheckTileEnabled
函数原型
u32 XRFdc_CheckTileEnabled(XRFdc *InstancePtr, u32 Type, u32 Tile_Id)
说明
此API检查RF-ADC/RF-DAC瓦片是否被启用或禁用。
XRFdc_GetMaxSampleRate
函数原型
u32 XRFdc_GetMaxSampleRate(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, double *MaxSampleRatePtr)
参数
*double MaxSampleRatePtr: 指针将被填充到瓦片的最大采样率中。
说明
这个API用来获取瓦片的最大采样率。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
XRFdc_GetMinSampleRate
函数原型
u32 XRFdc_GetMinSampleRate(XRFdc *InstancePtr, u32 Type, u32 Tile_Id, double *MinSampleRatePtr)
参数
*double MinSampleRatePtr: 指针将被填充到瓦片的最小采样率中。
说明
该API用于获取瓦片的最小采样率。
返回值
XRFDC_SUCCESS
XRFDC_FAILURE
