# # $Id: README,v 1.10 2000/11/28 16:46:11 reinelt Exp $ # This is the README file for lcd4linux INTRODUCTION lcd4linux is a small program that reads various information from the kernel (and probably from other subsystems, especially ISDN) and displays them on a LCD. It supports displaying text values and different types of bars: Horizontal and vertical bars, logarithmic bars, split bars (two independent bars in one row). USAGE lcd4linux -h print version number and a small help text, then exit lcd4linux -l list available drivers lcd4linux -d calibrate delay loop (necessary for some drivers) lcd4linux [-c key=val] [-F] [-f config-file] [-o output] [-q] [-v] run lcd4linux overwrite entries from the config-file with '-c' do not fork and detach with '-F' use configuration from 'config-file' instead of /etc/lcd4linux.conf write picture to 'output' (raster driver only) suppress startup splash screen with '-q' generate debugging messages with '-v' SUPPORTED DISPLAYS * Matrox Orbital: "LCD0821": 2 lines by 8 characters "LCD1621": 2 lines by 16 characters "LCD2021": 2 lines by 20 characters "LCD2041": 4 lines by 20 characters (tested) "LCD4021": 2 lines by 40 characters * CrystalFontz any of 626, 632, 634 and 636. * HD44780-based displays This driver supports display modules based on the Hitachi HD44780 chip, connected to a parallel port. These displays are made by different manufactures, and come in various sizes. * PalmOrb I was told that lcd4linux works fine with PalmOrb, a small program that emulates a Matrox Orbital display on the Palm Pilot. * X11 thanks to Herbert Rosmanith a driver for the X Window System is available. It supports any size at any resolution. A very small XLCD4Linux-Window can even swallow on the KDE Panel! * Raster formats: a generic raster driver (which is used by the X11-driver, too) is availiable, PPM (portable pixmap) is the only output format at the moment. I'm working on PNG! * other displays: lcd4linux and especially the display driver code is very modular, so it should be quite easy to write a driver for any display. See README.driver for details. Contributors are welcome!!! CONFIGURATION The configuration file (default: /etc/lcd4linux.conf) has a very simple format: Every line consists of a key and a value, seperated by whitespace (blanks or tabs). Values can contain whitespace, and can be enclosed in single or double quotes. A key must not contain whitespace. Keys are NOT case-sensitive. Order doesn't matter. Empty lines and all text on a line after a '#' will be ignored. If you want to use '#' in a value (think of X11-colors), you have to quote it with a backslash. The configuration file contains information for different modules of lcd4linux: Global options: tick: time in milliseconds between bar updates tack: time in milliseconds between text updates (text can be updated less often than bars, so you get a smooth bar display and readable text) tau: time constant (in milliseconds) for damping function (not used by now) Data-specific options: overload: load average threshold and bar scaling. The '%L' token (see below) displays a '!' instead of a blank if the current load average exceeds this value. load bars are scaled by this value (load=overload gives 100%) fifo: path to fifo for communication with isdnlog (not yet implemented) sensor1: path to the 1st temperature file (e.g. /proc/sys/dev/sensors/w83781d-isa-0290/temp1) it is important that you use the isa sensors, because the i2c sensors are very slow! sensor1_min: temperature where the corresponding bar starts sensor1_max: temperature where bar ends sensor[2..9], -_min, -_max: entries for the 2nd to 9th temperature sensor Driver-specific options: Display: the name of a display model (see "supported displays" above) every driver has its own configuration options (e.g. 'Port', 'Speed', ...) see README. for details! Display options: row1: Text to display in row 1 row[2-max]: Text to display in other rows The text to be displayed can contain specific directives, which will be replaced by the appropriate values, or will create bars: '\nnn` will write the ASCII-character nnn (octal) '%' will be replaced by the value of '%%' will write a '%' '%$' will write a '$' '$[+] will create a bar with the specified direction and length (in characters) with the value of . If the driver supports dual bars,
/* XPM */

/*
 * Copyright 1999 Michael Reinelt <michael@reinelt.co.at>
 * Copyright 2004 The LCD4Linux Team <lcd4linux-devel@users.sourceforge.net>
 *
 * This file is part of LCD4Linux.
 *
 * LCD4Linux is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * LCD4Linux is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 * 
 */

static char *lcd4linux[] = {
"38 32 3 1",
"  c None",
"# c #102000",
". c #a0d000",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"......................................",
"..##............######....######......",
"..##............######....######......",
"..##..........##......##..##....##....",
"..##..........##......##..##....##....",
"..##..........##..........##......##..",
"..##..........##..........##......##..",
"..##..........##..........##......##..",
"..##..........##..........##......##..",
"..##..........##..........##......##..",
"..##..........##..........##......##..",
"..##..........##......##..##....##....",
"..##..........##......##..##....##....",
"..##########....######....######......",
"..##########....######....######......",
"......................................",
"......................................",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
"                                      ",
};