Keithley 2600a series, Reference Manual, Page: 365 / 696

2600AS-901-01 Rev. B / September 2008 Return to Section Topics 19-43
Series 2600A System SourceMeter® Instruments Reference Manual Section 19: Remote Commands
display.loadmenu.add
Function Adds an entry to the “USER TESTS” submenu of the “LOAD TEST” menu.
TSP-Link
accessibility
This function can be accessed from a remote TSP-Link node.
Usage There are two ways to use this function:
display.loadmenu.add(displayname, chunk)
display.loadmenu.add(displayname, chunk, memory)
displayname
Name to display in the menu.
chunk
Chunk is the code to be executed.
memory
Save or don’t save
chunk
and
displayname
in
nonvolatile memory.
Set
memory
to one of the following values:
0
or
display.DONT_SAVE
1
or
display.SAVE
The default
memory
setting is
display.SAVE
.
Remarks • This function adds an entry to the “USER TESTS” submenu of the “LOAD TEST” menu. If the
given item is subsequently selected via the front panel, the
chunk
will be executed when the
RUN key is pressed.
• The
chunk
can be made up of scripts, functions, variables, and commands. With
memory
set to
display.SAVE
, commands are saved with the
chunk
in nonvolatile memory. Scripts, functions
and variables used in the chunk are not saved by
display.SAVE
. Functions and variables
need to be saved along with the script (see Loading and saving a user script in Section 11 ). If the
script is not saved in nonvolatile memory, it will be lost when the Series 2600A is turned off. See
Example 1 below.
• It does not matter what order the menu items are added. They will be displayed in alphabetical
order when the “USER TESTS” menu is selected.
Details See Load test menu in Section 11 .
Also see
display.loadmenu.delete
Examples Example 1: Assume a script with a function named “DUT1” has already been loaded into the
Series 2600A, and the script has NOT been saved in nonvolatile memory.
Now assume you want to add a test named “Test” to the USER TESTS menu. You want the test to
run the function named “DUT1” and sound the beeper. The following command will add “Test” to the
menu, define the chunk, and then save
displayname
and
chunk
in nonvolatile memory:
display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE)
When “Test” is run from the front panel USER TESTS menu, the function named “DUT1” will
execute and the beeper will beep for two seconds.
Now assume you cycle power on the Series 2600A. Since the script was not saved in nonvolatile
memory, the function named “DUT1” is lost. When “Test” is again run from the front panel, the
beeper will beep, but “DUT1” will not execute because it no longer exists in the chunk.
Example 2: Adds entry called “Part1” to the front panel “USER TESTS” load menu for the chunk
“testpart([[Part1]], 5.0)”, and saves it in nonvolatile memory:
display.loadmenu.add("Part1", "testpart([[Part1]], 5.0)", display.SAVE)