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

convert <screen> tags to tables; fix typos, ...

Browse Source
This commit is contained in:
marschap committed 2007-04-11 19:51:45 +00:00
1 parent 14bc686689
commit 46585d196e
10 files changed
+834 -310
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/lcdproc-user/drivers/hd44780.docbook
+339 -203
View File
@@ -13,9 +13,9 @@ parallel port:
</para>
<itemizedlist>
<listitem><para>4-bit</para></listitem>
<listitem><para>8-bit (winamp style)</para></listitem>
<listitem><para>extended 8-bit (LCD + LED bargraph)</para></listitem>
<listitem><para>4bit</para></listitem>
<listitem><para>8bit (winamp style)</para></listitem>
<listitem><para>extended 8bit (LCD + LED bargraph)</para></listitem>
<listitem><para>serial LPT</para></listitem>
</itemizedlist>
@@ -55,7 +55,7 @@ All variants use the same method of obtaining power. i.e., for each LCD:
<table id="hd44780-connections-power.table">
<title>HD44780: Power Connections</title>
<tgroup cols="3">
<tgroup cols="3" align="left">
<thead>
<row>
<entry>LCD</entry>
@@ -184,24 +184,28 @@ By default, the following keystrokes are generated by the different keys:
</para>
<table id="hd44780-connections-keypad-direct.mapping">
<title>HD44780: Default Keystrokes</title>
<tgroup cols="2">
<title>HD44780: Direct Key Mapping</title>
<tgroup cols="2" align="left">
<tbody>
<row>
<entry>X0</entry>
<entry>A</entry>
<entry><literal>A</literal></entry>
</row>
<row>
<entry>X1</entry>
<entry>B</entry>
<entry><literal>B</literal></entry>
</row>
<row>
<entry>X2</entry>
<entry>C</entry>
<entry><literal>C</literal></entry>
</row>
<row>
<entry>X3</entry>
<entry>D</entry>
<entry><literal>D</literal></entry>
</row>
<row>
<entry>X4</entry>
<entry><literal>E</literal></entry>
</row>
</tbody>
</tgroup>
@@ -278,8 +282,8 @@ assumes this:
</para>
<table id="hd44780-connections-keypad-matrix.mapping">
<title>HD44780: Keypad Layout</title>
<tgroup cols="5">
<title>HD44780: Matrix Keypad Layout</title>
<tgroup cols="5" align="left">
<tbody>
<row>
<entry></entry>
@@ -287,34 +291,39 @@ assumes this:
<entry><emphasis>X1</emphasis></entry>
<entry><emphasis>X2</emphasis></entry>
<entry><emphasis>X3</emphasis></entry>
<entry><emphasis>X4</emphasis></entry>
</row>
<row>
<entry><emphasis>Y0</emphasis></entry>
<entry>1</entry>
<entry>2</entry>
<entry>3</entry>
<entry>A</entry>
<entry><literal>1</literal></entry>
<entry><literal>2</literal></entry>
<entry><literal>3</literal></entry>
<entry><literal>A</literal></entry>
<entry><literal>E</literal></entry>
</row>
<row>
<entry><emphasis>Y1</emphasis></entry>
<entry>4</entry>
<entry>5</entry>
<entry>6</entry>
<entry>B</entry>
<entry><literal>4</literal></entry>
<entry><literal>5</literal></entry>
<entry><literal>6</literal></entry>
<entry><literal>B</literal></entry>
<entry><literal>F</literal></entry>
</row>
<row>
<entry><emphasis>Y2</emphasis></entry>
<entry>7</entry>
<entry>8</entry>
<entry>9</entry>
<entry>C</entry>
<entry><literal>7</literal></entry>
<entry><literal>8</literal></entry>
<entry><literal>9</literal></entry>
<entry><literal>C</literal></entry>
<entry><literal>G</literal></entry>
</row>
<row>
<entry><emphasis>Y3</emphasis></entry>
<entry>*</entry>
<entry>0</entry>
<entry>#</entry>
<entry>D</entry>
<entry><literal>*</literal></entry>
<entry><literal>0</literal></entry>
<entry><literal>#</literal></entry>
<entry><literal>D</literal></entry>
<entry><literal>H</literal></entry>
</row>
</tbody>
</tgroup>
@@ -379,8 +388,9 @@ Y3 o---|<---o o---+----o return line
<para>
A small extension allows you to switch the backlight of the display on
and off. At the moment only the 4bit and winamp connection types support
this. The extension uses one output pin, you cannot use that pin for other
and off. At the moment only the <code>4bit</code> and <code>winamp</code>
connection types support this.
The extension uses one output pin, you cannot use that pin for other
functions anymore. The wiring looks like this:
</para>
@@ -444,54 +454,80 @@ The BC327 transistor has the following connections:
</sect3>
<sect3 id="hd44780-4-bit">
<title>4-bit</title>
<sect3 id="hd44780-4bit">
<title>4bit</title>
<para>
This is originally based on "lcdtext" (by Matthias Prinke).
</para>
<table id="hd44780-4-bit.base-mapping">
<title>HD44780: 4-bit Pinouts (1)</title>
<tgroup cols="2">
<table id="hd44780-4bit.base-mapping">
<title>HD44780: 4bit Pinouts (1)</title>
<tgroup cols="4" align="left">
<colspec colname="lpt1"/>
<colspec colname="lpt2"/>
<colspec colname="lcd1"/>
<colspec colname="lcd2"/>
<thead>
<row>
<entry>printer port</entry>
<entry>LCD</entry>
<entry namest="lpt1" nameend="lpt2" align="center">printer port</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>D0 (2)</entry>
<entry>D4 (11)</entry>
<entry>D0</entry>
<entry>2</entry>
<entry>D4</entry>
<entry>11</entry>
</row>
<row>
<entry>D1 (3)</entry>
<entry>D5 (12)</entry>
<entry>D1</entry>
<entry>3</entry>
<entry>D5</entry>
<entry>12</entry>
</row>
<row>
<entry>D2 (4)</entry>
<entry>D6 (13)</entry>
<entry>D2</entry>
<entry>4</entry>
<entry>D6</entry>
<entry>(13)</entry>
</row>
<row>
<entry>D3 (5)</entry>
<entry>D7 (14)</entry>
<entry>D3</entry>
<entry>5</entry>
<entry>D7</entry>
<entry>14</entry>
</row>
<row>
<entry>D4 (6)</entry>
<entry>RS (4)</entry>
<entry>D4</entry>
<entry>6</entry>
<entry>RS</entry>
<entry>4</entry>
</row>
<row>
<entry>D5 (7)</entry>
<entry>RW (5) (LCD3 - 6) (optional - pull all LCD RW low (*) )</entry>
<entry>D5</entry>
<entry>7</entry>
<entry>RW</entry>
<entry>5 (LCD3 - 6) (optional - pull all LCD RW low (*) )</entry>
</row>
<row>
<entry>D6 (8)</entry>
<entry>EN (6)</entry>
<entry>D6</entry>
<entry>8</entry>
<entry>EN</entry>
<entry>6</entry>
</row>
<row>
<entry>D7 (9)</entry>
<entry>EN2 (LCD2 - 6) (optional)</entry>
<entry>D7</entry>
<entry>9</entry>
<entry>EN2</entry>
<entry>(LCD2 - 6) (optional)</entry>
</row>
</tbody>
</tgroup>
@@ -510,9 +546,9 @@ wire D5 (pin 7) to the enable line (pin 6) of the third LCD. Then for
displays four to seven use:
</para>
<table id="hd44780-4-bit.multi-mapping">
<title>HD44780: 4-bit Pinouts (2)</title>
<tgroup cols="2">
<table id="hd44780-4bit.multi-mapping">
<title>HD44780: 4bit Pinouts (2)</title>
<tgroup cols="2" align="left">
<thead>
<row>
<entry>printer port</entry>
@@ -544,9 +580,9 @@ displays four to seven use:
The optional keypad can be connected as follows:
</para>
<table id="hd44780-4-bit.keypad-mapping">
<title>HD44780: 4-bit Keypad Pinouts</title>
<tgroup cols="2">
<table id="hd44780-4bit.keypad-mapping">
<title>HD44780: 4bit Keypad Pinouts</title>
<tgroup cols="2" align="left">
<thead>
<row>
<entry>printer port</entry>
@@ -624,70 +660,104 @@ The optional backlight wiring should be connected to D5, pin 7.
</sect3>
<sect3 id="hd44780-8-bit-winamp">
<title>8-bit "Winamp"</title>
<sect3 id="hd44780-8bit-winamp">
<title>8bit "Winamp"</title>
<para>
This type of connection should work with winamp.
</para>
<table id="hd44780-8-bit-winamp.base-mapping">
<table id="hd44780-8bit-winamp.base-mapping">
<title>HD44780: "Winamp" wiring</title>
<tgroup cols="2">
<tgroup cols="4" align="left">
<colspec colname="lpt1"/>
<colspec colname="lpt2"/>
<colspec colname="lcd1"/>
<colspec colname="lcd2"/>
<thead>
<row>
<entry>printer port</entry>
<entry>LCD</entry>
<entry namest="lpt1" nameend="lpt2" align="center">printer port</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>D0 (2)</entry>
<entry>D0 (7)</entry>
<entry>D0</entry>
<entry>2</entry>
<entry>D0</entry>
<entry>7</entry>
</row>
<row>
<entry>D1 (3)</entry>
<entry>D1 (8)</entry>
<entry>D1</entry>
<entry>3</entry>
<entry>D1</entry>
<entry>8</entry>
</row>
<row>
<entry>D2 (4)</entry>
<entry>D2 (9)</entry>
<entry>D2</entry>
<entry>4</entry>
<entry>D2</entry>
<entry>9</entry>
</row>
<row>
<entry>D3 (5)</entry>
<entry>D3 (10)</entry>
<entry>D3</entry>
<entry>5</entry>
<entry>D3</entry>
<entry>10</entry>
</row>
<row>
<entry>D4 (6)</entry>
<entry>D4 (11)</entry>
<entry>D4</entry>
<entry>6</entry>
<entry>D4</entry>
<entry>11</entry>
</row>
<row>
<entry>D5 (7)</entry>
<entry>D5 (12)</entry>
<entry>D5</entry>
<entry>7</entry>
<entry>D5</entry>
<entry>12</entry>
</row>
<row>
<entry>D6 (8)</entry>
<entry>D6 (13)</entry>
<entry>D6</entry>
<entry>8</entry>
<entry>D6</entry>
<entry>13</entry>
</row>
<row>
<entry>D7 (9)</entry>
<entry>D7 (14)</entry>
<entry>D7</entry>
<entry>9</entry>
<entry>D7</entry>
<entry>14</entry>
</row>
<row>
<entry>nSTRB (1)</entry>
<entry>EN (6)</entry>
<entry>nSTRB</entry>
<entry>(1)</entry>
<entry>EN</entry>
<entry>6</entry>
</row>
<row>
<entry>nLF (14)</entry>
<entry>nRW (5) (EN3 6 - LCD 3) (optional (*) )</entry>
<entry>nLF</entry>
<entry>14</entry>
<entry>nRW</entry>
<entry>5 (EN3 6 - LCD 3) (optional (*) )</entry>
</row>
<row>
<entry>INIT (16)</entry>
<entry>RS (4)</entry>
<entry>INIT</entry>
<entry>16</entry>
<entry>RS</entry>
<entry>4</entry>
</row>
<row>
<entry>nSEL (17)</entry>
<entry>EN2 (6 - LCD 2) (optional)</entry>
<entry>nSEL</entry>
<entry>17</entry>
<entry>EN2</entry>
<entry>6 - LCD 2) (optional)</entry>
</row>
</tbody>
</tgroup>
@@ -712,9 +782,9 @@ connected to this line.
The optional keypad can be connected as follows:
</para>
<table id="hd44780-8-bit-winamp.keypad-mapping">
<table id="hd44780-8bit-winamp.keypad-mapping">
<title>HD44780: "Winamp" wiring - Keypad</title>
<tgroup cols="2">
<tgroup cols="2" align="left">
<thead>
<row>
<entry>printer port</entry>
@@ -792,8 +862,8 @@ The optional backlight wiring should be connected to nSEL, pin 17.
</sect3>
<sect3 id="hd44780-8-bit-lcdtime">
<title>8-bit "lcdtime"</title>
<sect3 id="hd44780-8bit-lcdtime">
<title>8bit "lcdtime"</title>
<para>
This is originally based on "lcdtime" (by Benjamin Tse
@@ -819,63 +889,97 @@ winamp or ext8bit wirings, because it only sends 4 bits at a time.
The LCD connections are:
</para>
<table id="hd44780-8-bit-lcdtime.base-mapping">
<table id="hd44780-8bit-lcdtime.base-mapping">
<title>HD44780: "lcdtime" wiring</title>
<tgroup cols="2">
<tgroup cols="4" align="left">
<colspec colname="lpt1"/>
<colspec colname="lpt2"/>
<colspec colname="lcd1"/>
<colspec colname="lcd2"/>
<thead>
<row>
<entry>printer port</entry>
<entry>LCD</entry>
<entry namest="lpt1" nameend="lpt2" align="center">printer port</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>D0 (2)</entry>
<entry>D0 (7)</entry>
<entry>D0</entry>
<entry>2</entry>
<entry>D0</entry>
<entry>7</entry>
</row>
<row>
<entry>D1 (3)</entry>
<entry>D1 (8)</entry>
<entry>D1</entry>
<entry>3</entry>
<entry>D1</entry>
<entry>8</entry>
</row>
<row>
<entry>D2 (4)</entry>
<entry>D2 (9)</entry>
<entry>D2</entry>
<entry>4</entry>
<entry>D2</entry>
<entry>9</entry>
</row>
<row>
<entry>D3 (5)</entry>
<entry>D3 (10)</entry>
<entry>D3</entry>
<entry>5</entry>
<entry>D3</entry>
<entry>10</entry>
</row>
<row>
<entry>D4 (6)</entry>
<entry>D4 (11)</entry>
<entry>D4</entry>
<entry>6</entry>
<entry>D4</entry>
<entry>11</entry>
</row>
<row>
<entry>D5 (7)</entry>
<entry>D5 (12)</entry>
<entry>D5</entry>
<entry>7</entry>
<entry>D5</entry>
<entry>12</entry>
</row>
<row>
<entry>D6 (8)</entry>
<entry>D6 (13)</entry>
<entry>D6</entry>
<entry>8</entry>
<entry>D6</entry>
<entry>13</entry>
</row>
<row>
<entry>D7 (9)</entry>
<entry>D7 (14)</entry>
<entry>D7</entry>
<entry>9</entry>
<entry>D7</entry>
<entry>14</entry>
</row>
<row>
<entry>nSEL (17)</entry>
<entry>nSEL</entry>
<entry>17</entry>
<entry>-</entry>
<entry></entry>
</row>
<row>
<entry>nSTRB (1)</entry>
<entry>RS (4)</entry>
<entry>nSTRB</entry>
<entry>1</entry>
<entry>RS</entry>
<entry>4</entry>
</row>
<row>
<entry>nLF (14)</entry>
<entry>RW (5) (LCD2 - 6) (optional - pull all LCD RW low (*))</entry>
<entry>nLF</entry>
<entry>14</entry>
<entry>RW</entry>
<entry>5 (LCD2 - 6) (optional - pull all LCD RW low (*)</entry>
</row>
<row>
<entry>INIT (16)</entry>
<entry>EN (6)</entry>
<entry>INIT</entry>
<entry>16</entry>
<entry>EN</entry>
<entry>6</entry>
</row>
</tbody>
</tgroup>
@@ -897,9 +1001,9 @@ connections.
The optional keypad can be connected as follows:
</para>
<table id="hd44780-8-bit-lcdtime.keypad-mapping">
<table id="hd44780-8bit-lcdtime.keypad-mapping">
<title>HD44780: "lcdtime" wiring - keypad</title>
<tgroup cols="2">
<tgroup cols="2" align="left">
<thead>
<row>
<entry>printer port</entry>
@@ -1154,7 +1258,7 @@ serialLpt wiring supports a keypad. The 3 wires version supports
<table id="hd44780-seriallpt-keypad.mapping">
<title>HD44780: Serial LPT - Keypad return lines</title>
<tgroup cols="2">
<tgroup cols="2" align="left">
<tbody>
<row>
<entry>nACK (10)</entry>
@@ -1242,7 +1346,7 @@ that. The BL output below should be connected to the BL input in the
<para>
LIS2 from VLSystem (<ulink url="http://www.vlsys.co.kr"></ulink>) is a full featured USB VFD module
with four channel fan controls. This device can be accessed as a serial device with the
help of the kernel modules <filename>ftdi_sio</filename> that map the USB port to a serial port
help of the kernel modules <filename>ftdi_sio.ko</filename> that map the USB port to a serial port
(<filename class="devicefile">/dev/ttyUSB<replaceable>x</replaceable></filename>).
</para>
@@ -1290,15 +1394,19 @@ See <ulink url="http://www.jepsennet.de/vdr/"></ulink>
<title>Pertelian X2040 "pertelian"</title>
<para>
The Pertelian X2040 includes an hd44780 display with enclosure and usb
connection. In order to work with lcdproc you need usbserial and
ftdi_sio modules loaded. Display will be available on /dev/ttyUSB0.
The Pertelian X2040 includes an HD44780 display with enclosure and USB
connection.
In order to work with <package>LCDproc</package> in Linux you need
the <filename>usbserial.ko</filename> and <filename>ftdi_sio.ko</filename>
kernel modules loaded. The display will then be available on a
serial port <filename>/dev/ttyUSB<replaceable>x</replaceable></filename>.
</para>
<para>
See the
<ulink url="http://pertelian.com/joomla/index.php?option=com_content&amp;task=view&amp;id=43&amp;Itemid=48">product
page</ulink> for more information.
<ulink url="http://pertelian.com/joomla/index.php?option=com_content&amp;task=view&amp;id=43&amp;Itemid=48">
X4020 product page</ulink> for more information.
</para>
</sect3>
@@ -1311,7 +1419,8 @@ ftdi_sio modules loaded. Display will be available on /dev/ttyUSB0.
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 Device= setting. The default is /dev/lcd.
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>
@@ -1328,10 +1437,11 @@ by Dale Wheat.
<title>LCD serializer device "lcdserializer"</title>
<para>
LCD serializer connection is technically the same of PIC-an-LCD with the same advantages,
LCD serializer connection is technically the same as PIC-an-LCD with the same advantages,
it uses the serial port making things really simple.
Unlike PIC-an-LCD
<ulink url="http://www.mindspring.com/~tcoonan/lcd.html">LCD serializer</ulink>
is not a commercial product like PIC-an-LCD, it's just a project found digging on the net and freely available.
is not a commercial product. it's just a project found digging on the net and freely available.
You have all the tools and the code to build it yourself and to customize the behaviour of the device.
</para>
@@ -1352,22 +1462,22 @@ You have all the tools and the code to build it yourself and to customize the be
<title>Burning the PIC</title>
<para>
First, you need to download the asm source for your pic and then make the hex:
</para>
<para>
<command>
gpasm lcd16f84_custom.asm
</command>
First, you need to download the ASM source for your PIC and then make the hex:
</para>
<screen>
<prompt>$</prompt> <userinput>gpasm lcd16f84_custom.asm</userinput>
</screen>
<para>
Now the binary is ready to be flashed to the PIC.
Connect the programmer with the PIC installed and issue the following command to see it burning ;-):
</para>
<para>
<command>
picprog --erase --burn --input lcd16f84.hex --pic /dev/ttyS0
</command>
</para>
<screen>
<prompt>$</prompt> <userinput>picprog --erase --burn --input lcd16f84.hex --pic /dev/ttyS0</userinput>
</screen>
</sect4>
<sect4 id="hd44780-lcdserializer-runninglcdproc">
@@ -1379,19 +1489,18 @@ remember this driver uses a baud rate of 9600, so JP2 need to be closed.
</para>
<para>
Now power on the board. You should see OK. on the LCD screen, otherwise, double-check all the connections.
Now power on the board. You should see <computeroutput>OK</computeroutput> on the LCD screen.
Otherwise double-check all the connections.
</para>
<para>
Change LCDd.conf to include the following statments in the hd44780 section:
Change <filename>LCDd.conf</filename> to include the following statements in the <code>[hd44780]</code> section:
</para>
<para>
<screen>
<programlisting>
ConnectionType=lcdserializer
Device=/dev/ttyS0
</screen>
</para>
</programlisting>
<para>
Finally, start the daemon and relax watching lcdproc running.
@@ -1437,7 +1546,7 @@ value to ARG1, then the value is sent to the LCD. The fourth line delays the exe
</para>
<para>
You don't have to write the ascii values in your modification, gpasm does the translation for you, so
You don't have to write the ASCII values in your modification, gpasm does the translation for you, so
if you want to see Booting... at startup, change the code above to look like this:
</para>
@@ -1554,7 +1663,7 @@ Both options expect a number in the range from <literal>0</literal> to <literal>
<title>Status</title>
<para>
The <code>lcd2usb</code> connection type has been written to support displaysi
The <code>lcd2usb</code> connection type has been written to support displays
with one and two HD44780 controllers.
Owing to the lack of a 2-controller display, it has only been tested with a
1-controller display.
@@ -1584,7 +1693,7 @@ port expander there (PCF8574P in this example).
</para>
<figure id="hd44780-i2c.circuit">
<title>HD44780: PCF8574P port expander on I2C bus</title>
<title>HD44780: PCF8574P port expander on I<superscript>2</superscript>C bus</title>
<screen>
<![CDATA[
IC1
@@ -1633,7 +1742,7 @@ port expander there (PCF8574P in this example).
<sect4 id="hd44780-i2c-config">
<title>Configuration</title>
<figure id="hd44780-i2c-config.example">
<example id="hd44780-i2c-config.example">
<title>HD44780: Configuration for I<superscript>2</superscript>C with port expander</title>
<screen>
<![CDATA[
@@ -1648,34 +1757,58 @@ DelayMult=1
Keypad=no
]]>
</screen>
</figure>
</example>
<para>
Device is the device file for your I<superscript>2</superscript>C bus (here /dev/i2c-0).
You have to load the kernel standard module i2c-dev and
the bus driver, but NO i2c chip modules (e.g. pcf8574)!
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
chip modules (e.g. <filename>pcf8574.ko</filename>)!
</para>
<para>
Port contains the i2c address of the i2c port expander
(here 0x20, the PCF8574 from the example above, with all address bits set to 0).
Bit 8 of the address (normally 0 in I2C addresses) given in port is special:
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>).
Bit 8 of the address (normally <literal>0</literal> in I<superscript>2</superscript>C addresses)
has a special meaning:
It tells the driver to treat the device as PCA9554 or similar,
a device that needs a 2-byte command, and it will be stripped
off the address.
</para>
<figure id="hd44780-i2c-config.portexpander-address">
<title>HD44780: Examples of I<superscript>2</superscript>C port expander adresses</title>
<screen>
<![CDATA[
port=0x20..0x27 PCF8574 with A[012]=0..7
port=0x38..0x3f PCF8574A with A[012]=0..7
port=0xa0..0xa7 PCA9554 with A[012]=0..7
port=0xa0..0xa7 PCA9554A with A[012]=0..7
]]>
</screen>
</figure>
<table id="hd44780-i2c-config.portexpander-address">
<title>HD44780: Examples of I<superscript>2</superscript>C port expander addresses</title>
<tgroup cols="2" align="left">
<thead>
<row>
<entry><command>Port=</command> value</entry>
<entry>Meaning</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>0x20</literal>&hellip;<literal>0x27</literal></entry>
<entry>PCF8574 with A[012]=<literal>0</literal>&hellip;<literal>7</literal></entry>
</row>
<row>
<entry><literal>0x38</literal>&hellip;<literal>0x3f</literal></entry>
<entry>PCF8574A with A[012]=<literal>0</literal>&hellip;<literal>7</literal></entry>
</row>
<row>
<entry><literal>0xa0</literal>&hellip;<literal>0xa7</literal></entry>
<entry>PCA9554 with A[012]=<literal>0</literal>&hellip;<literal>7</literal></entry>
</row>
<row>
<entry><literal>0xa0</literal>&hellip;<literal>0xa7</literal></entry>
<entry>PCA9554A with A[012]=<literal>0</literal>&hellip;<literal>7</literal></entry>
</row>
</tbody>
</tgroup>
</table>
</sect4>
</sect3>
@@ -1722,9 +1855,10 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
</term>
<listitem><para>
If you are using a serial connection, you must
set this parameter to the device your lcd is connected to. For
example, if it's connected to the first serial port, you have to
set Device to /dev/ttyS0. The default value is /dev/lcd.
set this parameter to the device your LCD is connected to. For
example, if the display is connected to the first serial port,
you have to set it to <filename>/dev/ttyS0</filename>.
The default value is <filename>/dev/lcd</filename>.
</para></listitem>
</varlistentry>
@@ -1735,8 +1869,8 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
<group choice="req">
<arg choice="plain"><literal><emphasis>4bit</emphasis></literal></arg>
<arg choice="plain"><literal>8bit</literal></arg>
<arg choice="plain"><literal>serialLpt</literal></arg>
<arg choice="plain"><literal>winamp</literal></arg>
<arg choice="plain"><literal>serialLpt</literal></arg>
<arg choice="plain"><literal>picanlcd</literal></arg>
<arg choice="plain"><literal>lcdserializer</literal></arg>
<arg choice="plain"><literal>los-panel</literal></arg>
@@ -1755,7 +1889,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
Select the type of the wiring / display connection.
</para>
<informaltable>
<tgroup cols="2">
<tgroup cols="2" align="left">
<thead>
<row>
<entry>ConnectionType</entry>
@@ -1764,59 +1898,59 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
</thead>
<tbody>
<row>
<entry><literal>4bit</literal></entry>
<entry><literal><link linkend="hd44780-4bit">4bit</link></literal></entry>
<entry>HD44780 4bit Wiring (default)</entry>
</row>
<row>
<entry><literal>8bit</literal></entry>
<entry><literal><link linkend="hd44780-8bit-lcdtime">8bit</link></literal></entry>
<entry>HD44780 8bit Wiring ("lcdtime")</entry>
</row>
<row>
<entry><literal>serialLpt</literal></entry>
<entry>HD44780 Serial LPT Wiring</entry>
</row>
<row>
<entry><literal>winamp</literal></entry>
<entry><literal><link linkend="hd44780-8bit-winamp">winamp</link></literal></entry>
<entry>HD44780 8bit Wiring "winamp" Style</entry>
</row>
<row>
<entry><literal>picanlcd</literal></entry>
<entry><literal><link linkend="hd44780-seriallpt">serialLpt</link></literal></entry>
<entry>HD44780 Serial LPT Wiring</entry>
</row>
<row>
<entry><literal><link linkend="hd44780-picanlcd">picanlcd</link></literal></entry>
<entry>PIC-an-LCD serial device "picanlcd"</entry>
</row>
<row>
<entry><literal>lcdserializer</literal></entry>
<entry><literal><link linkend="hd44780-lcdserializer">lcdserializer</link></literal></entry>
<entry>LCD serializer "lcdserializer"</entry>
</row>
<row>
<entry><literal>los-panel</literal></entry>
<entry><literal><link linkend="hd44780-los-panel">los-panel</link></literal></entry>
<entry>LCD on Serial panel device "los-panel" (<ulink url="http://www.xs4all.nl/~mlf/los/"></ulink>)</entry>
</row>
<row>
<entry><literal>vdr-lcd</literal></entry>
<entry><literal><link linkend="hd44780-vdr-lcd">vdr-lcd</link></literal></entry>
<entry>VDR LCD serial device "vdr-lcd"</entry>
</row>
<row>
<entry><literal>vdr-wakeup</literal></entry>
<entry><literal><link linkend="hd44780-vdr-wakeup">vdr-wakeup</link></literal></entry>
<entry>VDR-Wakeup module "vdr-wakeup"</entry>
</row>
<row>
<entry><literal>pertelian</literal></entry>
<entry><literal><link linkend="hd44780-pertelian">pertelian</link></literal></entry>
<entry>Pertelian X2040 LCD display (<ulink url="http://pertelian.com/joomla/index.php?option=com_content&amp;task=view&amp;id=43&amp;Itemid=48"></ulink>)</entry>
</row>
<row>
<entry><literal>bwctusb</literal></entry>
<entry><literal><link linkend="hd44780-bwctusb">bwctusb</link></literal></entry>
<entry>BWCT USB device "bwctusb" (<ulink url="http://www.bwct.de/lcd.html"></ulink>)</entry>
</row>
<row>
<entry><literal>lcd2usb</literal></entry>
<entry><literal><link linkend="hd44780-lcd2usb">lcd2usb</link></literal></entry>
<entry>Tim Harbaum's LCD2USB (<ulink url="http://www.harbaum.org/till/lcd2usb/"></ulink>)</entry>
</row>
<row>
<entry><literal>lis2</literal></entry>
<entry><literal><link linkend="hd44780-lis2">lis2</link></literal></entry>
<entry>LIS2 from VLSystem (<ulink url="http://www.vlsys.co.kr"></ulink>)</entry>
</row>
<row>
<entry><literal>i2c</literal></entry>
<entry><literal><link linkend="hd44780-i2c">i2c</link></literal></entry>
<entry>LCD driven by PCF8574(A)/PCA9554(A) connected via I<superscript>2</superscript>C</entry>
</row>
</tbody>
@@ -1857,12 +1991,12 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
</arg>
</term>
<listitem><para>
You need to set this parameter only if you don't have a standard
hd44780 display. ea_ks0073 is the charmap for Electronic
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 hd44780-charset.h
for more informations.
ISO-8859-1 than standard HD44780s. Refer to <filename>hd44780-charset.h</filename>
for more information.
</para></listitem>
</varlistentry>
@@ -1921,7 +2055,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
</term>
<listitem><para>
Tell if you have the additional output port ("bargraph") and you want to
be able to control it with the lcdproc OUTPUT command
be able to control it with the lcdproc OUTPUT command.
</para></listitem>
</varlistentry>
@@ -1936,8 +2070,9 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
</arg>
</term>
<listitem><para>
Specifies if the last line is pixel addressable or it controls an
underline effect. [default: <literal>yes</literal> (= pixel addressable); legal: <literal>yes</literal>, <literal>no</literal>]
Specifies whether the lowest pixel line of a character is pixel addressable
or if it controls an underline effect.
The default is <literal>yes</literal>, meaning a pixel addressable last pixel line.
</para></listitem>
</varlistentry>
@@ -2004,8 +2139,9 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
</term>
<listitem><para>
If your display is slow and cannot keep up with the flow of data from
LCDd, garbage can appear on the LCDd. Set this delay factor to 2 or 4
to increase the delays. Default: 1.
LCDd, garbage can appear on the LCDd. Set this delay multiplier to
<literal>2</literal> or <literal>4</literal> to increase the delays.
The default is <literal>1</literal> for a non-multiplied delay.
</para></listitem>
</varlistentry>
@@ -2035,7 +2171,7 @@ This can be done by specifying <option>--enable-drivers=all</option> or by inclu
Some displays (e.g. <code>vdr-wakeup</code>) need a message from the driver to that it
is still alive. When set to a value bigger then <literal>0</literal> the character in the
upper left corner is updated every <replaceable>SECONDS</replaceable> seconds.
Default: <literal>0</literal>.
The default <literal>0</literal> does not cause any extra updates.
</para></listitem>
</varlistentry>