|
|
@@ -1,6 +1,6 @@
|
|
|
.TH STDD 1 "28 July, 2013" 0.9 stdd
|
|
|
.SH NAME
|
|
|
-stdd \- a daemon to display the current time on an i2c-attached Adafruit 7 segment display with i2c-backpack
|
|
|
+stdd \- a daemon to display the current time on a 7 segment display
|
|
|
.SH SYNOPSIS
|
|
|
.B "stdd"
|
|
|
[
|
|
|
@@ -13,10 +13,66 @@ group name ]
|
|
|
.B -c/--config
|
|
|
configuration file
|
|
|
.SH DESCRIPTION
|
|
|
+stdd (short for "simple time display daemon") is a handy little daemon for
|
|
|
+the Raspberry PI device that can be used to display the current time on a
|
|
|
+7 segment display with a HT16K33 backpack from Adafruit Industries. It
|
|
|
+makes heavy use of the python libraries published by Adafruit to control
|
|
|
+the display via I2C.
|
|
|
+
|
|
|
.SH "COMMAND LINE OPTIONS"
|
|
|
+.TP
|
|
|
+.B "-d --daemon"
|
|
|
+run the program in daemon mode which means, it will detach from the shell and run in background
|
|
|
+.TP
|
|
|
+.BI "-u --user " "user name"
|
|
|
+instructs stdd to drop privileges and run with the privileges of the defined user. Please note that stdd nees to be started as root for this to work and the user (or his primary group) needs to be able to access the i2c device.
|
|
|
+.TP
|
|
|
+.BI "-g --group " "group name"
|
|
|
+instructs stdd to drop privileges and run with the privileges defined user. Please note that stdd nees to be started as root for this to work and the group needs to be able to access the i2c device.
|
|
|
+.TP
|
|
|
+.BI "-c --config " "configuration file"
|
|
|
+define the path to your stdd configuration file. This is usually needed to start the program in both modes.
|
|
|
.SH EXAMPLES
|
|
|
+.TP
|
|
|
+.B stdd -c /etc/stdd.conf
|
|
|
+minimal example using the default configuration file
|
|
|
+.TP
|
|
|
+.B stdd -c /etc/stdd.conf -u i2cuser -g i2c -d
|
|
|
+start with the privileges of user i2cuser, group i2c and run as daemon
|
|
|
.SH CONFIGURATION
|
|
|
+The following options can and should be set in the configuration file:
|
|
|
+.P
|
|
|
+HW_ADDRESS: hardware address for your display, a common value is "0x70" use i2cdetect to find yours if it doesn't match
|
|
|
+.P
|
|
|
+BLINK_COLON: define if you want the middle colon to blink, 0 = off, 1 = on
|
|
|
+.P
|
|
|
+BRIGHTNESS_HIGH: value used for "high" brightness, valid values are 0-15
|
|
|
+.P
|
|
|
+BRIGHTNESS_LOW: value used for "low" brightness, valid values are 0-15
|
|
|
+.P
|
|
|
+SET_BRIGHTNESS_LOW: value used for "low" brightness, valid values are 0-15
|
|
|
+.P
|
|
|
+SET_BRIGHTNESS_HIGH: time of the day to change the brightness from low to high
|
|
|
+.P
|
|
|
+SYSLOG_LEVEL: maximum syslog level to log, stdd uses debug, info and error
|
|
|
+.P
|
|
|
+SYSLOG_FACILITY: syslog facility to use for logging (default: user, can also be daemon)
|
|
|
.SH FILES
|
|
|
+.TP
|
|
|
+.B /etc/stdd.conf
|
|
|
+the default path to the configuration file
|
|
|
.SH "SEE ALSO"
|
|
|
+.TP
|
|
|
+.B http://learn.adafruit.com/matrix-7-segment-led-backpack-with-the-raspberry-pi
|
|
|
+Adafruit tutorial for attaching a display to the Raspberry PI and using the library
|
|
|
+.TP
|
|
|
+.B https://github.com/adafruit/Adafruit-Raspberry-Pi-Python-Code Adafruit
|
|
|
+sample code used in this project
|
|
|
.SH AUTHOR
|
|
|
+Helmut Pozimski
|
|
|
.SH COPYRIGHT
|
|
|
+2013, Helmut Pozimski, 3-Clause BSD license
|
|
|
+.P
|
|
|
+some parts written by Limor Fried, Kevin Townsend and Mikey Sklar for Adafruit Industries
|
|
|
+.P
|
|
|
+please look at the license header in the files for details
|
