Initialize With Independent Channels
- Updated2023-02-17
- 3 minute(s) read
Initialize With Independent Channels
Creates a new NI-DCPower session to the specified instrument(s) and channel(s) and returns a session handle to be used in all subsequent NI-DCPower node calls.
Inputs/Outputs
resource name
Resources to use in the session.
NI-DCPower resources can be names of the instrument(s) assigned by Measurement & Automation Explorer (MAX) and the channel(s) to initialize.
Resource Name Syntax
Use the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.
If you do not specify channels, all channels of the instrument(s) are included in the session.
channel name
Channel(s) to use.
If you do not wire this parameter, by default all channels in the session are used.
Channel Name Syntax
Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.
reset
Boolean value that specifies whether to reset channel(s) during the initialization procedure.
| True | Channel(s) reset during initialization procedure. |
| False | Channel(s) do not reset during initialization procedure. |
Default value: False
Placing Channels in a Known Startup State
To place channel(s) in a known startup state when creating a new session, set reset to True. This action is equivalent to using the Reset With Channels node immediately after initializing the session.
Leaving Channels in an Existing Configuration
To open a session and leave the channel(s) in an existing configuration without passing through a transitional output state, set reset to False. Next, configure the channel(s) as in the previous session, change the desired settings, and then call the Initiate With Channels node to write both settings.
option string
The initial value of certain properties for the session.
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.
Option String Syntax
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:<bus connector>
Simulating Multiple Instruments
To simulate a multi-instrument session, set Simulate to 1 and list multiple instruments for DriverSetup. For example:
Simulate=1, DriverSetup=ResourceName:<resource name>; Model:<model number>; BoardType:<bus connector> & ResourceName:<resource name>; Model:<model number>; BoardType:<bus connector>
error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Default value: No error
session out
Handle used to identify the session in all subsequent NI-DCPower node calls.
error out
Error information.
The node produces this output according to standard error behavior.
Initial State
With this node, you can optionally set the initial state of the Simulate and Driver Setup properties. After calling this node, the session will be in the Uncommitted state.
Configure Channels Independently
With this node and channel-based NI-DCPower nodes and properties, you can use any channels in the session independently. For example, you can initiate a subset of channels in the session with NI-DCPowerInitiate With Channels, and the other channels in the session remain in the Uncommitted state.