Series 2600B System SourceMeter® Instrument Reference Manual
Section 6: Instrument programming
2600BS-901-01 Rev. B / May 2013
6-17
The following steps use TSB Embedded. You can also use the
loadscript
and
endscript
commands to create the script over the remote interface. See
Load a script by sending commands
over the remote interface
(on page 6-4).
Steps to create a function using a script:
1. In TSB Embedded, enter a name into the TSP Script box. For example, type
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
is now 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. For this example, send:
MakeMyFunction()
This instructs the instrument to run the script, which creates the
MyFunction
global variable.
This variable is of the type
"function"
(see
Variable types
(on page 6-14)).
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")
Example: User script
User script created in Test Script Builder or
TSB Embedded
User script created in user's own program
function myDisplay(name)
display.clear()
display.settext(
name .. "$N is here!")
end
loadscript
function myDisplay(name)
display.clear()
display.settext(
name .. " $N is here!")
end
endscript
Operators
You can compare and manipulate Lua variables and constants using operators.
Summary of Contents for System SourceMeter 2601B
Page 841: ......
