LCDproc User's Guide

The Ultimate Guide to LCDproc 0.4.4

Rene Wagner

Guillaume Filion

William W. Ferrell

This document is a guide to LCDproc written for users. It covers LCDproc 0.4.4 ONLY. Some things may be valid for 0.5 as well, but a lot has changed since 0.4.1 and a lot will change for 0.5.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".


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