This is the README file for the Crystalfontz display driver for lcd4linux

This driver supports the 632/634 LCD-Modules from Crystalfontz, but should
work for the 626 and 636 modules too. The 634 is a 20x4 character display,
while the others only display 16x2. I've written the driver using a
634 module.

The driver understands the following configuration parameters:

Display:    any of 626, 632, 634 and 636.

Port:	    serial device (i.e. ttyS0) the LCD module is connnected
            to.

Speed:      any of 1200, 2400, 9600 and 19200. By default, the driver
            uses 9600 which is the speed the LCD modules are hardwired
            at. If your module works at a different speed than 9600,
            use this parameter. Otherwise omit it (i.e. omit it when
            you have a 634).

Backlight:  controls the backlight brightness. Quote from 634.pdf from
            the Crystalfonts-Webserver[1]: "0=OFF 100=ON. Intermediate
            values vary the brightness. There are a total of 25 possible
            brightness levels."

Contrast:   controls the contrast settings. Quote[1]: "0=very light,
            100 = very dark. 50 is typical. There are a total of 25
            possible contrast levels."


Known bugs:
When you draw a bar over a previously drawn textfield, the white portion
the bar will not erase the text. Only when the black portion of the bar
has reached the full bar length, the text will be erased. I did not bother
to implement that, since in lcd4linux, the whole display-screen is erased
prior to switching to a different 'screen'. Implementing this feature would
just add to program-overhead. Yes, you guessed it: I did not use the "bar"-
command that comes with the LCD-module, but wrote my own instead.
lcd4linux also supports "split-" or "dual-bars" (two bars in one segment),
which are not available on the Crystalfontz firmware.

  [1] http://www.crystalfontz.com

ion value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/lcd4linux.git/log/?id=f54facba617e2c6b22714e581e43fa8d0e45c4d9&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/debian?id=f54facba617e2c6b22714e581e43fa8d0e45c4d9&amp;showmsg=1&amp;follow=1'>debian</a> (<a href='/lcd4linux.git/log/debian?id=f54facba617e2c6b22714e581e43fa8d0e45c4d9&amp;showmsg=1'>unfollow</a>)</div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/lcd4linux.git/log/debian?id=f54facba617e2c6b22714e581e43fa8d0e45c4d9&amp;follow=1'>Collapse</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr class='logheader'><td><span title='2004-03-08 16:26:26 +0000'>2004-03-08</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/widget_text.c?id=96f97ca49625e33381abca737f13a5cace139f63&amp;follow=1'>[lcd4linux @ 2004-03-08 16:26:26 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-14</span>/<span class='insertions'>+46</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
re-introduced \nnn (octal) characters in strings
text widgets can have a 'update' speed of 0 which means 'never'
(may be used for static content)

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@389 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-08 04:33:08 +0000'>2004-03-08</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/evaluator.c?id=82c5b766363e22d0a416e91610617a60fca0fff2&amp;follow=1'>[lcd4linux @ 2004-03-08 04:33:08 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-21</span>/<span class='insertions'>+41</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
string concatenation fixed

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@388 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-06 20:31:16 +0000'>2004-03-06</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/widget_text.h?id=c008748638679f10746c70a7f677c0e8906ffa9e&amp;follow=1'>[lcd4linux @ 2004-03-06 20:31:16 by reinelt]</a></td><td>reinelt</td><td>12</td><td><span class='deletions'>-640</span>/<span class='insertions'>+946</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Complete rewrite of the evaluator to get rid of the code
from mark Morley (because of license issues).
The new Evaluator does a pre-compile of expressions, and
stores them in trees. Therefore it should be reasonable faster...

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@387 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-03 08:40:07 +0000'>2004-03-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/hash.c?id=2f4f59ba2e28ee38f721f09ab6756fd4575b3f78&amp;follow=1'>[lcd4linux @ 2004-03-03 08:40:07 by hejl]</a></td><td>hejl</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Fixed memory leak in hash_get_regex

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@386 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-03 04:44:16 +0000'>2004-03-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/widget_icon.c?id=b9a217e0dc5906e07b9f1e4674e9b797b6dd9b46&amp;follow=1'>[lcd4linux @ 2004-03-03 04:44:16 by reinelt]</a></td><td>reinelt</td><td>13</td><td><span class='deletions'>-63</span>/<span class='insertions'>+96</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
changes (cosmetics?) to the big patch from Martin
hash patch un-applied

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@385 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-03 03:47:04 +0000'>2004-03-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/wifi.c?id=9ef4282e9e32e857f4d0cac9df6d58f2cba159f4&amp;follow=1'>[lcd4linux @ 2004-03-03 03:47:04 by reinelt]</a></td><td>reinelt</td><td>46</td><td><span class='deletions'>-167</span>/<span class='insertions'>+770</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
big patch from Martin Hejl:
- use qprintf() where appropriate
- save CPU cycles on gettimeofday()
- add quit() functions to free allocated memory
- fixed lots of memory leaks

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@384 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-03 03:41:02 +0000'>2004-03-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_Crystalfontz.c?id=d0b39b590e56b191394cfcb6b8690de0fbd87957&amp;follow=1'>[lcd4linux @ 2004-03-03 03:41:02 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-9</span>/<span class='insertions'>+11</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Crystalfontz Contrast issue fixed

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@383 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-03-01 04:29:51 +0000'>2004-03-01</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=bfd7907defaef0916e1748bbdcf4a2fd6b8fc936&amp;follow=1'>[lcd4linux @ 2004-03-01 04:29:51 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-24</span>/<span class='insertions'>+55</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
cfg_number() returns -1 on error, 0 if value not found (but default val used),
 and 1 if value was used from the configuration.
HD44780 driver adopted to new cfg_number()
Crystalfontz 631 driver nearly finished

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@382 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-29 17:09:54 +0000'>2004-02-29</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/libtool?id=79fa81a94da20c84d6010b694f97af422a4bde26&amp;follow=1'>[lcd4linux @ 2004-02-29 17:09:53 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-15</span>/<span class='insertions'>+226</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
ChangeLog updated
Version number bumped to 0.10.0

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@381 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-29 14:30:59 +0000'>2004-02-29</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_generic_graphic.c?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;follow=1'>[lcd4linux @ 2004-02-29 14:30:59 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+10</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
icon visibility fix for generic graphics from Xavier

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@380 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-27 07:06:26 +0000'>2004-02-27</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/qprintf.h?id=485a26f6e3e2e84d7f9b8279fa6d7f440ea50a8b&amp;follow=1'>[lcd4linux @ 2004-02-27 07:06:24 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-11</span>/<span class='insertions'>+200</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
new function 'qprintf()' (simple but quick snprintf() replacement)

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@379 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-27 06:07:55 +0000'>2004-02-27</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/hash.h?id=af9193af58b39bf31ee8beabfac620b274da8b1c&amp;follow=1'>[lcd4linux @ 2004-02-27 06:07:55 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-21</span>/<span class='insertions'>+40</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
hash improvements from Martin

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@378 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-26 21:42:45 +0000'>2004-02-26</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/evaluator.c?id=3037be8a1e09d27d6150027b28e48738dbac0db1&amp;follow=1'>[lcd4linux @ 2004-02-26 21:42:45 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+12</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
memory leak fixes from Martin

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@377 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>