##----------------------------------------------------------------------------
## opt_digitemp                                            fli4l-3.0.0 v3.3.2b
##
## Creation:     03.03.2002 Johannes Hermen
##               08.08.2004 Gerd Walter
## Last Update:  04.03.2006 m.p.
##
## Copyright (c) 2006 Matthias Pilz <fli4l.pilz@tiscali.de>
##
## This program 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 of the License, or
## (at your option) any later version.
##----------------------------------------------------------------------------
#-----------------------------------------------------------------------------
# Optional package: DigiTemp for ds1820 sensors on serial port
#-----------------------------------------------------------------------------

# Globale einstellungen:

OPT_DIGITEMP='no'	# install digitemp: yes / no

DIGITEMP_BIN='passive'	# welches binary verwenden: passive / active
		# passive = fr Adapter DS9097 bzw. selbst gebaute (siehe Doku)
		# active = fr Adapter DS9097U auf DS2480B-Basis (iButton, The Link etc.)

DIGITEMP_PORT='2'	# Serial Port ( 1,2,3 etc. )
DIGITEMP_INTERVALL='58'	# Intervall in dem die Sensoren abgefragt werden

DIGITEMP_UNIT='C'	# C/F (Messwerte in C oder F)

# Sensoreinstellungen

DIGITEMP_ANZ='2'			# Anzahl der Temperatursensoren

DIGITEMP_1_NAME='CPU' 			# Name des Sensors
DIGITEMP_1_LOG='yes'			# Logging fr diesen Sensor? yes/no (via easycron)
DIGITEMP_1_LOG_FILE='/data/sensor1.log'	# Pfad und Name der Log-Datei
DIGITEMP_1_LOG_TIME='0 * * * *'		# Logging Zeitpunkt (cron-syntax) hier: jede Stunde

DIGITEMP_2_NAME='Keller'
DIGITEMP_2_LOG='no'				# Logging in Datei ist nur optional
DIGITEMP_2_LOG_FILE='/var/log/sensor2.log'	# Vorsicht bei Logging in die Ramdisk!
DIGITEMP_2_LOG_TIME='*/5 * * * *'		# hier: alle 5 Minuten

DIGITEMP_LOG_MAX='no'		# Gre der Logdatei begrenzen? / dafr in tools "tail=yes" setzen!
DIGITEMP_LOG_MAX_N='200'	# Anzahl der Zeilen (=Messwerte)

#-----------------------------------------------------------------------------
# alpha-Version mit rrdtool-Integration!
# bitte mini-Doku am Ende lesen....
#-----------------------------------------------------------------------------

DIGITEMP_RRD='no'		# use RoundRobinDatabase? yes/no (opt_rrdtool)
DIGITEMP_RRD_CREATEDB='no'	# force new database creation (only necessary for feature change)
DIGITEMP_RRD_VALUE_INTERVAL='1'	# muss auf 1 gesetzt bleiben!!
				# see rrdtool docu: RRDTOOL_%_VALUE_INTERVAL
DIGITEMP_RRD_GRAPH_INTERVAL='5'	# see rrdtool docu: RRDTOOL_%_GRAPH_INTERVAL
DIGITEMP_RRD_GRAPH_PATH='/data/rrdtool/digitemp' # see rrdtool docu: RRDTOOL_%_GRAPH_PATH

DIGITEMP_RRD_N='3'		# Anzahl der Sensoren, fr die Grafiken erstellt werden sollen
DIGITEMP_RRD_1_LABEL='CPU Temp'	# Beschriftung in der rrd-Grafik
DIGITEMP_RRD_2_LABEL='Keller'
DIGITEMP_RRD_3_LABEL='Keine Ahnung'

#-----------------------------------------------------------------------------
# Mini-Doku:
# ----------
# Achtung, wichtige Vernderung:
# Umstellung der Messwerte von Komma auf Dezimal-PUNKT (21,27 -> 21.27)
# also bitte _alle_ alten Dateien berschreiben
# alte Logs funktionieren nicht mehr mit dem neuen Web-Interface - sorry
#
# alpha-Version mit rrdtool-Funktion:
# dafr ist ein _unmodifiziertes_ opt_rrdtool notwendig
# (1802-rrdtool.tar.gz aus der opt-db : 395040 Bytes vom 23.12.2005)
# entscheidend ist das Web-Interface: opt/files/srv/www/admin/rrdtool.cgi
# die notwendigen rrdtool-Dateien werden "on-the-fly" beim Booten erzeugt
# auch die Integration in rrdtool wird so realisiert:
# die Zeile _digitemp="DigiTemp" wird an eine definierte Stelle geschrieben,
# und das funktioniert eben nur sicher, wenn die Originaldatei verwendet wird...
#
# bei nderung der Sensorenkonfiguration ist ein Reset (Neuanlegen) der RRDs notwendig...
# DIGITEMP_RRD_CREATEDB='no' auf yes stellen, einmal Booten, damit die rrds erzeugt werden,
# dann wieder auf no stellen, finales Build erstellen und damit neu starten.
# Wenn man das nicht macht, werden die Daten in der Datenbank sinnlos,
# weil alte fehlerhafte Daten zur Weiterberechnung benutzt werden.
# Kann man ganz gut an meinen Experimenten sehen:
# http://home.tiscali.de/fli4l/digitemp-beta/
#
# die erzeugten rrdtool-scripte lege ich mit bei: siehe /config/rrdtool/_digitemp.*
# sie werden nicht bentigt, sind nur als Debugging-Hilfe / Info gedacht
#
# wie die Ergebnisse aussehen knnen (screenshots & graphen):
# http://home.tiscali.de/fli4l/
# http://home.tiscali.de/fli4l/digitemp-beta/

# momentan besteht kein grosser Zusammenhang zwischen rrdtool und der Digitemp-Basis-Konfig
# wenn ein Sensor nicht vorhanden ist, werden keine verwertbaren Daten gesammelt,
# die RRD verbraucht dann eben nur Platz
# zur Zeit kann noch keine Selektion getroffen werden, aber:

# die "fertige" Version soll dann diese Funktionalitt bieten und so konfigurierbar sein:
#
# DIGITEMP_RRD_GRAPH_N='4' Anzahl der erzeugten Datenbanken = "Grafik-Gruppen" (auf max. 6 begrenzen?)
#
# DIGITEMP_RRD_GRAPH_1='2 5' # welche sensoren-nummern sollen als grafik dargestellt werden
# .... (s.u.)
#
# DIGITEMP_RRD_GRAPH_2='1 3 4' # welche sensoren-nummern sollen als grafik dargestellt werden
# DIGITEMP_RRD_GRAPH_2_COLOUR='(farbe1) (farbe2) (farbe3)' # farbe des jeweiligen graphen als hexwert
# DIGITEMP_RRD_GRAPH_2_VALUE_INTERVAL='1' # muss auf 1 gesetzt werden!
# DIGITEMP_RRD_GRAPH_2_GRAPH_INTERVAL='10' # wie oft sollen neue grafiken erzeugt werden (abstand in minuten)
#
# DIGITEMP_RRD_GRAPH_3='1 2' # sensoren knnen auch in mehreren grafiken verwendet werden
# .... (s.o.)
#
# DIGITEMP_RRD_GRAPH_4='3' # auch ein sensor allein soll natrlich mglich sein
# .... (s.o.)
#
# als Namen werden dann die Definitionen aus DIGITEMP_x_NAME verwendet, momentan besteht
# noch kein Zusammenhang, deshalb sind oben auch die Namen nicht korrekt zugeordnet
#
