Utility

NI-RFSG LabVIEW

Utility

Owning Palette: NI-RFSG Main Palette

Use the Utility VIs to access additional features of the NI-RFSG instrument driver.

Palette Object Description
niRFSG Initialize With Options

Initializes the NI-RFSG device (the upconverter module and the AWG module). This VI has the capability of receiving the AWG resource name through option string. This VI performs the following initialization actions:

- Creates a new IVI instrument driver session.

- Opens a session to the device you specify in the resource name parameter.

- If the reset device parameter is set to TRUE, this VI resets the device to a known state.

- Returns a value for the instrument handle parameter that you use to identify the instrument in all subsequent NI-RFSG VIs.

Supported Devices: NI 5650/5651/5652/5670/5671/5672

niRFSG Commit

Asserts the configured hardware parameters. Calling this VI moves the NI-RFSG device out of the Configuration state and into the Committed state. After calling this VI, changing any property reverts the NI-RFSG device to the Configuration state.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

niRFSG Wait Until Settled

Waits until the RF output signal settles. This VI is useful for devices that support on-the-fly (dynamic) configuration changes (changes while in the Generation state). Call this VI after making a dynamic change to wait for the output signal to settle. You can also call this VI after calling the niRFSG Commit VI to wait for changes to settle. This VI is not needed after calling the niRFSG Initiate VI because the niRFSG Initiate VI does not return until the output is settled.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

niRFSG Configure Output Enabled

Enables or disables signal output. You can call this VI in any software state, and it does not change the current state. Setting the output enabled parameter to FALSE while in the Generation state stops signal generation although generation continues internally.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

niRFSG Reset

Resets all properties to their default values and moves the NI-RFSG device to the Configuration state. This VI aborts the signal generation, clears all routes, and resets session properties to the initial values. During a reset, routes of signals between this and other devices are released, regardless of which device created the route.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

niRFSG Reset Device

Performs a hard reset on the device, which consists of the following actions:

- Signal generation is stopped.

- All routes are released.

- External bidirectional terminals are tristated.

- FPGAs are reset.

- Hardware is configured to its default state.

- All session properties are reset to their default states.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

niRFSG Self Test

Performs a self-test on the NI-RFSG device and returns the test results. This VI performs a simple series of tests to determine whether the NI-RFSG device is powered up and responding. This VI does not affect external I/O connections or connections between devices. Complete functional testing and calibration are not performed by this VI. The NI-RFSG device must be in the Configuration state before you call this VI.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

niRFSG Self Cal

Performs an internal (self-) calibration on the device. If the calibration is successful, new calibration data and constants are stored in the onboard nonvolatile memory of the module.

Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672

rfsg_Resample and Write

Resamples the complex waveform to the new IQ rate and writes it to the NI-RFSG device. This VI preserves the phase continuity of a phase-continuous complex waveform while resampling.

Supported Devices: NI 5670/5671/5672

niRFSG Error Message

Converts a error code returned by an NI-RFSG VI into a user-readable string.

Supported Devices: NI 5650/5651/5652/5670/5671/5672

niRFSG Revision Query

Returns the revision numbers of the NI-RFSG driver and the instrument firmware.

Supported Devices: NI 5650/5651/5652/5670/5671/5672

niRFSG Query Arb Waveform Capabilities

Queries and returns the arbitrary waveform capabilities of the NI-RFSG device. These capabilities are related to the current device configuration. The NI-RFSG device must be in the Configuration or Generation state before you call this VI.

Supported Devices: NI 5670/5671/5672

niRFSG Perform Thermal Correction

Corrects for any signal drift due to temperature variation when generating the same signal for extended periods of time without a parameter change. This VI compensates automatically for variations in device temperature when any signal generation parameters are changed. Under normal circumstances of short-term signal generation, NI-RFSG automatic compensation ensures stable power levels, and you do not need to use this VI. Use this VI when generating the same signal for a long period of time in a temperature-fluctuating environment. The NI-RFSG device must be in the Generation state before you call this VI.

Supported Devices: NI 5650/5651/5652/5670/5671/5672