diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/DRIVER.framebuffer | 44 | ||||
| -rw-r--r-- | docs/DRIVER.gu126x64D-K610A4 | 111 | ||||
| -rw-r--r-- | docs/DRIVER.gu140x32f | 126 | ||||
| -rw-r--r-- | docs/DRIVER.gu256x64-372 | 96 | ||||
| -rw-r--r-- | docs/DRIVER.gu256x64-3900 | 176 | ||||
| -rw-r--r-- | docs/DRIVER.hd61830 | 96 | ||||
| -rw-r--r-- | docs/DRIVER.image | 36 | ||||
| -rw-r--r-- | docs/DRIVER.ks0108 | 124 | ||||
| -rw-r--r-- | docs/DRIVER.noritake800 | 115 | ||||
| -rw-r--r-- | docs/DRIVER.sed1330 | 223 | ||||
| -rw-r--r-- | docs/DRIVER.sed1520 | 98 | ||||
| -rw-r--r-- | docs/DRIVER.serdisp | 61 | ||||
| -rw-r--r-- | docs/DRIVER.simlcd | 36 | ||||
| -rw-r--r-- | docs/DRIVER.t6963c | 159 | ||||
| -rw-r--r-- | docs/README.convpic | 42 | ||||
| -rw-r--r-- | docs/README.crtfont | 61 | ||||
| -rw-r--r-- | docs/README.showpic | 38 | ||||
| -rw-r--r-- | docs/README.showtext | 35 |
18 files changed, 1677 insertions, 0 deletions
diff --git a/docs/DRIVER.framebuffer b/docs/DRIVER.framebuffer new file mode 100644 index 0000000..ec1c65e --- /dev/null +++ b/docs/DRIVER.framebuffer @@ -0,0 +1,44 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The Framebuffer driver +--------------------------------------------------------------------- + +Description +----------- +The Framebuffer driver writes the output to the framebuffer device at +/dev/fb0. + +The driver is optimized for a 640x480x16 framebuffer. To use it, have +a kernel with a framebuffer device (e.g. vesa fb) and add e.g. +vga=0311 to the kernel init parameters (e.g. in lilo.conf). + + +Configuration Parameters +------------------------ +The Framebuffer driver supports the following parameters in config +file: + +Width + Sets the horizontal size of the display. If this parameter is not + given, a default value of 320 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 240 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' + +Zoom + Determines if pixels should be drawn double sized. + Possible values: 0, 1 + diff --git a/docs/DRIVER.gu126x64D-K610A4 b/docs/DRIVER.gu126x64D-K610A4 new file mode 100644 index 0000000..903e21d --- /dev/null +++ b/docs/DRIVER.gu126x64D-K610A4 @@ -0,0 +1,111 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The GU126X64-K610A4 driver +--------------------------------------------------------------------- + +Description +----------- +The GU126X64-K610A4 driver supports Noritake GU126X64D-K610A4 VFD +display. + +The VFD is connected to a single PC parallel port. + +Wirings +------- +The GU126X64-K610A4 driver supports the following connections on a +parallel port: + + + printerport LCD other + ----------- ---------------- ------- + 5V (Con1.1) VCC (Power supply 5V) + ACK (10) MB (Con1.9) (Module Busy) + 0V (Con1.5) GND (Ground) + + GND (18) 0V (Con2.1) (Ground) + INIT (16) ENABLE (Con2.2) (ENABLE) + D0 (02) PA0 (Con2.3) (DataBit 0) + D1 (03) PA1 (Con2.4) (DataBit 1) + D2 (04) PA2 (Con2.5) (DataBit 2) + D3 (05) PA3 (Con2.6) (DataBit 3) + D4 (06) PA4 (Con2.7) (DataBit 4) + D5 (07) PA5 (Con2.8) (DataBit 5) + D6 (08) PA6 (Con2.9) (DataBit 6) + D7 (09) PA7 (Con2.10) (DataBit 7) + +The Display is configured to parallel port mode with "Clock Input" +to "Falling Edge". + +================================================================ + +Configuration Parameters +------------------------ +The GU126X64-K610A4 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 256 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' + +Brightness + Sets the brightness of your display's backlight. + Possible values: 0 <= x <= 100) + Default value: 100 + +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: 0 + +Debug + Prints debugging information of some methods of the driver. + (add the values of interest) + + 1: show a log at the start of a refresh + 2: show a log at the end of a refresh with timing information + 4: show the rows (8 pixel) refreshed + 8: show every commands/bytes sent to the display + 16: log every unsuccessful waiting for display acknowledge diff --git a/docs/DRIVER.gu140x32f b/docs/DRIVER.gu140x32f new file mode 100644 index 0000000..60748cf --- /dev/null +++ b/docs/DRIVER.gu140x32f @@ -0,0 +1,126 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The GU140X32F driver +--------------------------------------------------------------------- + +Description +----------- +The GU140X32F driver supports Noritake GU140x32-F7806 VFD displays. +The VFD is operating in its 8 bit-mode connected to a PC's parallel +port. + + +Wirings +------- +The GU140x32F driver supports the following connections on a parallel +port: + - Standard + - Windows + +Standard wiring: + + printerport LCD other + ----------- ---------- ---------- + GND (01) GND (Ground) + VCC (02) VCC (+5VDC 500mA) + NC (03) + nSTRB (01) RS (04) (Register Select) + nAUTO (14) RW (05) (Read/Write) + INIT (16) EN (06) (Chip Enable) + D0 (02) D0 (07) (Data Bit 0) + D1 (03) D1 (08) (Data Bit 1) + D2 (04) D2 (09) (Data Bit 2) + D3 (05) D3 (10) (Data Bit 3) + D4 (06) D4 (11) (Data Bit 4) + D5 (07) D5 (12) (Data Bit 5) + D6 (08) D6 (13) (Data Bit 6) + D7 (09) D7 (14) (Data Bit 7) + +Windows wiring: + + printerport LCD other + ----------- ---------- ---------- + GND (01) GND (Ground) + VCC (02) VCC (+5VDC 500mA) + NC (03) + INIT (16) RS (04) (Register Select) + nAUTO (14) RW (05) (Read/Write) + nSTRB (01) EN (06) (Chip Enable) + D0 (02) D0 (07) (Data Bit 0) + D1 (03) D1 (08) (Data Bit 1) + D2 (04) D2 (09) (Data Bit 2) + D3 (05) D3 (10) (Data Bit 3) + D4 (06) D4 (11) (Data Bit 4) + D5 (07) D5 (12) (Data Bit 5) + D6 (08) D6 (13) (Data Bit 6) + D7 (09) D7 (14) (Data Bit 7) + +Note: The pin numbering may vary with other displays. + + +Configuration Parameters +------------------------ +The GU140x32F 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 140 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 32 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' + +Brightness + Sets the brightness of your display's backlight. + Possible values: 0 <= x <= 100) + Default value: 100 + +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 + +Wiring + Select the type of wiring your display is connected with. + Possible values: 'Standard', 'Windows' + Default value: 'Standard' + diff --git a/docs/DRIVER.gu256x64-372 b/docs/DRIVER.gu256x64-372 new file mode 100644 index 0000000..b840137 --- /dev/null +++ b/docs/DRIVER.gu256x64-372 @@ -0,0 +1,96 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The GU256X64-372 driver +--------------------------------------------------------------------- + +Description +----------- +The GU256X64-372 driver supports Noritake GU256x64-372 VFD displays. +The VFD is operating in its 8 bit-mode connected to a PC's parallel +port. + + +Wiring +------ +The GU256x64-372 driver supports the following connection on a parallel +port: + + printerport LCD other + ----------- ---------- ---------- + D0 (02) D0 (15) (Data Bit 0) + D1 (03) D1 (13) (Data Bit 1) + D2 (04) D2 (11) (Data Bit 2) + D3 (05) D3 (09) (Data Bit 3) + D4 (06) D4 (07) (Data Bit 4) + D5 (07) D5 (05) (Data Bit 5) + D6 (08) D6 (03) (Data Bit 6) + D7 (09) D7 (01) (Data Bit 7) + INIT (16) nWR (17) (Write) + nSEL (17) R/S (19) (Register Select, C/D) + GND (18) nRD (21) (Read) + GND (18) CSS (23) (Chip Select) + GND (18) GND (02) (Ground) + + +Configuration Parameters +------------------------ +The GU256x64-372 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 256 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' + +Brightness + Sets the brightness of your display's backlight. + Possible values: 0 <= x <= 100) + Default value: 100 + +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 + diff --git a/docs/DRIVER.gu256x64-3900 b/docs/DRIVER.gu256x64-3900 new file mode 100644 index 0000000..44bf4d1 --- /dev/null +++ b/docs/DRIVER.gu256x64-3900 @@ -0,0 +1,176 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The GU256X64-3900 driver +--------------------------------------------------------------------- + +Description +----------- +The GU256X64-3900 driver supports Noritake GU256X64-3900 VFD displays. +The VFD is either operating in 8 bit-mode connected to a single PC +parallel port or in serial mode connected to a single PC serial port. + + +Wirings +------- +The GU256X64-3900 driver supports the following connections on a +parallel port: + - Standard + - Satyr + +Standard wiring: + + printerport LCD other + ----------- ---------- ---------- + D0 (02) DB0 (08) (DataBit 0) + D1 (03) DB1 (07) (DataBit 1) + D2 (04) DB2 (06) (DataBit 2) + D3 (05) DB3 (05) (DataBit 3) + D4 (06) DB4 (04) (DataBit 4) + D5 (07) DB5 (03) (DataBit 5) + D6 (08) DB6 (02) (DataBit 6) + D7 (09) DB7 (01) (DataBit 7) + ACK (10) RDY (12) (Display Ready) + INIT (16) nWR (10) (Write) + GND (18) GND (09) GND (Ground) + GND (19) GND (11) GND (Ground) + GND (20) GND (13) GND (Ground) + GND (21) GND (14) GND (Ground) + VCC (15) VCC (Power supply 5V) + VCC (16) VCC (Power supply 5V) + +Satyr Wiring: + + printerport LCD other + ----------- ---------- ---------- + nSTRB (01) nWR (10) (Write) + D0 (02) DB0 (08) (DataBit 0) + D1 (03) DB1 (07) (DataBit 1) + D2 (04) DB2 (06) (DataBit 2) + D3 (05) DB3 (05) (DataBit 3) + D4 (06) DB4 (04) (DataBit 4) + D5 (07) DB5 (03) (DataBit 5) + D6 (08) DB6 (02) (DataBit 6) + D7 (09) DB7 (01) (DataBit 7) + BUSY (11) RDY (12) (Display Ready) + GND (18) GND (09) GND (Ground) + GND (19) GND (11) GND (Ground) + GND (20) GND (13) GND (Ground) + GND (21) GND (14) GND (Ground) + VCC (15) VCC (Power supply 5V) + VCC (16) VCC (Power supply 5V) + +Note: The pin numbering may vary with other displays. + + +The GU256X64-3900 driver supports the following connection on a +serial port: + + serialport LCD other + ---------- ---------- ---------- + DCD (01) DTR (02) + RxD (02) TxD (04) + TxD (03) RxD (01) + DTR (04) DSR (03) + GND (05) GND (07) GND (Ground) + DSR (06) DTR (02) + VCC (06) VCC (Power supply 5V) + +Note: The pin numbering may vary with other displays. + +On display switches: + SW No. Function Default + ------ -------- ------- + 1 Display address select Off + 2 Display address select Off + 3 Display address select Off + 4 Display address select Off + 5 Baud rate select Off + 6 Command mode select Off switch DMA On/Off + 7 Operating mode select Off + 8 Protocol Select Off + +Serial access to GU256X64C-3xx0 is nearly as fast as normal parallel +access but doesn't create the high system load of the parallel +approach. So for me serial access is preferred over normal parallel +mode. Even better is the DMA parallel mode. For DMA mode you have to +switch SW6 on the display to ON. + + +Configuration Parameters +------------------------ +The GU256X64-3900 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 256 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' + +Brightness + Sets the brightness of your display's backlight. + Possible values: 0 <= x <= 100) + Default value: 100 + +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 + +Wiring + Select the type of wiring your display is connected with. + Possible values: 'Standard', 'Satyr' + Default value: 'Standard' + +Interface + Select the interface your display is connnected to. + Possible values: 'Parallel', 'Serial' + Default value: 'Parallel' + +DMA + Enables/disables the usage of the controller's DMA mode which + increases writing speed. This only works in parallel interface mode. + Possible values: 'yes', 'no' + Default value: 'yes' + diff --git a/docs/DRIVER.hd61830 b/docs/DRIVER.hd61830 new file mode 100644 index 0000000..8e23420 --- /dev/null +++ b/docs/DRIVER.hd61830 @@ -0,0 +1,96 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The HD61830 driver +--------------------------------------------------------------------- + +Description +----------- +The HD61830 driver supports LC displays that use the Hitachi HD61830 +controller, connected to the parallel port of your PC. + + +Wirings +------- +The HD61830 driver supports the following connection on a parallel +port: + + printerport LCD other + ----------- ---------- ---------- + GND (18) GND (01) GND (Ground) + VDD (02) +5V (V Controller) + V0 (03) +5V..-15V (Contrast) + INIT (16) RS (04) (Register Select) + nAUTO (14) R/W (05) (Read 1/Write 0) + 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) + nCS (15) GND (Chip Select) + nRES (16) +5V (Reset) + VEE (17) -12V (V LCD) + nDO (18) (not connected) + +Note: The pin numbering may vary with other displays. + + +Configuration Parameters +------------------------ +The HD61830 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 240 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 128 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 + diff --git a/docs/DRIVER.image b/docs/DRIVER.image new file mode 100644 index 0000000..8da1ffd --- /dev/null +++ b/docs/DRIVER.image @@ -0,0 +1,36 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The Image driver +--------------------------------------------------------------------- + +Description +----------- +The Image driver writes image sequences in PBM (Portable Bit Map) +format showing the output that you would normally see on a LCD e.g. +from the graphlcd plugin. + + +Configuration Parameters +------------------------ +The Image driver supports the following parameters in config file: + +Width + Sets the horizontal size of the display. If this parameter is not + given, a default value of 240 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 128 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' + 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 + diff --git a/docs/DRIVER.noritake800 b/docs/DRIVER.noritake800 new file mode 100644 index 0000000..1962900 --- /dev/null +++ b/docs/DRIVER.noritake800 @@ -0,0 +1,115 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The Noritake 800(A) series driver +--------------------------------------------------------------------- + +Description +----------- +The Noritake 800(A) series driver supports following VFD displays manufactured +by Noritake (see http://www.noritake-itron.com on the link "Medium 0.6 dot"): + - GU128X64-800A; + - GU256X32-800A; + - GU128X32-800A; + - GU160X16-800A; + - GU160X32-800A; + - GU192X16-800A. + +Wirings +------- +The VFD should be connected to a parallel port of the PC + +printer port LIQUIDMP3 MZ other? +--------------------------------------------- + +Data lines D0...D7 connected straight in all wirings + +Strobe (1) CSS (23) WR (17) +Linefeed (14) RD (21) RD (21) +Init (16) WR (17) CSS (23) +Select (17) C/D (19) C/D (19) + +Printer port pins 18 .... 25 connected to GND; +VFD *ONLY EVEN* pins 2 .... 24 connected to GND +Everything else is *NOT CONNECTED* + +Further wirings might work and then for sure very easyly added to the code. +Just extend N800LptWiringMask(..) accordingly. This method is called in a +loop over all 16 (4 wires for now) possibilities in the constructor, so the +results are cached for the actual writes to the LPT control port, very +similar to ReverseBits(..) for data. + +The driver should also work for "WIRING_MZ", just report if there are +problems. +Feel free to add support for "Parallel #2 Interface" or "Serial interface". + +Tested only on my own GU128x64-800(A) so far, just with the default 8-bit +mode parallel wiring (referred as WIRING_LIQUIDMP3 or "0" in this code, or +"Parallel #1 Interface"in the data sheet). I can't actually test the other +wiring (as the display is already mounted in my HTPC, and the cable soldered), +or even the other modes from the datasheet ("Parallel #2 Interface", or +"Serial interface"), for those, my display lacks the necessary jumpers on +it's PCB) + + +Configuration Parameters +------------------------ +The Noritake 800(A) series 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 256 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' + +Brightness + Sets the brightness of your display's backlight. + Possible values: 0 <= x <= 100) + Default value: 100 + +AdjustTiming ---> not used in this driver (if there are problems, please report) + 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 ---> not used in this driver (if there are problems, please report) + 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 + diff --git a/docs/DRIVER.sed1330 b/docs/DRIVER.sed1330 new file mode 100644 index 0000000..2346cc5 --- /dev/null +++ b/docs/DRIVER.sed1330 @@ -0,0 +1,223 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The SED1330 driver +--------------------------------------------------------------------- + +Description +----------- +The SED1330 driver supports LC displays that use the Epson +SED1330/1335 controller, connected to the parallel port of your PC. + + +Wirings +------- +The SED1330 driver supports the following connections on a parallel +port: + - Original + - PowerLCD + - LCDProc + - Tweakers + - YASEDW + +Original wiring: + + printerport LCD other function in 6800 mode 8080 mode + ----------- ---------- ---------- --------------------- ----------- + /RES (01) +5V /RES (Reset) + nSTRB (01) /RD (02) E (Enable) /RD (Read) + nAUTO (14) /WR (03) R/W (Read/Write) /WR (Write) + SEL2 (04) GND Interface select 2 + SEL1 (05) +5V Interface select 1 + nSEL (17) /CS (06) GND /CS (Chip select) + INIT (16) A0 (07) A0 (Access type) + D0 (02) DB0 (08) D0 (Data bus 0) + D1 (03) DB1 (09) D1 (Data bus 1) + D2 (04) DB2 (10) D2 (Data bus 2) + D3 (05) DB3 (11) D3 (Data bus 3) + D4 (06) DB4 (12) D4 (Data bus 4) + D5 (07) DB5 (13) D5 (Data bus 5) + D6 (08) DB6 (14) D6 (Data bus 6) + D7 (09) DB7 (15) D7 (Data bus 7) + VDD (16) +5V VDD (Logic power supply) + GND (18) VSS (17) GND GND (Ground) + V0 (18) +5V..-22V V0 (LCD contrast) + VLC (19) -22V VEE (LCD drive voltage) + FGND (20) GND Frame ground + +PowerLCD wiring: + + printerport LCD other function in 6800 mode 8080 mode + ----------- ---------- ---------- --------------------- ----------- + /RES (01) +5V /RES (Reset) + nSEL (17) /RD (02) E (Enable) /RD (Read) + nSTRB (01) /WR (03) R/W (Read/Write) /WR (Write) + SEL2 (04) GND Interface select 2 + SEL1 (05) +5V Interface select 1 + nAUTO (14) /CS (06) GND /CS (Chip select) + INIT (16) A0 (07) A0 (Access type) + D0 (02) DB0 (08) D0 (Data bus 0) + D1 (03) DB1 (09) D1 (Data bus 1) + D2 (04) DB2 (10) D2 (Data bus 2) + D3 (05) DB3 (11) D3 (Data bus 3) + D4 (06) DB4 (12) D4 (Data bus 4) + D5 (07) DB5 (13) D5 (Data bus 5) + D6 (08) DB6 (14) D6 (Data bus 6) + D7 (09) DB7 (15) D7 (Data bus 7) + VDD (16) +5V VDD (Logic power supply) + GND (18) VSS (17) GND GND (Ground) + V0 (18) +5V..-22V V0 (LCD contrast) + VLC (19) -22V VEE (LCD drive voltage) + FGND (20) GND Frame ground + +LCDProc wiring: + + printerport LCD other function in 6800 mode 8080 mode + ----------- ---------- ---------- --------------------- ----------- + /RES (01) +5V /RES (Reset) + INIT (16) /RD (02) E (Enable) /RD (Read) + nAUTO (14) /WR (03) R/W (Read/Write) /WR (Write) + SEL2 (04) GND Interface select 2 + SEL1 (05) +5V Interface select 1 + nSTRB (01) /CS (06) GND /CS (Chip select) + nSEL (17) A0 (07) A0 (Access type) + D0 (02) DB0 (08) D0 (Data bus 0) + D1 (03) DB1 (09) D1 (Data bus 1) + D2 (04) DB2 (10) D2 (Data bus 2) + D3 (05) DB3 (11) D3 (Data bus 3) + D4 (06) DB4 (12) D4 (Data bus 4) + D5 (07) DB5 (13) D5 (Data bus 5) + D6 (08) DB6 (14) D6 (Data bus 6) + D7 (09) DB7 (15) D7 (Data bus 7) + VDD (16) +5V VDD (Logic power supply) + GND (18) VSS (17) GND GND (Ground) + V0 (18) +5V..-22V V0 (LCD contrast) + VLC (19) -22V VEE (LCD drive voltage) + FGND (20) GND Frame ground + +Tweakers wiring: + + printerport LCD other function in 6800 mode 8080 mode + ----------- ---------- ---------- --------------------- ----------- + /RES (01) +5V /RES (Reset) + nAUTO (14) /RD (02) E (Enable) /RD (Read) + INIT (16) /WR (03) R/W (Read/Write) /WR (Write) + SEL2 (04) GND Interface select 2 + SEL1 (05) +5V Interface select 1 + nSTRB (01) /CS (06) GND /CS (Chip select) + nSEL (17) A0 (07) A0 (Access type) + D0 (02) DB0 (08) D0 (Data bus 0) + D1 (03) DB1 (09) D1 (Data bus 1) + D2 (04) DB2 (10) D2 (Data bus 2) + D3 (05) DB3 (11) D3 (Data bus 3) + D4 (06) DB4 (12) D4 (Data bus 4) + D5 (07) DB5 (13) D5 (Data bus 5) + D6 (08) DB6 (14) D6 (Data bus 6) + D7 (09) DB7 (15) D7 (Data bus 7) + VDD (16) +5V VDD (Logic power supply) + GND (18) VSS (17) GND GND (Ground) + V0 (18) +5V..-22V V0 (LCD contrast) + VLC (19) -22V VEE (LCD drive voltage) + FGND (20) GND Frame ground + +YASEDW wiring: + + printerport LCD other function in 6800 mode 8080 mode + ----------- ---------- ---------- --------------------- ----------- + /RES (01) +5V /RES (Reset) + INIT (16) /RD (02) E (Enable) /RD (Read) + nSTRB (01) /WR (03) R/W (Read/Write) /WR (Write) + SEL2 (04) GND Interface select 2 + SEL1 (05) +5V Interface select 1 + nSEL (17) /CS (06) GND /CS (Chip select) + nAUTO (14) A0 (07) A0 (Access type) + D0 (02) DB0 (08) D0 (Data bus 0) + D1 (03) DB1 (09) D1 (Data bus 1) + D2 (04) DB2 (10) D2 (Data bus 2) + D3 (05) DB3 (11) D3 (Data bus 3) + D4 (06) DB4 (12) D4 (Data bus 4) + D5 (07) DB5 (13) D5 (Data bus 5) + D6 (08) DB6 (14) D6 (Data bus 6) + D7 (09) DB7 (15) D7 (Data bus 7) + VDD (16) +5V VDD (Logic power supply) + GND (18) VSS (17) GND GND (Ground) + V0 (18) +5V..-22V V0 (LCD contrast) + VLC (19) -22V VEE (LCD drive voltage) + FGND (20) GND Frame ground + +Note: The pin numbering may vary with other displays. + +SEL1 on GND selects 8080 mode, SEL1 on VDD selects 6800 mode. + + +Configuration Parameters +------------------------ +The SED1330 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 320 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 240 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 + +Wiring + Select the type of wiring your display is connected with. + Possible values: 'Original', 'PowerLCD', 'LCDProc', 'Tweakers', + 'YASEDW' + Default value: 'Original' + +OscillatorFrequency + Select the frequency the oscillator on your LCD board uses in kHz. + Possible values: 1000 <= x <= 15000) + Default value: 9600 + +Interface + Select the interface mode your display is connected with. + Possible values: '6800', '8080' + Default value: '6800' + diff --git a/docs/DRIVER.sed1520 b/docs/DRIVER.sed1520 new file mode 100644 index 0000000..c4084fc --- /dev/null +++ b/docs/DRIVER.sed1520 @@ -0,0 +1,98 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The SED1520 driver +--------------------------------------------------------------------- + +Description +----------- +The SED1520 driver supports LC displays that use the Epson SED1520 +controller, connected to the parallel port of your PC. + + +Wirings +------- +The SED1520 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 -4V) + nSEL (17) R/S (04) (Register Select) + R/W (05) GND (Read/Write) + nSTRB (01) EN1 (06) (Enable Left) + 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) + INIT (16) EN2 (15) (Enable Right) + RESET (16) +5V (Controller Reset) + LED+ (17) +4V/150mA (Backlight with 6,4Ohm Resistor to +5V) + nAUTO (14) LED- (18) GND (Backlight GND [via BS170]) + + See also http://www.usblcd.de/lcdproc/sed1520-dip.php4 ... + +Note: The pin numbering may vary with other displays. + + +Configuration Parameters +------------------------ +The SED1520 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 120 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 32 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 + diff --git a/docs/DRIVER.serdisp b/docs/DRIVER.serdisp new file mode 100644 index 0000000..c3113d9 --- /dev/null +++ b/docs/DRIVER.serdisp @@ -0,0 +1,61 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The serdisp driver +--------------------------------------------------------------------- + +Description +----------- +The serdisp driver supports LC displays that are supported by +serdisplib (http://serdisplib.sourceforge.net). + + +Configuration Parameters +------------------------ +The serdisp driver supports the following parameters in config file: + +Controller + Select the controller your LCD uses named like in serdisplib. + Possible values: See README in serdisplib package + +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 according to the selected controller is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value according to the selected controller 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' + +Contrast + Sets the contrast of your display. + Possible values: 0 <= x <= 10 + Default value: 5 + +Backlight + Switches the backlight of your display on and off. + Possible values: 'yes', 'no' + Default value: 'yes' + diff --git a/docs/DRIVER.simlcd b/docs/DRIVER.simlcd new file mode 100644 index 0000000..90bc3cb --- /dev/null +++ b/docs/DRIVER.simlcd @@ -0,0 +1,36 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The SimLCD driver +--------------------------------------------------------------------- + +Description +----------- +The Image driver writes a file including the output that you would +normally see on a LCD e.g. from the graphlcd plugin. You can use the +SimLCD tool to view this file. + + +Configuration Parameters +------------------------ +The SimLCD driver supports the following parameters in config file: + +Width + Sets the horizontal size of the display. If this parameter is not + given, a default value of 240 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 128 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' + diff --git a/docs/DRIVER.t6963c b/docs/DRIVER.t6963c new file mode 100644 index 0000000..33c61e6 --- /dev/null +++ b/docs/DRIVER.t6963c @@ -0,0 +1,159 @@ +--------------------------------------------------------------------- +GraphLCD driver library + +The T6963C driver +--------------------------------------------------------------------- + +Description +----------- +The T6963C driver supports LC displays that use the Toshiba T6963C +controller, connected to the parallel port of your PC. + + +Wirings +------- +The T6963C driver supports the following connections on a parallel +port: + - Standard (used by LCDproc) + - Windows (used by many windows programs) + +Standard wiring: + + printerport LCD other + ----------- ---------- ---------- + GND (18) GND (01) GND (Ground) + nSTRB (01) WR (06) (Write) + nAUTO (14) CE (15) (Chip Enable) + INIT (16) C/D (04) (Command/Data) + nSEL (17) RD (05) (Read) + D0 (02) D0 (07) (Data Bit 0) + D1 (03) D1 (08) (Data Bit 1) + D2 (04) D2 (09) (Data Bit 2) + D3 (05) D3 (10) (Data Bit 3) + D4 (06) D4 (11) (Data Bit 4) + D5 (07) D5 (12) (Data Bit 5) + D6 (08) D6 (13) (Data Bit 6) + D7 (09) D7 (14) (Data Bit 7) + +Windows wiring: + + printerport LCD other + ----------- ---------- ---------- + GND (18) GND (01) GND (Ground) + nSTRB (01) CE (15) (Chip Enable) + nAUTO (14) RD (05) (Read) + INIT (16) WR (06) (Write) + nSEL (17) C/D (04) (Command/Data) + D0 (02) D0 (07) (Data Bit 0) + D1 (03) D1 (08) (Data Bit 1) + D2 (04) D2 (09) (Data Bit 2) + D3 (05) D3 (10) (Data Bit 3) + D4 (06) D4 (11) (Data Bit 4) + D5 (07) D5 (12) (Data Bit 5) + D6 (08) D6 (13) (Data Bit 6) + D7 (09) D7 (14) (Data Bit 7) + +Serial wiring using a industry version with a serial to parallel +converter: + + printerport LCD + ----------- ---------- + nAuto (14) nCE (03) + nSTRB (01) nSCK (07) + INIT (16) nC/D (08) + INIT (16) nSDAT (08) + GND (25) GND (01) + + +Note: The pin numbering may vary with other displays. + +The LCD must operate in the 6x8 or 8x8 font mode. Usually, there is a +pin to choose 6x8 or 8x8 font mode. + +There are Displays that have a pin to select the number of characters +per line. In that case, you have to select (width (in pixels) / 6) or +(width (in pixels) / 8) characters per line. + +Attention: You have to tie these pins to +5V or GND. Don't leave them +open circuit or you will get unpredictable results. + +Because the T6963 driver reads the status of the display, it might be +neccessary to enable the bidirectional mode in the BIOS and to enable +bidirectional mode in the Linux kernel: + <*> Parallel port support + <*> PC-style hardware + [*] IEEE 1284 transfer modes + + +Configuration Parameters +------------------------ +The T6963C 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 240 pixels is used. + +Height + Sets the vertical size of the display. If this parameter is not + given, a default value of 128 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' + +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 + +Wiring + Select the type of wiring your display is connected with. + Possible values: 'Standard', 'Windows' + Default value: 'Standard' + +FontSelect + Select the font width your display uses for text mode. In most cases + this is selectable through one of the pins of your LCD board + Possible values: '6', '8' + Default value: '6' + +AutoMode + Enables or disables the usage of T6963C's auto mode which doubles + writing speed when enabled. + Possible values: 'yes', 'no' + Default value: 'yes' + +StatusCheck + Enables or disables the usage of T6963C's status check. When using a + shielded cable for connecting your display, the disabling may be + possible. This results in doubling the speed of writing data to the + LCD. + Possible values: 'yes', 'no' + Default value: 'yes' + diff --git a/docs/README.convpic b/docs/README.convpic new file mode 100644 index 0000000..5ab1d45 --- /dev/null +++ b/docs/README.convpic @@ -0,0 +1,42 @@ +This is the README of the crtfont tool, which is part of the GraphLCD +base package. + +written by Carsten Siebholz <c.siebholz AT t-online.de> + Andreas Brachold <vdr04 AT deltab de> + +See the file COPYING for license information. + + +Description: +------------ +convpic is a program to convert images to an own simple format (*.glcd) +that is used by the GraphLCD graphics library. + + +Installation and Configuration: +------------------------------- +see the file README in the base package's root directory. + + +Using convpic: +-------------- +Usage: convpic [-n] [-d x] -i infile [more files] -o outfile + + -n --invert inverts the output (default: no) + -i --infile specifies the name of the input file + -o --outfile specifies the name of the output file + -d --delay specifies the delay delay between multiple images + +supported formats: + TIFF: file is an uncompressed RGB-encoded 2-color TIFF + BMP : file is an uncompressed RGB-encoded 2-color Windows BMP + ANI : file is an uncompressed multi-frame from tuxbox-aniplay + GLCD: file is the own format used by the GraphLCD graphics library + +example: convpic -i vdr-logo.bmp -o vdr-logo.glcd + + +Known Problems: +--------------- + Export of TIFF isn't supported. + diff --git a/docs/README.crtfont b/docs/README.crtfont new file mode 100644 index 0000000..03bf485 --- /dev/null +++ b/docs/README.crtfont @@ -0,0 +1,61 @@ +This is the README of the crtfont tool, which is part of the GraphLCD +base package. + +written by Andreas Regel (andreas.regel AT powarman.de) + +based on crtfont from the graphlcd plugin for the Video Disc Recorder +written by Carsten Siebholz (c.siebholz AT t-online.de) + +See the file COPYING for license information. + + +Description: +------------ +crtfont is a program to create fonts for the GraphLCD graphics library. + + +Installation and Configuration: +------------------------------- +see the file README in the base package's root directory. + + +Using crtfont: +-------------- +To create a font, 2 source files are required: +- an image, that contains the characters as a bitmap. This image might + be in: + - Portable Bit Map (PBM) format. +- a description file (*.desc), that contains informations about the + positions of each character in the image. + The format of the description file: + - The first line contains the version of the description file format: + version:1 + - The next lines contain the font attributes in the format + <attribute>:<value>, one attribute per line. Possible attributes + are: + fontheight: the total height of the font + fontascent: the vertical distance from the horizontal baseline to + the highest character coordinate. + lineheight: the baseline-to-baseline distance + spacebetween: additional space between characters in a text + spacewidth: the width of the space character. If this value is + greater than zero, all characters will be compressed + horizontally to their active pixels. + - All other lines define the characters and their positions in the + image. The syntax is like: + PosX_1 Char_1 PosX_2 Char_2 PosX_3 ... PosX_n Char_n EndX + where PosX_x specifies the horizontal position of the leftmost + pixel of the character. Char_x might be the character itself + (A, B, ...) or it's decimal ASCII value (65, 66, ...) + +Usage: crtfont -f <format> -b <bmpfile> -d <descfile> -o <outfile> + + -f --format specifies the format of the bitmap. Possible values + are: + PBM: file is an Portable Bit Map + -b --bmpfile specifies the name of the bitmap file (*.pbm) + -d --descfile specifies the name of the description file (*.desc) + -o --outfile specifies the name of the output file (*.fnt) + + example: crtfont -f PBM -b f12.pbm -d f12.desc -o f12.fnt + diff --git a/docs/README.showpic b/docs/README.showpic new file mode 100644 index 0000000..5ea6184 --- /dev/null +++ b/docs/README.showpic @@ -0,0 +1,38 @@ +This is the README of the showpic tool, which is part of the GraphLCD +base package. + +written by Andreas Regel (andreas.regel AT powarman.de) + +based on showpic from the graphlcd plugin for the Video Disc Recorder +written by Carsten Siebholz (c.siebholz AT t-online.de) + +See the file COPYING for license information. + + +Description: +------------ +showpic is a program to show an image on a graphical LC Display. It +support all controller the GraphLCD driver library supports. + +The images must be in an own format (*.glcd), which can be created with +the convpic tool. + + +Using showpic: +-------------- + showpic [-c CONFIGFILE] [-d DISPLAY] [-s SLEEP] [-uie] file [more files] + + -c --config specifies the location of the config file + (default: /etc/graphlcd.conf) + -d --display specifies the output display + (default: the first one in config file) + -u --upsidedown rotates the output by 180 degrees (default: no) + -i --invert inverts the output (default: no) + -e --endless show all images in endless loop (default: no) + -s --sleep set sleeptime between two images [ms] + -b --brightness set brightness for display if driver support it + (default: config file value) + +examples: showpic -c /etc/graphlcd.conf vdr-logo.glcd + showpic -c /etc/graphlcd.conf -d LCD_T6963 -u -i vdr-logo.glcd + diff --git a/docs/README.showtext b/docs/README.showtext new file mode 100644 index 0000000..2136322 --- /dev/null +++ b/docs/README.showtext @@ -0,0 +1,35 @@ +This is the README of the showtext tool, which is part of the GraphLCD +base package. + +written by Andreas Regel (andreas.regel AT powarman.de) + +See the file COPYING for license information. + + +Description: +------------ +showtext is a program to show a user defined text with a user defined +font on a graphical LC Display. It supports all controllers the GraphLCD +driver library supports. + +The font must be in a special format (*.fnt), which can be created with +the crtfont tool. + + +Using showtext: +-------------- + showtext [-c CONFIGFILE] [-d DISPLAY] [-f FONT] [-x XPOS] [-y YPOS] [-uib] text [more text] + + -c --config specifies the location of the config file + (default: /etc/graphlcd.conf) + -d --display specifies the output display + (default: the first one in config file) + -f --font specifies the font that is used for the text output + -x --xpos specifies the x-position where the text starts + -y --ypos specifies the y-position where the text starts + -u --upsidedown rotates the output by 180 degrees (default: no) + -i --invert inverts the output (default: no) + -b --brightness set brightness for display if driver support it [%] + (default: config file value) + + example: showtext -c /etc/graphlcd.conf -f f17.fnt "Line1" "Line2" |