Skip to content

pilcd.1

Manvendra Bhangui edited this page Jan 17, 2025 · 2 revisions

NAME

pilcd - Print text on LCD Displays with Hitachi 44780 controller

SYNOPSYS

pilcd [-s] [-c clear_type] -r rownum message

or
pilcd -c 4 | -c 5 | -c 6

DESCRIPTION

pilcd(1) communicates with lcd-daemon(8) to print text on 20x4 or 16x2 LCD displays with Hitachi 44780 controllers. It uses a named pipe to send messages to lcd-daemon(8). The default named pipe is rundir/lcd-daemon/lcdfifo which can be changed by setting LCDFIFO environment variable. rundir is /run, /var/run or /tmp depending on your system.

picld(1) uses the following format for the message written to the named pipe (here <sp> stands for the white space character)

rownum<sp>scroll<sp>clear:message

where

scroll
value can be 0 or 1. 1 turns on scrolling

rownum
value can be 0 or 1 for 16x2 display or 0, 1, 2 or 3 for 20x4 display.

clear
The following values are supported for clear

1 clear the screen
2 clear and initialize
3 initializing LCD display
4 clear screen without displaying text
5 clear and initialize screen without displaying text
6 initialize screen without displaying text

message
Here message is any string specified as a single or multiple arguments.

OPTIONS

-s
Scrolls the message message

-c clear_type
Clears the LCD display before displaying text. You can give the following values

1 clear the screen
2 clear and initialize
3 initializing LCD display
4 clear screen without displaying text
5 clear and initialize screen without displaying text
6 initialize screen without displaying text

-r rownum
The row on which to print the text. Values are 0, 1, 2 or 3

message
The text message to display on the screen.

RETURN VALUE

0 if all steps were successful, non-zero otherwise. A diagnostic message is printed if pilcd encounters any error. If any systerm error is encountered, the return value will be 111.

AUTHORS

Manvendra Bhangui <[email protected]>

SEE ALSO

supervise(8) svc(8) envdir(8) multilog(8) lcd-daemon(8), notify-daemon(8)

Clone this wiki locally