Elo TouchSystems Entuitive 1229L, User Manual

Page: 140 / 249

Section 3. Commands
17
display
Function Show a single message or two alternating messages on the device’s display.
Syntax
/display
[x]
The optional argument x indicates the message to be displayed.
Errors none
Remarks
If the optional argument x is provided, this command displays it as a single message.
If x is
@
, the driver sends a command to the device to display the idle message
00
(“Welcome”). If x is omitted, the command uses the values of the
msg1
and
msg2
properties for the message texts. If
msg2
is empty, this command displays the text in
msg1
; otherwise, it displays the texts in
msg1
and
msg2
as alternating messages. The
message texts are displayed unmodified, except for any ‘\’ characters, which are
used as escape characters:
\r is converted to 0x0D (shown as <CR> in this document)
\n is converted to 0x0A (shown as <LF> in this document), e.g., to be used as
line separator for LCD screens that can display multiple lines
\\ is converted to \
\x hh is converted to a character with ASCII value hh (always two hex digits).
Not all ASCII values can be displayed.
Leading and trailing spaces are removed from the message texts in the x
argument and the
msg1
and
msg2
properties.
\x20
may be used for adding
leading spaces.
To center the message “Thank You” on the IntelliPIN LCD:
Command
/display \x20\x20\x20Thank You
Response none
echo
Function
Echo data
−
driver test command.
Syntax
/echo
string
string is limited to 11 characters (the width of the ‘arg1’ field in the response
format) without any embedded spaces.
Errors none
Remarks The driver responds by echoing the command back. If the command specifies a
string that is longer than 11 characters or if a space appears, the response will be
truncated. There is no translation for escape (\x00) commands. This command
cannot be cancelled with
/cancel
.
Example If you wish to ensure that the driver is properly installed, request it to echo a string:
Command
/echo Testing <LF>
Response
/echo Testing <LF>