---------------------------------------------------------------------
GraphLCD driver library

The KS0108 driver
---------------------------------------------------------------------

Description
-----------
The KS0108 driver supports LC displays that use the Samsung KS0108
controller, connected to the parallel port of your PC.


Wirings
-------
The KS0108 driver supports the following connection on a parallel
port:

  printerport   LCD          other
  -----------   ----------   ----------
  GND    (18)   GND   (01)   GND          (Ground)
                Vdd   (02)   +5V
                Vo    (03)                (LCD Contrast In)
  nSEL   (17)   R/S   (04)                (Register Select)
                R/W   (05)   GND          (Read/Write)
  nSTRB  (01)   EN    (06)                (Enable)
  D0     (02)   D0    (07)                (DataBit0)
  D1     (03)   D1    (08)                (DataBit1)
  D2     (04)   D2    (09)                (DataBit2)
  D3     (05)   D3    (10)                (DataBit3)
  D4     (06)   D4    (11)                (DataBit4)
  D5     (07)   D5    (12)                (DataBit5)
  D6     (08)   D6    (13)                (DataBit6)
  D7     (09)   D7    (14)                (DataBit7)
  nAUTO  (14)   CS1   (15)                (ChipSelect Controller 1)
  INIT   (16)   CS2   (16)                (ChipSelect Controller 2)
                RESET (17)   +5V          (Controller Reset)
                Vout  (18)                (Contrast Out)
                LED+  (19)   +4V          (Backlight)
                LED-  (20)   GND          (Backlight GND)

Note: The pin numbering may vary with other displays.

If you want to connect a 192x64 or 256x64 display (with 3 or 4
ChipSelects) or two 128x64 displays, you must add a binary decoder for
the ChipSelect lines. The mode ist auto-selected based on the width and
height parameters.

        nAUTO (14)
        |   INIT (16)
    Vdd |   |   GND GND
    |   |   |   |   |
    16  15  14  13  12  11  10  09
   --------------------------------
  |                                |
   >                               |
  |                                |
   --------------------------------
    01  02  03  04  05  06  07  08
    |   |   |   |               |
    CS1 |   |   |               GND
        CS2 |   CS4 (CS2 second LCD)
            CS3 (CS1 second LCD)


Configuration Parameters
------------------------
The KS0108 driver supports the following parameters in config file:

Device
 Instead of using the direct output via port address (see Port), you
 can use the parport device (/dev/parportX). The advantage over the
 direct output via port address is that this works for non-root users
 also. But it's a little bit slower. The modules ppdev.o, parport.o
 and parport_pc.o must be loaded or compiled into the kernel.

Port
 Sets the port address of the parallel port. If this parameter is not
 given, 0x378 is used. To use this direct output, the program that
 uses the driver library has to be started with user 'root'.

Width
 Sets the horizontal size of the display. If this parameter is not
 given, a default value of 128 pixels is used.

Height
 Sets the vertical size of the display. If this parameter is not
 given, a default value of 64 pixels is used.

UpsideDown
 Rotates the display output by 180 degrees. This might be useful, if
 the LCD is mounted upside-down.
 Possible values: 'yes', 'no'
 Default value: 'no'

Invert
 Inverts the display.
 Possible values: 'yes', 'no'
 Default value: 'no'

AdjustTiming
 To get a timing that is as accurate as possible, the drivers measure
 the time for port commands (see: benchmark in syslog). You might
 decrease or increase the time to wait after port commands with this
 parameter. Normally, there is no need to change this parameter.
 Possible values: -50 <= x <= 50
 Default value: 0

RefreshDisplay
 Normally, most of the drivers do not update the whole display, but
 only the areas that have changed since last update. So it might be,
 that some faulty pixels would stay a longer time. To avoid this, the
 plugin makes a complete refresh from time to time. This parameter
 defines how often a complete refresh will be done.
 e.g.: A value of 5 means, that the plugin will make a complete
       refresh on every 5th update.
 A value of 0 completely disables complete refreshs. 
 Possible values: 0 <= x <= 50
 Default value: 5

Control
 Sets the variant of setting the display control lines.
 Possible values: 0, 1
 Default value: 1