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()
The following programming example illustrates how to position the cursor on row 2, column 1, and
then read the cursor position:
display.setcursor(2, 1)
row, column = display.getcursor()
print(row, column)
Output:
2.00000e+00 1.00000e+00
Displaying text messages
To define and display a message, use the display.settext(text) function (text is the text
string to be displayed). The message will start at the present cursor position. The following
programming example illustrates how to display “Test in Process” on the top line, and “Do Not
Disturb” on the bottom line:
display.clear()
display.setcursor(1, 1, 0)
display.settext("Test in Process")
display.setcursor(2, 6, 0)
display.settext("Do Not Disturb")
Character codes
The following special codes can be embedded in the text string to configure and customize the
message:
$N Starts text on the next line (newline). If the cursor is already on line 2, text is ignored after the ‘$N’
is received.
$R Sets text to Normal.
$B Sets text to Blink.
$D Sets text to Dim intensity.
$F Set text to background blink.
$$ Escape sequence to display a single “$”.
In addition to displaying alphanumeric characters, you can display other special characters. Refer to
display.settext() (on page 11-141) for a listing of special characters and their corresponding codes.
The following programming example illustrates how to display the Greek symbol omega (Ω:
display.clear()
c = string.char(18)
display.settext(c)