Performs the following initialization actions:

- Creates a new IVI instrument driver session.

- Opens a session to the specified device using the interface and address that you specify for Resource Name.

- If ID Query is set to TRUE, this VI queries the device ID and checks that the ID is valid for NI-FGEN.

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

- Sends initialization commands to set the device to the state necessary for the operation of NI-FGEN.

- Returns a session handle that you can use to identify the device in all subsequent NI-FGEN VI calls.


icon

Inputs/Outputs

  • civrn.png Resource Name —

    Resource Name specifies the instrument name, for example "PXI1Slot3" where "PXI1Slot3" is an instrument name assigned by Measurement & Automation Explorer (MAX).

    Syntax:

    Example # Device Type Syntax Variable
    1 NI-DAQmx device myDAQmxDevice (myDAQmxDevice = device name)
    2 NI-DAQmx device DAQ::myDAQmxDevice (myDAQmxDevice = device name)
    3 NI-DAQmx device DAQ::2 (2 = device name)
    4 IVI logical name or IVI virtual name myLogicalName (myLogicalName = name)

    For NI-DAQmx devices, the syntax is just the device name specified in MAX, as shown in Example 1. Typical default names for NI-DAQmx devices in MAX are Dev1 or PXI1Slot1. You can rename an NI-DAQmx device by right-clicking on the name in MAX and entering a new name.

    An alternate syntax for NI-DAQmx devices consists of DAQ::NI-DAQmx device name, as shown in Example 2. This naming convention allows for the use of an NI-DAQmx device in an application that was originally designed for a Traditional NI-DAQ device. For example, if the application expects DAQ::1 (Traditional NI-DAQ syntax), you can rename the NI-DAQmx device to 1 in MAX and pass in DAQ::1 for the resource name, as shown in Example 3.

    If you use the DAQ::n syntax and an NI-DAQmx device name already exists with that same name, the NI-DAQmx device is matched first.

    You can also pass in the name of an IVI logical name or an IVI virtual name configured with the IVI Configuration utility, as shown in Example 4. A logical name identifies a particular virtual instrument. A virtual name identifies a specific device and specifies the initial settings for the session.

    Caution NI-DAQmx device names are not case-sensitive. However, all IVI names, such as logical names, are case-sensitive. If you use logical names, driver session names, or virtual names in your program, you must ensure that the name you use matches the name in the IVI Configuration Store file exactly, without any variations in the case of the characters.
  • cbool.png Id Query (default: True) —

    Id Query specifies whether to verify that NI-FGEN supports the device you initialize.

    Circumstances can arise where sending an ID query to the device is undesirable. When you set this parameter to FALSE, the VI initializes the device without performing an ID query.

    Default value: True

  • cbool.png Reset Device (default: True) —

    Reset Device specifies whether you want to reset the device during the initialization procedure.

    Set Reset Device to TRUE to reset the device. Reset Device performs the same function as the niFgen Reset VI.

    Default value: True

  • cerrcodeclst.png error in (no error) —

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

    Default value: no error

  • iivrn.png Instrument Handle Out —

    Instrument Handle Out passes a reference to your instrument session to the next VI.

  • ierrcodeclst.png error out —

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