#
# $Id: README.Drivers,v 1.4 2001/03/09 13:08:11 ltoetsch Exp $
#

How to write new display drivers for lcd4linux

If you plan to write a new display driver for lcd4linux, you should follow
this guidelines:

* use Skeleton.c as a start point.
  You might also have a look at Text.c

* create a new sourcefile <drivername>.c and add it to the bottom of
  Makefile.am

* add an entry to configure.in

* there's no need for a <drivername>.h

* create one (or more) unique display names (your driver will be selected by
  this name in the 'Display'-line of lcd4linux.conf).

* include "display.h" in your driver, to get the LCD structure and various 
  BAR_ definitions

* include "cfg.h" if you need to access settings in the config file.

* create a LCD table at the bottom of your driver, and fill it with the
  appropriate values. Take care that you specify the correct bar capabilities
  of your display or driver:

  BAR_L:  horizontal bars headed left
  BAR_R:  horizontal bars headed right
  BAR_H2: driver supports horizontal dual-bars
  BAR_U:  vertical bars bottom-up
  BAR_D:  vertical bars top-down
  BAR_V2: driver supports vertical dual-bars

* edit display.c and create a reference to your LCD table:

     external LCD YourDriver[];

* extend the FAMILY table in display.c with your driver:

     FAMILY Driver[] = {
       { "Skeleton",      Skeleton },
       { "MatrixOrbital", MatrixOrbital },
       { "YourFamily",    YourDriver },
       { "" }
     };

* write the correspondig init(), clear(), put(), bar(), quit() and
  flush()-functions. There's no need to use a framebuffer and display its
  contents with the flush()- call (as in MatrixOrbital.c), you can directly
  write to the display in the put()- and bar()-functions, and use an empty
  flush()-function. But if you have a limited number of user-defined
  characters, and therefore you have to do some sort of 'character reduction'
  or similar stuff, you will have to use a framebuffer and the flush()-call. 
me='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/lcd4linux.git/log/?id=cbd5a4b49f0e732c90c955a80b10aecbad5ac310&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/filter.h?id=cbd5a4b49f0e732c90c955a80b10aecbad5ac310&amp;follow=1'>filter.h</a> (<a href='/lcd4linux.git/log/filter.h?id=cbd5a4b49f0e732c90c955a80b10aecbad5ac310'>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/filter.h?id=cbd5a4b49f0e732c90c955a80b10aecbad5ac310&amp;showmsg=1&amp;follow=1'>Expand</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr><td><span title='2003-10-08 06:45:00 +0000'>2003-10-08</span></td><td><a href='/lcd4linux.git/commit/HD44780.c?id=a18e028622323a5c8a115bb4e28393d73ad56875&amp;follow=1'>[lcd4linux @ 2003-10-08 06:45:00 by nicowallmeier]</a></td><td>nicowallmeier</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2003-10-07 04:12:39 +0000'>2003-10-07</span></td><td><a href='/lcd4linux.git/commit/configure.in?id=c53818c2be387084f02a69c9fd3146234ad6e792&amp;follow=1'>[lcd4linux @ 2003-10-07 04:12:38 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-782</span>/<span class='insertions'>+858</span></td></tr>
<tr><td><span title='2003-10-06 05:51:15 +0000'>2003-10-06</span></td><td><a href='/lcd4linux.git/commit/expression.c?id=80daed22ba0e5232d18dec3b8608edfa0f784987&amp;follow=1'>[lcd4linux @ 2003-10-06 05:51:15 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+25</span></td></tr>
<tr><td><span title='2003-10-06 05:47:27 +0000'>2003-10-06</span></td><td><a href='/lcd4linux.git/commit/expression.c?id=f6b9e43347e8a0dbbc6016ff3584dc56058135c8&amp;follow=1'>[lcd4linux @ 2003-10-06 05:47:27 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-19</span>/<span class='insertions'>+37</span></td></tr>
<tr><td><span title='2003-10-06 04:34:06 +0000'>2003-10-06</span></td><td><a href='/lcd4linux.git/commit/expression.h?id=9cda8378d11759032315ef79032e1ac3dc6beddb&amp;follow=1'>[lcd4linux @ 2003-10-06 04:34:06 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1034</span></td></tr>
<tr><td><span title='2003-10-06 04:33:06 +0000'>2003-10-06</span></td><td><a href='/lcd4linux.git/commit/libtool?id=54945a6e1b3f8556a87c37d74693548321ae09e1&amp;follow=1'>[lcd4linux @ 2003-10-06 04:33:06 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-0</span>/<span class='insertions'>+6967</span></td></tr>
<tr><td><span title='2003-10-06 04:30:44 +0000'>2003-10-06</span></td><td><a href='/lcd4linux.git/commit/configure.in?id=581343674f98f066f035824fed1c7927b6d817f2&amp;follow=1'>[lcd4linux @ 2003-10-06 04:30:43 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-53</span>/<span class='insertions'>+40</span></td></tr>
<tr><td><span title='2003-10-05 17:58:50 +0000'>2003-10-05</span></td><td><a href='/lcd4linux.git/commit/widget.h?id=546476ef7ef80df1e77cc1cc0553a4a5e4fb0f48&amp;follow=1'>[lcd4linux @ 2003-10-05 17:58:50 by reinelt]</a></td><td>reinelt</td><td>65</td><td><span class='deletions'>-273</span>/<span class='insertions'>+607</span></td></tr>
<tr><td><span title='2003-10-04 07:54:18 +0000'>2003-10-04</span></td><td><a href='/lcd4linux.git/commit/ltmain.sh?id=737adb14d135c7d518b9ad521a13ec2f6c88a9bf&amp;follow=1'>[lcd4linux @ 2003-10-04 07:54:17 by reinelt]</a></td><td>reinelt</td><td>7</td><td><span class='deletions'>-1217</span>/<span class='insertions'>+23170</span></td></tr>
<tr><td><span title='2003-10-03 03:53:12 +0000'>2003-10-03</span></td><td><a href='/lcd4linux.git/commit/parport.c?id=bd0e54dd5863570a51db777a6d42462f28e4f737&amp;follow=1'>[lcd4linux @ 2003-10-03 03:53:12 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+12</span></td></tr>
<tr><td><span title='2003-10-03 03:51:14 +0000'>2003-10-03</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=3be91f1b07841c6126d5ce6d0370ebae3e6a1c4e&amp;follow=1'>[lcd4linux @ 2003-10-03 03:51:14 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-46</span>/<span class='insertions'>+92</span></td></tr>
<tr><td><span title='2003-09-29 06:58:37 +0000'>2003-09-29</span></td><td><a href='/lcd4linux.git/commit/display.c?id=5abfdf9721cdb83851a15fcec795f59748eb97c6&amp;follow=1'>[lcd4linux @ 2003-09-29 06:58:36 by reinelt]</a></td><td>reinelt</td><td>7</td><td><span class='deletions'>-15</span>/<span class='insertions'>+381</span></td></tr>
<tr><td><span title='2003-09-29 06:12:56 +0000'>2003-09-29</span></td><td><a href='/lcd4linux.git/commit/T6963.c?id=0280c32d667a36a5809f2c7a83015a7bc035dce7&amp;follow=1'>[lcd4linux @ 2003-09-29 06:12:56 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-15</span>/<span class='insertions'>+22</span></td></tr>
<tr><td><span title='2003-09-21 06:43:02 +0000'>2003-09-21</span></td><td><a href='/lcd4linux.git/commit/MatrixOrbital.c?id=6ad29537e9b46548040a6fa222e19abe9b5d4447&amp;follow=1'>[lcd4linux @ 2003-09-21 06:43:02 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-2</span>/<span class='insertions'>+71</span></td></tr>
<tr><td><span title='2003-09-19 08:40:32 +0000'>2003-09-19</span></td><td><a href='/lcd4linux.git/commit/lock.c?id=a47170396bc75a5e1f0414cd878b82249e07386d&amp;follow=1'>[lcd4linux @ 2003-09-19 08:40:32 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-27</span>/<span class='insertions'>+54</span></td></tr>
<tr><td><span title='2003-09-19 03:51:29 +0000'>2003-09-19</span></td><td><a href='/lcd4linux.git/commit/widget.h?id=2f8b80242a07e24a663dce4200e0104ec6f553e9&amp;follow=1'>[lcd4linux @ 2003-09-19 03:51:29 by reinelt]</a></td><td>reinelt</td><td>6</td><td><span class='deletions'>-17</span>/<span class='insertions'>+160</span></td></tr>
<tr><td><span title='2003-09-13 07:20:51 +0000'>2003-09-13</span></td><td><a href='/lcd4linux.git/commit/configure.in?id=27b91cea68aa3d71b8316d450a60b3199c80a6b8&amp;follow=1'>[lcd4linux @ 2003-09-13 07:20:51 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-12</span>/<span class='insertions'>+32</span></td></tr>
<tr><td><span title='2003-09-13 06:45:43 +0000'>2003-09-13</span></td><td><a href='/lcd4linux.git/commit/Text.c?id=e647c45635992c0b75f7d71bf8681704fc0e714d&amp;follow=1'>[lcd4linux @ 2003-09-13 06:45:43 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-57</span>/<span class='insertions'>+188</span></td></tr>
<tr><td><span title='2003-09-13 06:20:39 +0000'>2003-09-13</span></td><td><a href='/lcd4linux.git/commit/configure.in?id=7b6bc7621c9fff5fc1433ac7aa517fd800e712f0&amp;follow=1'>[lcd4linux @ 2003-09-13 06:20:39 by reinelt]</a></td><td>reinelt</td><td>7</td><td><span class='deletions'>-8673</span>/<span class='insertions'>+459</span></td></tr>
<tr><td><span title='2003-09-11 15:05:24 +0000'>2003-09-11</span></td><td><a href='/lcd4linux.git/commit/configure.in?id=ce85c8e37937fe9be2802b48958d030892c5c67d&amp;follow=1'>[lcd4linux @ 2003-09-11 15:05:24 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-89</span>/<span class='insertions'>+1519</span></td></tr>
<tr><td><span title='2003-09-11 04:09:53 +0000'>2003-09-11</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=42eb8ba4829ed60addd82f178e3cc1459634e541&amp;follow=1'>[lcd4linux @ 2003-09-11 04:09:52 by reinelt]</a></td><td>reinelt</td><td>6</td><td><span class='deletions'>-14</span>/<span class='insertions'>+46</span></td></tr>
<tr><td><span title='2003-09-10 15:59:39 +0000'>2003-09-10</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=35b12c1caeb9e9e3f326511c429f69eaf864ac32&amp;follow=1'>[lcd4linux @ 2003-09-10 15:59:39 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-13</span>/<span class='insertions'>+391</span></td></tr>
<tr><td><span title='2003-09-10 15:09:21 +0000'>2003-09-10</span></td><td><a href='/lcd4linux.git/commit/ChangeLog?id=4565aa4f3c0898a2e4e8ab14b693c3c6df2a3890&amp;follow=1'>[lcd4linux @ 2003-09-10 15:09:21 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+28</span></td></tr>
<tr><td><span title='2003-09-10 14:01:53 +0000'>2003-09-10</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=f3f0b72ff2607397a1d3f6d9523ad85ae271b80c&amp;follow=1'>[lcd4linux @ 2003-09-10 14:01:52 by reinelt]</a></td><td>reinelt</td><td>6</td><td><span class='deletions'>-21</span>/<span class='insertions'>+110</span></td></tr>
<tr><td><span title='2003-09-10 08:37:09 +0000'>2003-09-10</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=e84318e4e452ac32bdca99f31e0c3546dd6418e8&amp;follow=1'>[lcd4linux @ 2003-09-10 08:37:09 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-50</span>/<span class='insertions'>+73</span></td></tr>
<tr><td><span title='2003-09-10 03:48:23 +0000'>2003-09-10</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=525c17277ccccf4459be16018576b44e9e6a2a35&amp;follow=1'>[lcd4linux @ 2003-09-10 03:48:22 by reinelt]</a></td><td>reinelt</td><td>7</td><td><span class='deletions'>-47</span>/<span class='insertions'>+130</span></td></tr>
<tr><td><span title='2003-09-09 11:47:47 +0000'>2003-09-09</span></td><td><a href='/lcd4linux.git/commit/USBLCD.c?id=ef5ef770de8b4b5d682d24efff30c6cc084d8cc4&amp;follow=1'>[lcd4linux @ 2003-09-09 11:47:47 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-14</span>/<span class='insertions'>+37</span></td></tr>
<tr><td><span title='2003-09-09 06:54:43 +0000'>2003-09-09</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=dd4d20ad1a3970752a4fe81c95c164bf751c0f16&amp;follow=1'>[lcd4linux @ 2003-09-09 06:54:43 by reinelt]</a></td><td>reinelt</td><td>15</td><td><span class='deletions'>-135</span>/<span class='insertions'>+177</span></td></tr>
<tr><td><span title='2003-09-09 05:30:34 +0000'>2003-09-09</span></td><td><a href='/lcd4linux.git/commit/processor.h?id=ca55019e85e081afe878a93ba0dc83a44d862de9&amp;follow=1'>[lcd4linux @ 2003-09-09 05:30:33 by reinelt]</a></td><td>reinelt</td><td>11</td><td><span class='deletions'>-90</span>/<span class='insertions'>+243</span></td></tr>
<tr><td><span title='2003-09-01 07:07:04 +0000'>2003-09-01</span></td><td><a href='/lcd4linux.git/commit/ltmain.sh?id=9da5a161e002a4dbfb27a4d79e616c9850c29ea0&amp;follow=1'>[lcd4linux @ 2003-09-01 07:07:03 by reinelt]</a></td><td>reinelt</td><td>8</td><td><span class='deletions'>-402</span>/<span class='insertions'>+13825</span></td></tr>
<tr><td><span title='2003-09-01 04:09:35 +0000'>2003-09-01</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=947cd14666c824a02a28dd4b83540949e690e4fd&amp;follow=1'>[lcd4linux @ 2003-09-01 04:09:34 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-28</span>/<span class='insertions'>+127</span></td></tr>
<tr><td><span title='2003-08-24 05:28:31 +0000'>2003-08-24</span></td><td><a href='/lcd4linux.git/commit/ChangeLog?id=f036c97abc6be80ecc1ca0c2a8dfbe2492e63dc7&amp;follow=1'>[lcd4linux @ 2003-08-24 05:28:31 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-119</span>/<span class='insertions'>+156</span></td></tr>
<tr><td><span title='2003-08-24 05:17:58 +0000'>2003-08-24</span></td><td><a href='/lcd4linux.git/commit/system.c?id=019808ae3222f7dc718b8a66d999aabac9f633ee&amp;follow=1'>[lcd4linux @ 2003-08-24 05:17:58 by reinelt]</a></td><td>reinelt</td><td>25</td><td><span class='deletions'>-131</span>/<span class='insertions'>+217</span></td></tr>
<tr><td><span title='2003-08-24 04:31:56 +0000'>2003-08-24</span></td><td><a href='/lcd4linux.git/commit/icon.h?id=86a3dd8e35847debfdce7c65e52b8ffd8913689a&amp;follow=1'>[lcd4linux @ 2003-08-24 04:31:56 by reinelt]</a></td><td>reinelt</td><td>6</td><td><span class='deletions'>-11</span>/<span class='insertions'>+154</span></td></tr>
<tr><td><span title='2003-08-22 03:45:09 +0000'>2003-08-22</span></td><td><a href='/lcd4linux.git/commit/parport.c?id=147c48fbdaaeb39a2b49b18e4cbc7cb3e31d6f2f&amp;follow=1'>[lcd4linux @ 2003-08-22 03:45:08 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-8</span>/<span class='insertions'>+25</span></td></tr>
<tr><td><span title='2003-08-20 05:26:43 +0000'>2003-08-20</span></td><td><a href='/lcd4linux.git/commit/bar.c?id=626abb5929b0eed658fe2ef599a228b8b07f8a21&amp;follow=1'>[lcd4linux @ 2003-08-20 05:26:43 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-9</span>/<span class='insertions'>+11</span></td></tr>
<tr><td><span title='2003-08-19 05:23:55 +0000'>2003-08-19</span></td><td><a href='/lcd4linux.git/commit/parport.c?id=191b04cd6a955fd0e897d08b8a0d5f34fd6751aa&amp;follow=1'>[lcd4linux @ 2003-08-19 05:23:55 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-62</span>/<span class='insertions'>+123</span></td></tr>
<tr><td><span title='2003-08-19 04:28:41 +0000'>2003-08-19</span></td><td><a href='/lcd4linux.git/commit/bar.c?id=b72c7b98553f670f53b42cd98e6156852d8d5203&amp;follow=1'>[lcd4linux @ 2003-08-19 04:28:41 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-19</span>/<span class='insertions'>+42</span></td></tr>
<tr><td><span title='2003-08-17 16:37:39 +0000'>2003-08-17</span></td><td><a href='/lcd4linux.git/commit/processor.c?id=946a5ef8dd7de4c8900dc52d5597b6ded3764394&amp;follow=1'>[lcd4linux @ 2003-08-17 16:37:39 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-23</span>/<span class='insertions'>+77</span></td></tr>
<tr><td><span title='2003-08-17 12:11:58 +0000'>2003-08-17</span></td><td><a href='/lcd4linux.git/commit/display.h?id=a7a01e3ffef0fdb4c3bb51afb2928c3f6828ccc9&amp;follow=1'>[lcd4linux @ 2003-08-17 12:11:58 by reinelt]</a></td><td>reinelt</td><td>6</td><td><span class='deletions'>-27</span>/<span class='insertions'>+118</span></td></tr>
<tr><td><span title='2003-08-17 08:25:30 +0000'>2003-08-17</span></td><td><a href='/lcd4linux.git/commit/configure.in?id=425f0326d5960a40f264a64b625747d99bd59b4b&amp;follow=1'>[lcd4linux @ 2003-08-17 08:25:30 by reinelt]</a></td><td>reinelt</td><td>6</td><td><span class='deletions'>-46</span>/<span class='insertions'>+185</span></td></tr>
<tr><td><span title='2003-08-17 06:57:04 +0000'>2003-08-17</span></td><td><a href='/lcd4linux.git/commit/Makefile.in?id=e5a64d09f3358214ae09ee28fc727489b3fb037f&amp;follow=1'>[lcd4linux @ 2003-08-17 06:57:04 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-544</span>/<span class='insertions'>+325</span></td></tr>