graphlcd-base/docs/DRIVER.hd61830
changeset 4 df6a40031aa5
equal deleted inserted replaced
3:d0e62fc47285 4:df6a40031aa5
       
     1 ---------------------------------------------------------------------
       
     2 GraphLCD driver library
       
     3 
       
     4 The HD61830 driver
       
     5 ---------------------------------------------------------------------
       
     6 
       
     7 Description
       
     8 -----------
       
     9 The HD61830 driver supports LC displays that use the Hitachi HD61830
       
    10 controller, connected to the parallel port of your PC.
       
    11 
       
    12 
       
    13 Wirings
       
    14 -------
       
    15 The HD61830 driver supports the following connection on a parallel
       
    16 port:
       
    17 
       
    18   printerport   LCD          other
       
    19   -----------   ----------   ----------
       
    20   GND    (18)   GND   (01)   GND          (Ground)
       
    21                 VDD   (02)   +5V          (V Controller)
       
    22                 V0    (03)   +5V..-15V    (Contrast)
       
    23   INIT   (16)   RS    (04)                (Register Select)
       
    24   nAUTO  (14)   R/W   (05)                (Read 1/Write 0)
       
    25   nSTRB  (01)   EN    (06)                (Enable)
       
    26   D0     (02)   D0    (07)                (DataBit0)
       
    27   D1     (03)   D1    (08)                (DataBit1)
       
    28   D2     (04)   D2    (09)                (DataBit2)
       
    29   D3     (05)   D3    (10)                (DataBit3)
       
    30   D4     (06)   D4    (11)                (DataBit4)
       
    31   D5     (07)   D5    (12)                (DataBit5)
       
    32   D6     (08)   D6    (13)                (DataBit6)
       
    33   D7     (09)   D7    (14)                (DataBit7)
       
    34                 nCS   (15)   GND          (Chip Select)
       
    35                 nRES  (16)   +5V          (Reset)
       
    36                 VEE   (17)   -12V         (V LCD)
       
    37                 nDO   (18)                (not connected)
       
    38 
       
    39 Note: The pin numbering may vary with other displays.
       
    40 
       
    41 
       
    42 Configuration Parameters
       
    43 ------------------------
       
    44 The HD61830 driver supports the following parameters in config file:
       
    45 
       
    46 Device
       
    47  Instead of using the direct output via port address (see Port), you
       
    48  can use the parport device (/dev/parportX). The advantage over the
       
    49  direct output via port address is that this works for non-root users
       
    50  also. But it's a little bit slower. The modules ppdev.o, parport.o
       
    51  and parport_pc.o must be loaded or compiled into the kernel.
       
    52 
       
    53 Port
       
    54  Sets the port address of the parallel port. If this parameter is not
       
    55  given, 0x378 is used. To use this direct output, the program that
       
    56  uses the driver library has to be started with user 'root'.
       
    57 
       
    58 Width
       
    59  Sets the horizontal size of the display. If this parameter is not
       
    60  given, a default value of 240 pixels is used.
       
    61 
       
    62 Height
       
    63  Sets the vertical size of the display. If this parameter is not
       
    64  given, a default value of 128 pixels is used.
       
    65 
       
    66 UpsideDown
       
    67  Rotates the display output by 180 degrees. This might be useful, if
       
    68  the LCD is mounted upside-down.
       
    69  Possible values: 'yes', 'no'
       
    70  Default value: 'no'
       
    71 
       
    72 Invert
       
    73  Inverts the display.
       
    74  Possible values: 'yes', 'no'
       
    75  Default value: 'no'
       
    76 
       
    77 AdjustTiming
       
    78  To get a timing that is as accurate as possible, the drivers measure
       
    79  the time for port commands (see: benchmark in syslog). You might
       
    80  decrease or increase the time to wait after port commands with this
       
    81  parameter. Normally, there is no need to change this parameter.
       
    82  Possible values: -50 <= x <= 50
       
    83  Default value: 0
       
    84 
       
    85 RefreshDisplay
       
    86  Normally, most of the drivers do not update the whole display, but
       
    87  only the areas that have changed since last update. So it might be,
       
    88  that some faulty pixels would stay a longer time. To avoid this, the
       
    89  plugin makes a complete refresh from time to time. This parameter
       
    90  defines how often a complete refresh will be done.
       
    91  e.g.: A value of 5 means, that the plugin will make a complete
       
    92        refresh on every 5th update.
       
    93  A value of 0 completely disables complete refreshs. 
       
    94  Possible values: 0 <= x <= 50
       
    95  Default value: 5
       
    96