LCDproc User's Guide

The Ultimate Guide to LCDproc 0.5.7

Peter Marschall

Rene Wagner

Guillaume Filion

William W. Ferrell

0.5.7

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


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
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
init-lcdexec
init-lcdvc
5. LCDproc Drivers
The bayrad Driver
Features
Configuration in LCDd.conf
The CFontz 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 glcd Driver
Connections
Configuration in LCDd.conf
The glcdlib Driver
Connections
Configuration in LCDd.conf
The glk Driver
Supported devices
Configuration in LCDd.conf
The HD44780 Driver
Connections
Compiling
Configuration in LCDd.conf
Miscellanea
The i2500vfd Driver
Features
Options
The icp_a106 Driver
Configuration in LCDd.conf
The imon Driver
General
Configuration in LCDd.conf
The imonlcd Driver
General
Configuration in LCDd.conf
The IOWarrior Driver
General
Requirements
Configuration in LCDd.conf
The irman Driver
Configuration in LCDd.conf
The irtrans Driver
General
Configuration in LCDd.conf
The Joystick Input Driver
Configuration in LCDd.conf
The lb216 Driver
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
Configuration in LCDd.conf
Modify Your ~/.lircrc
The lis Driver
Features
Requirements
Configuration in LCDd.conf
The MD8800 Driver
Features
Configuration in LCDd.conf
The mdm166a driver
Configuration in LCDd.conf
Using the icons
Special device hints
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 MX5000 Driver
Features
Configuration in LCDd.conf
The NoritakeVFD Driver
Configuration in LCDd.conf
The *Really* Simple Serial interface (rawserial)
Features
Requirements
Configuration in LCDd.conf
The Mini-Box.com USB LCD picoLCD Driver
Displays
Requirements
Configuration in LCDd.conf
picolcd driver status
Copyright
The pyramid Driver
Features
Connector
Requirements
LED output
Configuration in LCDd.conf
The SDEC LCD Driver
Features
The sed1330 Driver
Connections
Keypad
Configuration in LCDd.conf
The sed1520 Driver
Connections
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 shuttleVFD Driver
Features
Configuration in LCDd.conf
The sli Driver
Configuration in LCDd.conf
The stv5730 Driver
Configuration in LCDd.conf
The SureElec Driver
Configuration in LCDd.conf
The svga Driver
Configuration in LCDd.conf
The Toshiba T6963 Driver
Connections
Compiling
Configuration in LCDd.conf
The text Driver
Configuration in LCDd.conf
The tyan Driver
Features
Configuration in LCDd.conf
The ula200 Driver
General
Requirements
Known problems
Implementation note
Configuration in LCDd.conf
The vlsys_m428 driver
General
Configuration
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
Miscellanea
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 (VLC)
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/ftdi: Backlight Wiring
5.12. HD44780: PCF8574P port expander on I2C bus
5.13. HD44780: ethlcd - block diagram
5.14. HD44780: USB-4-all brightness control
5.15. HD44780: USB-4-all contrast control
5.16. serialVFD: Serial Inverter

List of Tables

5.1. HD44780: Connection Types
5.2. HD44780: Power Connections
5.3. HD44780: Direct Key Mapping
5.4. HD44780: Matrix Keypad Layout
5.5. HD44780: 4bit Pinouts (1)
5.6. HD44780: 4bit Pinouts (2)
5.7. HD44780: 4bit Keypad Pinouts
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 - Keypad return lines
5.13. HD44780: 8bit FTDI
5.14. HD44780: 4bit FTDI
5.15. HD44780: Examples of I2C port expander addresses
5.16. HD44780: USB-4-all - Display connection
5.17. HD44780: USB-4-all - Keypad connection
5.18. HD44780: USB-4-all - Brightness and contrast connection
5.19. HD44780: Default pin mapping for Raspberry Pi
5.20. Mapping between LCDproc keys and IrMan commands
5.21. mdm166a_output bitmask
5.22. USB Pinout
5.23. Mapping of output bits to LEDs
5.24. ConnectionType classic ordered by LPT port pins
5.25. ConnectionType bitshaker ordered by LPT port pins
5.26. SED1520 80-style wiring schematic
5.27. SED1520 68-style wiring schematic
5.28. serialPOS: Emulation Protocol Status
5.29. serialVFD: Display Status
5.30. T6963 wiring schematic

List of Examples

4.1. LCDd.conf: Specify which driver to use
5.1. HD44780: Configuration for FTDI 4bit
5.2. HD44780: Configuration for LCD2USB
5.3. HD44780: Configuration for I2C with port expander
5.4. HD44780: Alternate configuration for Raspberry Pi GPIO pins
5.5. HD44780: Configuration example for Pi Plate connection type
5.6. HD44780: Configuration example for PiFace Control and Display connection type
5.7. LCDd.conf: Activate the lirc driver
5.8. ~/.lircrc: Specify the associations from buttons to keys for the lirc driver
5.9. Matrix Orbital: keymap config
5.10. Pyramid: How to use the LED output from the client
6.1. LCDd -h
6.2. lcdproc -h