Model 2651A High Power System SourceMeter® Instrument Reference Manual
Section 3: Functions and features
2651A-901-01 Rev. A / March 2011
3-73
Clearing the display
When sending a command to display a message, a previously defined user message is not cleared.
The new message starts at the end of the old message on that line. It is good practice to routinely
clear the display before defining a new message.
After displaying an input prompt, the message will remain displayed even after the operator performs
the prescribed action. The
clear()
function must be sent to clear the display. To clear both lines of
the display, but not affect any of the indicators, send the following function:
display.clear()
Cursor position
When displaying a message, the cursor position determines where the message will start. On power-
up, the cursor is positioned at row 1, column 1 (see the following figure). At this cursor position, a
user-defined message will be displayed on the top row (row 1).
Top line text will not wrap to the bottom line of the display automatically. Any text that does not fit on
the current line will be truncated. If the text is truncated, the cursor will be left at the end of the line.
Figure 66: Row/column format for display messaging
XXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Row 1
Row 2
Columns (for Row 1)
1
20
Columns (for Row 2)
1
32
Series 26XXA Display
X = display character
The function to set cursor position can be used two ways:
display.setcursor(
row
,
column
)
display.setcursor(
row
,
column
,
style
)
Where:
row
1
or
2
column
1
to
20
(row 1)
1
to
32
(row 2)
style
0
(invisible)
1
(blink)
When set to 0, the cursor will not be seen. When set to 1, a display character will blink to indicate its
position.
The
display.getcursor()
function returns the present cursor position, and can be used three
ways:
row
,
column
,
style
= display.getcursor()
row
,
column
= display.getcursor()
row
= display.getcursor()
