rfsa c api reference

niRFSA_CalAdjustIFAttenuationCalibration

  • Updated2024-05-08
  • 1 minute(s) read

niRFSA_CalAdjustIFAttenuationCalibration

ViStatus niRFSA_CalAdjustIFAttenuationCalibration(ViSession vi, ViConstString channelName, ViInt32 IFFilter, ViInt32 numberOfAttenuators, ViReal64* attenuatorSettings, ViReal64 measurement);

Purpose

Specifies the IF attenuation settings.

Supported Devices: PXIe-5601, PXIe-5694

Parameters

Input
Name Type Description
vi ViSession Identifies your instrument session. vi is obtained from the niRFSA_InitExtCal function and identifies a particular instrument session.
channelList ViConstString Identifies which channels to apply settings. Specify an empty string as the value of this parameter.
IFFilter ViInt32 Specifies the IF filter used by the downconverter.

NIRFSA_VAL_187_5_MHZ_WIDE (1400) Uses the 187.5 MHz wide bandwidth filter.
NIRFSA_VAL_187_5_MHZ_NARROW (1401) Uses the 187.5 MHz narrow bandwidth filter.
NIRFSA_VAL_53_MHZ (1402) Uses the 53 MHz filter.
NIRFSA_VAL_BYPASS (1403) Bypasses the IF filter.
numberOfAttenuators ViInt32 Specifies the number of attenuators to use during the IF attenuation adjustment.
attenuatorSettings ViReal64* Specifies the IF attenuator settings for the measurement. The first element in the array corresponds with IF1, the next element corresponds to IF2, and so on.
measurement ViReal64 Specifies the relevant measurement taken for the current configuration.

Return Value

Name Type Description
status ViStatus Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an NI-RFSA function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the niRFSA_GetError function. To clear the error information from NI-RFSA, call the niRFSA_ClearError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

Log in to get a better experience