mangavalk/lcdproc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update hd44780 doc, fix issue with option names in doc; update ChangeLog

Browse Source
This commit is contained in:
marschap
2007-12-27 18:58:24 +00:00
parent 31974b240e
commit 2fab392592
42 changed files with 403 additions and 358 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/lcdproc-user/drivers/hd44780.docbook
+174 -130
View File
@@ -223,6 +223,8 @@ There are several ways to get 5V:
</para></listitem>
<listitem><para>
Get it from the V<subscript>CC</subscript> and GND pins of an USB connector.
For the USB connection types this is done automatically, as the circuits
used there automatically power the LCD.
</para></listitem>
<listitem><para>
Get it from a joystick port (pin 1 and 9 are 5V, 4, 5 and 12 are GND).
@@ -306,36 +308,46 @@ per input pin. It is a simple solution if you need only few keys.
<para>
By default, the following keystrokes are generated by the different keys:
</para>
<table id="hd44780-connections-keypad-direct.mapping">
<title>HD44780: Direct Key Mapping</title>
<tgroup cols="2" align="left">
<thead>
<row>
<entry>key index</entry>
<entry>mapped string</entry>
</row>
</thead>
<tbody>
<row>
<entry>X0</entry>
<entry>1</entry>
<entry><literal>A</literal></entry>
</row>
<row>
<entry>X1</entry>
<entry>2</entry>
<entry><literal>B</literal></entry>
</row>
<row>
<entry>X2</entry>
<entry>3</entry>
<entry><literal>C</literal></entry>
</row>
<row>
<entry>X3</entry>
<entry>4</entry>
<entry><literal>D</literal></entry>
</row>
<row>
<entry>X4</entry>
<entry>5</entry>
<entry><literal>E</literal></entry>
</row>
</tbody>
</tgroup>
</table>
but you can change the mapping using the
<command>KeyDirect_<replaceable>NUM</replaceable></command> =
configuration parameter.
</para>
</sect5>
<sect5 id="hd44780-connections-keypad-matrix">
@@ -377,13 +389,13 @@ We connect the matrix of keys like this:
<screen>
<![CDATA[
Y0 o---|<---@--@--@
| | |
Y1 o---|<---@--@--@
| | |
Y2 o---|<---@--@--@
| | |
Y3 o---|<---@--@--@ O 5V
Y3 o---|<---@--@--@
| | |
Y4 o---|<---@--@--@ O 5V
| | | |
diodes | | | ___ |
1N4148 +----------|___|---+
@@ -393,7 +405,7 @@ Y3 o---|<---@--@--@ O 5V
| | +----|___|---+ resistors 22k
| | |
o o o
X0 X1 X2
X1 X2 X3
]]>
</screen>
@@ -401,9 +413,9 @@ Y3 o---|<---@--@--@ O 5V
<para>
As you can see, you need 1 resistor per X line, and 1 diode per Y line.
Lcdproc will presume that you have a keypad with a layout like a telephone
connected, with X and Y lines connected as show. To be more precise, it
assumes this:
By default, Lcdproc will presume that you have a keypad with a layout
like a telephone connected, with X and Y lines connected as show.
To be more precise, it assumes this mapping:
</para>
<table id="hd44780-connections-keypad-matrix.mapping">
@@ -412,14 +424,14 @@ assumes this:
<tbody>
<row>
<entry></entry>
<entry><emphasis>X0</emphasis></entry>
<entry><emphasis>X1</emphasis></entry>
<entry><emphasis>X2</emphasis></entry>
<entry><emphasis>X3</emphasis></entry>
<entry><emphasis>X4</emphasis></entry>
<entry><emphasis>X5</emphasis></entry>
</row>
<row>
<entry><emphasis>Y0</emphasis></entry>
<entry><emphasis>Y1</emphasis></entry>
<entry><literal>1</literal></entry>
<entry><literal>2</literal></entry>
<entry><literal>3</literal></entry>
@@ -427,7 +439,7 @@ assumes this:
<entry><literal>E</literal></entry>
</row>
<row>
<entry><emphasis>Y1</emphasis></entry>
<entry><emphasis>Y2</emphasis></entry>
<entry><literal>4</literal></entry>
<entry><literal>5</literal></entry>
<entry><literal>6</literal></entry>
@@ -435,7 +447,7 @@ assumes this:
<entry><literal>F</literal></entry>
</row>
<row>
<entry><emphasis>Y2</emphasis></entry>
<entry><emphasis>Y3</emphasis></entry>
<entry><literal>7</literal></entry>
<entry><literal>8</literal></entry>
<entry><literal>9</literal></entry>
@@ -443,7 +455,7 @@ assumes this:
<entry><literal>G</literal></entry>
</row>
<row>
<entry><emphasis>Y3</emphasis></entry>
<entry><emphasis>Y4</emphasis></entry>
<entry><literal>*</literal></entry>
<entry><literal>0</literal></entry>
<entry><literal>#</literal></entry>
@@ -454,8 +466,12 @@ assumes this:
</tgroup>
</table>
This mapping can be changed using the
<command>KeyMatrix_<replaceable>X</replaceable>_<replaceable>Y</replaceable></command> =
configuration parameter.
<para>
If you only need 10 keys, leave the rest away.
If you only need e.g. 10 keys, leave the rest away.
You should modify and recompile the
driver to get an other keypad layout.
</para>
@@ -483,13 +499,13 @@ wiring, it looks (completely drawn) like this:
diodes | |
1N4148 '-'
___ |
Y0 o---|<---o o---+
___ |
Y1 o---|<---o o---+
___ |
Y2 o---|<---o o---+
___ |
Y3 o---|<---o o---+----o return line
Y3 o---|<---o o---+
___ |
Y4 o---|<---o o---+----o return line
]]>
</screen>
@@ -797,91 +813,91 @@ The optional keypad can be connected as follows:
<entry>D0</entry>
<entry>2</entry>
<entry></entry>
<entry>Y0</entry>
<entry>Y1</entry>
</row>
<row>
<entry>D1</entry>
<entry>3</entry>
<entry></entry>
<entry>Y1</entry>
<entry>Y2</entry>
</row>
<row>
<entry>D2</entry>
<entry>4</entry>
<entry></entry>
<entry>Y2</entry>
<entry>Y3</entry>
</row>
<row>
<entry>D3</entry>
<entry>5</entry>
<entry></entry>
<entry>Y3</entry>
<entry>Y4</entry>
</row>
<row>
<entry>D4</entry>
<entry>6</entry>
<entry></entry>
<entry>Y4</entry>
<entry>Y5</entry>
</row>
<row>
<entry>D5</entry>
<entry>7</entry>
<entry></entry>
<entry>Y5</entry>
<entry>Y6</entry>
</row>
<row>
<entry>nSTRB</entry>
<entry>1</entry>
<entry></entry>
<entry>Y6</entry>
<entry>Y7</entry>
</row>
<row>
<entry>nLF</entry>
<entry>14</entry>
<entry></entry>
<entry>Y7</entry>
<entry>Y8</entry>
</row>
<row>
<entry>INIT</entry>
<entry>16</entry>
<entry></entry>
<entry>Y8</entry>
<entry>Y9</entry>
</row>
<row>
<entry>nSEL</entry>
<entry>17</entry>
<entry></entry>
<entry>Y9</entry>
<entry>Y10</entry>
</row>
<row>
<entry>nACK</entry>
<entry>10</entry>
<entry></entry>
<entry>X0</entry>
<entry>X1</entry>
</row>
<row>
<entry>BUSY</entry>
<entry>11</entry>
<entry></entry>
<entry>X1</entry>
<entry>X2</entry>
</row>
<row>
<entry>PAPEREND</entry>
<entry>12</entry>
<entry></entry>
<entry>X2</entry>
<entry>X3</entry>
</row>
<row>
<entry>SELIN</entry>
<entry>13</entry>
<entry></entry>
<entry>X3</entry>
<entry>X4</entry>
</row>
<row>
<entry>nFAULT</entry>
<entry>15</entry>
<entry></entry>
<entry>X4</entry>
<entry>X5</entry>
</row>
</tbody>
</tgroup>
@@ -1052,91 +1068,91 @@ The optional keypad can be connected as follows:
<entry>D0</entry>
<entry>2</entry>
<entry></entry>
<entry>Y0</entry>
<entry>Y1</entry>
</row>
<row>
<entry>D1</entry>
<entry>3</entry>
<entry></entry>
<entry>Y1</entry>
<entry>Y2</entry>
</row>
<row>
<entry>D2</entry>
<entry>4</entry>
<entry></entry>
<entry>Y2</entry>
<entry>Y3</entry>
</row>
<row>
<entry>D3</entry>
<entry>5</entry>
<entry></entry>
<entry>Y3</entry>
<entry>Y4</entry>
</row>
<row>
<entry>D4</entry>
<entry>6</entry>
<entry></entry>
<entry>Y4</entry>
<entry>Y5</entry>
</row>
<row>
<entry>D5</entry>
<entry>7</entry>
<entry></entry>
<entry>Y5</entry>
<entry>Y6</entry>
</row>
<row>
<entry>D6</entry>
<entry>8</entry>
<entry></entry>
<entry>Y6</entry>
<entry>Y7</entry>
</row>
<row>
<entry>D7</entry>
<entry>9</entry>
<entry></entry>
<entry>Y7</entry>
<entry>Y8</entry>
</row>
<row>
<entry>nLF</entry>
<entry>14</entry>
<entry></entry>
<entry>Y8</entry>
<entry>Y9</entry>
</row>
<row>
<entry>INIT</entry>
<entry>16</entry>
<entry></entry>
<entry>Y9</entry>
<entry>Y10</entry>
</row>
<row>
<entry>nACK</entry>
<entry>10</entry>
<entry></entry>
<entry>X0</entry>
<entry>X1</entry>
</row>
<row>
<entry>BUSY</entry>
<entry>11</entry>
<entry></entry>
<entry>X1</entry>
<entry>X2</entry>
</row>
<row>
<entry>PAPEREND</entry>
<entry>12</entry>
<entry></entry>
<entry>X2</entry>
<entry>X3</entry>
</row>
<row>
<entry>SELIN</entry>
<entry>13</entry>
<entry></entry>
<entry>X3</entry>
<entry>X4</entry>
</row>
<row>
<entry>nFAULT</entry>
<entry>15</entry>
<entry></entry>
<entry>X4</entry>
<entry>X5</entry>
</row>
</tbody>
</tgroup>
@@ -1324,91 +1340,91 @@ The optional keypad can be connected as follows:
<entry>D0</entry>
<entry>2</entry>
<entry></entry>
<entry>Y0</entry>
<entry>Y1</entry>
</row>
<row>
<entry>D1</entry>
<entry>3</entry>
<entry></entry>
<entry>Y1</entry>
<entry>Y2</entry>
</row>
<row>
<entry>D2</entry>
<entry>4</entry>
<entry></entry>
<entry>Y2</entry>
<entry>Y3</entry>
</row>
<row>
<entry>D3</entry>
<entry>5</entry>
<entry></entry>
<entry>Y3</entry>
<entry>Y4</entry>
</row>
<row>
<entry>D4</entry>
<entry>6</entry>
<entry></entry>
<entry>Y4</entry>
<entry>Y5</entry>
</row>
<row>
<entry>D5</entry>
<entry>7</entry>
<entry></entry>
<entry>Y5</entry>
<entry>Y6</entry>
</row>
<row>
<entry>D6</entry>
<entry>8</entry>
<entry></entry>
<entry>Y6</entry>
<entry>Y7</entry>
</row>
<row>
<entry>D7</entry>
<entry>9</entry>
<entry></entry>
<entry>Y7</entry>
<entry>Y8</entry>
</row>
<row>
<entry>nSTRB</entry>
<entry>1</entry>
<entry></entry>
<entry>Y8</entry>
<entry>Y9</entry>
</row>
<row>
<entry>nSEL</entry>
<entry>17</entry>
<entry></entry>
<entry>Y9</entry>
<entry>Y10</entry>
</row>
<row>
<entry>nACK</entry>
<entry>10</entry>
<entry></entry>
<entry>X0</entry>
<entry>X1</entry>
</row>
<row>
<entry>BUSY</entry>
<entry>11</entry>
<entry></entry>
<entry>X1</entry>
<entry>X2</entry>
</row>
<row>
<entry>PAPEREND</entry>
<entry>12</entry>
<entry></entry>
<entry>X2</entry>
<entry>X3</entry>
</row>
<row>
<entry>SELIN</entry>
<entry>13</entry>
<entry></entry>
<entry>X3</entry>
<entry>X4</entry>
</row>
<row>
<entry>nFAULT</entry>
<entry>15</entry>
<entry></entry>
<entry>X4</entry>
<entry>X5</entry>
</row>
</tbody>
</tgroup>
@@ -1470,21 +1486,21 @@ GND to pin 8 of the IC.
5V | shift reg | display
O | | keys
| 1| |4
+----|STR Q0|--------------------o 11 D4 Y0
+----|STR Q0|--------------------o 11 D4 Y1
| | |5
Data | 2| Q1|--------------------o 12 D5 Y1
Data | 2| Q1|--------------------o 12 D5 Y2
D3 5 o-------------------------|D |6
| | Q2|--------------------o 13 D6 Y2
| | Q2|--------------------o 13 D6 Y3
| 3| |7
D4 6 o-------------------------|CK Q3|--------------------o 14 D7 Y3
D4 6 o-------------------------|CK Q3|--------------------o 14 D7 Y4
| | |14
| 15| Q4|--------------------o Y4
| 15| Q4|--------------------o Y5
+----|OE |13
| Q5|--------------------o 4 RS Y5
| Q5|--------------------o 4 RS Y6
| |12
| Q6|--------------------o Y6
| Q6|--------------------o Y7
| |11
| Q7|--------------------o Y7
| Q7|--------------------o Y8
| |9
| QS|-- +--o 5 RW
| __|10 |
@@ -1530,19 +1546,19 @@ complex. If you do not understand the schematic, do not build it.
| shift reg | display
| | keys
Data 1| |3
D3 5 o---------------------+---|D Q0|--------------------o 11 D4 Y0
D3 5 o---------------------+---|D Q0|--------------------o 11 D4 Y1
| | |4
| 2| Q1|--------------------o 12 D5 Y1
| 2| Q1|--------------------o 12 D5 Y2
+---|D |5
| Q2|--------------------o 13 D6 Y2
| Q2|--------------------o 13 D6 Y3
| |6
| Q3|--------------------o 14 D7 Y3
| Q3|--------------------o 14 D7 Y4
| |10
Clock 8| Q4|--------------------o Y4
Clock 8| Q4|--------------------o Y5
D4 6 o-------------------------|CK |11
| Q5|--------------------o 4 RS Y5
| Q5|--------------------o 4 RS Y6
___ 9|\ 8 9|_ |12
+--|___|--+----| >o----|R Q6|--------------------o Y6
+--|___|--+----| >o----|R Q6|--------------------o Y7
| 22k | |/ | |13
| --- IC1 | Q7|---+ +--o 5 RW
| --- | | | 5V |
@@ -1618,31 +1634,31 @@ serialLpt wiring supports a keypad. The 3 wires version supports
<entry>nACK</entry>
<entry>10</entry>
<entry></entry>
<entry>X0</entry>
<entry>X1</entry>
</row>
<row>
<entry>BUSY</entry>
<entry>11</entry>
<entry></entry>
<entry>X1</entry>
<entry>X2</entry>
</row>
<row>
<entry>PAPEREND</entry>
<entry>12</entry>
<entry></entry>
<entry>X2</entry>
<entry>X3</entry>
</row>
<row>
<entry>SELIN</entry>
<entry>13</entry>
<entry></entry>
<entry>X3</entry>
<entry>X4</entry>
</row>
<row>
<entry>nFAULT</entry>
<entry>15</entry>
<entry></entry>
<entry>X4</entry>
<entry>X5</entry>
</row>
</tbody>
</tgroup>
@@ -1925,7 +1941,7 @@ serial port <filename>/dev/ttyUSB<replaceable>x</replaceable></filename>.
The PIC-an-LCD module is also supported. It is not connected to the LPT port
but to a serial port, which saves you from a lot of potential problems.
To use it, specify the device to which you have connected the module in the
config file with the <command>Device=</command> setting.
config file with the <command>Device</command> setting.
The default is <filename>/dev/lcd</filename>.
It does not support a keypad nor backlight switching.
</para>
@@ -2128,7 +2144,7 @@ The board, driven by the <code>bwctusb</code> 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 you can set the display's contrast using software
(see the <command>Contrast=</command> configuration parameter).
(see the <command>Contrast</command> configuration parameter).
</para>
<sect4 id="hd44780-bwctusb-config">
@@ -2136,7 +2152,7 @@ But you can set the display's contrast using software
<para>
If there is more than one BWCT USB module connected to the system,
the <command>SerialNumber=</command> configuration parameter allows
the <command>SerialNumber</command> configuration parameter allows
selecting which display is used in LCDd.
</para>
@@ -2170,7 +2186,7 @@ for your own interface e.g. for a graphic LCD.
<para>
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:
the <command>DirectKey_1</command> to <command>DirectKey_3</command> commands:
one for each key and the third if the keys are pressed simultaneously.
With this 3-key setup, menus can be used (see example below).
</para>
@@ -2181,9 +2197,9 @@ With this 3-key setup, menus can be used (see example below).
<para>
Besides the standard configuration options for <code>hd44780</code> displays, the
<code>lcd2usb</code> connection type supports three additional options:
<command>Contrast=</command> to set the display's contrast,
<command>Brightness=</command> to set the display's brightness when the backlight is switched on and
<command>OffBrightness=</command> to set the display's brightness when is backlight is switched off.
<command>Contrast</command> to set the display's contrast,
<command>Brightness</command> to set the display's brightness when the backlight is switched on and
<command>OffBrightness</command> to set the display's brightness when is backlight is switched off.
All three options expect a number in the range from <literal>0</literal> to <literal>1000</literal>.
</para>
@@ -2214,7 +2230,7 @@ KeyDirect_3=Escape
<tip>
<para>
In order to make the <code>lcd2usb</code> connection type work with a 2-controller display
you may need to set the <command>vSpan=</command> config option accordingly.
you may need to set the <command>vSpan</command> config option accordingly.
</para>
</tip>
</sect4>
@@ -2299,7 +2315,7 @@ Keypad=no
</example>
<para>
The <command>Device=</command> configuration setting denotes the device file
The <command>Device</command> configuration setting denotes the device file
of your I<superscript>2</superscript>C bus (here <filename>/dev/i2c-0</filename>).
You have to load the kernel standard module <filename>i2c-dev.ko</filename> and
the bus driver, but <emphasis>no</emphasis> I<superscript>2</superscript>C
@@ -2307,7 +2323,7 @@ chip modules (e.g. <filename>pcf8574.ko</filename>)!
</para>
<para>
The <command>Port=</command> config option contains the I<superscript>2</superscript>C
The <command>Port</command> config option contains the I<superscript>2</superscript>C
address of the I<superscript>2</superscript>C port expander
(here 0x20, the PCF8574 from the example above, with all address bits set to <literal>0</literal>).
@@ -2323,7 +2339,7 @@ off the address.
<tgroup cols="2" align="left">
<thead>
<row>
<entry><command>Port=</command> value</entry>
<entry><command>Port</command> value</entry>
<entry>Meaning</entry>
</row>
</thead>
@@ -2376,7 +2392,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<variablelist>
<varlistentry>
<term>
<command>Port=</command>
<command>Port</command> =
<arg choice="plain"><replaceable>PORT</replaceable></arg>
</term>
<listitem><para>
@@ -2389,7 +2405,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Device=</command>
<command>Device</command> =
<arg choice="plain"><replaceable>DEVICE</replaceable></arg>
</term>
<listitem><para>
@@ -2403,7 +2419,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>ConnectionType=</command>
<command>ConnectionType</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal><emphasis>4bit</emphasis></literal></arg>
@@ -2512,7 +2528,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<tip>
<para>
The above table might be outdated, when you read this.
<!-- The above table might be outdated, when you read this. -->
If you suspect the table above to be outdated, you might want to have a look at
<filename>server/drivers/hd44780-drivers.h</filename> in <package>LCDproc</package>'s
source directory which contains the actual translation code.
@@ -2524,7 +2540,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Speed=</command>
<command>Speed</command> =
<arg choice="plain"><replaceable>BITRATE</replaceable></arg>
</term>
<listitem><para>
@@ -2535,27 +2551,53 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Charmap=</command>
<command>CharMap</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal><emphasis>hd44780_default</emphasis></literal></arg>
<arg choice="plain"><literal>hd44780_euro</literal></arg>
<arg choice="plain"><literal>ea_ks0073</literal></arg>
<arg choice="plain"><literal>sed12780f_0b</literal></arg>
</group>
</arg>
</term>
<listitem><para>
You need to set this parameter only if you do not have a standard
HD44780 display. <literal>ea_ks0073</literal> is the charmap for Electronic
Assembly's KS0073 based displays. These devices have a richer
charset, including many icons and many more characters of the
ISO-8859-1 than standard HD44780s. Refer to <filename>hd44780-charset.h</filename>
for more information.
Set the character mapping depending on the display you have:
<itemizedlist>
<listitem><para>
The default, <literal>hd44780_default</literal>, is for "classic"
HD44780 displays.
</para></listitem>
<listitem><para>
<literal>hd44780_euro</literal> is for displays with a ROM mask
supporting the european charset (ROM code A02).
</para></listitem>
<listitem><para>
<literal>ea_ks0073</literal> is the charmap for Electronic
Assembly's KS0073 based displays. These devices have a richer
charset, including many icons and many more characters of the
ISO-8859-1 than standard HD44780s.
</para></listitem>
<listitem><para>
<literal>sed12780f_0b</literal> is for some SED 12780F displays.
</para></listitem>
</itemizedlist>
You only need to set this parameter if you have a non-standard
HD44780 display.
<tip>
<para>
See <filename>server/drivers/hd44780-charset.h</filename>
in <package>LCDproc</package>'s source directory for the actual
mappings.
</para>
</tip>
</para></listitem>
</varlistentry>
<varlistentry>
<term>
<command>Keypad=</command>
<command>Keypad</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal>yes</literal></arg>
@@ -2571,7 +2613,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Brightness=</command>
<command>Brightness</command> =
<arg choice="plain"><replaceable>BRIGHTNESS</replaceable></arg>
</term>
<listitem><para>
@@ -2584,7 +2626,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>OffBrightness=</command>
<command>OffBrightness</command> =
<arg choice="plain"><replaceable>BRIGHTNESS</replaceable></arg>
</term>
<listitem><para>
@@ -2597,7 +2639,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Contrast=</command>
<command>Contrast</command> =
<arg choice="plain"><replaceable>CONTRAST</replaceable></arg>
</term>
<listitem><para>
@@ -2614,7 +2656,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Backlight=</command>
<command>Backlight</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal>yes</literal></arg>
@@ -2629,7 +2671,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>OutputPort=</command>
<command>OutputPort</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal>yes</literal></arg>
@@ -2645,7 +2687,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Lastline=</command>
<command>Lastline</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal><emphasis>yes</emphasis></literal></arg>
@@ -2662,7 +2704,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>Size=</command>
<command>Size</command> =
<arg choice="plain">
<replaceable>WIDTH</replaceable>
<literal>x</literal>
@@ -2678,7 +2720,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>vSpan=</command>
<command>vSpan</command> =
<arg choice="plain">
<replaceable>HEIGHT</replaceable>
<literal>,</literal>&hellip;
@@ -2704,7 +2746,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>ExtendedMode=</command>
<command>ExtendedMode</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal>yes</literal></arg>
@@ -2721,7 +2763,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>DelayMult=</command>
<command>DelayMult</command> =
<arg choice="plain"><replaceable>DELAY</replaceable></arg>
</term>
<listitem><para>
@@ -2734,7 +2776,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>DelayBus=</command>
<command>DelayBus</command> =
<arg choice="plain">
<group choice="req">
<arg choice="plain"><literal><emphasis>yes</emphasis></literal></arg>
@@ -2751,7 +2793,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>KeepAliveDisplay=</command>
<command>KeepAliveDisplay</command> =
<arg choice="plain"><replaceable>SECONDS</replaceable></arg>
</term>
<listitem><para>
@@ -2765,7 +2807,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>RefreshDisplay=</command>
<command>RefreshDisplay</command> =
<arg choice="plain"><replaceable>SECONDS</replaceable></arg>
</term>
<listitem><para>
@@ -2778,17 +2820,19 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>DirectKey_<replaceable>NUM</replaceable>=</command>
<command>KeyDirect_<replaceable>NUM</replaceable></command> =
<arg choice="plain"><replaceable>KEY</replaceable></arg>
</term>
<term>
<command>KeyMatrix_<replaceable>X</replaceable>_<replaceable>Y</replaceable>=</command>
<command>KeyMatrix_<replaceable>X</replaceable>_<replaceable>Y</replaceable></command> =
<arg choice="plain"><replaceable>KEY</replaceable></arg>
</term>
<listitem>
<para>
If you have a keypad you can assign keystrings to the keys.
See documentation for used terms and how to wire it.
See the section on <link linkend="hd44780-connections-keypad">keypads</link>
for used terms and the section on the specific connection type how to
wire it.
</para>
<para>
To map, for example, the directly connected key <literal>4</literal>
@@ -2802,7 +2846,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>VendorID=</command>
<command>VendorID</command> =
<arg choice="plain"><replaceable>VENDORID</replaceable></arg>
</term>
<listitem><para>
@@ -2813,7 +2857,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>ProductID=</command>
<command>ProductID</command> =
<arg choice="plain"><replaceable>PRODUCTID</replaceable></arg>
</term>
<listitem><para>
@@ -2824,7 +2868,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<varlistentry>
<term>
<command>SerialNumber=</command>
<command>SerialNumber</command> =
<arg choice="plain"><replaceable>SERIALNO</replaceable></arg>
</term>
<listitem><para>