Table Of Contents

Initialize With Options (G Dataflow)

Version:
    Last Modified: December 19, 2018

    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.

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

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

    Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

    error in does not contain an error error in contains an error
    If no error occurred before the node runs, the node begins execution normally.

    If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

    If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

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

    Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

    error in does not contain an error error in contains an error
    If no error occurred before the node runs, the node begins execution normally.

    If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

    If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

    Accessing the Device Session with the NI-RFSA 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.

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

    Where This Node Can Run:

    Desktop OS: Windows

    FPGA: Not supported

    Web Server: Not supported in VIs that run in a web application

    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


    Recently Viewed Topics