update user's guide

This commit is contained in:
marschap
2006-04-05 10:36:58 +00:00
parent fa88c2b8eb
commit bb49a9182b
39 changed files with 4149 additions and 513 deletions
+105 -68
View File
@@ -3,7 +3,7 @@
<para>
This section talks about using LCDproc with LCD displays that use the
T6963 chipset. Usually, this chipset is used on big character LCD
T6963 chipset from Toshiba. Usually, this chipset is used on big character LCD
displays that can often act as a screen.
</para>
@@ -13,42 +13,42 @@ displays that can often act as a screen.
<table>
<title>T6963 wiring schematic</title>
<tgroup cols="2">
<thead>
<row>
<entry>Parallel port</entry>
<entry>LCD</entry>
</row>
</thead>
<tbody>
<row>
<entry>1 (Strobe)</entry>
<entry>5 (WR)</entry>
</row>
<row>
<entry>2-9 (Data)</entry>
<entry>11-18 (Data)</entry>
</row>
<row>
<entry>14 (Autofeed)</entry>
<entry>7 (CE)</entry>
</row>
<row>
<entry>16 (Init)</entry>
<entry>8 (C/D)</entry>
</row>
<row>
<entry>17 (Slct)</entry>
<entry>6 (RD)</entry>
</row>
<row>
<entry>18 (GND)</entry>
<entry>3 (GND)</entry>
</row>
<row>
<entry>+5V</entry>
<entry>3 (LCD +)</entry>
</row>
</tbody>
<thead>
<row>
<entry>Parallel port</entry>
<entry>LCD</entry>
</row>
</thead>
<tbody>
<row>
<entry>1 (Strobe)</entry>
<entry>5 (WR)</entry>
</row>
<row>
<entry>2-9 (Data)</entry>
<entry>11-18 (Data)</entry>
</row>
<row>
<entry>14 (Autofeed)</entry>
<entry>7 (CE)</entry>
</row>
<row>
<entry>16 (Init)</entry>
<entry>8 (C/D)</entry>
</row>
<row>
<entry>17 (Slct)</entry>
<entry>6 (RD)</entry>
</row>
<row>
<entry>18 (GND)</entry>
<entry>3 (GND)</entry>
</row>
<row>
<entry>+5V</entry>
<entry>3 (LCD +)</entry>
</row>
</tbody>
</tgroup>
</table>
@@ -65,41 +65,74 @@ can be done by specifying "--enable-drivers=all" or by
</sect2>
<sect2 id="T6963-configuration">
<title>Configuration</title>
<!-- ## Toshiba T6963 driver ## -->
<sect2 id="t6963-config">
<title>Configuration in LCDd.conf</title>
<para>
Since LCDproc 0.4.3 the T6963 driver must be configured from the configfile (LCDd.conf).
</para>
<sect3>
<title>[t6963]</title>
<para>
At the time of writing, the T6369 driver uses the Arguments option for its
configuration. This will be parsed as if is was passed as argument to a program.
</para>
<variablelist>
<varlistentry>
<term>
<command>Size=</command>
<arg choice="plain">
<replaceable>WIDTH</replaceable>
<literal>x</literal>
<replaceable>HEIGHT</replaceable>
</arg>
</term>
<listitem><para>
set display size [default: 20x6]
</para></listitem>
</varlistentry>
<table>
<title>Arguments</title>
<tgroup cols="2">
<thead>
<row>
<entry>-p --port</entry>
<entry>Select the output port to use [0x378]</entry>
</row>
</thead>
<tbody>
<row>
<entry>-t --type</entry>
<entry>Select the LCD type (size) [20x6]</entry>
</row>
</tbody>
</tgroup>
</table>
<varlistentry>
<term>
<command>Port=</command>
<arg choice="plain"><replaceable>PORT</replaceable></arg>
</term>
<listitem><para>
Specify the address of the parallel port the LCD is connected to.
Common values for <replaceable>PORT</replaceable> are <literal>0x278</literal>,
<literal>0x378</literal> and <literal>0x3BC</literal>.
Legal values are <literal>0x200</literal> - <literal>0x400</literal>.
If not given the default value is <literal>0x378</literal>.
</para></listitem>
</varlistentry>
<tip>
<para>
An example configuration could look like this: Arguments="--port 0x378 --type=20x6"
</para>
</tip>
<varlistentry>
<term>
<command>ECPlpt=</command>
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal><emphasis>yes</emphasis></literal></arg>
<arg choice="plain"><literal>no</literal></arg>
</group>
</arg>
</term>
<listitem><para>
Is ECP mode on? [default: yes; legal: yes, no]
</para></listitem>
</varlistentry>
<varlistentry>
<term>
<command>graphic=</command>
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal>yes</literal></arg>
<arg choice="plain"><literal><emphasis>no</emphasis></literal></arg>
</group>
</arg>
</term>
<listitem><para>
Use graphic? [default: no; legal: yes, no]
</para></listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>
@@ -114,15 +147,19 @@ detailed instructions on how to configure the T6963 driver.
<para>
Then as usual, start LCDd with the correct config file:
</para>
<para>
E.g. <command>LCDd -c ./LCDd.conf</command>
</para>
<para>
If you want to override the driver selection in LCDd.conf then use:
</para>
<para>
<command>LCDd -c ./LCDd.conf -d T6963</command>
</para>
<para>
If you use this, the T6963 driver will read the options from the config
file anyway.