
Section 7: TSP command reference
2606B System SourceMeter® Instrument Reference Manual
7-76
2606B-901-01 Rev. B / May 2018
Details
Sending this command selects the user screen and then moves the cursor to the given location.
The
display.clear()
,
display.setcursor()
, and
display.settext()
functions are
overlapped commands. That is, the script does not wait for one of these commands to complete.
These functions do not immediately update the virtual display. For performance considerations, they
update the display as soon as processing time becomes available.
An out-of-range parameter for
row
sets the cursor to row 2. An out-of-range parameter for
column
sets the cursor to column 20 for row 1, or 32 for row 2.
An out-of-range parameter for
style
sets it to 0 (invisible).
A blinking cursor is only visible when it is positioned over displayed text. It cannot be seen when
positioned over a space character.
Example
display.clear()
display.setcursor(1, 8)
display.settext("Hello")
display.setcursor(2, 14)
display.settext("World")
This example displays a message on the virtual
front panel, approximately center. Note that the
top line of text is larger than the bottom line of
text.
The virtual front panel of the instrument displays
"Hello" on the top line and "World" on the second
line.
Also see
(on page 7-61)
(on page 7-63)
(on page 7-76)
display.settext()
This function displays text on the virtual front-panel user screen.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
display.settext(
text
)
text
Text message to be displayed, with optional character codes
Details
This function selects the user display screen and displays the given text.
After the instrument is turned on, the first time you use a display command to write to the display, the
message "User Screen" is cleared. After the first write, you need to use
display.clear()
to clear
the message.
The
display.clear()
,
display.setcursor()
, and
display.settext()
functions are
overlapped commands. That is, the script does not wait for one of these commands to complete.
These functions do not immediately update the virtual display. For performance considerations, they
update the display as soon as processing time becomes available.