LCDproc User's Guide

The Ultimate Guide to LCDproc 0.5

Peter Marschall

Rene Wagner

Guillaume Filion

William W. Ferrell

0.0.4

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".

Abstract

This document is a guide to LCDproc written for users. It covers LCDproc 0.5.x


Table of Contents

1. Introduction
About this Document
What is LCDproc?
The LCDproc Server - LCDd
The LCDproc "Main" Client - lcdproc
Other LCDproc Clients
2. How to Obtain LCDproc
Versioning
Download Yesterday's CVS Version of LCDproc as a Tarball
Download The Latest Version of LCDproc from CVS
apt-get
3. Installation
Build LCDproc
Install LCDproc Directly From The Sources
Generate And Install Packages of LCDproc
4. LCDproc Configuration
Configure LCDd
LCDd.conf: The [Server] Section
LCDd.conf: The [Menu] Section
LCDd.conf: The Driver Section
The LCDproc Init Scripts
init-LCDd
init-lcdproc
5. LCDproc Drivers
The bayrad Driver
Features
Configuration in LCDd.conf
The CFontz Driver
Configuration in LCDd.conf
The CFontz633 Driver
Configuration in LCDd.conf
The CFontzPacket Driver
Configuration in LCDd.conf
The curses Driver
Configuration in LCDd.conf
The CwLnx Driver
Features
Configuration in LCDd.conf
The ea65 driver
EA65 front panel VFD
Configuration in LCDd.conf
The Eyebox One Driver (EyeboxOne)
Eyebox One LCD Module
Eyebox One Driver and lcdproc client
Copyright
Configuration in LCDd.conf
The G15 Driver
Features
Configuration in LCDd.conf
The glcdlib Driver
Connections
Configuration in LCDd.conf
The glk Driver
Configuration in LCDd.conf
The HD44780 Driver
Connections
Compiling
Configuration in LCDd.conf
Miscellania
The icp_a106 Driver
Configuration in LCDd.conf
The imon Driver
General
Configuration in LCDd.conf
The IOWarrior Driver
Configuration in LCDd.conf
The irman Driver
Configuration in LCDd.conf
The Joystick Input Driver
Configuration in LCDd.conf
The lb216 Driver
Connections
Configuration in LCDd.conf
The lcdm001 Driver
Configuration in LCDd.conf
The lcterm Driver
Configuration in LCDd.conf
The lirc Driver
Checking Your LIRC Setup
Build LCDd with the lirc Driver
Configure LCDd to Use the lirc Driver
Modify Your ~/.lircrc
The MD8800 Driver
Features
Configuration in LCDd.conf
The ms6931 Driver
Configuration in LCDd.conf
The mtc_s16209x Driver
Configuration in LCDd.conf
The MtxOrb Driver
Matrix Orbital LCD Modules
Matrix Orbital Hardware Installation
Configuration in LCDd.conf
The NoritakeVFD Driver
Configuration in LCDd.conf
The Mini-Box USB LCD (picoLCD 20x2) Driver (picolcd)
Setting up the picoLCD
Configuration in LCDd.conf
picolcd driver status
Copyright
The pyramid Driver
Features
Requirements
LED output
Configuration in LCDd.conf
The sed1330 Driver
Connections
Configuration in LCDd.conf
The sed1520 Driver
Configuration in LCDd.conf
The serialPOS Driver
Connecting The Display
Configuration in LCDd.conf
The serialVFD Driver
Connecting The Display
Configuration in LCDd.conf
The sli Driver
Configuration in LCDd.conf
The stv5730 Driver
Configuration in LCDd.conf
The svga Driver
Configuration in LCDd.conf
The Toshiba T6963 Driver
Connections
Compiling
Configuration in LCDd.conf
Running
The text Driver
Configuration in LCDd.conf
The tyan Driver
Features
Configuration in LCDd.conf
The ula200 Driver
Configuration in LCDd.conf
The xosd Driver
Configuration in LCDd.conf
Parallel Port Troubleshooting
Check The Wiring
Power Source Unregulated / Noisy
Ground Lift
Latchup
Contrast
Parallel Port Voltage
Enable Signal Rise Time
EMI
One or Two Black Lines
Software Too Fast
LED Backlight
HD44780 Compatible
Miscellania
6. Running LCDproc
Running LCDd
Running LCDd from the command line
The Command Line Options of LCDd
Running lcdproc
The Command Line Options of lcdproc
7. Contact Us
Errata
The LCDproc Mailing List
Reporting Bugs
A. GNU Free Documentation License
PREAMBLE
APPLICABILITY AND DEFINITIONS
VERBATIM COPYING
COPYING IN QUANTITY
MODIFICATIONS
COMBINING DOCUMENTS
COLLECTIONS OF DOCUMENTS
AGGREGATION WITH INDEPENDENT WORKS
TRANSLATION
TERMINATION
FUTURE REVISIONS OF THIS LICENSE
How to use this License for your documents

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: One Return Line
5.6. HD44780: Backlight Wiring
5.7. HD44780: Serial LPT wiring ('simple')
5.8. HD44780: Serial LPT wiring ('complex')
5.9. HD44780: Serial LPT - Keypad return lines buffered
5.10. HD44780: Serial LPT - Backlight extra circuit
5.11. HD44780: PCF8574P port expander on I2C bus
5.12. serialVFD: Serial Inverter

List of Tables

5.1. HD44780: Power Connections
5.2. HD44780: Direct Key Mapping
5.3. HD44780: Matrix Keypad Layout
5.4. HD44780: 4bit Pinouts (1)
5.5. HD44780: 4bit Pinouts (2)
5.6. HD44780: 4bit Keypad Pinouts
5.7. HD44780: "Winamp" wiring
5.8. HD44780: "Winamp" wiring - Keypad
5.9. HD44780: "lcdtime" wiring
5.10. HD44780: "lcdtime" wiring - keypad
5.11. HD44780: Serial LPT - Keypad return lines
5.12. HD44780: Examples of I2C port expander addresses
5.13. Mapping between LCDproc keys and IrMan commands
5.14. Mapping of output bits to LEDs
5.15. ConnectionType classic ordered by LCD pins
5.16. ConnectionType classic ordered by LPT port pins
5.17. serialPOS: Emulation Protocol Status
5.18. serialVFD: Display Status
5.19. T6963 wiring schematic

List of Examples

4.1. LCDd.conf: Specify which driver to use
5.1. HD44780: Configuration for I2C with port expander
5.2. LCDd.conf: Activate the lirc driver
5.3. ~/.lircrc: Specify the associations from buttons to keys for the lirc driver
5.4.
5.5. How to use the LED output from the client
6.1. LCDd -h
6.2. lcdproc -h