Section 3: Functions and features
The following programming example illustrates how to use the $N and $B character codes to display
the message Test in Process on the top line and the blinking message Do Not Disturb on the
bottom line:
display.clear()
display.settext("Test in Process $N$BDo Not Disturb")
The following programming example illustrates how to use the $$ character code to display the
message You owe me $8 on the top line:
display.clear()
display.setcursor(1, 1)
display.settext("You owe me $$8")
If the extra $ character is not included, the $8 is interpreted as an undefined character code and is
ignored. The message You owe me is displayed.
Be careful when embedding character codes in the text string. It is easy to forget that the character
following the $ is part of the code. For example, if you want to display Hello on the top line and
Nate on the bottom line, send the following command:
display.settext("Hello$Nate")
The above command displays Hello on the top line and ate on the bottom line. The correct syntax
for the command is as follows:
display.settext("Hello$NNate")
Returning a text message
The display.gettext() function returns the displayed message (text) and has the following
options:
text = display.gettext()
text = display.gettext(embellished)
text = display.gettext(embellished, row)
text = display.gettext(embellished, row, columnStart)
text = display.gettext(embellished, row, columnStart, columnEnd)
Where:
embellished
row
columnStart
columnEnd
3-84
Model 2651A High Power System SourceMeter® Instrument Reference Manual
Returns text as a simple character string (false) or includes character codes (true)
The row to read text from (1 or 2); if not included, text from both rows is read
Starting column for reading text
Ending column for reading text
2651A-901-01 Rev. C October 2021
Need help?
Do you have a question about the Keithley 2651A and is the answer not in the manual?