lcdproc/docs/lcdproc-user/drivers/t6963.docbook

<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>

<sect2 id="t6963-connections">
<title>Connections</title>

<table id="t6963-connections.mapping">
<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>
</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> = &parameters.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> = &parameters.yesdefno;
  </term>
  <listitem><para>
    Is ECP mode on? [default: <literal>yes</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
  </para></listitem>
</varlistentry>

<varlistentry>
  <term>
    <property>graphic</property> = &parameters.yesnodef;
  </term>
  <listitem><para>
    Use graphic? [default: <literal>no</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
  </para></listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

<sect2 id="t6963-running">
<title>Running</title>

<para>
Modify the <filename>LCDd.conf</filename> file before you run LCDd. In this config file are
detailed instructions on how to configure the T6963 driver.
</para>

<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.
</para>

</sect2>

</sect1>