![background image](http://html2.mh-extra.com/html/keithley/system-sourcemeter-2601b/system-sourcemeter-2601b_reference-manual_4009934335.webp)
Section 6: Instrument programming
Series 2600B System SourceMeter® Instrument Reference Manual
6-58
2600BS-901-01 Rev. B / May 2013
For additional information, see
waitcomplete()
(on page 7-380).
The following code shows two examples of using the
waitcomplete()
command from the master
node:
-- Wait for each node in group
N
to complete all overlapped operations.
waitcomplete(
N
)
-- Wait for all groups on the TSP-Link network to complete overlapped operations.
waitcomplete(0)
A group leader can issue the
waitcomplete()
command to wait for the local group to complete all
overlapped operations.
The following code is an example of how to use the
waitcomplete()
command from a group
leader:
-- Wait for all nodes in the local group to complete all overlapped operations.
waitcomplete()
Using the data queue for real-time communication
Nodes that are running test scripts at the same time can store data in the data queue for real-time
communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO)
structure to store data. You can use the data queue to post numeric values, strings, and tables.
Use the data queue commands to:
•
Share data between test scripts running in parallel
•
Access data from a remote group or a local node on a TSP-Link
®
network at any time
You cannot access the reading buffers or global variables from any node in a remote group while a
node in that group is performing an overlapped operation. However, you can use the data queue to
retrieve data from any node in a group that is performing an overlapped operation. In addition, the
master node and the group leaders can use the data queue as a way to coordinate activities.
Tables in the data queue consume one entry. When a node stores a table in the data queue, a copy
of the data in the table is made. When the data is retrieved from the data queue, a new table is
created on the node that is retrieving the data. The new table contains a completely separate copy of
the data in the original table, with no references to the original table or any subtables.
You can access data from the data queue even if a remote group or a node has overlapped
operations in process. See the
dataqueue
commands in the
TSP command reference
(on page 7-1)
for more information.
Copying test scripts across the TSP-Link network
To run a large script on a remote node, copy the test script to the remote node to increase the speed
of test script initiation.
The code in the example below copies a test script across the TSP-Link
®
network, creating a copy of
the script on the remote node with the same name.
-- Add the source code from the script
-- testScript to the data queue.
node[2].dataqueue.add(testScript.source)
-- Create a new script on the remote node
-- using the source code from testScript.
node[2].execute(testScript.name ..
"= script.new(dataqueue.next(), [[" .. testScript.name .. "]])")
Summary of Contents for System SourceMeter 2601B
Page 841: ......