Section 6: Instrument programming
Model 2651A High Power System SourceMeter® Instrument Reference Manual
6-20
2651A-901-01 Rev. A / March 2011
Create functions using scripts
You can use scripts to define functions. Scripts that define a function are like any other script: They
do not cause any action to be performed on the instrument until they are executed. The global
variable of the function does not exist until the script that created the function is executed.
A script can consist of one or more functions. Once a script has been run, the computer can call
functions that are in the script directly.
NOTE
The following steps use TSB Embedded. You can also use the
loadscript
and
endscript
commands to create the script. See
Load a script by sending commands over the remote interface
(on page 6-4).
Steps to create a function using a script
Steps
Example
1. In TSB Embedded, enter a name into the
TSP Script box
MakeMyFunction
2. Enter the function as the body of the script
This example concatenates two strings:
MyFunction = function (who)
print("Hello " .. who)
end
3. Click
Save Script
MakeMyFunction
now exists on the instrument
in a global variable with the same name as the
script (
MakeMyFunction
). However, the function
defined in the script does not yet exist because
the script has not been executed.
4. Run the script as a function
MakeMyFunction()
This instructs the instrument to run the script,
which creates the
MyFunction
global variable
(which is also a function).
5. Run the new function with a value
MyFunction("world")
The response message is:
Hello world
Group commands using the function keyword
The following script contains instrument commands that display the name of the person that is using
the script on the front panel of the instrument. It takes one parameter to represent this name. When
this script is run, the function is loaded in memory. Once loaded into memory, you can call the
function outside of the script to execute it.
When calling the function, you must specify a string for the
name
argument of the function. For
example, to set the name to
John
, call the function as follows:
myDisplay("John")
