graphlcd-base/docs/DRIVER.noritake800
changeset 4 df6a40031aa5
equal deleted inserted replaced
3:d0e62fc47285 4:df6a40031aa5
       
     1 ---------------------------------------------------------------------
       
     2 GraphLCD driver library
       
     3 
       
     4 The Noritake 800(A) series driver
       
     5 ---------------------------------------------------------------------
       
     6 
       
     7 Description
       
     8 -----------
       
     9 The Noritake 800(A) series driver supports following VFD displays manufactured
       
    10 by Noritake (see http://www.noritake-itron.com on the link "Medium 0.6 dot"):
       
    11  - GU128X64-800A;
       
    12  - GU256X32-800A;
       
    13  - GU128X32-800A;
       
    14  - GU160X16-800A;
       
    15  - GU160X32-800A;
       
    16  - GU192X16-800A.
       
    17 
       
    18 Wirings
       
    19 -------
       
    20 The VFD should be connected to a parallel port of the PC
       
    21 
       
    22 printer port      LIQUIDMP3        MZ            other?
       
    23 ---------------------------------------------
       
    24 
       
    25 Data lines D0...D7 connected straight in all wirings
       
    26 
       
    27 Strobe (1)         CSS (23)      WR (17)
       
    28 Linefeed (14)      RD (21)       RD (21)
       
    29 Init (16)          WR (17)       CSS (23)
       
    30 Select (17)        C/D (19)      C/D (19)
       
    31 
       
    32 Printer port pins 18 .... 25 connected to GND;
       
    33 VFD *ONLY EVEN* pins 2 .... 24 connected to GND
       
    34 Everything else is *NOT CONNECTED*
       
    35 
       
    36 Further wirings might work and then for sure very easyly added to the code.
       
    37 Just extend N800LptWiringMask(..) accordingly. This method is called in a
       
    38 loop over all 16 (4 wires for now) possibilities in the constructor, so the
       
    39 results are cached for the actual writes to the LPT control port, very
       
    40 similar to ReverseBits(..) for data.
       
    41 
       
    42 The driver should also work for "WIRING_MZ", just report if there are
       
    43 problems.
       
    44 Feel free to add support for "Parallel #2 Interface" or "Serial interface".
       
    45 
       
    46 Tested only on my own GU128x64-800(A) so far, just with the default 8-bit
       
    47 mode parallel wiring (referred as WIRING_LIQUIDMP3 or "0" in this code, or
       
    48 "Parallel #1 Interface"in the data sheet). I can't actually test the other
       
    49 wiring (as the display is already mounted in my HTPC, and the cable soldered),
       
    50 or even the other modes from the datasheet ("Parallel #2 Interface", or
       
    51 "Serial interface"), for those, my display lacks the necessary jumpers on
       
    52 it's PCB)
       
    53   
       
    54   
       
    55 Configuration Parameters
       
    56 ------------------------
       
    57 The Noritake 800(A) series driver supports the following parameters in config
       
    58 file:
       
    59 
       
    60 Device
       
    61  Instead of using the direct output via port address (see Port), you
       
    62  can use the parport device (/dev/parportX). The advantage over the
       
    63  direct output via port address is that this works for non-root users
       
    64  also. But it's a little bit slower. The modules ppdev.o, parport.o
       
    65  and parport_pc.o must be loaded or compiled into the kernel.
       
    66 
       
    67 Port
       
    68  Sets the port address of the parallel port. If this parameter is not
       
    69  given, 0x378 is used. To use this direct output, the program that
       
    70  uses the driver library has to be started with user 'root'.
       
    71 
       
    72 Width
       
    73  Sets the horizontal size of the display. If this parameter is not
       
    74  given, a default value of 256 pixels is used.
       
    75 
       
    76 Height
       
    77  Sets the vertical size of the display. If this parameter is not
       
    78  given, a default value of 64 pixels is used.
       
    79 
       
    80 UpsideDown
       
    81  Rotates the display output by 180 degrees. This might be useful, if
       
    82  the LCD is mounted upside-down.
       
    83  Possible values: 'yes', 'no'
       
    84  Default value: 'no'
       
    85 
       
    86 Invert
       
    87  Inverts the display.
       
    88  Possible values: 'yes', 'no'
       
    89  Default value: 'no'
       
    90 
       
    91 Brightness
       
    92  Sets the brightness of your display's backlight.
       
    93  Possible values: 0 <= x <= 100)
       
    94  Default value: 100
       
    95 
       
    96 AdjustTiming ---> not used in this driver (if there are problems, please report)
       
    97  To get a timing that is as accurate as possible, the drivers measure
       
    98  the time for port commands (see: benchmark in syslog). You might
       
    99  decrease or increase the time to wait after port commands with this
       
   100  parameter. Normally, there is no need to change this parameter.
       
   101  Possible values: -50 <= x <= 50
       
   102  Default value: 0
       
   103 
       
   104 RefreshDisplay ---> not used in this driver (if there are problems, please report)
       
   105  Normally, most of the drivers do not update the whole display, but
       
   106  only the areas that have changed since last update. So it might be,
       
   107  that some faulty pixels would stay a longer time. To avoid this, the
       
   108  plugin makes a complete refresh from time to time. This parameter
       
   109  defines how often a complete refresh will be done.
       
   110  e.g.: A value of 5 means, that the plugin will make a complete
       
   111        refresh on every 5th update.
       
   112  A value of 0 completely disables complete refreshs. 
       
   113  Possible values: 0 <= x <= 50
       
   114  Default value: 5
       
   115