RFSoC应用笔记 - RF数据转换器 -17- API使用指南之ADC状态指示函数
前言
本文主要介绍关于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
Macro | Description |
---|---|
XRFDC_SIGDET_MODE_AVG | Average mode of operation |
XRFDC_SIGDET_MODE_RNDM | Randomized mode of operation |
Valid Macros for SettingsPtr->TimeConstant Argument
Macro | Description |
---|---|
XRFDC_SIGDET_TC_2_0 | 2^0 Cycles |
XRFDC_SIGDET_TC_2_2 | 2^2 Cycles |
XRFDC_SIGDET_TC_2_4 | 2^4 Cycles |
XRFDC_SIGDET_TC_2_8 | 2^8 Cycles |
XRFDC_SIGDET_TC_2_12 | 2^12 Cycles |
XRFDC_SIGDET_TC_2_14 | 2^14 Cycles |
XRFDC_SIGDET_TC_2_16 | 2^16 Cycles |
XRFDC_SIGDET_TC_2_18 | 2^18 Cycles |
说明
从寄存器中读取信号检测器的设置,并填充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
相关文章
- 学习笔记 | 独立成分分析(ICA, FastICA)及应用
- http.sys的简单应用
- 基于AspectJ的AOP应用 | Spring学习笔记2.2
- 【Flutter桌面篇】Flutter&Windows应用尝鲜
- Redis学习笔记:Redis实践与应用
- 盘点各家云笔记应用
- 一款基于 GitHub 的 Web 笔记应用
- 【Android 应用开发】Android 网络编程 API笔记 - java.net 包 权限 地址 套接字 相关类 简介
- TRICONEX 3700A 提供智能和安全容器应用
- Java学习笔记 static关键字作用和应用
- Oracle中的小于号:应用与操作(oracle小于号)
- Oracle触发器的类型及其应用(oracle触发器类型)
- 微软加速统一OneNote笔记应用:逐步淘汰OneNote for Windows 10应用
- 越来越好的笔记应用,记录、查阅一切有价值的信息,同样跨平台支
- 越来越好的笔记应用,记录、查阅一切有价值的信息,同样跨平台支
- 的应用检查MySQL中CHECK的应用(check在mysql里)
- 滑动窗口算法在Redis中的应用(滑动窗口算法 redis)
- Oracle全面支持Java链技术构建数据库应用(java链oracle)
- MySQL快速上手,实现简单应用(mysql一个简单应用)
- Oracle 中 Mutation 操作的应用(oracle 中莫的用法)
- 根据Redis应用,搭建最佳服务器配置(redis需要多少机器)
- 函数平均数函数AVG在Oracle中的应用(oracle 中 avg)
- 重磅!央行发布声纹识别应用标准,适用手机银行、第三方支付
- php笔记之:AOP的应用
- MySQL笔记之字符串函数的应用