graphlcd-base/docs/DRIVER.gu256x64-372
changeset 4 df6a40031aa5
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/graphlcd-base/docs/DRIVER.gu256x64-372	Wed Feb 06 17:32:55 2008 +0000
     1.3 @@ -0,0 +1,96 @@
     1.4 +---------------------------------------------------------------------
     1.5 +GraphLCD driver library
     1.6 +
     1.7 +The GU256X64-372 driver
     1.8 +---------------------------------------------------------------------
     1.9 +
    1.10 +Description
    1.11 +-----------
    1.12 +The GU256X64-372 driver supports Noritake GU256x64-372 VFD displays.
    1.13 +The VFD is operating in its 8 bit-mode connected to a PC's parallel
    1.14 +port.
    1.15 +
    1.16 +
    1.17 +Wiring
    1.18 +------
    1.19 +The GU256x64-372 driver supports the following connection on a parallel
    1.20 +port:
    1.21 +
    1.22 +  printerport   LCD          other
    1.23 +  -----------   ----------   ----------
    1.24 +  D0     (02)   D0    (15)                (Data Bit 0)
    1.25 +  D1     (03)   D1    (13)                (Data Bit 1)
    1.26 +  D2     (04)   D2    (11)                (Data Bit 2)
    1.27 +  D3     (05)   D3    (09)                (Data Bit 3)
    1.28 +  D4     (06)   D4    (07)                (Data Bit 4)
    1.29 +  D5     (07)   D5    (05)                (Data Bit 5)
    1.30 +  D6     (08)   D6    (03)                (Data Bit 6)
    1.31 +  D7     (09)   D7    (01)                (Data Bit 7)
    1.32 +  INIT   (16)   nWR   (17)                (Write)
    1.33 +  nSEL   (17)   R/S   (19)                (Register Select, C/D)
    1.34 +  GND    (18)   nRD   (21)                (Read)
    1.35 +  GND    (18)   CSS   (23)                (Chip Select)
    1.36 +  GND    (18)   GND   (02)                (Ground)
    1.37 +
    1.38 +
    1.39 +Configuration Parameters
    1.40 +------------------------
    1.41 +The GU256x64-372 driver supports the following parameters in config
    1.42 +file:
    1.43 +
    1.44 +Device
    1.45 + Instead of using the direct output via port address (see Port), you
    1.46 + can use the parport device (/dev/parportX). The advantage over the
    1.47 + direct output via port address is that this works for non-root users
    1.48 + also. But it's a little bit slower. The modules ppdev.o, parport.o
    1.49 + and parport_pc.o must be loaded or compiled into the kernel.
    1.50 +
    1.51 +Port
    1.52 + Sets the port address of the parallel port. If this parameter is not
    1.53 + given, 0x378 is used. To use this direct output, the program that
    1.54 + uses the driver library has to be started with user 'root'.
    1.55 +
    1.56 +Width
    1.57 + Sets the horizontal size of the display. If this parameter is not
    1.58 + given, a default value of 256 pixels is used.
    1.59 +
    1.60 +Height
    1.61 + Sets the vertical size of the display. If this parameter is not
    1.62 + given, a default value of 64 pixels is used.
    1.63 +
    1.64 +UpsideDown
    1.65 + Rotates the display output by 180 degrees. This might be useful, if
    1.66 + the LCD is mounted upside-down.
    1.67 + Possible values: 'yes', 'no'
    1.68 + Default value: 'no'
    1.69 +
    1.70 +Invert
    1.71 + Inverts the display.
    1.72 + Possible values: 'yes', 'no'
    1.73 + Default value: 'no'
    1.74 +
    1.75 +Brightness
    1.76 + Sets the brightness of your display's backlight.
    1.77 + Possible values: 0 <= x <= 100)
    1.78 + Default value: 100
    1.79 +
    1.80 +AdjustTiming
    1.81 + To get a timing that is as accurate as possible, the drivers measure
    1.82 + the time for port commands (see: benchmark in syslog). You might
    1.83 + decrease or increase the time to wait after port commands with this
    1.84 + parameter. Normally, there is no need to change this parameter.
    1.85 + Possible values: -50 <= x <= 50
    1.86 + Default value: 0
    1.87 +
    1.88 +RefreshDisplay
    1.89 + Normally, most of the drivers do not update the whole display, but
    1.90 + only the areas that have changed since last update. So it might be,
    1.91 + that some faulty pixels would stay a longer time. To avoid this, the
    1.92 + plugin makes a complete refresh from time to time. This parameter
    1.93 + defines how often a complete refresh will be done.
    1.94 + e.g.: A value of 5 means, that the plugin will make a complete
    1.95 +       refresh on every 5th update.
    1.96 + A value of 0 completely disables complete refreshs. 
    1.97 + Possible values: 0 <= x <= 50
    1.98 + Default value: 5
    1.99 +