Initialize With Options

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

Inputs/Outputs

datatype_icon

resource name

Resource name of the device to initialize.

Device Name Syntax

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.

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.

Creating a New Session for a Vector Signal Analyzer

To create a new session for your vector signal analyzer, you must wire the downconverter resource name to this input.

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Default value: No error

datatype_icon

id query

Boolean value that indicates whether NI-RFSA performs an ID query.

When you perform an ID query, NI-RFSA verifies the device you initialize is supported.

True NI-RFSA performs an ID query.
False NI-RFSA does not perform an ID query.

Default value: True

datatype_icon

reset

Boolean value that specifies whether the NI-RFSA device is reset during the initialization procedure.

True The device is reset.
False The device is not reset.

Default value: False

datatype_icon

option string

Initial value of certain properties for the session.

You can set the following properties using this input:

  • Range Check
  • Query Instrument Status
  • Cache
  • Driver Setup
  • Simulate

Option String Syntax

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.

Property Use Valid Values Example String Syntax
Range Check Specify whether to validate property values and node 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"
datatype_icon

session out

Reference to your instrument session passed to the next node.

datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Hardware Support

This node supports the following hardware:

  • PXIe-5601/5603/5605/5606 (external digitizer mode)
  • PXIe-5644/5645/5646
  • PXIe-5663E/5665/5667/5668
  • PXIe-5693/5694/5698
  • PXIe-5820/5840

Examples

Search within the programming environment to access the following installed examples:
  • RFSA Downconverter with External Digitizer
  • RFSA In-band Retuning with External LO

Accessing the Device Session with the Soft Front Panel

You can access the new device session using the NI-RFSA Soft Front Panel (SFP). Accessing the device session with the SFP can help you debug your code.

To enable SFP session access, create a new session for your device by wiring the following string into the option string input: DriverSetup=SFPSessionAccess:1.

To disable SFP session access, wire the following string into the option string input: DriverSetup=SFPSessionAccess:0.