RFSoC应用笔记 - RF数据转换器（18）：API使用指南之DAC状态指示函数

本文转载自：Vuko-wxh的CSDN博客

前言

本文主要介绍关于RF数据转换器的DAC状态指示函数的相关使用方法。

获取DAC相关工作状态

XRFdc_GetInterpolationFactor

函数原型

u32 XRFdc_GetInterpolationFactor(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *InterpolationFactorPtr);

参数

• *XRFdc InstancePtr：指向驱动程序实例的指针。

• u32 Tile_Id：RF-DAC tile 编号。 有效值为 0-3。

• u32 Block_Id：块内的RF-DAC 块编号。 有效值为 0-3。

• u32 * InterpolationFactorPtr : 返回RF-DAC内插因子的指针。

描述

请求的 RF-DAC 的插值因子返回给调用者。此 API 函数仅适用于 RF-DAC。

返回值

XRFDC_SUCCESS

XRFDC_FAILURE

XRFdc_GetDecoderMode

函数原型

u32 XRFdc_GetDecoderMode(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *DecoderModePtr);

参数

• *XRFdc InstancePtr：指向驱动程序实例的指针。

• u32 Tile_Id：RF-DAC tile 编号。 有效值为 0-3。

• u32 Block_Id：块内的RF-DAC 块编号。 有效值为 0-3。

• u32 * DecoderModePtr: 将解码器模式设置返回给调用者的指针。有效值是：

• Maximum linearity：最大线性度，用于随机解码器

• Maximum SNR：最大信噪比，用于非随机解码器

说明

该API函数从相关寄存器中读取解码器模式。这个API函数只用于RF-DACs。

返回值
XRFDC_SUCCESS
XRFDC_FAILURE

XRFdc_GetOutputCurr

函数原型

u32 XRFdc_GetOutputCurr(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *OutputCurrPtr);

参数

• u32 * OutputCurrPtr: OutputCurr 指针，用于返回输出电流。

说明

该API函数获取输出电流。这个API函数只用于RF-DACs。第三代设备的电流以μA为单位返回。

返回值

XRFDC_SUCCESS

XRFDC_FAILURE

XRFdc_GetInvSincFIR

函数原型

u32 XRFdc_GetInvSincFIR(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u16 *ModePtr);

参数

• XRFdc * InstancePtr：指向驱动程序实例的指针。

• u32 Tile_Id：RF-DAC tile 编号。 有效值为 0-3。

• u32 Block_Id：块内的RF-DAC 块编号。 有效值为 0-3。

• u16 * ModePtr: 启用指针是用来获取状态的。有效值是0（禁用），1（第一奈奎斯特区），仅对于第三代设备，2（第二奈奎斯特区）。

说明

该API函数用于获取InvSinc滤波器的状态。该API函数仅用于RF-DAC，模式2仅适用于第三代设备。

返回值

XRFDC_SUCCESS

XRFDC_FAILURE

XRFdc_GetDACDataScaler

函数原型

u32 XRFdc_SetDACDataScaler(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *EnablePtr);

参数

• u32 * EnablePtr: 将被填充到启用状态的指针。

说明

这个API函数用数据缩放器的启用状态来填充所提供的指针。

返回值

XRFDC_SUCCESS
XRFDC_FAILURE

XRFdc_GetDACCompMode (Gen 3)

函数原型

u32 XRFdc_GetDACCompMode(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *Enable);

参数

• u32 * Enable : 指向返回传统的DAC输出模式。有效值为0（第三代 行为），1（第二代行为）。

说明

从寄存器中读取行为，指针被填充。这是一个只针对RF-DAC的API函数。只适用于第三代设备。

返回值

XRFDC_SUCCESS

XRFDC_FAILURE

XRFdc_GetDataPathMode (Gen 3)

函数原型

u32 XRFdc_GetDataPathMode(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *Mode);

参数

• u32 * Mode: 指针用于返回数据路径模式。有效值为0-3。

• 
  

说明

从寄存器中读取模式并填充指针。这是一个只针对RF-DAC的API函数。只适用于第三代设备。

返回值

XRFDC_SUCCESS
XRFDC_FAILURE

XRFdc_GetIMRPassMode (Gen 3)

函数原型

u32 XRFdc_GetIMRPassMode(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id, u32 *Mode);

参数

• *u32 Mode: 指针用于返回IMR滤波器模式。有效值为0（低通）1（高通）。

• 
  

  说明

  该模式用于更新相应的块级寄存器。这是一个仅适用于RF-DAC的API功能。只适用于第三代设备。

  返回值

  XRFDC_SUCCESS
  XRFDC_FAILURE

  XRFdc_GetNoOfDACBlock

• 函数原型

• u32 XRFdc_GetNoOfDACBlock(XRFdc *InstancePtr, u32 Tile_Id);

• 返回值

  该函数返回瓦片中启用的RF-DAC的数量。

  XRFdc_IsDACBlockEnabled

• 函数原型

• u32 XRFdc_IsDACBlockEnabled(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id);

• 返回值
  如果请求的RF-DAC被启用，该函数返回1；否则，返回0。

  XRFdc_GetInverseSincFilter

• 函数原型

• u32 XRFdc_GetInverseSincFilter(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id);

• 返回值

• 如果RF-DAC的反向sinc滤波器被启用，函数返回1；否则，返回0。

• XRFdc_GetMixedMode

• 函数原型

• u32 XRFdc_GetMixedMode(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id)

• 返回值

• 该函数返回RF-DAC的混频模式设置。

• XRFdc_IsDACDigitalPathEnabled

• 函数原型

• u32 XRFdc_IsDACDigitalPathEnabled(XRFdc *InstancePtr, u32 Tile_Id, u32 Block_Id)

• 说明

• 此API检查RF-DAC数字路径是否启用。

• 返回值

• XRFDC_SUCCESS
  XRFDC_FAILURE