To use an external lcd device together with the
/dev/lcd file, you have to call configure with the
'--enable-lcd-monitor' option.

Requirements:
 - display driver software for device /dev/lcd
 - a LCD display hardware with 16x2 or 20x2 chars

This software part uses the /dev/lcd interface
for DOT-Matrix LCD displays.
The /dev/lcd interface comes from Nils Faerber.
It can be found at http://www.home.unix-ag.org/nils/lcd.html

History (of the lcd-monitor):
 1: initial release for linesrv_2.1.6
 2: online seconds added for online time
 3: number of online lines added, real online clients counting
 4: output optimized now for a 20x2 char display, but 16x2 OLD style
    is still in the code. This old style is available with
    '--enable-lcd-16x2' option during configure.



The 20x2 char LCD output format:

 ----------------------
 |00/00/0 0.0 23:17.55|
 |0000B 0000B offline |
 ----------------------
 In the first row:
  - number of connected clients
  - number of online clients
  - number of online lines
  - CPU short time load value
  - system time
 In the second row:
  - actually bytes upload / second ( Bytes/Kilobytes/Megabytes)
  - actually bytes download / second ( Bytes/Kilobytes/Megabytes)
  - online time (min:sec)


The 16x2 output format offers the following stateview:

 C = number of connected clients
 O = number of online clients
 L = number of online lines
 T = online time (min:sec)

The initial code was contributed by
Martin Berentsen < berentsen at sent5 dot uni-duisburg dot de >

You might want to edit server/external.c. You
see there the update_lcd_status() function. Change it
as much as you like, but follow these rules:
- use global linesrv variables (see server/global_vars.h
  and the files it includes) read-only!
- The function doesn't have to be reentrant (forget it if
  you don't know what I'm talking about, it's not important)
  as linesrv is not multithreaded (and won't become it in future).

The update_lcd_status() does nothing else than collecting
data from some interesting global variables (lines, clients, ...)
and print them to /dev/lcd.

I (S.Fuchs) don't support this code. It's here to get used
but it's your own job to make it useful for your specific
display.

Greetings

S. Fuchs, M. Berentsen


