#
# $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. 
'>
<input type='hidden' name='id' value='52a1bd361c6a5433262c3ef33ff2b224fc0b9e9d'/><input type='hidden' name='showmsg' 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='/dtv-scan-tables.git/log/?id=52a1bd361c6a5433262c3ef33ff2b224fc0b9e9d&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/dtv-scan-tables.git/log/dvb-t?id=52a1bd361c6a5433262c3ef33ff2b224fc0b9e9d&amp;showmsg=1&amp;follow=1'>dvb-t</a>/<a href='/dtv-scan-tables.git/log/dvb-t/se-Sarna_Mickeltemplet?id=52a1bd361c6a5433262c3ef33ff2b224fc0b9e9d&amp;showmsg=1&amp;follow=1'>se-Sarna_Mickeltemplet</a> (<a href='/dtv-scan-tables.git/log/dvb-t/se-Sarna_Mickeltemplet?id=52a1bd361c6a5433262c3ef33ff2b224fc0b9e9d&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='/dtv-scan-tables.git/log/dvb-t/se-Sarna_Mickeltemplet?id=52a1bd361c6a5433262c3ef33ff2b224fc0b9e9d&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='2013-07-28 09:56:28 +0200'>2013-07-28</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-c/de-Primacom?id=edc0bc3f04b715f2c882343e4d4fdf94e7cc1e29&amp;follow=1'>de-Primacom initial tuning data doesn't work anymore</a></td><td>Franz Schrober</td><td>1</td><td><span class='deletions'>-28</span>/<span class='insertions'>+41</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Hi,

I wanted to watch TV today with kaffeine 1.2.2-2 from debian and noticed
that it didn't work anymore. Also scans even after the update of the
initial tuning data didn't show all tv stations. Just replacing the
entry for dvb-c/de-Primacom in ~/.kde/share/apps/kaffeine/scanfile.dvb
with the one from http://narfation.org/misc/dvbc/de-Primacom fixed the
problem for me after the next scan for tv stations.


</td></tr>
<tr class='logheader'><td><span title='2013-07-15 09:31:27 +0200'>2013-07-15</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/ua-Odessa?id=044cfc43a0006d5b5bc6d8c2d626c85f3c8a2b48&amp;follow=1'>New DVB-T2 muxes for Russia, Ukraine.</a></td><td>CrazyCat</td><td>7</td><td><span class='deletions'>-3</span>/<span class='insertions'>+27</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Oliver Schinagl &lt;oliver@schinagl.nl&gt;


</td></tr>
<tr class='logheader'><td><span title='2013-07-15 09:31:17 +0200'>2013-07-15</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-12-45.0E?id=2623422ff3aa0ea8fc7fb9ceac5b21346bdf2628&amp;follow=1'>Some MIS+PLS transponders for 5W.</a></td><td>CrazyCat</td><td>5</td><td><span class='deletions'>-19</span>/<span class='insertions'>+56</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Oliver Schinagl &lt;oliver@schinagl.nl&gt;


</td></tr>
<tr class='logheader'><td><span title='2013-07-15 09:31:12 +0200'>2013-07-15</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Hotbird-13.0E?id=65f6f1ebe7eed639f2da80745a2de49b84fb7fcd&amp;follow=1'>Hotbird Mediaset MIS+PLS transponders.</a></td><td>CrazyCat</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+4</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Oliver Schinagl &lt;oliver@schinagl.nl&gt;


</td></tr>
<tr class='logheader'><td><span title='2013-07-15 09:31:03 +0200'>2013-07-15</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/ua-Lozovaya?id=9697bf6dc254770b47d510357c64f716a32cf43e&amp;follow=1'>Some multistream transponders.</a></td><td>CrazyCat</td><td>6</td><td><span class='deletions'>-0</span>/<span class='insertions'>+37</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Some DVB-T2 muxes for RU and UA.

Signed-off-by: Oliver Schinagl &lt;oliver@schinagl.nl&gt;


</td></tr>