High Voltage SourceMeter Instrument Reference Manual Section 9: TSP-Link and TSP-
2470-901-01 Rev. A / May 2019 9-9
Running test scripts and programs on remote nodes
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 operatio
n
s
tate. 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.
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
m
aster 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.
For additional information, refer to waitcomplete() (on page 14-292
).