NI-RFSA Express (IQ)

NI RF Vector Signal Analyzers

NI-RFSA Express (IQ)

Configures and acquires data from National Instruments RF signal analyzers using NI-RFSA in IQ mode.

Dialog Box Options
Block Diagram Inputs
Block Diagram Outputs

Dialog Box Options

ParameterDescription
Configuration Contains the following options:
  • Device—Specifies the RF signal analyzer used. This ring control lists all NI RF signal analyzers installed on this computer that can be used by this Express VI. If you relaunch the VI and the selected RF signal analyzer is dimmed, it is no longer available.
  • Carrier frequency (Hz)—Specifies the carrier frequency of the acquired RF signal.
  • Reference level (dBm)—Specifies the maximum expected power of the RF signal to be acquired.
  • Attenuation—Specifies whether the attenuation is automatically determined or user-specified.
    • Attenuation (dB)—Specifies the downconverter's overall attenuation of the input RF signal.
  • IQ rate (Samples/s)—Specifies the IQ rate of the waveform.
  • Acquire—Specifies whether to acquire a finite number of samples or to acquire samples continuously until the acquisition is stopped.
  • IQ samples—For a finite acquisition, specifies the number of samples to be acquired. For a continuous acquisition, specifies the number of samples to be fetched every time the data is read.
Trigger Contains the following options:
  • Reference trigger type—Specifies the reference trigger type for the acquisition.
  • Pretrigger samples—Specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

    Of the total number of samples acquired, the number of samples configured as Pretrigger samples are acquired immediately prior to the trigger. The remaining samples are acquired immediately after the trigger.

  • Reference trigger source—Specifies the trigger source. The RF signal analyzer waits for the specified trigger to start the acquisition.
  • Edge—Specifies whether to trigger on a rising or falling edge of the trigger signal.
  • Level (dBm)—Specifies the trigger threshold for the IQ power edge trigger.
  • Minimum quiet time (s)—Configures the minimum time the signal must be above or below the trigger level before the IQ Power Edge trigger is armed. If Slope is set to Rising, the signal must be below the trigger level for the specified time. If Slope is set to Falling, the signal must be above the trigger level for the specified time. Set this control when triggering on burst signals to avoid triggering in the middle of a burst.
  • Max time (s)—Specifies how long to allow for the acquisition to complete before reporting a timeout error.
Advanced Contains the following options:
  • Reference clock source—Specifies the source of the reference clock signal. Only certain combinations of Reference clock source and PXI Chassis Clk10 source are valid.
  • PXI chassis Clk10 source—Specifies the signal driven to the 10 MHz reference clock on the PXI backplane. Only certain combinations of Reference clock source and PXI Chassis Clk10 source are valid.
  • Use relative initial time—Specifies if the timestamp value of the waveform is absolute or relative to the trigger point.
  • Digitizer sample clock source—Specifies the digitizer sample clock source. Select one of the following options:
    • Onboard clock—Uses the onboard sample clock of the digitizer.
    • External—Coerce IQ rate—Uses an external sample clock. Select this option if your external clock has fixed rates. The IQ rate is coerced based upon the rate of the external clock.
    • External—Coerce external clock—Uses an external sample clock. Select this option if your external clock has a flexible rate. The clock rate is calculated from the IQ rate and the external clock should be set accordingly.
  • External clock rate (Hz)—This parameter is defined as one of the following:
    • When Digitizer sample clock source is set to External—Coerce IQ Rate, specifies the external clock rate. The IQ rate is coerced based upon this value.
    • When Digitizer sample clock source is set to External—Coerce external clock, displays the external clock rate, which is calculated from the IQ rate. The external clock should be set to this value.
  • Output data type—Specifies the data type of the acquired waveform.
Graph viewSpecifies how the acquired waveform is displayed on the graph. Select from the following options:
  • I vs. Time
  • Q vs. Time
  • Power vs. Time
Autoscale graphSpecifies whether to autoscale the Y scale of the graph.

Checked—The Y scale of the graph is autoscaled every time the graph is updated.
Unchecked—The Y scale of the graph remains unchanged when the graph is updated.

Block Diagram Inputs

ParameterDescription
closeDetermines whether the instrument session remains open when the VI finishes execution. Use this parameter for loop optimization by setting it to FALSE on all iterations except the last. The default is TRUE.

Note: This input is not intended for sharing the session between Express VIs. If a loop contains multiple Express VIs that use the same device, you must wire in TRUE for this input.

max timeSpecifies the timeout value for the Express VI.
error inDescribes error conditions that occur before this Express VI runs.

Block Diagram Outputs

ParameterDescription
dataContains the data acquired by the device.
error outContains error information. If error in indicates that an error occurred before this Express VI runs, error out contains the same error information. Otherwise, it describes the error status that this Express VI produces.