#
# $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. 
uthor'>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='/dtv-scan-tables.git/log/?id=e810c267c3a6960c8d57935bb1a9b334026038ed&amp;follow=1'>root</a>/<a href='/dtv-scan-tables.git/log/dvb-t?id=e810c267c3a6960c8d57935bb1a9b334026038ed&amp;follow=1'>dvb-t</a>/<a href='/dtv-scan-tables.git/log/dvb-t/se-Joestrom?id=e810c267c3a6960c8d57935bb1a9b334026038ed&amp;follow=1'>se-Joestrom</a> (<a href='/dtv-scan-tables.git/log/dvb-t/se-Joestrom?id=e810c267c3a6960c8d57935bb1a9b334026038ed'>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='/dtv-scan-tables.git/log/dvb-t/se-Joestrom?id=e810c267c3a6960c8d57935bb1a9b334026038ed&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='2024-01-30 17:34:57 +0100'>2024-01-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Trksat-3A4A-42.0E?id=76c5a9110f7ee40fd1c63eca8ca84b125a0ac11e&amp;follow=1'>dvb-s: drop transponders that aren't there at Lyngsat anymore</a></td><td>Mauro Carvalho Chehab</td><td>50</td><td><span class='deletions'>-20357</span>/<span class='insertions'>+0</span></td></tr>
<tr><td><span title='2024-01-30 17:31:26 +0100'>2024-01-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-601-49.0E?id=118e8c00436b524273499b6c01b0c4e77083a4b5&amp;follow=1'>dvb-s: update from today's Lyngsat report</a></td><td>Mauro Carvalho Chehab</td><td>196</td><td><span class='deletions'>-15543</span>/<span class='insertions'>+15859</span></td></tr>
<tr><td><span title='2024-01-30 17:06:37 +0100'>2024-01-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/uk-WinterHill?id=fca403cc92717328bccb3b2a4c747a474632c0da&amp;follow=1'>dtv-scan-tables: full uk transmitter update</a></td><td>Simon Liddicott</td><td>81</td><td><span class='deletions'>-500</span>/<span class='insertions'>+163</span></td></tr>
<tr><td><span title='2022-11-25 11:46:20 +0000'>2022-11-25</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-c/hu-Digikabel?id=833d4cc1dddb3560e93ef7dc6951ab5c204b5c13&amp;follow=1'>dtv-scan-tables: hu-Digikabel changes</a></td><td>Hrotkó Gábor</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+26</span></td></tr>
<tr><td><span title='2022-04-30 16:02:58 +0100'>2022-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/pt-All?id=57ed2982275045ea5e92ef2a40b9fa58255852e5&amp;follow=1'>pt-All: fix modulation</a></td><td>Mauro Carvalho Chehab</td><td>1</td><td><span class='deletions'>-10</span>/<span class='insertions'>+10</span></td></tr>
<tr><td><span title='2022-04-30 15:50:08 +0100'>2022-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/pt-All?id=5f7b549da3c7ed1e9dfe4fcbbda742a9d7ee5aec&amp;follow=1'>pt-All: Update Portugal channels</a></td><td>Mauro Carvalho Chehab</td><td>1</td><td><span class='deletions'>-34</span>/<span class='insertions'>+70</span></td></tr>
<tr><td><span title='2022-03-07 17:34:29 +0100'>2022-03-07</span></td><td><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Palmas?id=e403f83644167e240668c0668a8de04532060683&amp;follow=1'>Update Brazilian ISDB-T tables</a></td><td>Mauro Carvalho Chehab</td><td>549</td><td><span class='deletions'>-2923</span>/<span class='insertions'>+13860</span></td></tr>
<tr><td><span title='2022-03-07 17:05:00 +0100'>2022-03-07</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-38-45.1E?id=0eb034356d9699799ed8633ac3fe01622d39e6ff&amp;follow=1'>Update satellite channel lists from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>54</td><td><span class='deletions'>-1882</span>/<span class='insertions'>+2326</span></td></tr>
<tr><td><span title='2021-12-14 12:36:28 +0100'>2021-12-14</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/uk-WinterHill?id=5acecf65ccd5633c50b8c199cce50fb734635097&amp;follow=1'>dtv-scan-tables: latest UK changes</a></td><td>Simon Liddicott</td><td>4</td><td><span class='deletions'>-24</span>/<span class='insertions'>+24</span></td></tr>
<tr><td><span title='2021-04-30 21:33:05 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Tupirama?id=25ee9e0ce4bbacdb278d4cff306ceb6528c4f548&amp;follow=1'>update Brazilian scan files</a></td><td>Mauro Carvalho Chehab</td><td>2476</td><td><span class='deletions'>-12805</span>/<span class='insertions'>+69312</span></td></tr>
<tr><td><span title='2021-04-30 13:29:02 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal201-90.0E?id=66ec1eabbf6a596b42f6d4802b6aead3e8ba1ad5&amp;follow=1'>Remove legacy entries</a></td><td>Mauro Carvalho Chehab</td><td>129</td><td><span class='deletions'>-24898</span>/<span class='insertions'>+0</span></td></tr>
<tr><td><span title='2021-04-30 13:28:58 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-601-49.0E?id=f46e7874dd45f03f47b31e8cd56108f3f10711f8&amp;follow=1'>Add new satellites from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>75</td><td><span class='deletions'>-21</span>/<span class='insertions'>+29721</span></td></tr>
<tr><td><span title='2021-04-30 10:31:15 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-38-45.1E?id=137a4b9176f8fb074c955a49ae97865d2fb85095&amp;follow=1'>Rename a few satellites with two names and update frequencies</a></td><td>Mauro Carvalho Chehab</td><td>2</td><td><span class='deletions'>-283</span>/<span class='insertions'>+182</span></td></tr>
<tr><td><span title='2021-04-30 10:29:42 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-402-54.9E?id=cf6e4b502139112c82f092001eb6b9ac3912182a&amp;follow=1'>Update frequencies from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>188</td><td><span class='deletions'>-12304</span>/<span class='insertions'>+12666</span></td></tr>