niDCPower Initialize With Channels VI

NI DC Power Supplies and SMUs Help (NI-DCPower)

Edition Date: January 2018

Part Number: 370736U-01

View Product Info

DOWNLOAD (Windows Only)


NI-DCPower (English | Japanese)
Installed With: NI-DCPower

Creates and returns a new NI-DCPower session to the power supply or SMU specified in resource name to be used in all subsequent NI-DCPower VI calls.

With this VI, you can optionally set the initial state of the following session properties: Simulate and Driver Setup. After calling this VI, the session will be in the Uncommitted state. Refer to the Programming States topic in the NI DC Power Supplies and SMUs Help for details about specific software states.

To place the device in a known startup state when creating a new session, set reset to TRUE. This action is equivalent to using the niDCPower Reset VI immediately after initializing the session.

To open a session and leave the device in its existing configuration without passing through a transitional output state, set reset to FALSE. Next, configure the device as in the previous session, change the desired settings, and then call the niDCPower Initiate VI to write both settings.

Related topics:

Programming States

niDCPower Initialize With Channels

/images/reference/en-XX/help/370736U-01/cio.gif

resource name specifies the resource name assigned by Measurement & Automation Explorer (MAX), for example, PXI1Slot3, where PXI1Slot3 is an instrument resource name. resource name can also be a logical IVI name.

/images/reference/en-XX/help/370736U-01/cstr.gif

channels specifies which output channel(s) to include in the newly created session. Specify multiple channels by using a channel list or a channel range. A channel list is a comma (,) separated sequence of channel names (for example, 0,2 specifies channels 0 and 2). A channel range is a lower bound channel followed by a hyphen (-) or colon (:) followed by an upper bound channel (for example, 0-2 specifies channels 0, 1, and 2). In the Running state, multiple output channel configurations are performed sequentially based on the order specified in this parameter. If you do not wire this parameter, by default all channels on the device are included in the session.

/images/reference/en-XX/help/370736U-01/cbool.gif

reset (false) specifies whether to reset the power supply during the initialization procedure. The default is FALSE.

/images/reference/en-XX/help/370736U-01/cstr.gif

option string specifies the initial value of certain properties for the session.

The syntax for option string is a list of properties with an assigned value where 1 is TRUE and 0 is FALSE. For example:

Simulate=0, DriverSetup=Model:<model number>; BoardType:<type>

You do not have to specify a value for all the properties. If you do not specify a value for a property, the default value is used.

For more information about simulating a device, refer to Simulating a Power Supply or SMU in the NI DC Power Supplies and SMUs Help.

/images/reference/en-XX/help/370736U-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370736U-01/cbool.gif

status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.

/images/reference/en-XX/help/370736U-01/ci32.gif

code is the error or warning code. The default is 0. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.

/images/reference/en-XX/help/370736U-01/cstr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.

/images/reference/en-XX/help/370736U-01/iio.gif

instrument handle out passes the handle used to identify the session in all subsequent NI-DCPower VI calls.

/images/reference/en-XX/help/370736U-01/ierrcodeclst.gif

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

/images/reference/en-XX/help/370736U-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370736U-01/ii32.gif

code is the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.

/images/reference/en-XX/help/370736U-01/istr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning.

WAS THIS ARTICLE HELPFUL?

Not Helpful