add documentation for i2500vfd
This commit is contained in:
marschap
@@ -6,7 +6,7 @@ The HD44780 has become the de-facto standard of alphanumeric character displays.
|
||||
Although the original Hitachi HD44780 is long out of production, its command
|
||||
set has survived in a variety of (fully or nearly) compatible LCD, VFD and
|
||||
even OLED displays sold by a broad range of manufacturers all over the world.
|
||||
To name ony a few: KS0066, KS0070, KS0076, LC7985, NT3881, SED1278, ST7066 ...
|
||||
To name only a few: KS0066, KS0070, KS0076, LC7985, NT3881, SED1278, ST7066 ...
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@@ -131,12 +131,25 @@ Last but not least, for special purposes, there are even more connection types:
|
||||
</itemizedlist>
|
||||
|
||||
|
||||
<para>
|
||||
Depending on the connection type and the display connected, the driver supports
|
||||
various special features.
|
||||
<itemizedlist>
|
||||
<listitem>Input keys</listitem>
|
||||
<listitem>software controllable brightness / backlight</listitem>
|
||||
<listitem>software controllable contrast</listitem>
|
||||
<listitem>multiple displays / multi-controller displays</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<!--
|
||||
<para>
|
||||
The driver also lets you use multiple displays as a single virtual
|
||||
display. For example, a 4, 2 and 1 line display can be used to form a
|
||||
7 line display. The number of displays is limited by the individual
|
||||
HD44780 driver.
|
||||
</para>
|
||||
-->
|
||||
|
||||
<sect2 id="hd44780-connections">
|
||||
<title>Connections</title>
|
||||
@@ -145,7 +158,7 @@ HD44780 driver.
|
||||
<title>Common connections for all connectiontypes</title>
|
||||
|
||||
<para>
|
||||
No matter what connectiontype you choose, you will always need some
|
||||
No matter what connection type you choose, you will always need some
|
||||
connections. They are explaned here.
|
||||
</para>
|
||||
|
||||
@@ -441,8 +454,8 @@ assumes this:
|
||||
</table>
|
||||
|
||||
<para>
|
||||
If you only need 10 keys, leave the rest away. However, the lcdproc menu is
|
||||
controlled by the keystrokes A to D. You should modify and recompile the
|
||||
If you only need 10 keys, leave the rest away.
|
||||
You should modify and recompile the
|
||||
driver to get an other keypad layout.
|
||||
</para>
|
||||
|
||||
@@ -1810,7 +1823,7 @@ and drives both channels as outputs to control the display in 8bit mode.
|
||||
</table>
|
||||
|
||||
<para>
|
||||
You can configure the USB vendor/product ID in LCDd.conf.
|
||||
You can configure the USB vendor/product ID in <filename>LCDd.conf</filename>.
|
||||
The wiring of the control lines can optionally be reconfigured,
|
||||
please look at the driver source if you really need that.
|
||||
</para>
|
||||
@@ -2104,14 +2117,23 @@ Refer to <link linkend="hd44780-lcdserializer-burning">burning section</link> in
|
||||
<title>BWCT USB LCD module "bwctusb"</title>
|
||||
|
||||
<para>
|
||||
The BWCT USB LCD module is also supported. It is not connected to an LPT port
|
||||
but to an USB port, which saves you from a lot of potential problems.
|
||||
To use it, set the connection type in the config file with the ConnectionType=
|
||||
setting to "bwctusb" (without the quotes).
|
||||
It does neither support a keypad nor backlight switching but it supports setting
|
||||
the display's contrast using the "Contrast" configuration parameter as well as
|
||||
specifying which one (of multiple BWCT LCD devices) is wanted using the
|
||||
"SerialNumber" configuration parameter.
|
||||
The BWCT USB LCD module, sold by Bernd Walter Computing Technology
|
||||
(<ulink url="http://www.bwct.de/lcd.html"></ulink>) is a little board
|
||||
that can be piggy-packed to a HD44780 display and connects that to USB.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The board, driven by the <literal>bwctusb</literal> connection type,
|
||||
does neither support a keypad for input, nor more than one single-controller
|
||||
display, nor does it allow setting the backlight or brightness.
|
||||
But it you can the display's contrast using software
|
||||
(see the <command>Constrast=</command> configuration parameter).
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If there is more than one BWCT USB modules connected to the system,
|
||||
the <command>SerialNumber=</command> configuration parameters allows
|
||||
selecting which display is used in LCDd.
|
||||
</para>
|
||||
|
||||
</sect3>
|
||||
@@ -2143,9 +2165,11 @@ e.g. for a graphic LCD.
|
||||
<title>Special config options</title>
|
||||
|
||||
<para>
|
||||
Two keys can be connected to the LCD2USB interface board. They can generate three key events:
|
||||
One for each key and one if the keys are pressed simultaneously. With this menus can be used
|
||||
(see example below).
|
||||
Two keys can be connected to the LCD2USB interface board. They can generate three key events
|
||||
that can be mapped to key names using the <command>DirectKey_1</command> to
|
||||
<command>DirectKey_3=</command> commands:
|
||||
one for each key and one if the keys are pressed simultaneously.
|
||||
With this 3-key setup, menus can be used (see example below).
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@@ -2540,15 +2564,46 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<command>Brightness=</command>
|
||||
<arg choice="plain"><replaceable>BRIGHTNESS</replaceable></arg>
|
||||
</term>
|
||||
<listitem><para>
|
||||
Set the initial brightness when the backlight is on
|
||||
for the <literal>lcd2usb</literal> connection type.
|
||||
Legal values are <literal>0</literal> - <literal>1000</literal>,
|
||||
with <literal>800</literal> being the default.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<command>OffBrightness=</command>
|
||||
<arg choice="plain"><replaceable>BRIGHTNESS</replaceable></arg>
|
||||
</term>
|
||||
<listitem><para>
|
||||
Set the initial off-brightness, i.e. the brightness when the backlight is off,
|
||||
for the <literal>lcd2usb</literal> connection type.
|
||||
The ilegal range is <literal>0</literal> - <literal>1000</literal>.
|
||||
If not given, it defaults to <literal>300</literal>.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<command>Contrast=</command>
|
||||
<arg choice="plain"><replaceable>CONTRAST</replaceable></arg>
|
||||
</term>
|
||||
<listitem><para>
|
||||
Set the initial contrast for the <literal>bwctusb</literal> connection type.
|
||||
Legal values for <replaceable>CONTRAST</replaceable> are <literal>0</literal> - <literal>1000</literal>.
|
||||
If not given, it defaults to <literal>300</literal>.
|
||||
Set the initial contrast for the <literal>bwctusb</literal> and
|
||||
<literal>lcd2usb</literal> connection types.
|
||||
Legal values for <replaceable>CONTRAST</replaceable> are
|
||||
<literal>0</literal> - <literal>1000</literal>.
|
||||
If not given, it defaults to <literal>500</literal> which may
|
||||
be too low or too high for the selected connection type.
|
||||
So, if the screen is blank or dark, please try playing with
|
||||
the contrast a bit.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
@@ -2625,13 +2680,16 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
|
||||
</arg>
|
||||
</term>
|
||||
<listitem><para>
|
||||
The "vertical span" when using multiple displays or multi-controller displays.
|
||||
It is a comma separated list of the heights of each display. In multi-controller
|
||||
displays it lists the number of lines each controller is responsible for.
|
||||
The "vertical span" when using the driver with multi-controller displays
|
||||
or with multiple displays that are treated as a single virtual display.
|
||||
It is a comma separated list of the heights of each display.
|
||||
In multi-controller displays it lists the number of lines each controller
|
||||
is responsible for.
|
||||
</para>
|
||||
<para>
|
||||
E.g. <code>VSpan=2,2</code> means you have two displays and
|
||||
each has two lines.
|
||||
E.g. <code>vSpan=2,2,1</code> means you have three physical displays, the first
|
||||
two having two lines each, and the third having one line, that together form
|
||||
a virtual display that is 5 lines high.
|
||||
</para>
|
||||
<para>
|
||||
The sum of the <replaceable>HEIGHT</replaceable>s must match the total height
|
||||
@@ -2736,7 +2794,6 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
@@ -2760,6 +2817,18 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>
|
||||
<command>SerialNumber=</command>
|
||||
<arg choice="plain"><replaceable>VENDORID</replaceable></arg>
|
||||
</term>
|
||||
<listitem><para>
|
||||
Serial no. of the USB device to look for with <command>ConnectionType=</command><literal>bwctusb</literal>.
|
||||
If not given, the first BWCT USB module found will be used.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
</sect3>
|
||||
|
||||
</sect2>
|
||||
@@ -2818,7 +2887,7 @@ Updated April 2002, Rene Wagner <email>reenoo@gmx.de</email>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Updated and extended April 2006, Peter Marschall <email>peter@adpm.de</email>
|
||||
Updated and extended April 2006 to November 2007, Peter Marschall <email>peter@adpm.de</email>
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
<sect1 id="i2500vfd-howto">
|
||||
<title>The i2500vfd Driver</title>
|
||||
|
||||
<para>
|
||||
This section talks about using LCDproc with an Intra2net Intranator 2500 VFD display.
|
||||
The displays are part of a custom high grade steel chassis and not sold separately.
|
||||
More information can be found here: <ulink url="http://www.intra2net.com/">Intra2net AG</ulink>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
It connects to USB using a FTDI FT245BM chip and therefore needs libftdi as requirement.
|
||||
libftdi can be found here: <ulink url="http://www.intra2net.com/de/produkte/opensource/ftdi/">libftdi</ulink>
|
||||
</para>
|
||||
|
||||
<sect2 id="i2500vfd-features">
|
||||
<title>Features</title>
|
||||
|
||||
<para>
|
||||
The display features a 140x32 pixel Noritake VFD tube which gets driven
|
||||
by an Atmel ATmega128 processor and used as a 23x4 character display with a
|
||||
6x8 pixel font.
|
||||
It features B/W colors and two additional adjustable grayscale colors.
|
||||
It does hardware double buffering with up to 27 FPS and shows an animated boot logo
|
||||
until data is received from USB.
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2 id="i2500vfd-options">
|
||||
<title>Options</title>
|
||||
|
||||
<para>
|
||||
There are currently no options for this driver.
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
Reference in New Issue
Block a user