#
# $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. 
d' value='51e3eab98f0f01d7eabb73e1243919de0a97693c'/><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=51e3eab98f0f01d7eabb73e1243919de0a97693c&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/dtv-scan-tables.git/log/isdb-t?id=51e3eab98f0f01d7eabb73e1243919de0a97693c&amp;showmsg=1&amp;follow=1'>isdb-t</a>/<a href='/dtv-scan-tables.git/log/isdb-t/br-sc-Guaramirim?id=51e3eab98f0f01d7eabb73e1243919de0a97693c&amp;showmsg=1&amp;follow=1'>br-sc-Guaramirim</a> (<a href='/dtv-scan-tables.git/log/isdb-t/br-sc-Guaramirim?id=51e3eab98f0f01d7eabb73e1243919de0a97693c&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-sc-Guaramirim?id=51e3eab98f0f01d7eabb73e1243919de0a97693c&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='2018-05-10 22:46:56 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/es-Zaragoza?id=f3a7cfdc1dcc3c32da82ad2fdc7d9b7f68581731&amp;follow=1'>dtv-scan-tables: dvb-t/es-Zaragoza</a></td><td>Javier García</td><td>1</td><td><span class='deletions'>-17</span>/<span class='insertions'>+844</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Hello,

I have scanned the DVB-T channels of Zaragoza, Spain
I wanted to send them to share and that may be useful for other users.

Javier García


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 22:34:33 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Anik-F1-107.3W?id=2c26e3633832300c008864c66241394d426e0135&amp;follow=1'>Remove Anik F1 107.3W</a></td><td>Olliver Schinagl</td><td>1</td><td><span class='deletions'>-35</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Due to a failure in the solar panels [0], Anik F1 was replaced by F1R in
2005. Anik F1 appears to be still active serving south America, but
without any DVB transponders.

[0] http://space.skyrocket.de/doc_sdat/anik-f1.htm

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 22:18:54 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/SES3_C-103.0W?id=3bdeeb4781b2b32e2fc97019f9e3438e3d18e8bf&amp;follow=1'>Synchronize orbital position naming in filenames</a></td><td>Olliver Schinagl</td><td>22</td><td><span class='deletions'>-0</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
No content changes where performed on these files.

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 22:09:18 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Agila2_C-146.0E?id=bba6c923e73d3028f694793c281ce6d386b6d48c&amp;follow=1'>Drop Agila 2 146.0E</a></td><td>Olliver Schinagl</td><td>1</td><td><span class='deletions'>-186</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Agila 2 was moved in late 2011 to 3 West, renamed to ABS-3 [0]. The
transponder frequencies are no match for the ABS-3 so lets just
remove it.

[0] http://space.skyrocket.de/doc_sdat/agila-2.htm

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 22:06:58 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Amazonas3-61.0W?id=e82c2c8b0620cd034064223097dd13e8d4169c2b&amp;follow=1'>Update Amazonas 3 61.0W</a></td><td>Olliver Schinagl</td><td>2</td><td><span class='deletions'>-411</span>/<span class='insertions'>+18</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
The Amazonas 3 replaced the Amazonas 1 in 2012 as can be seen at [0].
Lets rename it accordingly. Further more, many of the transponders
have been dropped so remove those as well.

[0] http://space.skyrocket.de/doc_sdat/amazonas-3.htm

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 22:05:57 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/ABS2-75.0E?id=1dc44e7a44f27e94a87b96879e55b10ec82621ee&amp;follow=1'>Rename ABS1 to ABS2</a></td><td>Olliver Schinagl</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
ABS-1 appears to have replaced ABS-2 according to [0].
Lets rename it to reflect it's current name.

[0] http://space.skyrocket.de/doc_sdat/abs-2.htm

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 22:05:57 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Eutelsat5_5.0W?id=740c6b2eb7ad8c9ff77a2d8cc6811d6dbfa201c3&amp;follow=1'>Rename Atlantic Bird 3 to Eutelsat5</a></td><td>Olliver Schinagl</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
In 2012 Atlantic Bird 3 was renamed to Eutelsat 5 West A as can be seen
at [0]. Reflect this name change in the filename to make it easier to find.

[0] http://space.skyrocket.de/doc_sdat/stellat-1.htm

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 21:37:46 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Atlantic-Bird-1-12.5W?id=b8a4ea7d8908a28a2a0ea85b264461e3036310d7&amp;follow=1'>Remove Atlantic Bird 1</a></td><td>Olliver Schinagl</td><td>1</td><td><span class='deletions'>-270</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Atlantic Bird 1 was renamed to Eutelsat 12 West A in 2012 and moved from
12 to 36 degree's in 2016 and was thus not accurate anymore. In 2018 it
was repositioned to 59 east and renamed to Eutelsat 59A as can be seen
at [0]. So far there are no active transponders.

[0] http://space.skyrocket.de/doc_sdat/atlantic-bird-1.htm

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


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 21:26:32 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-s/Atlantic-Bird-3-5.0W?id=3dc7a8d6b5f9a8218ac3763c3a4d5cc86100c5a0&amp;follow=1'>dtv-scan-tables - dvb-s - update and rename the config file for ↵</a></td><td>leny@netcourrier.com</td><td>1</td><td><span class='deletions'>-53</span>/<span class='insertions'>+663</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Atlantic-Bird-3-5.0W - Ku Band

Hello,

The latest update for the file Atlantic-Bird-3-5.0W (Ku Band) is 2015-03-28:
https://git.linuxtv.org/dtv-scan-tables.git/log/dvb-s/Atlantic-Bird-3-5.0W
but since March 2015 there are a lot of changes in the tranponders list.
And now, a lot of transponders for Algerian, French and Italian TV and
Radio channels are missing.
Attached is an updated config scan file (Atlantic-Bird-3-5.0W.patch
file) for Atlantic-Bird-3-5.0W transponders in dvbv5 format.
Could you please ensure that this new patch is committed into the DVB
source code tree repositery?
PS : Attached there is also the full up to date file :
Atlantic-Bird-3-5.0W-2017-01-09.NEW.FULL if you need it

Thank you

Best regards


</td></tr>
<tr class='logheader'><td><span title='2018-05-10 17:28:44 +0200'>2018-05-10</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-c/nl-Ziggo?id=36ef13f2185b8a75f9c1beda8ff8ce407949d273&amp;follow=1'>Add another initial transponder for Ziggo/Netherlands.</a></td><td>Jens Peters</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+8</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Ziggo and UPC had merged, but the initial UPC transponder is still the correct one for former UPC customers.
See also https://gathering.tweakers.net/forum/list_message/31632914#31632914


</td></tr>