--------------------------------------------------------------------- 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