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

2600AS-901-01 Rev. B / September 2008 Return to Section Topics 11-11
Series 2600A System SourceMeter® Instruments Reference Manual Section 11: Display Operations
Loading and saving a user script
After a user script is loaded into the Series 2600A it can be saved in nonvolatile memory. If it is not
stored in nonvolatile memory, the script will be lost when the Series 2600A is turned off.
When loading a script from the Test Script Builder, the launch can be configured to save the script
in nonvolatile memory (see
Using Test Script Builder in Section 13 ).
When loading a user script from another program,
myscript.save()
is used to save the script in
nonvolatile memory (see Saving a user script in Section 12 ).
Adding USER TESTS menu entries
The following function can be used in two ways to add an entry into the USER TESTS submenu:
display.loadmenu.add(displayname, chunk)
display.loadmenu.add(displayname, chunk, memory)
displayname
Name string to add to 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
.
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 ). If the script is not saved in
nonvolatile memory, it will be lost when the Series 2600A is turned off. See Example 1 below.
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 :
The following command adds an entry called “Part1” to the front panel “USER TESTS” submenu
for the chunk “testpart([[Part1]], 5.0)”, and saves it in nonvolatile memory:
display.loadmenu.add("Part1", "testpart([[Part1]], 5.0)", display.SAVE)