1 # LCDd.conf -- configuration file for the LCDproc server daemon LCDd
3 # This file contains the configuration for the LCDd server.
5 # The format is ini-file-like. It is divided into sections that start at
6 # markers that look like [section]. Comments are all line-based comments,
7 # and are lines that start with '#' or ';'.
9 # The server has a 'central' section named [server]. For the menu there is
10 # a section called [menu]. Further each driver has a section which
11 # defines how the driver acts.
13 # The drivers are activated by specifiying them in a driver= line in the
14 # server section, like:
18 # This tells LCDd to use the curses driver.
19 # The first driver that is loaded and is capable of output defines the
20 # size of the display. The default driver to use is curses.
21 # If the driver is specified using the -d <driver> command line option,
22 # the Driver= options in the config file are ignored.
24 # The drivers read their own options from the respective sections.
28 ## Server section with all kinds of settings for the LCDd server ##
31 # Tells the server to load the given drivers. Multiple lines can be given.
32 # The name of the driver is case sensitive and determines the section
33 # where to look for further configuration options of the specific driver
34 # as well as the name of the dynamic driver module to load at runtime.
35 # The latter one can be changed by giving af File= directive in the
36 # driver specific section.
38 # The following drivers are supported:
39 # bayrad, CFontz, CFontz633, CFontzPacket, curses, CwLnx, ea65,
40 # EyeboxOne, g15, glcdlib, glk, hd44780, icp_a106, imon, IOWarrior,
41 # irman, joy, lb216, lcdm001, lcterm, lirc, MD8800, ms6931, mtc_s16209x,
42 # MtxOrb, NoritakeVFD, picolcd, pyramid, sed1330, sed1520, serialPOS,
43 # serialVFD, sli, stv5730, svga, t6963, text, tyan, ula200, xosd
46 # Tells the driver to bind to the given interface
49 # Listen on this specified port; defaults to 13666.
52 # Sets the reporting level; defaults to 2 (warnings and errors only).
55 # Should we report to syslog instead of stderr ? Default: no
58 # Sets the default time in seconds to displays a screen.
61 # User to run as. LCDd will drop its root priviledges,
62 # if any, and run as this user instead.
65 # If yes, the the serverscreen will be rotated as a usual info screen. If no,
66 # it will be a background screen, only visible when no other screens are
70 # The server will stay in the foreground if set to true.
73 # Where can we find the driver modules ?
74 # IMPORTANT: Make sure to change this setting to reflect your
75 # specific setup! Otherwise LCDd won't be able to find
76 # the driver modules and will thus not be able to
78 # NOTE: Always place a slash as last character !
79 DriverPath=server/drivers/
81 # GoodBye message: each entry represents a display line; default: builtin
82 #GoodBye="Thanks for using"
85 # The "...Key=" lines define what the server does with keypresses that
86 # don't go to any client.
87 # These are the defaults:
94 # If you have only 4 keys, you can choose to use this:
95 #ToggleRotateKey=Enter
99 # If you have only 3 keys, you can choose to use this:
100 #ToggleRotateKey=Enter
105 ## The menu section. The menu is an internal LCDproc client. ##
107 # You can configure what keys the menu should use. Note that the MenuKey
108 # will be reserved exclusively, the others work in shared mode.
110 # The following works excellent with 4 keys or more.
115 # If you have 6 keys you may define these as well
119 # If you have only 3 keys, you could use something like this:
126 ### Driver sections are below this line, in alphabetical order ###
129 ## EMAC BayRAD driver ##
132 # Select the output device to use [default: /dev/lcd]
135 # Set the communication speed [default: 9600; legal: 1200, 2400, 9600, 19200]
140 ## CrystalFontz driver (for CF632 & CF634) ##
143 # Select the output device to use [default: /dev/lcd]
145 # Select the LCD size [default: 20x4]
147 # Set the initial contrast [default: 560; legal: 0 - 1000]
149 # Set the initial brightness [default: 1000; legal: 0 - 1000]
151 # Set the initial off-brightness [default: 0; legal: 0 - 1000]
152 # This value is used when the display is normally
153 # switched off in case LCDd is inactive
155 # Set the communication speed [default: 9600; legal: 1200, 2400, 9600, 19200 or 115200]
157 # Set the firmware version (New means >= 2.0) [default: no; legal: yes, no]
159 # Reinitialize the LCD's BIOS [default: no; legal: yes, no]
160 # normally you shouldn't need this
165 ## CrystalFontz633 driver (for CF633 only) ##
168 # Select the output device to use [default: /dev/lcd]
170 # Select the LCD type (size) [default: 16x2]
172 # Set the initial contrast [default: 560; legal: 0 - 1000]
174 # Set the initial brightness [default: 1000; legal: 0 - 1000]
176 # Set the initial off-brightness [default: 0; legal: 0 - 1000]
177 # This value is used when the display is normally
178 # switched off in case LCDd is inactive
180 # Set the communication speed [default: 9600; legal: 1200, 2400, 9600, 19200, 115200]
182 # Set the firmware version (New means >= 2.0) [default: no; legal: yes, no]
183 # Currently this flag is not in use, there is no such thing as NewFirmware. ;=)
185 # Reinitialize the LCD's BIOS [default: no; legal: yes, no]
186 # I want to reboot the LCD to make sure we start from a known state
191 ## CrystalFontz packet driver (for CF631, CF633 & CF635) ##
194 # Select the LCD model [default: 633; legal: 631, 633, 635]
196 # Select the output device to use [default: /dev/lcd]
198 # Select the LCD size [default: depending on model: 635: 20x4, 631: 20x2, 633: 16x2]
200 # Set the initial contrast [default: 560; legal: 0 - 1000]
202 # Set the initial brightness [default: 1000; legal: 0 - 1000]
204 # Set the initial off-brightness [default: 0; legal: 0 - 1000]
205 # This value is used when the display is normally
206 # switched off in case LCDd is inactive
208 # Set the communication speed [default: 9600; legal: 1200, 2400, 9600, 19200, 115200]
210 # Set the firmware version (New means >= 2.0) [default: no; legal: yes, no]
211 # Currently this flag is not in use, there is no such thing as NewFirmware. ;=)
213 # Reinitialize the LCD's BIOS [default: no; legal: yes, no]
214 # I want to reboot the LCD to make sure we start from a known state
223 # foreground color [default: blue]
225 # background color when "backlight" is off [default: cyan]
227 # background color when "backlight" is on [default: red]
230 # display size [default: 20x4]
233 # What position (X,Y) to start the left top corner at...
238 # use ASC symbols for icons & bars [default: no; legal, yes, no]
246 # Select the LCD model [default: 12232; legal: 12232, 1602]
249 # Select the output device to use [default: /dev/lcd]
252 # Select the LCD size [default: depending on model: 12232: 20x4, 1602: 16x2]
255 # Set the communication speed [default: 19200; legal: 9600, 19200]
258 # Reinitialize the LCD's BIOS [default: no; legal: yes, no]
259 # normally you shouldn't need this
262 # If you have a keypad connected. Keypad layout is currently not
263 # configureable from the config file.
266 # If you have a non-standard keypad you can associate any keystrings to keys.
267 # There are 6 input keys in the CwLnx hardware that generate characters
270 # The following is the built-in default mapping hardcoded in the driver.
271 # You can leave those unchanged if you have a standard keypad.
272 # You can change it if you want to report other keystrings or have a non
281 # keypad_test_mode permits to test keypad assignement
282 # Default value is no
283 #keypad_test_mode=yes
287 ## ea65 driver for the display in AOpen XC Cube AV EA65 media barebones ##
290 # Device is fixed /dev/ttyS1
291 # Width and Height are fixed 9x1
293 # As the VFD is self luminescent we don't have a backlight
294 # But we can use the backlight functions to control the front LEDs
295 # Brightness 0 to 299 -> LEDs off
296 # Brightness 300 to 699 -> LEDs half bright
297 # Brightness 700 to 1000 -> LEDs full bright
299 # OffBrightness is the the value used for the 'backlight off' state
304 ## EyeboxOne driver ##
307 # Select the output device to use [default: /dev/ttyS1]
311 # Set the display size [default: 20x4]
314 # Switch on the backlight? [default: yes]
317 # Switch on the cursor? [default: no]
320 # Set the communication speed [default: 19200; legal: 1200, 2400, 9600, 19200]
323 # Enter Key is a \r character, so it's hardcoded in the driver
330 # You can find out which key of your display sends which
331 # character by setting keypad_test_mode to yes and running
332 # LCDd. LCDd will output all characters it receives.
333 # Afterwards you can modify the settings above and set
334 # keypad_set_mode to no again.
339 ## g15 driver for Logitech G15 Keyboard LCDs ##
342 # Display size (currently unused)
345 ## glcdlib meta driver for graphical LCDs ##
350 # which graphical display supported by graphlcd-base to use [default: image]
351 # (see /etc/graphlcd.conf for possible drivers)
354 # no=use graphlcd bitmap fonts (they have only one size / font file)
355 # yes=use fonts supported by FreeType2 (needs Freetype2 support in libglcdprocdriver and its dependants)
358 # text resolution in fixed width characters [default: 16x4]
359 # (if it won't fit according to available physical pixel resolutioni
360 # and the minimum available font face size in pixels, then
361 # 'DebugBorder' will automatically be turned on)
364 # path to font file to use
365 FontFile=/usr/share/fonts/corefonts/courbd.ttf
367 ## these only apply if UseFT2=yes:
369 # character encoding to use
370 CharEncoding=iso8859-2
372 # minumum size in pixels in which fonts should be rendered
376 Brightness=50 # Brightness (in %) if applicable
377 Contrast=50 # Contrast (in %) if applicable
378 Backlight=no # Backlight if applicable
379 UpsideDown=no # flip image upside down
380 Invert=no # invert light/dark pixels
381 ShowDebugFrame=no # turns on/off 1 pixel thick debugging
382 # border whithin the usable text area,
383 # for setting up TextResolution and
384 # MinFontFaceSize (if using FT2);
385 ShowBigBorder=no # border around the unused area
386 ShowThinBorder=yes # border around the unused area
392 ## Matrix Orbital GLK driver ##
395 # select the serial device to use [default: /dev/lcd]
398 # set the initial contrast value [default: 560; legal: 0 - 1000]
401 # set the serial port speed [default: 19200; legal: 9600, 19200, 38400]
406 ## Hitachi HD44780 driver ##
409 # Select what type of connection. See documentation for types.
412 # Port where the LPT is. Usual values are 0x278, 0x378 and 0x3BC
415 # Device of the serial interface (default is /dev/lcd)
418 # Bitrate of the serial port (0 for interface default)
421 # If you have a keypad connected.
422 # You may also need to configure the keypad layout further on in this file.
425 # set the initial contrast (for bwctusb only) [default: 0; legal: 0 - 1000]
428 # If you have a switchable backlight.
431 # If you have the additional output port ("bargraph") and you want to
432 # be able to control it with the lcdproc OUTPUT command
435 # Specifies if the last line is pixel addressable or it controls an
436 # underline effect. [default: true (= pixel addressable); legal: yes, no]
439 # Specifies the size of the LCD.
440 # In case of multiple combined displays, this should be the total size.
443 # For multiple combined displays: how many lines does each display have.
444 # Vspan=2,2 means both displays have 2 lines.
447 # If you have an HD66712, a KS0073 or an other 'almost HD44780-compatible',
448 # set this flag to get into extended mode (4-line linear).
449 # This flag is NOT the old obsolete Extended option.
452 # Character map to to map ISO-8859-1 to the LCD's character set
453 # [default: hd44780_default; legal: hd44780_default, ea_ks0073, sed1278f_0b ]
454 Charmap=hd44780_default
456 # If your display is slow and cannot keep up with the flow of data from
457 # LCDd, garbage can appear on the LCDd. Set this delay factor to 2 or 4
458 # to increase the delays. Default: 1.
461 # Some displays (e.g. vdr-wakeup) need a message from the driver to that it
462 # is still alive. When set to a value bigger then null the character in the
463 # upper left corner is updated every <KeepAliveDisplay> seconds. Default: 0.
466 # If you experience occasional garbage on your display you can use this
467 # option as workaround. If set to a value bigger than null it forces a
468 # full screen refresh <RefreshDiplay> seconds. Default: 0.
471 # You can reduce the inserted delays by setting this to false.
472 # On fast PCs it is possible your LCD does not respond correctly.
476 # If you have a keypad you can assign keystrings to the keys.
477 # See documentation for used terms and how to wire it.
478 # For example to give directly connected key 4 the string "Enter", use:
480 # For matrix keys use the X and Y coordinates of the key:
481 # KeyMatrix_1_3=Enter
489 ## ICP A106 driver ##
495 ## Code Mercenaries IO-Warrior driver ##
501 # serial number [exactly as listed by usbview]
502 # (if not given, the 1st IOWarrior found gets used)
503 #SerialNumber=00000674
505 # Specifies if the last line is pixel addressable or it controls an
506 # underline effect. [default: true (= pixel addressable); legal: yes, no]
511 ## Soundgraph/Ahanix/Silverstone/Uneed/Accent iMON driver ##
514 # select the device to use
524 #if in trouble with IrMan, try Lirc emulator for IrMan
526 # Select the input device to use
529 # Select the configuration file to use
530 #Config=/etc/irman.cfg
534 ## Joystick driver ##
537 # Select the input device to use [default: /dev/js0]
555 # Select the output device to use [default: /dev/lcd]
558 # Set the initial brightness [default: 255; legal: 0 - 255]
561 # Set the communication speed [default: 9600; legal: 2400, 9600]
564 # Reinitialize the LCD's BIOS [default: no; legal: yes, no]
576 # Normal context Menu context
577 # ------- -------------- ------------
578 # PauseKey Pause/Continue Enter/select
579 # BackKey Back(Go to previous screen) Up/Left
580 # ForwardKey Forward(Go to next screen) Down/Right
581 # MainMenuKey Open main menu Exit/Cancel
587 # You can rearrange the settings here.
588 # If your device is broken, have a look at server/drivers/lcdm001.h
592 ## HNE LCTerm driver ##
599 ## LIRC input driver ##
602 # Specify an alternative location of the lircrc file [default: ~/.lircrc]
603 #lircrc=/etc/lircrc.lcdproc
605 # Must be the same as in your lircrc
610 ##The driver for the VFD of the Medion MD8800 PC ##
612 # device to use [default: /dev/ttyS1]
615 # display size [default: 16x2]
618 # Set the initial brightness [default: 1000; legal: 0 - 1000]
620 # Set the initial off-brightness [default: 0; legal: 0 - 1000]
621 # This value is used when the display is normally
622 # switched off in case LCDd is inactive
627 ## MSI MS-6931 driver for displays in 1HU servers ##
630 # device to use [default: /dev/ttyS1]
633 # display size [default: 16x2]
638 ## MTC-S16209x driver ##
641 # Select the output device to use [default: /dev/lcd]
644 # Set the initial brightness [default: 255; legal: 0 - 255]
647 # Reinitialize the LCD's BIOS [default: no; legal: yes, no]
652 ## Matrix Orbital driver ##
655 # Select the output device to use [default: /dev/lcd]
658 # Set the display size [default: 20x4]
661 # Set the display type [default: lcd; legal: lcd, lkd, vfd, vkd]
664 # Set the initial contrast [default: 480]
665 # NOTE: The driver will ignore this if the display
666 # is a vfd or vkd as they don't have this feature
669 # Set the initial brightness [default: 1000; legal: 0 - 1000]
671 # Set the initial off-brightness [default: 0; legal: 0 - 1000]
672 # This value is used when the display is normally
673 # switched off in case LCDd is inactive
676 # Set the communication speed [default: 19200; legal: 1200, 2400, 9600, 19200]
679 # The following table translates from MtxOrb key letters to logical key names.
680 # By default no keys are mapped, meaning the keypad is not used at all.
687 # See the [menu] section for an explanation of the key mappings
689 # You can find out which key of your display sends which
690 # character by setting keypad_test_mode to yes and running
691 # LCDd. LCDd will output all characters it receives.
692 # Afterwards you can modify the settings above and set
693 # keypad_set_mode to no again.
698 ## Noritake VFD driver ##
700 # device where the VFD is. Usual values are /dev/ttyS0 and /dev/ttyS1 [default: /dev/lcd]
703 # Specifies the size of the LCD.
709 # set the serial port speed [default: 9600, legal: 1200, 2400, 9600, 19200, 115200]
712 # re-initialize VFD ?
717 ## Mini-box.com picoLCD (usblcd) driver ##
719 # This is for the Mini-Box.com usblcd device that ships with the M300. It can
720 # also be purchased separately but this driver has only been tested on the M300
723 # KeyTimeout is the time that LCDd spends waiting for a key press before cycling
724 # through other duties. Higher values make LCDd use less CPU time and make
725 # key presses more detectable. Lower values make LCDd more responsive but a
726 # little prone to missing key presses. 500 (.5 second) is the default and a
730 # Contrast: [default: 1000; legal: 0 - 1000]
733 # Light the keys? i[default: on; legal: on, off]
736 # If Keylights is on, the you can unlight specific keys below:
737 # Key0 is the directional pad. Key1 - Key5 correspond to the F1 - F5 keys.
738 # There is no LED for the +/- keys. This is a handy way to indicate to users
739 # which keys are disabled. [default: on; legal: on, off]
749 ## Pyramid LCD driver ##
752 # device to connect to [default: /dev/lcd]
757 ## Seiko Epson 1330 driver ##
760 # Port where the LPT is. Common values are 0x278, 0x378 and 0x3BC
763 # Type of LCD module (legal: G321D, G121C, G242C, G191D, G2446, SP14Q002)
764 # Note: Currently only tested with G321D & SP14Q002.
767 # Width x Height of a character cell in pixels [legal: 6x7 - 8x16; default: 6x10]
770 # Select what type of connection [legal: classic, bitshaker; default: classic]
771 ConnectionType=classic
774 ## Seiko Epson 1520 driver ##
777 # Port where the LPT is. Usual values are 0x278, 0x378 and 0x3BC
782 ## serial POS display driver ##
785 # Device to use in serial modea [default: /dev/lcd]
788 # Specifies the size of the display in characters. [default: 16x2]
791 # Set the communication protocol to use with the POS display.
792 # [default: AEDEX; legal: IEE, Epson, Emax, IBM, LogicControls, Ultimate]
795 # communication baud rate with the display [default: 9600; legal: 1200, 2400, 19200, 115200]
800 ## Serial VFD driver ##
801 ## Drives various (see below) serial 5x7dot VFD's. ##
804 # Specifies the displaytype.[default: 0]
805 # 0 NEC (FIPC8367 based) VFDs.
807 # 2 Noritake VFDs (*).
809 # (* most should work, not testet yet.)
812 # "no" if display connected serial, "yes" if connected parallel. [default: no(=serial)]
815 # Number of Custom-Characters [default: displaytype dependent]
818 # Portaddress where the LPT is. Used in parallelmode only. Usual values are 0x278, 0x378 and 0x3BC
821 # Device to use in serial mode. Usual values are /dev/ttyS0 and /dev/ttyS1
824 # Specifies the size of the VFD.
827 # Set the initial brightness [default: 1000; legal: 0 - 1000]
828 # (4 steps 0-250, 251-500, 501-750, 751-1000)
830 # Set the initial off-brightness [default: 0; legal: 0 - 1000]
831 # This value is used when the display is normally
832 # switched off in case LCDd is inactive
833 # (4 steps 0-250, 251-500, 501-750, 751-1000)
836 # set the serial port speed [default: 9600; legal: 1200, 2400, 9600, 19200, 115200]
839 # enable ISO 8859 1 compatibility [default: yes; legal: yes, no]
847 # Port the device is connected to [default: 0x378]
855 # svgalib mode to use [default: G320x240x256; legal: supported svgalib modes]
858 # set display size [default: 20x4]
861 # Set the initial contrast [default: 500; legal: 0 - 1000]
862 # Can be set but does not change anything internally
865 # Set the initial brightness [default: 1000; legal: 1 - 1000]
868 # Set the initial off-brightness [default: 500; legal: 1 - 1000]
869 # This value is used when the display is normally
870 # switched off in case LCDd is inactive
877 # Set the display size [default: 20x4]
882 ## Toshiba T6963 driver ##
885 # set display size [default: 20x6]
888 # port to use [default: 0x378; legal: 0x200 - 0x400]
891 # Is ECP mode on? [default: yes; legal: yes, no]
894 # Use graphics? [default: no; legal: yes, no]
899 ## Tyan Barebones LCD driver (GS10 & GS12 series) ##
902 # Select the output device to use [default: /dev/lcd]
905 # Set the communication speed [default: 9600; legal: 4800, 9600]
908 # set display size [default: 16x2]
913 ## ELV ula200 driver ##
916 # Select the LCD size [default: 20x4]
919 # If you have a non standard keypad you can associate any keystrings to keys.
920 # There are 6 input key in the CwLnx hardware that generate characters
923 # The following it the built-in default mapping hardcoded in the driver.
924 # You can leave those unchanged if you have a standard keypad.
925 # You can change it if you want to report other keystrings or have a non
936 ## Wirz SLI LCD driver ##
939 # Select the output device to use [default: /dev/lcd]
942 # Set the communication speed [default: 19200; legal: 1200, 2400, 9600, 19200, 38400, 57600, 115200]
947 ## OnScreen Display using libxosd ##
950 # set display size [default: 20x4]
953 # font to use, in XLFD format, as given by "xfontsel"
954 Font=-*-terminus-*-r-*-*-*-320-*-*-*-*-*