LCDInfo version 0.02
********************

What does it do?
****************
This is a small program to control a Hitachi HD44780 based LCD display with the parallel port.
At the moment all it does is printing kernel and version (Only GNU/Linux supported at the moment!) and the computer's uptime.

How do i use it?
****************
Compile the package with the command:

gcc -O2 lcdinfo.c iolcd.c uptime.c systeminfo.c

You will then need to be root to start it. Also, if you use some other printer port you need to change the value of BASE in the source file, default is 0x378.
Then connect the lcd to the parallel port in the following manner:

LCD			LPT
1 (VSS)			25 (GND)
2 (VDD)			1 (You might need some more juice to power it, then use a modified floppy connector or something, the red cable should be +5V)
3 (VLC)			25 (GND) (The correct procedure would be to connect a potentiometer (is that the correct word in english?) to VLC and then between VSS ans VDD, this way you can change contrast, ive found that connecting it to GND works well though)
4 (RS)			14
5 (RW)			17
6 (E)			16
7 (D0)			2
|			|
|			|
14 (D7)			9

(Oops warning! Consult your data-sheet from your LCD manufacturer, the above is true for my Seiko display but it _might_ differ from other manufacturers!)

After that is done, just start the lcdinfo program and you will have a LCD display which shows something like this:

** Linux - 2.2.7 **
Up:01y 082d 16:03:31

and counting...

What will the next version do?
******************************
Who knows? I will develop this as i learn more C and i really have to wait until i get a real 4x20 character display, now i have a 2x40. Since im new to C i will probably hardcode size and other things for the time being, im not sure when i will make it configurable and with a real Makefile etc (If you know how autoconf etc. works and want to help me out with it i'd be really happy about it though).

Copyright, Dont blame me(tm) etc.
*********************************
LCDInfo is copyrighted by Jan Svenungson (jan.svenungson<at>linux.nu) and is released under the GNU GPL (see the file COPYING for more info).
If you use this and your computer crashes or catches fire or whatever, Dont blame me. This software comes without any warranty.

I've found a nasty bug, you want a patch?
*****************************************
Sure! I would love getting any positive or negative feedback. Patches with detailed comments (so i can understand the changes, as i said, i'm new to C) are really appreciated! You can reach me at the above e-mail adress or at UIN 6581164.

Your program does not do what i want to, can you fix it?
********************************************************
Maybe, but first check out LCDProc (http://lcdproc.omnipotent.net), its been around for quite a while and support many more LCDs than LCDInfo does and also have more features (a lcdserver which gets info from separate clients which seems neat to me).
If you still want to impress me with a really cool feature please do so, if i find it usable and i can code it i probably will.
