aboutsummaryrefslogtreecommitdiffstats
path: root/TODO
diff options
context:
space:
mode:
authormichael <michael@3ae390bd-cb1e-0410-b409-cd5a39f66f1f>2007-01-14 13:44:38 +0000
committermichael <michael@3ae390bd-cb1e-0410-b409-cd5a39f66f1f>2007-01-14 13:44:38 +0000
commita71f0a4648cc64c4a2f41e797d9956116287f162 (patch)
treepre { line-height: 125%; } td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } .highlight .hll { background-color: #ffffcc } .highlight .c { color: #888888 } /* Comment */ .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ .highlight .k { color: #008800; font-weight: bold } /* Keyword */ .highlight .ch { color: #888888 } /* Comment.Hashbang */ .highlight .cm { color: #888888 } /* Comment.Multiline */ .highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */ .highlight .cpf { color: #888888 } /* Comment.PreprocFile */ .highlight .c1 { color: #888888 } /* Comment.Single */ .highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */ .highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .highlight .ge { font-style: italic } /* Generic.Emph */ .highlight .gr { color: #aa0000 } /* Generic.Error */ .highlight .gh { color: #333333 } /* Generic.Heading */ .highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .highlight .go { color: #888888 } /* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */
#
# $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. 
class='del'>-// done with the "Next Generation Layout"
-
-// 2001-03-24 Brian Cleven <lcleven@home.com>
-// support 40x4 displays with two HD44780 chips on it
-// we need another 'Enable' line for this
-// this way one could connect two displays to one parallel port, too
-// done with 0.9.11 MR
-
-// 2001-05-25 Jens Garthe <outline@xslan.de>
-// detect wether curses.h and libncurses is installed, and
-// don't include the 'Text'-driver if not.
-// _should_ work now 2001-05-31 -lt
-
-// 2001-09-11 Michael Reinelt <reinelt@eunet.at>
-// use new extended tokens to split up several data sources
-// (CPU, Net, Disk, ISDN, ...)
-// e.g. '%nw' is 'network transmit' for _all_ devices
-// '%n0w' is 'network transmit' for eth0
-// '%n1w' for eth1
-// done with the "Next Generation Layout"
-
-// 2001-09-11 Michael Reinelt <reinelt@eunet.at>
-// remove bar code from drivers and create a common bar library
-// done somewhere in 2003 -mr
-
-// 2001-09-12 Carsten Nau <info@cnau.de>
-// make the output for emails shorter (at the moment up to 9999 emails)
-// done with the "Next Generation Layout"
-
-2001-09-13 Michael Reinelt <reinelt@eunet.at>
-combine mail.c and mail2.c
-if there's an error getting mail info, display "?" instead of "0"
-
-2001-09-14 Michael Reinelt <reinelt@eunet.at>
-do not disable mail check in first error
-instead use a number of retries
-errors can occur in case of short disconnects, but normal operation
-should resume
-
-2002-02-15 Udo Altmann (udo.altmann@web.de)
-support for inversed/blinking text
-don't know if displays support this feature...
-
-// 2003-09-08 Michael Reinelt (reinelt@eunet.at>
-// at least one of my HD44780 displays use an inverted "P" instead of
-// a full block. Therefore a bar my look strange. Make the ASCII code
-// of the full block configurable...
-// done with the "Next Generation Layout"
-// see the "asc255bug" attribute
-
-// 2003-09-14 Markus <markus@norad.de>
-// change %t tokens from Byte/sec to kB/sec, ith one decimal places.
-// Either make it configurabel, or add new tokens.
-// done with the "Next Generation Layout"
-
-// 2003-10-29 Matt Thrailkill <xwred1@modestolan.com>
-// > To go off on another tangent... have you at all considered some sort of
-// > marquee support? I toyed with the row scrolling support which was
-// > recently added, and it is nifty. But marquees would be handy for doing
-// > something like horizontally scrolling, say, the title of the currently
-// > playing mp3. I've toyed with trying to dive in and add it, but I'm a
-// > pretty lazy guy and haven't done it. What do you think?
-// done with the "Next Generation Layout"
-
-2003-12-31 Stefan ??? <nef17@gmx.net>
-add support for software-controlled backlight for HD44780
-http://www.jalcds.de/images/4x20backlight.gif
-
-2004-01-25 Michael Reinelt <reinelt@eunet.at>
-add attribute "blinking" to text widgets
-
-2004-01-25 Xavier VELLO <xavier66@free.fr>
-add "inverse" attribute to text widget
-possible with Cwlinux and all graphics displays
-
-2004-01-25 Xavier VELLO <xavier66@free.fr>
-add an "image" widget
-
-2004-01-25 Xavier VELLO <xavier66@free.fr>
-icons should not only be updated regularly, but shown only when
-a certain expression returns 1
-
+# $Id
+# $URL$
+Sorry, there is no TODO anymore.
+Go to http://lcd4linux.bulix.org for all the documentation.