diff options
Diffstat (limited to 'docs/DRIVER.ks0108')
| -rw-r--r-- | docs/DRIVER.ks0108 | 124 |
1 files changed, 124 insertions, 0 deletions
diff --git a/docs/DRIVER.ks0108 b/docs/DRIVER.ks0108 new file mode 100644 index 0000000..24d5a17 --- /dev/null +++ b/docs/DRIVER.ks0108 @@ -0,0 +1,124 @@ +--------------------------------------------------------------------- +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 + |