#
# $Id: README.Drivers,v 1.3 2000/05/21 06:20:35 reinelt 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

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

* 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() 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. 
isdb-t/br-mt-Sorriso'>
<input type='hidden' name='id' value='76b8385450942bdc03bf77f627f0b509015113bd'/><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=76b8385450942bdc03bf77f627f0b509015113bd&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/dtv-scan-tables.git/log/isdb-t?id=76b8385450942bdc03bf77f627f0b509015113bd&amp;showmsg=1&amp;follow=1'>isdb-t</a>/<a href='/dtv-scan-tables.git/log/isdb-t/br-mt-Sorriso?id=76b8385450942bdc03bf77f627f0b509015113bd&amp;showmsg=1&amp;follow=1'>br-mt-Sorriso</a> (<a href='/dtv-scan-tables.git/log/isdb-t/br-mt-Sorriso?id=76b8385450942bdc03bf77f627f0b509015113bd&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/isdb-t/br-mt-Sorriso?id=76b8385450942bdc03bf77f627f0b509015113bd&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='2015-01-18 15:59:01 +0100'>2015-01-18</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/uk-Tacolneston?id=2d181a8f9cecb6d5ad2577ba5e34c3ca698a2eda&amp;follow=1'>COM 7 and Local TV Updates</a></td><td>silid</td><td>16</td><td><span class='deletions'>-17</span>/<span class='insertions'>+236</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
This update adds the COM7 HD mux to some regions and Oxford and Sheffield Local muxes.

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


</td></tr>
<tr class='logheader'><td><span title='2015-01-11 11:17:59 +0100'>2015-01-11</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/uk-StocklandHill?id=5c5830646b781b7cfc630fa6ac2160ca9fcb5262&amp;follow=1'>dvb-t scan tables</a></td><td>Adam Laurie</td><td>1</td><td><span class='deletions'>-6</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Hi Oliver,

That's great - here is the frequency patch, tested with current (repo)
version of tvheadend - all channels receiving OK including HD.

Unfortunately, it didn't fix my original problem of picons not being
picked up, but I guess the names are related to frequency etc., not just
channel name as it works fine on all my satellite channels.... On to my
next quest, I guess!... :)

cheers &amp; thanks again,
Adam
--
Adam Laurie                         Tel: +44 (0) 20 7993 2690
Suite 7
61 Victoria Road
Surbiton
Surrey                              mailto:adam@algroup.co.uk
KT6 4JX                             http://rfidiot.org

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


</td></tr>
<tr class='logheader'><td><span title='2015-01-11 11:06:23 +0100'>2015-01-11</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Sirius-5.0E?id=aaa9a0918fcf35957dc5c31afe9afed96a0c3c2f&amp;follow=1'>Sirius-5.0E: complete update based on kingofsat.net data</a></td><td>Olli Salonen</td><td>1</td><td><span class='deletions'>-78</span>/<span class='insertions'>+111</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
</td></tr>
<tr class='logheader'><td><span title='2014-12-21 12:27:23 +0100'>2014-12-21</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/au-Brisbane?id=b46a22ca4f51a43143ab0618ee1b3b0067fa4fd3&amp;follow=1'>dtv-scan-tables: update dvb-t/au-Brisbane</a></td><td>Brian Burch</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+2</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Update dvb-t/au-Brisbane as per Brian Burch's bug report on Ubuntu
Launchpad:
https://bugs.launchpad.net/ubuntu/+source/dtv-scan-tables/+bug/1393280

Signed-off-by: Jonathan McCrohan &lt;jmccrohan@gmail.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2014-12-21 10:57:37 +0100'>2014-12-21</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/au-Canberra-Black-Mt?id=9221817e2e403db91647ef7673a0c35a97d87174&amp;follow=1'>update</a></td><td>Olliver Schinagl</td><td>1</td><td><span class='deletions'>-9</span>/<span class='insertions'>+9</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Signed-off-by: Olliver Schinagl &lt;oliver@schinagl.nl&gt;


</td></tr>
<tr class='logheader'><td><span title='2014-11-30 12:15:23 +0100'>2014-11-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fi-DNA-Ylivieska?id=82115b4a1f1039d5a2f93f2b7ddc4b2d2713b7ae&amp;follow=1'>dtv-scan-tables: fix the DNA muxes in Finland to DVB-T2</a></td><td>Olli Salonen</td><td>34</td><td><span class='deletions'>-102</span>/<span class='insertions'>+102</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
All of the DNA muxes in Finland are DVB-T2, not DVB-T.

Signed-off-by: Olli Salonen &lt;olli.salonen@iki.fi&gt;


</td></tr>
<tr class='logheader'><td><span title='2014-11-30 12:15:14 +0100'>2014-11-30</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fi-Turku?id=4059d5ebe87e30b949dd3a9ca9a304c653152456&amp;follow=1'>dtv-scan-tables: add mux H to stations transmitting it in Finland</a></td><td>Olli Salonen</td><td>6</td><td><span class='deletions'>-30</span>/<span class='insertions'>+60</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
The new mux H is being broadcasted by Digita from 6 stations in Finland.

Signed-off-by: Olli Salonen &lt;olli.salonen@iki.fi&gt;


</td></tr>
<tr class='logheader'><td><span title='2014-11-10 10:10:47 +0100'>2014-11-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/vn-Thaibinh?id=2d9e6af384f85a7c998114b21d9cd8314f401743&amp;follow=1'>Delete DVBv3 comments from DVBv5 scan files</a></td><td>Jonathan McCrohan</td><td>494</td><td><span class='deletions'>-496</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Probably should have happened as part of 06e54ff.

Signed-off-by: Jonathan McCrohan &lt;jmccrohan@gmail.com&gt;


</td></tr>