mmdolze
680891761e
* Add Doxygen comments (also for internal functions, shortened for API). * Document initialization. * Remove some unused variables and defines. * Pass through indent. * Remove references to LCD pins from documentation and add some warning.
180 lines
4.6 KiB
Plaintext
180 lines
4.6 KiB
Plaintext
<sect1 id="t6963-howto">
|
|
<title>The Toshiba T6963 Driver</title>
|
|
|
|
<para>
|
|
This section talks about using LCDproc with LCD displays that use the
|
|
T6963 chipset from Toshiba. Usually, this chipset is used on big character LCD
|
|
displays that can often act as a screen.
|
|
</para>
|
|
|
|
<para>
|
|
The driver uses the text mode of the chipset with a custom font loaded which
|
|
resembles the characters from Code Page 437.
|
|
</para>
|
|
|
|
<para>
|
|
Only displays in 'Single Scan' configurations are supported. Displays configured
|
|
as 'Dual Scan' are currently not supported. Those use onboard memory differently.
|
|
Check the datasheet of your display!
|
|
</para>
|
|
|
|
<sect2 id="t6963-connections">
|
|
<title>Connections</title>
|
|
|
|
<warning>
|
|
<para>
|
|
Displays using T6963 chipset come in a variety of pin-outs and power configurations.
|
|
They usually require negative voltage for contrast and some displays have
|
|
a negative voltage generator onboard. Therefore the wiring table below does
|
|
only list signal names, not LCD pins. Be sure to get the correct datasheet
|
|
for your display and identify the pins to use!
|
|
</para>
|
|
<para>
|
|
We do not give wiring examples for power, contrast, and other control lines.
|
|
You have to figure out this from your display's datasheet!
|
|
</para>
|
|
</warning>
|
|
|
|
<table id="t6963-connections.mapping">
|
|
<title>T6963 wiring schematic</title>
|
|
<tgroup cols="5" align="left">
|
|
<colspec colname="lpt1"/>
|
|
<colspec colname="lpt2" align="right"/>
|
|
<colspec colname="base" align="center"/>
|
|
<colspec colname="lcd1"/>
|
|
<colspec colname="lcd2"/>
|
|
<thead>
|
|
<row>
|
|
<entry namest="lpt1" nameend="lpt2" align="center">Parallel port</entry>
|
|
<entry morerows="1"><-></entry>
|
|
<entry namest="lcd1" nameend="lcd2" align="center">LCD</entry>
|
|
</row>
|
|
<row>
|
|
<entry>name</entry>
|
|
<entry>pin</entry>
|
|
<entry>name</entry>
|
|
<entry>pin</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>nSTRB</entry>
|
|
<entry>1</entry>
|
|
<entry></entry>
|
|
<entry>/WR</entry>
|
|
<entry>*</entry>
|
|
</row>
|
|
<row>
|
|
<entry>D0-D7</entry>
|
|
<entry>2-9</entry>
|
|
<entry></entry>
|
|
<entry>DB0-DB7</entry>
|
|
<entry>*</entry>
|
|
</row>
|
|
<row>
|
|
<entry>nLF</entry>
|
|
<entry>14</entry>
|
|
<entry></entry>
|
|
<entry>/CE</entry>
|
|
<entry>*</entry>
|
|
</row>
|
|
<row>
|
|
<entry>INIT</entry>
|
|
<entry>16</entry>
|
|
<entry></entry>
|
|
<entry>C/D</entry>
|
|
<entry>*</entry>
|
|
</row>
|
|
<row>
|
|
<entry>nSEL</entry>
|
|
<entry>17</entry>
|
|
<entry></entry>
|
|
<entry>/RD</entry>
|
|
<entry>*</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="t6963-compiling">
|
|
<title>Compiling</title>
|
|
|
|
<para>
|
|
Make sure that the T6963 files are built when you run configure. This
|
|
can be done by specifying "--enable-drivers=all" or by
|
|
"--enable-drivers=t6963".
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<!-- ## Toshiba T6963 driver ## -->
|
|
<sect2 id="t6963-config">
|
|
<title>Configuration in LCDd.conf</title>
|
|
|
|
<sect3 id="t6963-config-section">
|
|
<title>[t6963]</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<property>Size</property> = ¶meters.size;
|
|
</term>
|
|
<listitem><para>
|
|
set display size [default: <literal>20x6</literal>]
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<property>Port</property> =
|
|
<parameter><replaceable>PORT</replaceable></parameter>
|
|
</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>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<property>ECPlpt</property> = ¶meters.yesdefno;
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Is ECP mode on? [default: <literal>yes</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
|
|
</para>
|
|
<para>
|
|
Despite its name, this driver does not use ECP mode of parallel port. This
|
|
option turns bi-directional mode of the port on or off. Leave this on
|
|
unless you experience problems.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<property>graphic</property> = ¶meters.yesnodef;
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Use graphic? [default: <literal>no</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
|
|
</para>
|
|
<para>
|
|
Enables / disables drawing of the content of the graphic RAM. This is
|
|
currently a no-op as the driver does not make use of the graphic RAM.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|