SETLCD n, offset, x$

Purpose

To display the string expression x$ on Line #n on built-in alphanumeric Liquid Crystal Display (LCD) or compatible Vacuum Fluorescent Display (VFD). x$ may be formed by concatenation of various strings using the ‘+’ operator (e.g. "Temp ="+STR$(A,3)+CHR$(223)+" C"). Integers must be converted to string using the STR$( ) or HEX$( ) function to be accepted by this function.

Special case: if n =0 the string x$ will be sent to the LCD’s "Instruction-Register" which allows hardware-specific LCD configuration such as clear screen, set cursor ON/OFF etc. (please refer to LCD’s manual for details)

The parameter offset = 1 to 40 allows you to send the string x$ beginning from the offsetth position. Only the characters position to be occupied by x$ will be written to the display, other characters of the display remain unaffected.

The PLC may support LCD display modules capable of displaying up to 4 lines x 40 characters per line of alphanumeric characters. If the display has fewer lines or fewer characters per line, the unavailable lines or characters will be ignored by the PLC. Once set, the LCD display will latch the set value until the next SETLCD statement on the same line and same offset is executed. On the TRiLOGI simulator, the result of the SETLCD is displayed together with the Special Variables view screen.

Examples SETLCD 1,1,"This is a 1x20 LCD Display"

backbutton.gif (507 bytes)  Basic to TBASIC Reference Manual