mtxorb.docbook

linux下LCD驱动的例子代码

<para>
This section was originally part of the lcdproc.sgml file by William W. Ferrell <email>[e-mail]</email>
</para>

<para>
Slightly modified in order to include it in this document March 2002, Rene Wagner <email>[e-mail]</email>
</para>
</sect2>
-->

<!-- ## Matrix Orbital driver ## -->
<sect2 id="MtxOrb-config">
<title>Configuration in LCDd.conf</title>

<sect3 id="MtxOrb-config-section">
<title>[MtxOrb]</title>

<variablelist>
<varlistentry>
  <term>
    <command>Device=</command>
    <arg choice="plain"><replaceable>DEVICE</replaceable></arg>
  </term>
  <listitem><para>
    Select the output device to use [default: <filename>/dev/lcd</filename>]
  </para></listitem>
</varlistentry>

<varlistentry>
  <term>
    <command>Size=</command>
    <arg choice="plain">
      <replaceable>WIDTH</replaceable>
      <literal>x</literal>
      <replaceable>HEIGHT</replaceable>
    </arg>
  </term>
  <listitem><para>
    Set the display size [default: <literal>20x4</literal>]
  </para></listitem>
</varlistentry>

<varlistentry>
  <term>
    <command>Backlight=</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>
    Switch on the backlight? [default: <literal>yes</literal>; legal: <literal>yes</literal>, <literal>no</literal>]
    </para>
    <note><para>
      The driver will ignore this setting if the display
      is a VFD or VKD as they crash if the backlight is turned off.
    </para></note>
  </listitem>
</varlistentry>

<varlistentry>
  <term>
    <command>Contrast=</command>
    <arg choice="plain"><replaceable>CONTRAST</replaceable></arg>
  </term>
  <listitem><para>
    Set the initial contrast.
    Legal values for <replaceable>CONTRAST</replaceable> are <literal>0</literal> - <literal>1000</literal>.
    If not given, the default value is <literal>480</literal>.
    </para>
    <note><para>
      The driver will ignore this setting if the display
      is a VFD or VKD as they do not support this feature.
    </para></note>
  </listitem>
</varlistentry>

<varlistentry>
  <term>
    <command>Speed=</command>
    <arg choice="plain">
    <group choice="req">
      <arg choice="plain"><literal>1200</literal></arg>
      <arg choice="plain"><literal>2400</literal></arg>
      <arg choice="plain"><literal>9600</literal></arg>
      <arg choice="plain"><literal><emphasis>19200</emphasis></literal></arg>
    </group>
    </arg>
  </term>
  <listitem><para>
    Set the the baud rate to use when communicating with the LCD.
    If not specified, it defaults to <literal>19200</literal>.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term>
    <command>Type=</command>
    <arg choice="plain">
    <group choice="req">
      <arg choice="plain"><literal><emphasis>lcd</emphasis></literal></arg>
      <arg choice="plain"><literal>lkd</literal></arg>
      <arg choice="plain"><literal>vfd</literal></arg>
      <arg choice="plain"><literal>vkd</literal></arg>
    </group>
    </arg>
  </term>
  <listitem><para>
    Set the display type [default: <literal>lcd</literal>; legal: <literal>lcd</literal>,
								  <literal>lkd</literal>,
								  <literal>vfd</literal>,
								  <literal>vkd</literal>]
  </para></listitem>
</varlistentry>

<varlistentry>
  <term>
    <command>KeyMap_<replaceable>LETTER</replaceable>=</command>
    <arg choice="plain"><replaceable>KEY</replaceable></arg>
  </term>
  <listitem>
    <para>
    Matrix Orbital displays support keypads with up to 25 keys, which return
    one of the letters <literal>A</literal> - <literal>Y</literal> for each
    pressed key.
    </para>
    <para>
    These settings allow to map the letter <replaceable>LETTER</replaceable>,
    that is generated by the display when a key is pressed, to be mapped to
    a key name <replaceable>KEY</replaceable> that <command>LCDd</command>
    can understand (see <link linkend="menu-section" endterm="menu-section.title"/>
    for more information).
    </para>
    <para>
    There is no default key mapping; if no keys are mapped in the
    <filename>LCDd.conf</filename> config file, the display is treated
    as if it had no keys attached.
    </para>
    <example id="MtxOrb-config-keymap-example">
      <programlisting>
      KeyMap_A=Left
      KeyMap_B=Right
      KeyMap_C=Up
      KeyMap_D=Down
      KeyMap_E=Enter
      KeyMap_F=Escape
      </programlisting>
    </example>  
  </listitem>
</varlistentry>

<!--
<varlistentry>
  <term>
    <command>LeftKey=</command>
    <arg choice="plain"><replaceable>MTX-KEY</replaceable></arg>
  </term>
  <term>
    <command>RightKey=</command>
    <arg choice="plain"><replaceable>MTX-KEY</replaceable></arg>
  </term>
  <term>
    <command>EnterKey=</command>
    <arg choice="plain"><replaceable>MTX-KEY</replaceable></arg>
  </term>
  <term>
    <command>UpKey=</command>
    <arg choice="plain"><replaceable>MTX-KEY</replaceable></arg>
  </term>
  <term>
    <command>DownKey=</command>
    <arg choice="plain"><replaceable>MTX-KEY</replaceable></arg>
  </term>
  <term>
    <command>EscapeKey=</command>
    <arg choice="plain"><replaceable>MTX-KEY</replaceable></arg>
  </term>
  <listitem><para>
    The following table translate from MtxOrb Key to Logical Key.
    See [input] section for an explanation of the key mappings
    This is a new implementation in 0.5
    Legal values for <replaceable>MTX-KEY</replaceable> are the letters
    <literal>A</literal> - <literal>F</literal>.
  </para></listitem>
</varlistentry>
-->

<varlistentry>
  <term>
    <command>keypad_test_mode=</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>
    You can find out which key of your display sends which
    character by setting keypad_test_mode to yes and running
    LCDd. LCDd will output all characters it receives.
    Afterwards you can modify the settings above and set
    keypad_set_mode to no again.
  </para></listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

</sect1>