#
# $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. 
3'/><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=90b412717bba962083a14ea7056d4c0bdd2b2613&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/dtv-scan-tables.git/log/dvb-c?id=90b412717bba962083a14ea7056d4c0bdd2b2613&amp;showmsg=1&amp;follow=1'>dvb-c</a>/<a href='/dtv-scan-tables.git/log/dvb-c/ch-Video2000?id=90b412717bba962083a14ea7056d4c0bdd2b2613&amp;showmsg=1&amp;follow=1'>ch-Video2000</a> (<a href='/dtv-scan-tables.git/log/dvb-c/ch-Video2000?id=90b412717bba962083a14ea7056d4c0bdd2b2613&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-c/ch-Video2000?id=90b412717bba962083a14ea7056d4c0bdd2b2613&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='2016-05-28 16:59:29 -0300'>2016-05-28</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/ca-AB-Calgary?id=7096892c9675f48fe63b01a9cdce50838cbc595e&amp;follow=1'>ca-AB-Calgary: move the newer version to atsc</a></td><td>Mauro Carvalho Chehab</td><td>2</td><td><span class='deletions'>-49</span>/<span class='insertions'>+14</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
This file is an ATSC standard file, and not DVB-T. Replace
the legacy file with the newer one.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@osg.samsung.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2016-05-09 18:42:32 -0300'>2016-05-09</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Astra-28.2E?id=e56800218f88cb777577083161975a3078ac0bf7&amp;follow=1'>Errors in scan file</a></td><td>Bob Goddard</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+21</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
I posted an email with a patch back on 04/02/2016 17:32 only to find that nothing has been done.

This patch, reproduced below adds 2 new transponders to Astra 28.2E and removes a trailing space. This trailing spaces causes dvbv5-scan to segfault.

Why has this not been actioned and why was my email address banned? Is this a close community that tells people to f-off?

dvb-s/Astra-28.2E | 27 ++++++++++++++++++++++++---

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@osg.samsung.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2016-05-06 09:01:20 -0300'>2016-05-06</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Astra-28.2E?id=138d406945fb110062214d30b73ed4c71f433691&amp;follow=1'>Update dvb-s/Astra-28E with new transponders and corrections</a></td><td>Bob Goddard</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+24</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Update dvb-s/Astra-28.2E. 2 new transponders, corrected duplicate of
tp 92 in tp 93 and removed trailing space causing user tools segfault.

Signed-off-by: Bob Goddard &lt;linuxtv@1.linuxtv.bgcomp.co.uk&gt;


</td></tr>
<tr class='logheader'><td><span title='2016-05-01 14:00:44 -0300'>2016-05-01</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Tocantinopolis?id=d89c2f2bf92af99e44428d2a8727bc1682a73909&amp;follow=1'>Add new Brazilian channel lists</a></td><td>Mauro Carvalho Chehab</td><td>305</td><td><span class='deletions'>-49</span>/<span class='insertions'>+17876</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Channels imported from portalbsd.com.br.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@osg.samsung.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2016-05-01 13:59:19 -0300'>2016-05-01</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-PortoNacional?id=e838e8af23ce2d4cbff1bcd4cafadf5500765278&amp;follow=1'>Update Brazilian channel lists to reflect latest status</a></td><td>Mauro Carvalho Chehab</td><td>990</td><td><span class='deletions'>-2504</span>/<span class='insertions'>+18744</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Syncrhonize with the latest tables at portalbsd.com.br.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab@osg.samsung.com&gt;


</td></tr>