Running Simultaneous Test Scripts - Keithley 2601B Reference Manual

Series 2600B System SourceMeter® Instrument Reference Manual
Assigning groups
Group numbers can range from zero (0) to 64. The default group number is 0. You can change the
group number at any time. You can also add or remove a node to or from a group at any time.
Each time the node's power is turned off, the group number for that node changes to 0.
The following example code dynamically assigns a node to a group:
-- Assign node 3 to group 1.
node[3].tsplink.group = 1

Running simultaneous test scripts

You can send the execute() command from the master node to initiate a test script and Lua code
on a remote node. The execute() command places the remote node in the overlapped operation
state. As a test script runs on the remote node, the master node continues to process other
commands simultaneously.
Use the following code to send the execute() command for a remote node. The N parameter
represents the node number that runs the test script (replace N with the node number).
To set the global variable "setpoint" on node N to 2.5:
node[N].execute("setpoint = 2.5")
The following code demonstrates how to run a test script that is defined on the local node. For this
example, scriptVar is defined on the local node, which is the node that initiates the code to run on
the remote node. The local node must be the master node.
To run scriptVar on node N:
node[N].execute(scriptVar.source)
The programming example below demonstrates how to run a test script that is defined on a remote
node. For this example, scriptVar is defined on the remote node.
To run a script defined on the remote node:
node[N].execute("scriptVar()")
It is recommended that you copy large scripts to a remote node to improve system performance. See
Copying test scripts across the TSP-Link network
Coordinating overlapped operations in remote groups
All overlapped operations on all nodes in a group must have completed before the master node can
send a command to the group. If you send a command to a node in a remote group when an
overlapped operation is running on any node in that group, errors will occur.
You can execute the waitcomplete() command on the master node or group leader to wait for
overlapped operations. The action of waitcomplete() depends on the parameters specified.
If you want to wait for completion of overlapped operations for:
•
All nodes in the local group: Use waitcomplete() without a parameter from the master node
or group leader.
•
A specific group: Use waitcomplete(N) with a group number as the parameter from the
master node. This option is not available for group leaders.
•
All nodes in the system: Use waitcomplete(0) from the master node. This option is not
available for group leaders.
2600BS-901-01 Rev. B / May 2013
Section 6: Instrument programming
(on page 6-58) for more information.
6-57