
5th Feb 2014
                                                        Version 0.8ANSI

lcdd - a user space driver for HD44780 based char. lcds 
       ANSI version - obeys a subset of ANSI terminal commands
       in so far as it can :-)  
       
This has been tested with 2 row, 16 and 20 col devices and 4 row 20 col
devices. Other 2 row devices should also work, as should 1 row devices too, 
but I have not tested these devices. Feedback on whether they do work 
would be appreciated.

Version 0.8ANSI introduced support for 4 row  by 20 col devices, where 
it is assumed that row 3 starts at the column after where row 1 ends:
and similarly row 4 starts at the col after row 2 ends.

For 2 row devices, row 1 starts at address 0 (0x00) and row 1 starts at 
64 (0x40). So for a 4 row by 20 col device, row 3 starts at address 20 
(0x14) and row 4 starts at 84 (0x54).

Initial ANSI code from a patch set from Yan Seiner  <yan@seiner.com>

This version works with an I2C connected MCP23017 16 I/O bit device
connected to an HD44780 LCD. Of course there are several ways these 
could be linked up. The jj_i2c version (header file lcdd_jji2c.h and
driver code lcddriver_jji2c.c and lcddriver_jji2c.h) works with my 
homemade MCP23017 breakout board - details at

  http://www.comp.leeds.ac.uk/jj/electronics/MCP23017_Breakout_Board.proj.html

I'm sure it would be easy to mod the code to work with the AdaFruit I2C LCD
that uses the MCP23017 too. 

  http://learn.adafruit.com/adafruit-16x2-character-lcd-plus-keypad-for-raspberry-pi

which has a warped way of connecting the MCP23017 outputs to the LCD 
(why oh why do the bit reversal!!).

The latest version of this program can be got from....

 http://www.comp.leeds.ac.uk/jj/linux/lcdd.tgz

It is provided under the terms of the GNU General Public License - see the
file COPYING for details.

Compiling
---------

To compile the correct version of the program link lcdd.h to the right
header file (edit and defaults in the header file), and link lcddriver.c 
and lcddriver.h to correct driver file, and then do 
 
  make lcdd

The man page is not done. There is info on the program in the file
lcdd.txt which explains the command line options.

The ts72x0 specific routines are in the file ts7200io.c with header file
ts7200io.h (only a prototype at moment). These routines can be used in other
programs. At the moment you'll have to read the source files for more info.
Sorry.

Jim Jackson
<jj@franjam.org.uk>
http://www.comp.leeds.ac.uk/jj
http://www.comp.leeds.ac.uk/jj/linux/arm-sbc.html
http://www.comp.leeds.ac.uk/jj/electronics/MCP23017_Breakout_Board.proj.html


