niRFSA Initialize With Options VI

NI RF Vector Signal Analyzers (NI-RFSA 18.1) Help

Edition Date: June 2018

Part Number: 372058U-01

View Product Info

Download Help (Windows Only)

NI-RFSA 18.1 Help
NI-RFSA 18.2.1 Help
NI-RFSA 19.1 Help

Creates a new session for the device. This VI sets the initial value of certain properties for the session and sends initialization commands to reset all hardware modules to a known state necessary for NI-RFSA operation.

To create a new session, wire the downconverter resource name for the RF vector signal analyzer to the resource name input.

You can access the device session this VI creates using the NI-RFSA Soft Front Panel (SFP). Accessing the device session with the SFP can help you debug your code. Refer to Debugging Your Application Using SFP Session Access for more information about accessing your session with the SFP.

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5694/5698, PXIe-5820/5840

Related Topics

Driver Setup Options


niRFSA Initialize With Options


resource name specifies the resource name of the device to initialize.

For NI-RFSA devices, the syntax is the device name specified in MAX. The typical default name for your device in MAX is PXI1Slot2. You can rename your devices by right-clicking the name in MAX, selecting Rename from the drop-down menu, and entering a new name. You can also pass in the name of an IVI logical name configured with the IVI Configuration utility. For additional information, refer to the Installed Products»IVI topic of the Measurement & Automation Explorer Help.

Note   Device names are not case-sensitive. However, IVI logical names are case-sensitive. If you use an IVI logical name, verify the name is identical to the name shown in the IVI Configuration Utility.

option string sets the initial value of certain properties for the session.

The format of this string is "PropertyName=Value", where PropertyName is the name of the property and Value is the value to which the property is set. To set multiple properties, separate their assignments with a comma.

The following table lists the properties you can use with this parameter and their valid values.

Property Use Valid Values Example
Range Check Specify whether to validate property values and VI parameters. 0 (false), 1 (true) "RangeCheck=1"
Query Instrument Status Query the device status after each operation. 0 (false), 1 (true) "QueryInstrumentStatus=1"
Cache Cache the value of properties. 0 (false), 1 (true) "Cache=1"
Driver Setup Specify an FPGA bitfile, enable soft front panel (SFP) session access, or specify a device. Refer to Driver Setup Options for more information about using the driver setup string, including valid values. "DriverSetup=SFPSessionAccess:1;LO:my5652"
Simulate Simulate I/O operations using NI-RFSA. 0 (false), 1 (true) "Simulate=1"
Note  To simulate a device using the PXIe-5622 25 MHz digitizer, set the Digitizer field to 5622_25MHz_DDC and the Simulate field to 1. You can set the Digitizer field to 5622_25MHz_DDC only when using the PXIe-5665.

id query specifies whether NI-RFSA performs an ID query. When you perform an ID query, NI-RFSA verifies the device you initialize is supported. The default value is TRUE.

TRUE Perform an ID query.
FALSE Do not perform an ID query.

reset specifies whether the NI-RFSA device is reset during the initialization procedure. The default value is FALSE.

TRUE The device is reset.
FALSE The device is not reset.

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.


instrument handle identifies your instrument session.


error out contains error information. This output provides standard error out functionality.


Refer to the following VIs for examples of using the niRFSA Initialize With Options VI.

  • RFSA Downconverter with External Digitizer VI: labview\examples\instr\niRFSA

  • RFSA In-band Retuning with External LO VI: labview\examples\instr\niRFSA


    Not Helpful