LCDproc User's Guide

The Ultimate Guide to LCDproc 0.4.4

Rene Wagner

Guillaume Filion

William W. Ferrell

Copyright © 2003 Rene Wagner

Copyright © 2002 Guillaume Filion

Copyright © 1999 William W. Ferrell

Table of Contents

1. Introduction

1.1. About this Document

1.2. What is LCDproc?

1.3. The LCDproc Server - LCDd

1.4. The LCDproc "Main" Client - lcdproc

1.5. Other LCDproc Clients

2. How to Obtain LCDproc

2.1. Versioning

2.2. Download Last Day's CVS Version of LCDproc as a Tarball

2.3. Download The Latest Version of LCDproc from CVS

2.4. Debian GNU/Linux

2.5. Gentoo Linux

3. Installation

3.1. Build LCDproc

3.2. Install LCDproc Directly From The Sources

3.3. Generate And Install Packages of LCDproc

4. LCDproc Configuration

4.1. Configure LCDd

4.1.1. LCDd.conf: The [server] Section

4.1.2. LCDd.conf: The [input] Section

4.1.3. LCDd.conf: The Drivers Section

4.2. The LCDproc Init Scripts

4.2.1. init-LCDd

4.2.2. init-lcdproc

5. LCDproc Drivers

5.1. The HD44780 Driver

5.1.1. Connections

5.1.2. Compiling

5.1.3. Configuration

5.1.4. Running

5.1.5. Questions & Answers

5.1.6. Miscellania

5.2. The Toshiba T6963 Driver

5.2.1. Connections

5.2.2. Compiling

5.2.3. Configuration

5.2.4. Running

5.3. Parallel Port Troubleshooting

5.3.1. Check The Wiring

5.3.2. Power Source Unregulated / Noisy

5.3.3. Ground Lift

5.3.4. Latchup

5.3.5. Contrast

5.3.6. Parallel Port Voltage

5.3.7. Enable Signal Rise Time

5.3.8. EMI

5.3.9. One or Two Black Lines

5.3.10. Software Too Fast

5.3.11. LED Backlight

5.3.12. HD44780 Compatible

5.3.13. Miscellania

5.4. The Matrix Orbital Driver (MtxOrb)

5.4.1. Matrix Orbital LCD Modules

5.4.2. Matrix Orbital Hardware Installation

5.4.3. Copyright

5.5. The lircin Driver

5.5.1. Checking Your LIRC Setup

5.5.2. Build LCDd with the lircin Driver

5.5.3. Configure LCDd to Use the lircin Driver

5.5.4. Modify Your ~/.lircrc

6. Running LCDproc

6.1. Running LCDd

6.1.1. Running LCDd from the command line

6.1.2. The Command Line Options of LCDd

6.2. Running lcdproc

6.2.1. The Command Line Options of lcdproc

7. Contact Us

7.1. Errata

7.2. The LCDproc Mailing List

7.3. Reporting Bugs

A. GNU Free Documentation License

A.1. PREAMBLE

A.2. APPLICABILITY AND DEFINITIONS

A.3. VERBATIM COPYING

A.4. COPYING IN QUANTITY

A.5. MODIFICATIONS

A.6. COMBINING DOCUMENTS

A.7. COLLECTIONS OF DOCUMENTS

A.8. AGGREGATION WITH INDEPENDENT WORKS

A.9. TRANSLATION

A.10. TERMINATION

A.11. FUTURE REVISIONS OF THIS LICENSE

A.12. How to use this License for your documents

List of Tables

4-1. The Standard LCDd Input Keys

5-1. HD44780: Power Connections

5-2. HD44780: Default Keystrokes

5-3. HD44780: 4-bit Pinouts (1)

5-4. HD44780: 4-bit Pinouts (2)

5-5. HD44780: 4-bit Keypad Pinouts

5-6. HD44780: Connection Types

5-7. T6963 wiring schematic

5-8. Arguments

List of Figures

5-1. HD44780: Connecting the contrast adjusting pin (Vadj.)

5-2. HD44780: Direct Keys

5-3. HD44780: Single Matrix Key

5-4. HD44780: Complete Key Matrix

5-5. HD44780: Keypad Layout

5-6. HD44780: One Return Line

5-7. HD44780: Backlight Wiring

5-8. HD44780: "Winamp" wiring

5-9. HD44780: "Winamp" wiring - Keypad

5-10. HD44780: "lcdtime" wiring

5-11. HD44780: "lcdtime" wiring - keypad

5-12. HD44780: Serial LPT wiring ('simple')

5-13. HD44780: Serial LPT wiring ('complex')

5-14. HD44780: Serial LPT - Keypad return lines

5-15. HD44780: Serial LPT - Keypad return lines buffered

5-16. HD44780: Serial LPT - Backlight extra circuit

List of Examples

4-1. LCDd.conf: Specify which driver to use

4-2. LCDd.conf: Compatibility mode for drivers written for 0.4.1

4-3. lcdproc.conf: Modify the option passed to lcdproc

5-1. LCDd.conf: Activate the lircin driver

5-2. ~/.lircrc: Specify the keys for the lircin driver

6-1. LCDd -h

6-2. lcdproc -h