From 12:00 PM - 4:00 PM CST on Thursday, October 18, ni.com will be undergoing system upgrades that may result in temporary service interruption.

We appreciate your patience as we improve our online experience.

Table Of Contents

IviSwtch Initialize (G Dataflow)

Version:
    Last Modified: October 24, 2017

    Creates a new IVI instrument driver session. Opens a session to the specific driver using the logical name of the IVI driver session. Sends initialization commands to set the instrument to the state necessary for the operation of the instrument driver. Returns an instrument handle that you use to identify the instrument in all subsequent instrument driver node calls.

    spd-note-note
    Note  

    This node creates a new session each time you invoke it. Although you can open more than one IVI session for the same resource, it is best not to do so. You can use the same session in multiple program threads.

    Content from the IVI specifications reproduced with permission from the IVI Foundation.

    The IVI Foundation and its member companies make no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The IVI Foundation and its member companies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

    connector_pane_image
    datatype_icon

    logical name ("SampleSwitch")

    Pass the logical name that identifies the particular driver session to use. The driver session, in turn, identifies a specific driver and device and specifies the initial settings for the session.

    spd-note-note
    Note  

    All IVI names, such as logical names or virtual names, are case-sensitive. If you use logical names, driver session names, or virtual names in your program, ensure that the name you use matches the name in the IVI Configuration Store file exactly, without any variations in character case.

    :

    IVI Configuration Utility

    Using Your Program with a Different Instrument

    If you want to use your program with a different physical instrument, change the configuration of the logical name to use the driver session for the new physical instrument. You can change the initial settings for the session by changing the configuration of the driver session.

    Default: "SampleSwitch"

    datatype_icon

    instrument handle out

    The instrument handle that you obtain from the IviSwtch Initialize Node. The handle identifies a particular instrument session.

    Default: None

    datatype_icon

    reset device

    Boolean value that specifies whether you want to reset the instrument during the initialization procedure.

    True Reset Device
    False Don't Reset Device

    Default: true

    datatype_icon

    id query

    Boolean value that specifies whether you want the instrument driver to perform an ID Query.

    True Perform ID Query. The driver verifies that the instrument type you initialize is supported.
    False Skip ID Query. The node initializes the instrument without performing an ID query.

    Default: True

    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

    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.

    Where This Node Can Run:

    Desktop OS: Windows

    FPGA: Not supported

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


    Recently Viewed Topics