Self-calibrates the NI-RFSA device and associated modules that support self-calibration. If self-calibration completes successfully, the new calibration constants are stored immediately in the nonvolatile memory of the module. On a MIMO session, this function self-calibrates all NI-RFSA devices and associated modules that support self-calibration.

Syntax

int32 __stdcall RFmxInstr_SelfCalibrate(niRFmxInstrHandle instrumentHandle, char selectorString[], int32 stepsToOmit)

Remarks

Refer to the specifications document for your device for more information about how often to self-calibrate. For more information about Self Calibrate, refer to the niRFSA Self Cal VI topic for your device in the NI RF Vector Signal Analyzers Help.

Note

For PXIe-5644/5645/5646, RFmx internally closes the RFSA session, performs self-calibration and opens a new session for the same device. If the RFSA session has been accessed from RFmx, using the RFmxInstr_GetNIRFSASession function before calling the RFmxInstr Self Calibrate function, the RFSA session will become invalid upon calling the RFmxInstr Self Calibrate.

Supported devices: PXIe-5663/5663E/5665/5668, PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840/5841/5842/5860

Parameters

NameDirectionTypeDescription
instrumentHandle[in]niRFmxInstrHandle

This parameter identifies the instrument session. This parameter is obtained from the RFmxInstr_Initialize function or the RFmxInstr_InitializeFromNIRFSASessionArray function.

selectorString[in]char[]

Specifies a selector string. Pass an empty string.

stepsToOmit[in]int32

This parameter 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. The only valid value for PXIe-5820/5830/5831/5832/5840/5841/5842/5860 is an empty array.

Name (Value)

Description

Preselector Alignment (1)

Omits the Preselector Alignment step. If you omit this step and the niRFSA Is Self Cal Valid function indicates the calibration data for this step is invalid, the preselector alignment specifications are not guaranteed. This step applies only to the PXIe-5605/5606.

Gain Reference (2)

Omits the Gain Reference step. If you omit this step and the niRFSA Is Self Cal Valid function indicates the calibration data for this step is invalid, the absolute accuracy of the device is not guaranteed.

IF Flatness (4)

Omits the IF Flatness step. If you omit this step and the niRFSA Is Self Cal, valid function indicates the calibration data for this step is invalid, the IF flatness specifications are not guaranteed.

Digitizer Self Cal (8)

Omits the Digitizer Self Cal step. If you omit this step and the niRFSA Is Self Cal Valid function indicates the calibration data for this step is invalid, the absolute accuracy of the device is not guaranteed.

LO Self Cal (10)

Omits the LO Self Cal step. If you omit this step and the niRFSA Is Self Cal Valid function indicates the calibration data for this step is invalid, the LO PLL may fail to lock.

Amplitude Accuracy (20)

Not used by this function.

Residual LO Power (40)

Not used by this function.

Image Suppression (80)

Not used by this function.

Synthesizer Alignment (100)

Not used by this function.

DC Offset (200)

Not used by this function.

Returns

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 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