LCDd

LCDd(8) LCDproc suite LCDd(8)
NAME
LCDd - LCDproc server daemon
SYNOPSISLCDd [-hf] [-c config] [-d driver] [-i bool] [-a addr] [-p port] [-uuser] [-w time] [-r level] [-s bool]
DESCRIPTIONLCDd is the server part of LCDproc, a daemon which listens to a certain
port (normally 13666) and displays information on an LCD display. It
works with several types and sizes of displays.
Most settings of LCDd are configured through its configuration file
/etc/LCDd.conf, some of them can be overridden using command line
options. Before running LCDd you should carefully read through that
file and modify everything necessary according to your needs.
Otherwise you might encounter LCDd not running properly on your system.
To make full use of LCDd, a client such as lcdproc(1), lcdexec(1), or
lcdvc is required.
OPTIONS
Available options are:
-h Display help screen
-c config
Use a configuration file other than /etc/LCDd.conf-d driver
Specify a driver to use (output only to first), overriding the
Driver parameter in the config file's [Server] section.
-f Run in the foreground, overriding the Foreground parameter in
the config file's [Server] section. The default, if not
specified in the config file, is to daemonize LCDd as it is
intended to operate in the background.
-i bool
Tell whether the to enable (1) or disable (0) showing the
LCDproc server screen in n the screen rotation, overriding
ServerScreen in the config file's [Server] section.
-w waittime
Time to pause at each screen (in seconds), overriding the
WaitTime parameter in the config file's [Server] section.
-a addr
Bind to network address addr, overriding the Bind parameter in
the config file's [Server] section.
-p port
Listen on port port for incoming connections, overriding the
Port parameter in the config file's [Server] section.
-u user
Run as user user, overriding the User parameter in the config
file's [Server] section.
-s bool
Output messages to syslog (1) or to stdout (0), overriding the
ReportToSyslog parameter in the config file's [Server] section.
-r level
Set reporting level to level, overriding th ReportLevel
parameter in the config file's [Server] section.
SUPPORTED DRIVERS
Currently supported display drivers include:
bayrad BayRAD LCD modules by EMAC Inc.
CFontz CrystalFontz CFA-632 and CFA-634 serial LCD displays
CFontzPacket
CrystalFontz CFA-533, CFA-631, CFA-633 and CFA-635 serial/USB
LCD displays
curses Standard video display using the (n)curses library
CwLnx serial/USB displays by Cwlinux (http://www.cwlinux.com)
ea65 VFD front panel display on Aopen XC Cube EA65 media barebone
EyeboxOne
LCD display on the EyeboxOne
futaba The Futaba TOSD-5711BB VFDisplay on Elonex Artisan/Scaleo Media
Centre PCs
g15 LCD display on the Logitech G15 keyboard
glcd generic driver for graphical LCDs with FreeType rendering
support. This driver supports the following sub-drivers (a.k.a.
connection types):
glcd2usb
Till Harbaum's open source/open hardware GLCD2USB
(http://www.harbaum.org/till/glcd2usb/)
picolcdgfx
picoLCD 256x64 Sideshow graphic LCD (Mini-Box.com)
png Write out screens as PNG images
serdisplib
Uses serdisplib (http://serdisplib.sourceforge.net/) for
output
t6963 Toshiba T6963 based LCD displays (graphic mode)
glcdlib
graphical LCDs supported by graphlcd-base
glk Matrix Orbital GLK Graphic Displays
hd44780
Hitachi HD44780 LCD displays. This driver supports the
following sub-drivers (a.k.a. connection types):
4bit LCD 4bit-mode, connected to a PC parallel port
8bit LCD 8bit-mode, connected to a PC parallel port
serialLpt
LCD in 4bit-mode through a 4094 shift register
winamp LCD in 8bit-mode using WinAmp-wiring, connected to a PC
parallel port
picanlcd
LCD driven by a PIC-an-LCD chip/board by Dale Wheat,
connected to a serial port
lcdserializer
LCD driven by a PIC16C54-based piggy-back board,
connected to a serial port
los-panel
LCD driven by an Atmel AVR based board, connected to a
serial port
ezio Portwell EZIO-100 and EZIO-300 LCD connected to a serial
port (http://drivers.portwell.com/CA_Manual/EZIO/)
vdr-lcd
???, connected to a serial port
vdr-wakeup
VDR-Wake module by Frank Jepsen
(http://www.jepsennet.de/vdr/)
pertelian
Pertelian X2040 module (http://pertelian.com/)
lis2 LIS2 from VLSystem (http://www.vlsys.co.kr), connected to
USB
mplay MPlay Blast from VLSystem (http://www.vlsys.co.kr),
connected to USB
usblcd LCD device from Adams IT Services (http://www.usblcd.de/)
bwctusb
USB-to-HD44780 converter by BWCT (http://www.bwct.de)
lcd2usb
Till Harbaum's open source/open hardware LCD2USB
(http://www.harbaum.org/till/lcd2usb/)
usbtiny
Devices based on Dick Streefland's USBtiny firmware
uss720 USS-720 USB-to-IEEE 1284 Bridge (Belkin F5U002 USB
Parallel Printer Adapters)
usb4all
Sprut's open source / open hardware USB-4-all
(http://www.sprut.de/)
ftdi USB connection via a FTDI FT2232D chip in bitbang mode
i2c LCD in 4-bit mode driven by PCF8574(A) / PCA9554(A),
connected via I2C bus
piplate
Adafruit RGB Positive 16x2 LCD+Keypad for Raspberry Pi
spi LCD with KS0073 or equivalent in serial mode, connected
via SPI bus
pifacecad
PiFace Control and Display for the Raspberry Pi
(http://www.piface.org.uk/)
ethlcd TCP connection using open source/open hardware ethlcd
(http://manio.skyboo.net/ethlcd/)
raspberrypi
LCD driven by the GPIO pins of a Raspberry Pi
gpio LCD connection via GPIO pins controlled by the linux
sysfs interface
i2500vfd
140x32 pixel VFD Display of the Intra2net Intranator 2500
appliance
icp_a106
ICP Peripheral Communication Protocol alarm/LCD board used in
QNAP devices and 19" rack cases made by ICP
imon iMON IR/VFD modules in cases by
Soundgraph/Ahanix/Silverstone/Uneed/Accent
imonlcd
iMON IR/LCD modules in cases by
Soundgraph/Ahanix/Silverstone/Uneed/Accent/Antec
irtrans
IRTrans IR/VFD modules in cases by Ahanix (e.g. MCE303) and
possibly others May require irserver
(http://www.irtrans.de/en/download/linux.php) to be running for
connectivity.
IOWarrior
Code Mercenaries IOWarrior
irman IrMan infrared (input)
joy Joystick driver (input)
lb216 LB216 LCD displays
lcdm001
kernelconcepts.de 20x4 serial LCD displays
lcterm serial LCD terminal from Helmut Neumark Elektronik
(http://www.neumark.de)
linux_input
Linux event devices (input)
lirc Infrared (input)
lis L.I.S MCE 2005 20x2 VFD (http://vlsys.co.kr)
MD8800 VFD displays in Medion MD8800 PCs
mdm166a
Futuba MDM166A displays
ms6931 MSI-6931 displays in 1U rack servers by MSI
mtc_s16209x
MTC_S16209x LCD displays by Microtips Technology Inc
MtxOrb Matrix Orbital displays (except Matrix Orbital GLK displays)
mx5000 LCD display on the Logitech MX5000 keyboard
NoritakeVFD
Noritake VFD Device CU20045SCPB-T28A
Olimex_MOD_LCD1x9
Olimex MOD-LCD1x9 14 segment display
rawserial
Dumps the entire framebuffer to the serial port at a
configurable rate.
picolcd
Mini-box.com USB LCD (PicoLCD 20x4 & picoLCD 20x2)
pyramid
LCD displays from Pyramid (http://www.pyramid.de)
sdeclcd
Watchguard Firebox LCD display based on SDEC LMC-S2D20
(http://www.sdec.com.tw)
sed1330
SED1330/SED1335 (aka S1D13300/S1D13305) based graphical displays
sed1520
122x32 pixel graphic displays based on SED1520 controllers
serialPOS
Driver for Point Of Sale ("POS") devices using various protocols
(currently AEDEX only)
serialVFD
Text VFDs of various manufacturers, see LCDproc user-
documentation for further details.
shuttleVFD
Shuttle VFD (USB-based)
sli Wirz SLI driver (unknown)
stv5730
STV5730A on-screen display chip
SureElec
LCD devices from SURE electronics
(http://www.sureelectronics.net)
svga VGA monitors using svgalib
t6963 Toshiba T6963 based LCD displays (text mode)
text Standard "hard-copy" text display
tyan LCD module in Tyan Barebone GS series
ula200 ULA-200 device from ELV (http://www.elv.de)
vlsys_m428
VFD/IR combination in case MonCaso 320 from Moneual
yard2 yard2 LCD module
xosd On Screen Display on X11
Multiple drivers can be used simultaneously; thus, for example, a
Matrix Orbital display (MtxOrb driver) can be combined with an infrared
driver (irmanin driver).
INVOCATIONLCDd -d MtxOrb -d joy
The invocation example above will start LCDd reading its configuration
from the default configuration file /etc/LCDd.conf but overriding the
drivers specified therein with the Matrix Orbital driver and the
Joystick input driver.
LCDPROC CLIENT-SERVER PROTOCOL
There is a basic sequence:
1. Open a TCP connection to the LCDd server port (usually 13666).
2. Say "hello"
3. The server will return some information on the type
of display available.
4. Define (and use) a new screen and its widgets.
5. Close the socket when done displaying data.
CLIENT COMMANDS
There are many commands for the client to send to the LCDd server:
hello This starts a client-server session with the LCDd server; the
server will return a data string detailing the type of display
and its size.
client_set -name name
Set the client's name.
screen_add #id
Add a new screen to the display.
screen_del #id
Remove a screen from the display.
screen_set #id [-name name ] [-wid width] [-hgt height] [-priorityprio] [-duration int] [-timeout int] [-heartbeat mode] [-backlightmode] [-cursor mode] [-cursor_x xpos] [-cursor_y ypos]
Initialize a screen, or reset its data.
widget_add #screen #id type [-in #frame]
Add a widget of type type to screen #screen.
widget_del #screen #id
Delete widget #id from screen #screen.
widget_set #screen #id data
Set the data used to define a particular widget #id on screen
#screen.
HEARTBEAT MODES
Valid heartbeat mode values (for the screen_set command) are:
on Display pulsing heart symbol.
off No heartbeat display.
open Use client's heartbeat setting. This is the default.
BACKLIGHT MODES
Valid backlight mode values (for the screen_set command) are:
on Turn backlight on.
off Turn backlight off
toggle Turn backlight off when it is on and vice versa.
open Use client's backlight setting. This is the default.
blink Blinking backlight
flash Flashing blacklight
Priorities
Valid priority settings (used in the screen_set command) are as
follows:
input The client is doing interactive input.
alert The screen has an important message for the user.
foreground
an active client
info Normal info screen, default priority.
background
The screen is only visible when no normal info screens exists.
hidden The screen will never be visible.
For compatibility with older versions of clients a mapping of numeric
priority values is also supported:
1 - 64 foreground
65 - 192
normal
193 - (infinity)
background
An example of how to properly use priorities is as follows:
Imagine you're making an mp3 player for lcdproc. When the song
changes, it's nice to display the new name immediately. So, you could
set your screen's priority to foreground, wait for the server to
display (or ignore) your screen, then set the screen back to normal.
This would cause the mp3 screen to show up as soon as the one on screen
was finished, then return to normal priority afterward.
Or, let's say your client monitors the health of hospital patients. If
one of the patients has a heart attack, you could set the screen
priority to alert, and it would be displayed immediately. It wouldn't
even wait for the previous screen to finish. Also, the display would
stay on screen most of the time until the user did something about it.
WIDGET TYPES
Widgets can be any of the following:
string A text string to display (as is).
hbar A horizontal bar graph.
vbar A vertical bar graph.
title A title displayed across the top of the display, within a
banner.
icon A graphic icon.
scroller
A scrolling text display, scrolling either horizontally or
vertically.
frame A container to contain other widgets, permitting them to be
referred to as a single unit. A widget is put inside a frame by
using the -in #id parameter, where #id refers to the id of the
frame.
num Displays a large decimal digit
Widgets are drawn on the screen in the order they are created.
SETTING WIDGET DATA
In the widget_set command, the data argument depends on which widget is
being set. Each widget takes a particular set of arguments which
defines its form and behavior:
string x y text
Displays text at position (x,y).
title text
Uses text as title to display.
hbar x y length
Displays a horizontal bar starting at position (x,y) that is
length pixels wide.
vbar x y length
Displays a vertical bar starting at position (x,y) that is
length pixels high.
icon x y name
Displays the icon name at position (x,y).
scroller left top right bottom direction speed text
The text defined will scroll in the direction defined. Valid
directions are h (horizontal), m (marquee) and v (vertical).
The speed defines how many "movements" (or changes) will occur
per frame. A positive number indicates frames per movement; a
negative number indicates movements per frame.
frame left top right bottom wid hgt dir speed
Frames define a visible "box" on screen, from the (left, top)
corner to the (right, bottom) corner. The actual data may be
bigger, and is defined as wid (width) by hgt (height); if it is
bigger, then the frame will scroll in the direction (dir) and
speed defined.
num x int
Displays large decimal digit int at the horizontal position x,
which is a normal character x coordinate on the display. The
special value 10 for int displays a colon.
BUGS
If LCDd seems not to work as expected, try to run it in the foreground
with reporting level set to maximum and reporting to stderr. This can
be achieved without changes to the config file by using the command
line:
LCDd -f -r 5 -s 0FILES/etc/LCDd.conf, LCDd's default configuration file
SEE ALSOlcdproc-config(5), lcdproc(1), lcdexec(1)AUTHOR
Many people have contributed to LCDd. See the CREDITS file for more
details.
All questions should be sent to the lcdproc mailing list. The mailing
list, and the newest version of LCDproc, should be available from here:
http://www.lcdproc.org/LEGAL STUFF
The lcdproc package is released as "WorksForMe-Ware". In other words,
it is free, kinda neat, and we don't guarantee that it will do anything
in particular on any machine except the ones it was developed on.
It is technically released under the GNU GPL license (you should have
received the file, "COPYING", with LCDproc) (also, look on
http://www.fsf.org/ for more information), so you can distribute and
use it for free -- but you must make the source code freely available
to anyone who wants it.
For any sort of real legal information, read the GNU GPL (GNU General
Public License). It's worth reading.
LCDproc February 10, 2014 LCDd(8)