Table Of Contents

IviScope Initialize With Options (G Dataflow)

Last Modified: September 7, 2018

Creates a new IVI instrument driver and optionally sets the initial session properties state. Opens a session to the specified device using the interface and address you specify for the Resource Name parameter. 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.

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

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: "SampleScope"

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

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

option string

String you can use to set the initial value of certain properties for the session. The following table lists the property names you can set in this parameter.

Name
RangeCheck
QueryInstrStatus
Cache
Simulate
RecordCoercions
Spy
InterchangeCheck
DriverSetup

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 will be set. To set multiple properties, separate their assignments with a comma. If you pass NULL or an empty string for this parameter, the instrument driver uses the values from the Measurement and Automation Explorer's IVI Configuration Utility. You can override these values by assigning a value explicitly in a string you pass for this parameter. You do not have to specify all of the properties and may leave any of them out. If you do not specify one of the properties, the driver uses the value from the IVI Configuration Utility.

Valid Values for ViBoolean Properties

True TRUE, 1, True
False FALSE, 0, False

Default:

RangeCheck TRUE
QueryInstrStatus FALSE
Cache TRUE
Simulate FALSE
"Simulate=0,RangeCheck=1,QueryInstrStatus=0,Cache=1"

datatype_icon

instrument handle out

The instrument handle that you obtain from the IviScope Initialize or IviScope Initialize With Options node. The handle identifies a particular instrument session.

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.

Optional Session Properties

IviScope>>Inherent IVI Settings>>User Options>>Range Check

IIviScope>>Inherent IVI Settings>>User Options>>Query Instrument Status

IIviScope>>Inherent IVI Settings>>User Options>>Cache

IviScope>>Inherent IVI Settings>>User Options>>Simulate

IviScope>Inherent IVI Settings>>User Options>>Record Value Coercions

ID Query

If the ID Query parameter is set to True, this node queries the instrument ID and checks that it is valid for this instrument driver.

Reset

If the Reset parameter is set to True, this node resets the instrument to a known state.

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