diff options
| -rw-r--r-- | README.Rows | 33 | ||||
| -rw-r--r-- | README.Tokens | 52 | ||||
| -rw-r--r-- | lcd4linux.conf.sample | 328 |
3 files changed, 336 insertions, 77 deletions
diff --git a/README.Rows b/README.Rows new file mode 100644 index 0000000..9e43ad1 --- /dev/null +++ b/README.Rows @@ -0,0 +1,33 @@ +list of possible directives which will be replaced +by the appropriate values or will create bars or +icons extracted from +http://lcd4linux.sourceforge.net/manual.html + +Directive Description +=================================================================================== +\nnn will write the ASCII-character nnn (octal) +%token will be replaced by the value of token + for a detailed description of every + possible token please refer to + http://lcd4linux.sourceforge.net/manual.html or + /usr/share/doc/packages/lcd4linux/README.Tokens +%% will write a '%' +%$ will write a '$' +%& will write a '&' +$<direction><length><token>[+<token>] will create a bar with the specified + direction and length (in characters) + with the value of token. If the driver + supports dual bars, you can specify the + second value with '+token'. 'direction' can + be 'l' (left), 'r' (right), 'u' (up) or + 'd'(down). If you specify the direction + in upper case, a logarithmic bar will be + created. The space occupied by a bar + always grows from left to right or from + top to bottom, regardless of the direction! +$t<height><token>,<width> will create a time series bar. The data + is displayed like '$u', but shifted every + second 1 pixel to the left. Currently only + displays based on the pixel-driver support + these type of bars. +&<num> will draw the icon 'num' at this position diff --git a/README.Tokens b/README.Tokens new file mode 100644 index 0000000..ce26842 --- /dev/null +++ b/README.Tokens @@ -0,0 +1,52 @@ +list of possible lcd4linux tokens extracted from +http://lcd4linux.sourceforge.net/manual.html + +Token Description +====================================================================== +bd battery duration in s{econds}, m{ins}, h{ours} or d{ays} +bp battery percentage (APM by now) +bs battery status ('=' = online, '+' = charging, '-' discharging) +cb percentage of CPU busy (=100-idle) +ci percentage of CPU idle +cn percentage of CPU in niced tasks +cs percentage of CPU in system mode +cu percentage of CPU in user mode +dm disk blocks max (read, write) +dr disk blocks read +dt disk blocks total (read+write) +dw disk blocks written +e* mails in mailbox 1-9, total mail +hc seti@home % completed +ht seti@home time spent on workunit +ic ISDN connected (0=offline, 1=online) +ii ISDN bytes received +im ISDN bytes max (received, send) +io ISDN bytes sent +it ISDN bytes total (received+send) +L '!' if load > overload (from config) +l1 load average for the past 1 minute +l2 load average for the past 5 minutes +l3 load average for the past 15 minutes +ma application memory (kB) = used - buffer - cache +mb buffers (kB) +mc page cache (kB) +mf free memory (kB) +ms shared memory (kB) +mt total memory from /proc/meminfo (kB) +mu used memory (kB) +nm network bytes max (receive, transmit) +nr network bytes received +nt network bytes total (receive+transmit) +nw network bytes transmitted +o operating system name ('Linux') +p processor ('i686') +r total amount of memory installed (MB) +s1 temperature of sensor 1 +s2 temperature of sensor 2 (up to s9) +ti PPP bytes received +tm PPP bytes max (received, send) +to PPP bytes sent +tt PPP bytes total (received+send) +u* mails in mailbox 1-9, unseen mail +v operating system release ('2.0.38') +x* output of command 1-9 diff --git a/lcd4linux.conf.sample b/lcd4linux.conf.sample index 62c0a62..e012f60 100644 --- a/lcd4linux.conf.sample +++ b/lcd4linux.conf.sample @@ -1,22 +1,42 @@ +# +# /etc/lcd4linux.conf +# configuration file for lcd4linux +# +# http://lcd4linux.sourceforge.net +# +# for the complete lcd4linux documentation please refer to +# http://lcd4linux.sourceforge.net/manual.html + + +# driver-specific options +# +# Display: +# the name of a display driver +# +# every driver has its own configuration options +# (e.g. 'Port', 'Speed', ...) +# for a detailed description of every option which is +# available for a specific driver please refer to +# http://lcd4linux.sourceforge.net/display/main.html +# #Display LCD2041 #Port /dev/ttyS2 #Speed 19200 #Contrast 160 - -Display HD44780 -#Port 0x378 -Port /dev/parports/1 -Size 24x2 +# +#Display HD44780 +#Port /dev/parport0 +#Size 24x2 #Delay 503 - +# #Display BLC100x #Port /dev/ttyS2 #Type 20x4 - +# #Display USBLCD #Port /dev/usb/usblcd #Size 20x4 - +# #Display PalmPilot #Port /dev/ttyS2 #Speed 4800 @@ -25,7 +45,7 @@ Size 24x2 #pixel 1+0 #gap 0x0 #border 2 - +# #Display PPM #size 20x4 #font 5x8 @@ -35,7 +55,7 @@ Size 24x2 #foreground \#102000 #halfground \#70c000 #background \#80d000 - +# #Display PNG #size 20x4 #font 5x8 @@ -45,7 +65,7 @@ Size 24x2 #foreground \#102000 #halfground \#70c000 #background \#80d000 - +# #Display X11 #size 20x5 #font 5x8 @@ -55,95 +75,249 @@ Size 24x2 #foreground \#102000 #halfground \#90c000 #background \#a0d000 - +# #Display Text #size 40x8 #TextBar 1 - +# #Display SIN #Port /dev/tty9 + +# timing options - all values are milliseconds +# +# please note that starting with 0.9.11 the settings tick, +# tack, tau are marked as obsolete and replaced by the +# following ones: +# +# Tick.Text: +# time between text updates - default is 500 +# +# Tick.bar : +# time between bar updates - default is 100 +# +# Tick.icon: +# time between icon updates - default is 100 +# +# Tick.gpo : +# time between gpo updates - default is 100 +# +#Tick.Text 500 +#Tick.bar 100 +#Tick.icon 100 +#Tick.gpo 100 + + +# data-specific options +# +# Overload: +# load average threshold and bar scaling +# +# SetiDir: +# directory where seti@home stores its data files +# +# Battwarning: +# flash bp-bar if running below Battwarning +# I use: Row6 "Bat%bp%bs%bd$r10bp+bp" +# which gives a nice flash effect - default is 10 +# +Overload 2.0 +SetiDir /etc/setiathome +#Battwarning 10 + + +# mail/news related options +# +# Mailbox[1..9]: +# defines the mailbox for querying +# the string may be a plain mbox file or a pop3/imap4/nntp +# server string with the following format: +# pop3:[user[:pass]@]machine[:port] +# imap4:[user[:pass]@]machine[:port][/dir] +# nntp:[user[:pass]@]machine[:port][/dir] +# quering a plain (local) mbox file is achieved by giving +# the full path/name to the mbox file +# port defaults to 110 (pop3 query) and 143 (imap query) +# if [/dir] is not given, INBOX is assumed +# if [/dir] is given for nntp it should be a valid group name +# with '.' separating items +# if [/dir] is not given for nntp all/unread news of subscribed +# groups from Newsrc are calculated. +# +# Delay_e[1..9]: +# delay in seconds for querying Mailbox[1..9] - default is 5 +# +# Newsrc: +# path/name of your .newsrc file containing subscribed news +# please note that authorization on newsservers is currently untested +# user and pass may not contain a '/' with above syntax +# +#Mailbox1 /var/spool/mail/michi +#Delay_e1 5 +# +#Mailbox2 pop3:user:pass@machine +#Delay_e2 20 +# +#Mailbox3 imap4:user:pass@machine/folder +#Delay_e3 20 +# +#Mailbox4 nntp:server/at.linux +#Delay_e4 120 + + +# temperature sensors +# +# Sensor[1..9]: +# path to temperature file [1...9] +# +# Sensor[1..9]_min: +# temperature where the corresponding bar starts +# +# Sensor[1..9]_max: +# temperature where bar ends +# +# Sensor[1..9]_factor: +# formula to calculate real temperature +# (display_value=raw_value*factor+offset) +# lookup these values in /etc/sensors.conf +# +# Sensor[1..9]_offset: +# offset to calculate the real temperature +# +#Sensor1 /proc/sys/dev/sensors/as99127f-i2c-0-2d/temp1 +#Sensor1_min 30 +#Sensor1_max 50 +# +#Sensor2 /proc/sys/dev/sensors/as99127f-i2c-0-2d/temp2 +#Sensor2_min 30 +#Sensor2_max 50 +# +#Sensor3 /proc/sys/dev/sensors/as99127f-i2c-0-2d/temp3 +#Sensor3_min 30 +#Sensor3_max 50 + + + +# plugins +# +# x[1..9]: +# command to execute. predefined $PATH: +# PATH=/usr/local/bin:/usr/bin:/bin +# $X[1..9] is the result of command x[1..9] in environment +# +# Tick_x[1..9]: +# delay in ticks (overrides Delay_x[1..9]) +# +# Delay_x[1..9]: +# delay in seconds - default is 1 +# +# Max_x[1..9]: +# max value for scaling bars - default is 100 (value should be numeric) +# +# Min_x[1..9]: +# min value for bars - default is 0 (should be != Max_x[1..9]) +# +#x1 tail -1 /var/log/messages +#Tick_x1 10 +#Delay_x1 1 +#Max_x1 50 +#Min_x1 10 +# +#x2 echo $X1 | cut -b25- + + +# display options +# +# Row[1..9]: +# text to display in row [1..9] +# +# the text to be displayed can contain specific directives which will +# be replaced by the appropriate values or will create bars or icons. +# for a detailed description of every possible directive please refer to +# http://lcd4linux.sourceforge.net/manual.html or +# /usr/share/doc/packages/lcd4linux/README.Rows +# Row1 "Busy %cb%% $r14cs+cb" Row2 "Load%l1%L$r14l1" - +# +#Row1 "$u3l1$u3cb$u3cs $u3mu$u3ma$u3ms $u3dr$u3dw $u3nr$u3nw $u3ii$u3io" +#Row2 " " +#Row3 " " +#Row4 "CPU MEM IO IP" +# #Row1 "*** %o %v ***" #Row2 "%p CPU %r MB RAM" #Row3 "Busy %cb%% $r10cs+cb" #Row4 "Load%l1%L$r10l1" - -# e(x)ecute command in %x* -# Row5 %x1 -# Row6 %x2 -# x1 tail -1 /var/log/messages -# x2 echo $X1 | cut -b25- -# Note: PATH=/usr/local/bin:/usr/bin:/bin -# Note: $X1 .. $X8 is the text of lines x1 .. x8 # -# Tick_x1 10 # every 10 ticks -# Delay_x1 2 # every 2 seconds -# Max_x1 50 # max for scaling bars (default 100), value SHOULD be numeric ;-) -# Min_x1 10 # min (default 0), SHOULD be != Max_x1 - #Row1 "Load%l1%L$r10cs+cb" #Row2 "Disk%dm $R10dr+dw" #Row3 "Net %nm $R10nr+nw" #Row4 "ISDN%im $r10ii+io" #Row4 "DSL %tm $r10ti+to" #Row5 "Temp%s2°$r10s1+s2" +# +#Row5 %x1 +#Row6 %x2 +# +#Row6 "Mails %e3/%u3" -#Row1 "$u3l1$u3cb$u3cs $u3mu$u3ma$u3ms $u3dr$u3dw $u3nr$u3nw $u3ii$u3io" -#Row2 " " -#Row3 " " -#Row4 "CPU MEM IO IP" - -Tick 100 -Tack 400 -Tau 500 - -Overload 2.0 - -# flash bp-Bar if below Battwarning -# I use Row6 "Bat%bp%bs%bd$r10bp+bp" -# which gives a nice flash effect -# default is 10 - -Battwarning 10 - -SetiDir /etc/setiathome - -# normal local mbox -# Mailbox1 /var/spool/mail/michi - -# POP3 mail @ machine -# Mailbox2 pop3:user:pass@machine - -# IMAP4 mail folder @ machine -# Mailbox3 imap4:user:pass@machine/folder - -# News server on 'server' group at.linux -# Mailbox4 nntp:server/at.linux -# Full syntax of pop3/imap4/nntp is: -# [user[:pass]@]machine[:port][/dir] +# icons # -# display total/unseen mails/news of Mailbox3 -# Row6 "Mails %e3/%u3" - -# delay query of MailboxN in seconds (default = 5) -Delay_e1 5 -Delay_e2 20 -Delay_e3 20 -Delay_e4 120 +# Icons: +# number of icons +# +# every icon you are reserving here is no longer available +# for bars. As most displays have only eight user-defineable +# characters, and a dual-bar needs at least five of them +# you should not use more than 3 icons in parallel +# with bars... +# +# Icon<num>.Bitmap<row>: +# bitmap row 'row' for icon 'num' +# +# for a detailed description of how to use icons please refer to +# http://lcd4linux.sourceforge.net/display/main.html +# +#Icons 1 +# +#Icon1.Bitmap1 ..... +#Icon1.Bitmap2 .*.*. +#Icon1.Bitmap3 ***** +#Icon1.Bitmap4 ***** +#Icon1.Bitmap5 .***. +#Icon1.Bitmap6 .***. +#Icon1.Bitmap7 ..*.. +#Icon1.Bitmap8 ..... -Sensor1 /proc/sys/dev/sensors/as99127f-i2c-0-2d/temp1 -Sensor1_min 30 -Sensor1_max 50 -Sensor2 /proc/sys/dev/sensors/as99127f-i2c-0-2d/temp2 -Sensor2_min 30 -Sensor2_max 50 +# virtual rows +# +# Rows: +# number of rows to use (maybe greater than your displays rows) +# +# Scroll: +# number of rows to scroll +# +# Turn: +# time in milliseconds between scrolling events +# +#Rows 10 +#Scroll 2 +#Turn 5000 -Sensor3 /proc/sys/dev/sensors/as99127f-i2c-0-2d/temp3 -Sensor3_min 30 -Sensor3_max 50 +# general purpose outputs +# +# GPOs: +# number of outputs to use +# +# GPO[1..max]: +# token to use for GPO[1..max] +# +# the token should return a numeric value. If this value is greater +# than zero the output will be enabled otherwise disabled. +# please refer to the corresponding documentation under +# http://lcd4linux.sourceforge.net/display/main.html to +# find out if GPOs are supported with your display |