Plugins:Kalender

Aus TuxBoxWIKI
(Weitergeleitet von Tuxcal)
Wechseln zu: Navigation, Suche


Allgemeines

TuxCal ist ein Kalender, mit dem es möglich ist Feiertage, Geburtstage, Termine und Zeiträume auf der DBox2 und auf der Dreambox zu verwalten. Die wichtigsten Feiertage sind fest im Programm integriert, es können jedoch auch regionale Feiertage eingefügt werden, die nicht fest eingebaut wurden. Der integrierte Daemon tuxcald erinnert auf Wunsch optisch und akustisch an die eingetragenen Events (Ereignisse). Somit vergisst man keine wichtigen Termine und Geburtstage mehr. Außerdem kann auch noch eine Bildschirmuhr frei positionierbar auf dem Bildschirm angezeigt werden.

Das Programm besteht aus 2 Teilen:

  • dem Daemon tuxcald, welcher im Hintergrund läuft und die Uhr steuert und die Termine überwacht, und optisch und akustisch signalisiert.
  • dem Plugin tuxcal.so + tuxcal.cfg, das den Kalender anzeigt und in dem neue Events verwaltet werden können und das den Daemon steuert.

Außerdem wird noch eine Datendatei tuxcal.list verwendet. In ihr werden die Termine, Geburtstage, Zeiträume und frei definierbare Feiertage verwaltet.

Sobald der Daemon einen neuen Termin gefunden hat, wird eine optische und/oder akustische Benachrichtigung ausgelöst, um den Nutzer darüber zu informieren. Dies kann über ein Nachrichtenfenster erfolgen oder das Plugin kann gleich gestartet werden.

Um bei einer interessanten Sendung nicht gestört zu werden, kann die Abfrage über das Plugin angehalten und auch wieder gestartet werden. Sofern der Daemon aktiviert ist, werden beim Verlassen des Plugins alle Feiertage, Geburtstage, Termine und Zeiträume innerhalb des konfigurierten Zeitraums signalisiert.


Installation

Folgende Dateien nach /var/tuxbox/plugins/ kopieren:

- tuxcal.cfg

- tuxcal.so

und folgende nach /var/bin/:

- tuxcald

Die Dateien tuxcal.so und tuxcald benötigen Ausführrechte (755).

Das Datenfile tuxcal.list kommt nach /var/tuxbox/config/tuxcal/.


Plugin updaten, was ist dabei zu beachten

Wenn man das Plugin updaten will, ist zu beachten, dass man dazu vorher den Daemon tuxcald beenden muss, um eine neue Version dieser Datei auf die Box kopieren zu können. Dazu per Telnet unter Windows auf der DBox2 einloggen mit [Start] [Ausführen], dann eingeben telnet <DBOXIP> wobei <DBOXIP> durch die IP-Adresse der DBox2 zu ersetzen ist, z.B.:

telnet 192.168.0.23

Dann sollte ein Fenster auftauchen, in dem login drinsteht. Bei

login: root
Password: dbox2

eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben. Dann folgenden Befehl eingeben:

killall -9 tuxcald

Jetzt kann man die neuere Version des Daemons tuxcald per FTP nach /var/bin/ auf die Box kopieren und die ältere Version überschreiben. War dort schon eine ältere Version drin, sollten die Ausführrechte (755) schon passen. Sonst per Telnet diesen Befehl ausführen:

chmod 755 /var/bin/tuxcald

Dann entweder die Box runterfahren und neu starten, oder per Telnet diesen Befehl ausführen:

/var/bin/tuxcald -nodelay

Bitte auch zu beachten, dass man beim Plugin-Update auch immer die passende Version des Plugins tuxcal.so und tuxcal.cfg nach /var/tuxbox/plugins/ kopieren muss. Sollte das Plugin noch nicht in diesem Verzeichnis installiert gewesen sein, per Telnet diesen Befehl ausführen:

chmod 755 /var/tuxbox/plugins/tuxcal.so

Damit wird das Plugin ausführbar gemacht. Jetzt entweder die Box neu starten oder auf der Fernbedienung Dbox-Taste - Service - Plugins neu einlesen - Dbox-Taste drücken, um das Plugin Kalender auf der blauen Taste angezeigt zu bekommen.


Konfiguration

Damit der Daemon die Termine überprüfen kann, erzeugt er beim ersten Start die Konfigurationsdatei tuxcal.conf im Verzeichnis /var/tuxbox/config/tuxcal/, falls diese nicht existiert. Die Datei wird mit Standardwerten vorbelegt, die im Rahmen der Parametergrenzen geändert werden können. Hier können nun die gewünschen Angaben eingetragen, oder alternativ eine fertige Datei vom PC per FTP übertragen werden. Damit diese Datei erzeugt wird, muss das Plugin gestartet werden und der Autostart aktiviert werden, danach die DBox2 neu starten.


Die Datei tuxcal.conf hat folgenden Aufbau:

Eintrag Bedeutung mögliche Werte Standard
STARTDELAY Wartezeit bis der Daemon mit der ersten Abfrage beginnt
(die GUI benötigt einige Zeit zum Starten)
15...60 30
INTERVALL Abstand zwischen den Abfragen, bzw. Aktualisierung der Uhr in Sekunden 0...60 1
LOGGING loggen bestimmter Ausgaben des Daemon Y / N Y
AUDIO akustische Signalisierung:
Benutzerdefinierte 12/24/48KHz PCM Wave-Dateien können unter
/var/tuxbox/config/tuxcal/ abgelegt werden.
tuxcal_birthday.wav für Geburtstage
tuxcal_event.wav für Termine, Feiertage, Zeiträume
tuxcal_timer.wav für uhrzeitgenaue Termine
Y / N Y
VIDEO optische Signalisierung
(Message: muss per Fernbedienung bestätigt werden)
(Popup: wird nach einiger Zeit automatisch geschlossen)
1 = Plugin starten
2 = Enigma Popup
3 = Neutrino Message
4 = Neutrino Popup
5 = keine Signalisierung
1
SIGNAL Signalisierung von Ereignissen, wie sie mit dem Parameter SIGMODE eingestellt wurden 1 = nur von heute
2 = von heute und morgen
3 = bis 2 Tage im voraus
4 = bis 3 Tage im voraus
5 = bis 4 Tage im voraus
1
SIGMODE Signalisierung bestimmter Ereignisse 0 = nur Termine und Geburtstage
1 = auch Zeitspannen
2 = 0 + Feiertage
3 = alles
0
SIGTIME Signalisierung zu festen Uhrzeiten, zu diesen Zeiten wird die Signalisierung täglich ausgeführt.
Es können mehrere Zeiten, getrennt durch ein ; eingetragen werden
(max. 5 Zeiten)
00:00 - 23:59 leer
OSD TV-Ausgaben in Deutsch oder Englisch G / E G
SKIN Farbpalette wählen (1=blau, 2=grau) 1...3 1
WEBPORT Port des Webinterface der DBox2 1 - 65535 80
WEBUSER Benutzername für das Webinterface der DBox2 Text ohne Leerzeichen von bis zu 32 Zeichen leer
WEBPASS Passwort für das Webinterface der DBox2 Text ohne Leerzeichen von bis zu 32 Zeichen leer
POS_X Position für die Bildschirmuhr horizontal (sinnvoll ca. 40 - 550) 0 - 720 500
POS_Y Position für die Bildschirmuhr vertikal (sinnvoll ca. 10 - 500) 0 - 540 30
SHOW Bildschirmuhr beim Start anzeigen, kann dann nachher im Plugin mit Dbox-Taste ein- oder ausgeschaltet werden Y / N Y
DATE Bildschirmuhr Anzeige Datum Y / N N
CLOCK Bildschirmuhr Anzeige Uhrzeit Y / N Y
SEC Bildschirmuhr Anzeige der Sekunden Y / N Y
SIZE Bildschirmuhr Größe der Anzeige (S)mall, (N)ormal oder (B)ig S / N / B S
COLOR Bildschirmuhr Schriftfarbe: 0 Transparent, 1: schwarz, 2: weiß
die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)
0-255 1
BACK Bildschirmuhr Hintergrundfarbe: 0 Transparent, 1: schwarz, 2: weiß
die direkte Angabe (außer 0,1,2 funktioniert aber nur wenn DETECT = N)
0-255 1
DETECT Bildschirmuhr Versuch der Erkennung der gewählten Farbe aus der bestehenden Palette 0 / 1 1
MAIL Bildschirmuhr Anzeige von mit Tuxmail empfangener, ungelesener Mails Y / N Y

"WEBUSER" und "WEBPASS" können leer gelassen werden, wenn das Webinterface keine Authorisation erfordert.


Konfigurationsbeispiel "tuxcal.conf"

STARTDELAY=40
INTERVALL=1
LOGGING=Y
AUDIO=Y
VIDEO=3
SIGNAL=3
SIGMODE=0
SIGTIME=12:00;20:15;

OSD=G
SKIN=1

WEBPORT=80
WEBUSER=#
WEBPASS=#

POS_X=75
POS_Y=20
SHOW=Y
DATE=N
CLOCK=Y
SEC=Y
SIZE=S
COLOR=2
BACK=0
DETECT=1
MAIL=Y
 


Datendatei tuxcal.list

Die Datendatei tuxcal.list ist eigentlich selbsterklärend:

das Format ist wie folgt: <Art>;<Datum bzw. Zeitraum>;<Text> z.B.:

Beispiel für frei definierte Feiertage:

f;26.10.;Nationalfeiertag Österreich;

Beispiele für Zeiträume:

z;10.02.-21.02.;Winterferien;
z;18.04.-25.04.;Osterferien;
z;16.03.2006 07:00-20.03.2006 17:30;Geschäftsreise Italien; 

Beispiele für Geburtstage:

g;29.05.;Freundin;
g;25.04.1911;Oma;
 

Beispiele für Termine:

t;23.05.;Hochzeitstag!!!;
t;03.12.2006;Freundin Blumen schenken!;
t;23.02.2006 14:45;Zahnarzt;

Abkürzungen:

f = Feiertag
z = Zeitraum
g = Geburtstag
t = Termin

Die Datendatei tuxcal.list kann entweder mit einem Unix-Editor auf dem PC erstellt werden und dann per FTP auf die DBox2 nach /var/tuxbox/config/tuxcal/ kopiert werden. Oder sie kann direkt mit dem integrierten Termin-Editor auf der DBox2 erstellt und bearbeitet werden.


Signalisierung

Die Signalisierung von Terminen ohne Uhrzeit wird ohne weitere Maßnahmen automatisch nur beim Start der DBox2 aus dem Deep-Standby oder bei einem Datumswechsel ausgeführt. Außerdem kann über den Parameter SIGTIME=12:00;20:15; in der tuxcal.conf zu diesen Uhrzeiten eine automatische Signalisierung ausgeführt werden. Maximal sind 5 Zeiten möglich. Außerdem besteht die Möglichkeit, durch Einfügen von Befehlen in die Datei standby.off die Signalisierung auch beim Starten der DBox2 aus dem Standby auszuführen. Des Weiteren gibt es noch Möglichkeiten die Signalisierung auch beim Beenden des Movie- bzw. Audioplayers auszuführen. Auch das Abschalten der Signalisierung während einer Aufnahme über die Dateien recording.start und recording.end ist möglich, was vor allem für die Benutzer eines Videorecorders oder DVD-Recorders am Scart-Eingang wichtig ist. Außerdem werden alle aktuellen Termine beim Verlassen des Tuxcal-Plugins optisch und/oder akustisch angezeigt.


Optische Signalisierung

Bei der optischen Signalisierung über Popup- oder Message-Fenster werden alle aktuellen Termine abhängig von den Einstellungen in der Datei tuxcal.list angezeigt. Passen die Termine nicht auf ein Fenster, so taucht rechts im Fenster ein Scrollbalken auf. Mit [Runter] bzw. [Hoch] kann dann das nächste bzw. vorherige Fenster anzeigen. [Home] bzw. [Ok] schließt dieses Fenster.
Bei der IR-Tastatur kann ebenfalls mit [Runter] bzw. [Hoch] auf die nächste bzw. vorherige Seite geblättert werden, [Pos1] schließt das Fenster.
Es wird empfohlen, in den Einstellungen für Neutrino beim Parameter VIDEO=3 einzustellen, da bei einem Popup die Anzeige zu schnell wieder verschwindet, bevor man sie lesen kann.

TuxCal16.png TuxCal17.png

Wird bei einem Termin die Uhrzeit mit eingetragen, so wird nur dieser Termin zur eingestellten Uhrzeit angezeigt. Man beachte die Bildschirmuhr und die Uhrzeit des Termins. Die Signalisierung erfolgt wirklich genau auf die Sekunde.

Tuxcal15.png


Akustische Signalisierung durch Sounddateien

Für die akustische Signalisierung können noch spezielle benutzerdefinierte 12/24/48KHz PCM WAV-Dateien nach /var/tuxbox/config/tuxcal/ kopiert werden.

- tuxcal_birthday.wav, für die akustische Benachrichtigung bei Geburtstagen.

- tuxcal_timer.wav, für die akustische Benachrichtigung bei Terminen, die genau auf die Minute signalisiert werden sollen. Dazu ist es notwendig, eine Uhrzeit einzutragen.

- tuxcal_event.wav, für die akustische Benachrichtigung bei den restlichen Ereignissen.


Fertige Sounddateien können im Jack the Grabber-Forum heruntergeladen werden.

Sounddateien verlinken um Platz zu sparen

Da die Sounddateien relativ groß sind und der Speicherplatz auf der Box begrenzt ist, kann man auch nur eine Sounddatei auf der Box anlegen. Um trotzdem bei allen Ereignissen akustisch informiert zu werden, hat man die Möglichkeit, nur eine Datei z.B. tuxcal_event.wav nach /var/tuxbox/config/tuxcal/ auf der Box zu speichern. Die anderen Dateien werden mit folgenden Befehlen verlinkt. Dazu per Telnet auf die Box einloggen.

Per Telnet kann man sich unter Windows auf der DBox2 einloggen mit [Start] [Ausführen], dann eingeben telnet <DBOXIP> wobei <DBOXIP> durch die IP-Adresse der DBox2 zu ersetzen ist, z.B.:

telnet 192.168.0.23

Dann sollte ein Fenster auftauchen, in dem login drinsteht. Bei

login: root
Password: dbox2

eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann diese beiden Befehle ausführen:

ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_timer.wav
ln -s /var/tuxbox/config/tuxcal/tuxcal_event.wav /var/tuxbox/config/tuxcal/tuxcal_birthday.wav

Dadurch wurden für die Dateien tuxcal_timer.wav und tuxcal_birthday.wav sogenannte Symlinks auf die Datei tuxcal_event.wav erstellt. Die 2 verlinkten Dateien tuxcal_timer.wav und tuxcal_birthday.wav existieren zwar nicht, aber bei ihrem Aufruf wird jetzt die Datei tuxcal_event.wav abgespielt.

Für zukünftige Versionen ist jedoch geplant, die Sounddateien zu packen, und beim Aufruf nach /tmp/ zu entpacken und sie dann abzuspielen.


Erstellung der Sounddateien

Die DBox2 spielt nur Sounddateien in einem speziellen Format ab. Die PCM WAV-Dateien solltet ihr mit dem Audiorecorder unter Windows in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz umwandeln. Stereo geht auch, die Dateien werden dann aber entsprechend größer. Ich empfehle deswegen 8 Bit Mono, 12 KHz.


Scripte um Tuxcal bei bestimmten Vorgängen auf der Box zu steuern

Das TuxCal-Plugin lässt sich über verschiedene Scripte auf der DBox2 steuern. Nachfolgend sind einige Beispiel aufgeführt. Alle Scripte müssen im UNIX-Format erstellt werden und benötigen Ausführrechte (755).


Scriptbeispiel um tuxcald über das Startscript der Box automatisch zu starten

Ohne einen aktiven Daemon tuxcald finden keine Abfragen statt und die Bildschirmuhr wird auch nicht angezeigt. Der Autostart muss vom Nutzer also erst einmal aktiviert werden, da er standardmäßig deaktiviert ist. Bei jedem Start der DBox2 bzw. GUI wird er danach automatisch gestartet. Der folgende Code muss entweder in die start_neutrino oder in die rc.S bzw. rcS.local eingetragen werden. Bei Enigma kommt dieser Code in die start_enigma.

Normalerweise sollte jedoch die folgende Startsequenz mittlerweile in jedem aktuellen Image so eingetragen sein:

if [ -e /var/etc/.tuxcald ]; then
   if [ -e /var/bin/tuxcald ]; then
	/var/bin/tuxcald &
   else 
	/bin/tuxcald &
   fi
fi

Bitte beachten, dass die Eintragung unbedingt mit einem UNIX-Editor (vi, Ultraedit, Crimson-Editor) gemacht werden muss, und dass die Datei auch im UNIX-Format abgespeichert wird. Sonst startet die DBox2 nicht mehr. Falls das doch einmal passiert, besteht jedoch kein Grund zur Panik. Man kann nämlich immer noch per FTP oder Telnet auf die DBox2 zugreifen. Per FTP einfach die betreffende Datei nochmal von der DBox2 herunterladen und im UNIX-Format abspeichern. Dann wieder auf die DBox2 laden und diese neu starten. Per Telnet kann man sich unter Windows auf der DBox2 einloggen mit [Start] [Ausführen], dann eingeben telnet <DBOXIP> wobei <DBOXIP> durch die IP-Adresse der DBox2 zu ersetzen ist, z.B.:

telnet 192.168.0.23

Dann sollte ein Fenster auftauchen, in dem login drinsteht. Bei

login: root
Password: dbox2

eingeben. Die Passworteingabe wird nicht angezeigt, ist also blind einzugeben. Bei YADI-Images ist standardmäßig kein Passwort vergeben.

Dann folgende Befehle eingeben (dies bezieht sich jetzt auf eine fehlerhafte start_neutrino, die in /var/tuxbox/ liegt wie beim Jack-the-Grabber-Image. Andere Speicherorte und Dateien im Pfad anpassen):

dos2unix /var/tuxbox/start_neutrino
chmod 755 /var/tuxbox/start_neutrino
reboot

Mit diesem Befehl wird die Datei vom DOS- ins UNIX-Format umgewandelt und Ihr werden Ausführechte vergeben, womit die DBox2 auch wieder klarkommt. Dann wird die DBox2 neu gestartet.


Signalisierung nach Start aus dem Standby

Um die Abfrage gleich nach dem Aufwachen aus dem Standby zu aktivieren, kann unter Enigma das Script /var/etc/enigma_leave_standby.sh sowie unter Neutrino das Script /var/tuxbox/config/standby.off mit dem Inhalt

if [ -e /tmp/tuxcald.pid ]; then kill -hup $(cat /tmp/tuxcald.pid); fi

angelegt werden.


Signalisierung während Movieplayer und Audioplayer deaktivieren

Um beim Abspielen von Filmen im Movieplayer oder MP3s im Audioplayer nicht gestört zu werden, besteht die Möglichkeit den Daemon während der Wiedergabe vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von tuxcald erfolgt über die Scripte /var/tuxbox/config/movieplayer.start bzw. /var/tuxbox/config/audioplayer.start. Dort muss folgender Code eingefügt werden:

if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi

Um den Daemon tuxcald nach dem Beenden von Movie- bzw. Audioplayer wieder zu reaktivieren, ist in den Scripten /var/tuxbox/config/movieplayer.end bzw. /var/tuxbox/config/audioplayer.end folgender Code einzufügen:

if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi

Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden von Movie- bzw. Audioplayer angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.


Signalisierung während Aufnahme deaktivieren

Um beim Aufnehmen von Filmen nicht gestört zu werden, besteht die Möglichkeit den Daemon während der Aufnahme vorübergehend abzuschalten, und nach dem Beenden automatisch wieder zu aktivieren. Das Ausschalten von tuxcald erfolgt über das Script /var/tuxbox/config/recording.start. Dort muss folgender Code eingefügt werden:

if [ -e /tmp/tuxcald.pid ]; then kill -usr2 $(cat /tmp/tuxcald.pid); fi

Um den Daemon tuxcald nach dem Beenden der Aufnahme wieder zu reaktivieren, ist im Script /var/tuxbox/config/recording.end folgender Code einzufügen:

if [ -e /tmp/tuxcald.pid ]; then kill -usr1 $(cat /tmp/tuxcald.pid); fi

Bitte beachten, dass dabei auch Termine, die uhrzeitgesteuert angezeigt werden sollen, erst nach dem Beenden der Aufnahme angezeigt werden. Somit besteht das Risiko, einen wichtigen Termin zu verpassen.


Bedienung

Zum Starten des Plugins [BLAU] drücken und dann den Eintrag "Kalender" wählen.

Das Plugin zeigt nun den Kalender an.

Tuxcal01.png


Das Plugin kann sowohl mit der Fernbedienung, als auch mit der IR-Tastatur bedient werden.

Die Zeile kann mit [HOCH] und [RUNTER] gewechselt werden, die Spalte [RECHTS] und [LINKS]. Mit [+] [-] bzw. [Bild Hoch] [Bild runter] kann der nächste bzw. vorhergehende Monat angezeigt werden. [0] springt auf das aktuelle Datum.

Durch Druck auf [OK] bzw. [Enter] werden die Einträge des aktuellen Tages angezeigt. Man kann hier ebenfalls mit den vorher beschriebenen Tasten navigieren.

TuxCal02.png

Durch Betätigen von [Gelb] bzw. [F3] kann man einen neuen Termin einfügen, nach Bestätigung mit [OK] bzw. [Enter] wird dieser eingefügt, [Home] bzw. [Esc] oder [Pos1] verlässt das Fenster, ohne den Eintrag einzufügen. Wird ein Eintrag eingefügt, so springt der Cursor jetzt auf den eingefügten Termin unten im Fenster. Hier kann noch bei mehreren Einträgen mit [HOCH] und [RUNTER] der gewünschte Eintrag gewechselt werden.

TuxCal23.png

Durch Betätigen von [Rot] bzw. [F1] kann man Einträge nach einer Bestätigung durch [OK] oder [Enter] löschen, [Home] bzw. [Esc] oder [Pos1] verlässt das Fenster ohne den Eintrag zu löschen.

TuxCal24.png

Durch Betätigen von [Grün] bzw. [F2] gelangt man in den Markieren-Modus, wo bei mehreren Einträgen mit [HOCH] und [RUNTER] der gewünschte Eintrag gewechselt werden kann.

TuxCal03.png


Durch Betätigen von [Blau] bzw. [F4] gelangt man in den Termin-Editor.


Termin-Editor

Der Termin-Editor kann sowohl mit der Fernbedienung als auch mit der IR-Tastatur bedient werden. Mit [Rot] bzw. [F1] kann zwischen den verschiedenen Terminarten Einträge, Zeitraum, Feiertag und Geburtstag umgeschaltet werden.

Mit [Grün] bzw. [F2] wird die Jahreszahl ein- und ausgeblendet.

[Gelb] bzw. [F3] blendet die Uhrzeit ein und aus.

Durch Betätigen von [Blau] bzw. [F4] wird das Enddatum ein- oder ausgeblendet, was gleichzeitig dem Editieren von Zeiträumen entspricht.

Jetzt können die Einträge gemacht werden. Die Belegung der Tasten für die Fernbedienung werden links unten im Fenster angezeigt. Mit [+] und [-] kann eine einzelne Ziffer oder ein Buchstabe solange durchgescrollt werden, bis er dem gewünschten Ergebnis entspricht.

Mit [HOCH], [RUNTER], [RECHTS] und [LINKS] kann man in den Eingabefenstern die Positionen wechseln.

Mit [OK] bzw. [Enter] wird die Eingabe abgeschlossen. Nochmaliges Betätigen der Tasten [OK] bzw. [Enter] speichert den Eintrag ab, wird hier [Home] bzw. [Esc] oder [Pos1] gedrückt, bleibt man im Termin-Editor.

TuxCal19.png

Will man den Termin-Editor verlassen, ohne den Termin abzuspeichern, ist zuerst [Home] bzw. [Esc] oder [Pos1] zu betätigen. Dann im folgenden Fenster [OK] bzw. [Enter] drücken, um den Termin-Editor zu verlassen, mit [Home] bzw. [Esc] oder [Pos1] bleibt man im Termin-Editor.

TuxCal20.png

Bitte beachten, dass die Uhrzeit nur bei den Terminarten Eintrag und Zeitraum wirksam ist. Nur in diesen Terminarten wird man also zeitgenau informiert. Bei Geburtstagen wird bei Eingabe einer Jahreszahl das Alter im Fenster angezeigt. Termine, die verjährt sind, werden nicht signalisiert, jedoch werden Termine ohne Angabe einer Jahreszahl jährlich zum eingetragenen Datum signalisiert.

TuxCal04.png TuxCal13.png TuxCal12.png TuxCal14.png


Versionsnummern anzeigen

Zur Fehlereingrenzung ist die genutzte Version von Daemon und Plugin wichtig. Diese kann durch Drücken von [?] bzw. [Pause] ermittelt werden.

TuxCal05.png


Autostart festlegen

Über das Plugin kann auch der Start des Daemon kontrolliert werden. Ein Druck auf [STANDBY] aktiviert den Autostart, ein weiterer deaktiviert diesen wieder, bei der IR-Tastatur liegt diese Funktion auf der [linken runden schwarzen Taste], links neben [Esc].

TuxCal06.png TuxCal07.png

Vom Plugin wird dabei unter /var/etc/ die Datei .tuxcald angelegt oder gelöscht. Eine vorhandene .tuxcald bedeutet, dass der Autostart aktiviert ist. Allerdings muss dies vom Initscript der DBox2 oder dem Startscript der jeweiligen GUI (start_enigma, start_neutrino, start_lcars) ausgewertet werden.


Uhrzeitanzeige ein- oder ausblenden

Mit [Dbox] bzw. [Num] wird die Bildschirmuhr ein- oder ausgeschaltet. Dies kann auch über das Script Bildschirmuhr steuern gemacht werden.

TuxCal18.png


Abfrage steuern

Normalerweise wird der Daemon beim Start der DBox2 automatisch gestartet und überwacht die Termine. Die Abfrage kann auch mit [MUTE] gesteuert werden, z.B. wenn man eine Sendung ungestört ansehen oder eine manuelle Prüfung auslösen möchte. Ein Druck schaltet die Abfrage aus, ein weiterer wieder ein. Dabei wird auch die Bildschirmuhr aus- bzw. eingeschaltet. Die Einträge werden beim Verlassen des Plugins sofort geprüft und alle aktuellen Termine bei aktiviertem Daemon optisch und akustisch signalisiert.

TuxCal08.png TuxCal09.png


Plugin verlassen

Das Plugin kann mittels [Home] bzw. [Esc] oder [Pos1] beendet werden. Die Einträge in der tuxcal.list werden beim Verlassen des Plugins bei aktivem Daemon tuxcald sofort geprüft und alle aktuellen Termine optisch und akustisch signalisiert.


Kommandozeile

Der Daemon tuxcald kann auch von der Kommandozeile aus gestartet bzw. kontrolliert werden. Folgende Startparameter sind derzeit möglich:

  • -nodelay : die Einträge in tuxcal.list werden sofort nach dem Start abgefragt und das festgelegte STARTDELAY übergangen.
  • -syslog : die Informationen werden nicht auf die Konsole ausgegeben, sondern an einen Syslog-Server gesendet.
  • -play <audio-Datei> : die angegebene Audio-Datei wird gespielt, der Daemon wird nicht gestartet.
  • -v : die Versionsnummer von tuxcald wird angezeigt. Der Daemon wird nicht gestartet.

Um alle Ausgaben des Daemons auf seinen PC umzuleiten, muss auf der DBox2 mittels

syslogd -R <IP-Adresse>

des PC das Logging aktiviert werden. Auf dem PC muss natürlich ein Syslog-Server installiert sein, welcher die Ausgaben entgegen nimmt. Zur lokalen Speicherung auf der DBox2 genügt ein syslogd ohne Parameter. Die Ausgaben werden so unter /var/log/messages gespeichert. Alternativ kann durch syslogd -O <Pfad der Logdatei> auch ein anderer Pfad eingestellt werden.

Sobald der Daemon läuft kann er über Signale an seine PID gesteuert werden. Die PID kann auf 2 Arten ermittelt werden:

  • verwenden des Befehls ps | grep tuxmcald oder pidof tuxcald und nutzen der kleinsten aufgelisteten PID
  • auslesen aus der Datei /tmp/tuxcald.pid z.B. mit cat /tmp/tuxcald.pid

Damit kann nun die Konfiguration aktualisiert, die Kontenabfrage gesteuert oder der Daemon sauber beendet werden.


Konfiguration aktualisieren

Falls zur Laufzeit die Konfiguration geändert wurde, kann der Daemon die neue Konfiguration einlesen, ohne hierfür extra beendet und neu gestartet zu werden:

kill -HUP <PID> bzw. kill -1 <PID>


Abfrage steuern

Die Abfrage kann ebenfalls unterbrochen und wieder gestartet werden, ohne den Daemon zu beenden.

kill -USR1 <PID> bzw. kill -10 <PID> startet die Abfrage,
kill -USR2 <PID> stoppt die Abfrage,


Daemon beenden

Ein sauberes Beenden erfolgt mit diesem Befehl:

kill -TERM <PID> bzw. kill -15 <PID> oder einfach mit kill <PID>


Scriptbeispiel zum Daemon beenden

kill -term $(cat /tmp/tuxcald.pid)


Scriptbeispiel um die Bildschirmuhr zu steuern

Die Bildschirmuhr kann über dieses Script abwechselnd ein- oder ausgeschaltet werden:

if [ -e /tmp/tuxcald.pid ]; then kill -ALRM $(cat /tmp/tuxcald.pid); fi

Eine andere Möglichkeit die Bildschirmuhr gezielt ein- oder auszublenden, geht über die Schalterdatei /tmp/tuxcal.clk.
Ist die Uhr eingeschaltet, so wird diese Datei angelegt. Will man die Uhr über ein Script ausschalten, so ist diese Datei mit dem Befehl

rm /tmp/tuxcal.clk

zu löschen. Legt man die Datei mit dem Befehl

touch /tmp/tuxcal.clk

an, so wird die Bildschirmuhr wieder eingeblendet.


Bildschirmuhr

Ist der Daemon tuxcald aktiviert, und die Konfigurationsdatei tuxcal.conf wurde entsprechend konfiguriert, wird an der definierten Stelle eine Digitaluhr auf dem Bildschirm eingeblendet. Wenn der Parameter MAIL=Y eingestellt ist, werden bei neu eingegangenen Mails im Email-Plugin, links von der Uhrzeit abwechselnd die Zahl der eingegangenen Mails und ein Briefsymbol angezeigt. Diese Anzeige bleibt solange aktiviert, bis man das Email-Plugin aufruft. Diese Information wird aus der Datei tuxmail.new in /tmp/ ausgelesen. Die Uhr kann über [Dbox] bzw. [Num] im TuxCal-Plugin, wahlweise ein- oder ausgeblendet werden. Außerdem kann die Bildschirmuhr, wenn man sie beim Starten der Box nicht angezeigt haben will, über den Parameter SHOW=N ausgeblendet werden. Man kann sie dann trotzdem jederzeit im Plugin mit [Dbox] bzw. [Num] ein- und wieder ausschalten.

TuxCal10.png TuxCal11.png


Links

Bitte beachten, dass dieses Wiki für die neueste Version von TuxCal gilt. Aktuell ist am (03.08.2008) Version Plugin 1.08 / Daemon 1.12.

Download TuxCal-Plugin: Jedoch nur eine alte Version, da das Plugin im CVS ist, und eigentlich in jedem aktuellen Image eingebaut sein sollte
Download Sounddateien:
Diskussion und Fragen:

Bitte beachten, dass man sich im Jack-the-Grabber-Forum registrieren und einloggen muss, um die Downloadlinks zu sehen.

Registrierung im JTG-Board