RFmxInstr_SelfCalibrateRange

RFmx WLAN 19.1 Help

Edition Date: October 2019

Part Number: 377887C-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall RFmxInstr_SelfCalibrateRange( niRFmxInstrHandle instrumentHandle, char selectorString[], int32 stepsToOmit, float64 minimumFrequency, float64 maximumFrequency, float64 minimumReferenceLevel, float64 maximumReferenceLevel );

Purpose

Self-calibrates all configurations within the specified frequency and reference level limits. If there is an open session for NI-RFSG for your device, it may remain open but cannot be used while this function runs. NI recommends that no external signals are present on the RF In port while the calibration is taking place. For more information about Self Calibrate Range, refer to the niRFSA Self Calibrate Range function topic for your device in the NI RF Vector Signal Analyzers Help.

Supported devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5840/5841

Note This function does not update self-calibration date and temperature. Self-calibration range data is not saved to your device if you restart the system.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxInstr_Initialize function.
selectorString char[] Specify an empty string as the value of this parameter.
stepsToOmit int32 Specifies which calibration steps to skip during the self-calibration process. The default value is an empty array, which indicates that all calibration steps are performed.
RFMXINSTR_VAL_SELF_CAL_STEP_PRESELECTOR_ALIGNMENT (1) Not used by this function.
RFMXINSTR_VAL_SELF_CAL_STEP_GAIN_REFERENCE (2) Not used by this function.
RFMXINSTR_VAL_SELF_CAL_STEP_IF_FLATNESS (4) Not used by this function.
RFMXINSTR_VAL_SELF_CAL_STEP_DIGITIZER_SELF_CAL (8) Not used by this function.
RFMXINSTR_VAL_SELF_CAL_STEP_LO_SELF_CAL (10) Omits the LO Self Cal step. If you omit this step and the niRFSA Is Self Cal Valid VI indicates the calibration data for this step is invalid, the LO PLL may fail to lock.
RFMXINSTR_VAL_SELF_CAL_STEP_AMPLITUDE_ACCURACY (20) Omits the Amplitude Accuracy step. If you omit this step, the absolute accuracy of the device is not adjusted.
RFMXINSTR_VAL_SELF_CAL_STEP_RESIDUAL_LO_POWER (40) Omits the Residual LO Power step. If you omit this step, the Residual LO Power performance is not adjusted.
RFMXINSTR_VAL_SELF_CAL_STEP_IMAGE_SUPPRESSION (80) Omits the Image Suppression step. If you omit this step, the Residual Sideband Image performance is not adjusted.
RFMXINSTR_VAL_SELF_CAL_STEP_SYNTHESIZER_ALIGNMENT (100) Omits the VCO Alignment step. If you omit this step, the LO PLL will not get adjusted.
RFMXINSTR_VAL_SELF_CAL_STEP_DC_OFFSET (200) Omits the DC Offset step.
minimumFrequency float64 Specifies the minimum frequency for the custom self calibration range. This value is expressed in Hz.
Note: For the PXIe-5830/5831, only the applicable ports within the specified frequency range are calibrated.
maximumFrequency float64 Specifies the maximum frequency for the custom self calibration range. This value is expressed in Hz.
minimumReferenceLevel float64 Specifies the minimum reference level for the custom self calibration range. This value is expressed in dBm.
maximumReferenceLevel float64 Specifies the maximum reference level for the custom self calibration range. This value is expressed dBm.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning. Examine the status code from each call to an RFmx 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 RFmxInstr_GetError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

WAS THIS ARTICLE HELPFUL?

Not Helpful