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

 value='1'/><select name='qt'>
<option value='grep'>log msg</option>
<option 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=733a1141da1f25e986ee423d67f5342673102b30&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/lcd4linux.kdelnk?id=733a1141da1f25e986ee423d67f5342673102b30&amp;showmsg=1&amp;follow=1'>lcd4linux.kdelnk</a> (<a href='/lcd4linux.git/log/lcd4linux.kdelnk?id=733a1141da1f25e986ee423d67f5342673102b30&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/lcd4linux.kdelnk?id=733a1141da1f25e986ee423d67f5342673102b30&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='2005-04-24 05:27:09 +0000'>2005-04-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=cc9c2bd2432848924d60846a552dac1d0daf3fa6&amp;follow=1'>[lcd4linux @ 2005-04-24 05:27:09 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-7</span>/<span class='insertions'>+38</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Trefon Backlight added

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-24 04:41:28 +0000'>2005-04-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/ChangeLog?id=d0c29c65a8eecfd49ab97af1b85258bdff9185b7&amp;follow=1'>[lcd4linux @ 2005-04-24 04:41:28 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+68</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Changelog updated

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-24 04:33:46 +0000'>2005-04-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=62c2b871ae20d093190f7a64b1f13661c7a42222&amp;follow=1'>[lcd4linux @ 2005-04-24 04:33:46 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-10</span>/<span class='insertions'>+444</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
driver for TREFON USB LCD's added

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-20 05:49:21 +0000'>2005-04-20</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_SimpleLCD.c?id=024363f46c5257d74e90b4bd737772b70049f4da&amp;follow=1'>[lcd4linux @ 2005-04-20 05:49:21 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-44</span>/<span class='insertions'>+125</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Changed the code to add some VT100-compatible control sequences (see the comments above).
A configfile boolean option 'VT100_Support' (default to 1) indicate if the display in
used support these control-sequences or not.

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-09 07:36:42 +0000'>2005-04-09</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_LCDLinux.h?id=1f139b5afd67194f363bb4f92b2300c2deed629e&amp;follow=1'>[lcd4linux @ 2005-04-09 07:36:42 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-17</span>/<span class='insertions'>+99</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
updated LCD-Linux driver to version 0.8.8

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-05 06:57:41 +0000'>2005-04-05</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugins.m4?id=3b55000a09e59b2ee620e01b8dd4e383fe4b43dc&amp;follow=1'>[lcd4linux @ 2005-04-05 06:57:39 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-34</span>/<span class='insertions'>+34</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
AC_CHECK_HEADERS corrected

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-05 05:12:57 +0000'>2005-04-05</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=8621c074afa688d5019818bdf44c14cdf53f1aa6&amp;follow=1'>[lcd4linux @ 2005-04-05 05:12:48 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-407</span>/<span class='insertions'>+33</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
i2c patch from Paul (still does not work here :-(

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-05 04:46:06 +0000'>2005-04-05</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_math.c?id=add33a2a7f689611d2b76029a0d5597281f684bc&amp;follow=1'>[lcd4linux @ 2005-04-05 04:46:06 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+20</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
ceil/floor patch from Maxime

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-04 20:11:14 +0000'>2005-04-04</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_imon.c?id=c49672b6b89a02dd5ed9c5203b534f8bd6e07509&amp;follow=1'>[lcd4linux @ 2005-04-04 20:11:14 by nicowallmeier]</a></td><td>nicowallmeier</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
to be compatible with gcc 2.95

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-03 07:07:51 +0000'>2005-04-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugins.m4?id=118d85d597ffa77ca2d53b01c1dc5295f11c5f2c&amp;follow=1'>[lcd4linux @ 2005-04-03 07:07:43 by reinelt]</a></td><td>reinelt</td><td>8</td><td><span class='deletions'>-9</span>/<span class='insertions'>+152</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
added statfs plugin

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-02 05:28:58 +0000'>2005-04-02</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_USBLCD.c?id=a6a03faa860233ec2b2d13abbb14bd9661a61222&amp;follow=1'>[lcd4linux @ 2005-04-02 05:28:58 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-19</span>/<span class='insertions'>+27</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
fixed gcc4 warnings about signed/unsigned mismatches

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


</td></tr>
<tr class='logheader'><td><span title='2005-04-01 05:16:04 +0000'>2005-04-01</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_pop3.c?id=db07da0b72602a70c23ed10e4bface19ed029bc8&amp;follow=1'>[lcd4linux @ 2005-04-01 05:16:04 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-584</span>/<span class='insertions'>+694</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
moved plugin init stuff to a seperate function called on first use

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


</td></tr>
<tr class='logheader'><td><span title='2005-03-30 04:57:50 +0000'>2005-03-30</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_cfg.c?id=f650bc134e5e1db71498bd4504a98331a99993d2&amp;follow=1'>[lcd4linux @ 2005-03-30 04:57:50 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-23</span>/<span class='insertions'>+67</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Evaluator speedup: use bsearch for finding functions and variables

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


</td></tr>
<tr class='logheader'><td><span title='2005-03-28 22:29:23 +0000'>2005-03-28</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_HD44780.c?id=5985c204a32bd6b9f69646dbe6110ffa0c55651b&amp;follow=1'>[lcd4linux @ 2005-03-28 22:29:23 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-250</span>/<span class='insertions'>+346</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
HD44780 multiple displays patch from geronet

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


</td></tr>
<tr class='logheader'><td><span title='2005-03-28 19:39:23 +0000'>2005-03-28</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_generic_i2c.h?id=36b9cd6acd0607f0b9ae8b58ef74a12786faf938&amp;follow=1'>[lcd4linux @ 2005-03-28 19:39:14 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-256</span>/<span class='insertions'>+1147</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
HD44780/I2C patch from Luis merged (still does not work for me)

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


</td></tr>
<tr class='logheader'><td><span title='2005-03-25 15:44:43 +0000'>2005-03-25</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_HD44780.c?id=b6dd247d8ae45694367c16be7fae65f084a18961&amp;follow=1'>[lcd4linux @ 2005-03-25 15:44:43 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+5</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
HD44780 Backlight fixed (thanks to geronet)

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


</td></tr>
<tr class='logheader'><td><span title='2005-03-23 12:23:35 +0000'>2005-03-23</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_Crystalfontz.c?id=93f4190b076c528589fe1f32a10b4ce346e999fe&amp;follow=1'>[lcd4linux @ 2005-03-23 12:23:35 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-27</span>/<span class='insertions'>+32</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
fixed some signed/unsigned char mismatches in the Crystalfontz driver (ticket #12)

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


</td></tr>
<tr class='logheader'><td><span title='2005-02-24 07:07:55 +0000'>2005-02-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/ChangeLog?id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;follow=1'>[lcd4linux @ 2005-02-24 07:07:55 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+53</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
ChangeLog

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


</td></tr>
<tr class='logheader'><td><span title='2005-02-24 07:06:48 +0000'>2005-02-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=b8d041d37641f40b4a093fb0e712f6dbd12f662b&amp;follow=1'>[lcd4linux @ 2005-02-24 07:06:45 by reinelt]</a></td><td>reinelt</td><td>11</td><td><span class='deletions'>-28</span>/<span class='insertions'>+347</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
SimpleLCD driver added

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


</td></tr>
<tr class='logheader'><td><span title='2005-02-24 06:51:40 +0000'>2005-02-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_LCDLinux.c?id=865a7df05b49209d0551a4df87fceba434d3cb2c&amp;follow=1'>[lcd4linux @ 2005-02-24 06:51:40 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-4</span>/<span class='insertions'>+5</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
LCD-Linux driver GOTO_COST corrected

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-30 06:43:22 +0000'>2005-01-30</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=a086667aad27e4a615bf5f521a516ef533dd9618&amp;follow=1'>[lcd4linux @ 2005-01-30 06:43:22 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-69</span>/<span class='insertions'>+95</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
driver for LCD-Linux finished

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-29 09:30:56 +0000'>2005-01-29</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_HD44780.c?id=575f363d88d793449679641941bd42f5b50d3503&amp;follow=1'>[lcd4linux @ 2005-01-29 09:30:56 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-8</span>/<span class='insertions'>+11</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
minor HD44780 cleanups

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-22 22:57:57 +0000'>2005-01-22</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=620568e08f7e1e7be5d3be85643f821cdcca897b&amp;follow=1'>[lcd4linux @ 2005-01-22 22:57:57 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-47</span>/<span class='insertions'>+382</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
LCD-Linux driver added

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-22 12:44:41 +0000'>2005-01-22</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_MatrixOrbital.c?id=4b6f7fb1f11af97b369feb39aa4c4ac16252045a&amp;follow=1'>[lcd4linux @ 2005-01-22 12:44:41 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
MatrixOrbital backlight micro-fix

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-18 06:30:24 +0000'>2005-01-18</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/widget_text.h?id=ae6d2a0a265f41e9c9773d61dcf16da3653b674e&amp;follow=1'>[lcd4linux @ 2005-01-18 06:30:21 by reinelt]</a></td><td>reinelt</td><td>89</td><td><span class='deletions'>-261</span>/<span class='insertions'>+603</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
added (C) to all copyright statements

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-17 06:38:48 +0000'>2005-01-17</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_HD44780.c?id=1f29316bdf4df65aed92770d0c440e0984ef1086&amp;follow=1'>[lcd4linux @ 2005-01-17 06:38:48 by reinelt]</a></td><td>reinelt</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'>
info about backlight and brightness

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


</td></tr>
<tr class='logheader'><td><span title='2005-01-17 06:29:25 +0000'>2005-01-17</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=f25e145be4d7ebe0c3b6803acf8521d5b2d8b1a1&amp;follow=1'>[lcd4linux @ 2005-01-17 06:29:24 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-33</span>/<span class='insertions'>+85</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
added software-controlled backlight support to HD44780

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


</td></tr>