##-----------------------------------------------------------------------------
## cpanel.txt - fli4l configuration parameters               fli4l-2.0.x v3.6.2
##
## Creation:     23.06.2002  gk
## Last Update:  20.11.2005  gk
##
## Copyright (c) 2002-2005 Georg Kainzbauer <georgkainzbauer@gmx.net>
##
## 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.
##-----------------------------------------------------------------------------

Funktionsbeschreibung:
======================
Dieses Packet ermglicht das Abfragen von 4 Tasten am seriellen Port des fli4l-Routers.
Bei Tastendruck werden Systemkommandos wie z.B. halt oder reboot aufgerufen. Die Tasten 
knnen frei belegt werden. Dabei sind 14 Variationen mglich (theoretisch sind jedoch 15 
mglich, allerdings macht bei der 15ten die Hardware nicht mit). 

Die Power-LED leuchtet grn sobald die Schaltung einsatzbereit ist. Wird ein Befehl 
abgearbeitet, blinkt die LED. 
LED1 kann frei belegt werden (nheres erfahren Sie weiter unten).

Tastenbelgung:
==============
Die einzelnen Tastenbelegungen entsprechen der Stellenwertigkeit der Tasten.
Taste 1 = 1
Taste 2 = 2
Taste 3 = 4
Taste 4 = 8
Sollen mehrere Tasten gleichzeitig bettigt werden, so addiert man die Stellenwertigkeit 
der einzelnen Tasten. Daraus erhhlt man die Funktionsnummer fr den Befehl.

Die auszufhrenden Befehle werden in diese Zeilen eingetragen:
OPT_CPANEL_FUNKTION1='BEFEHL'
Dabei ist zu beachten, dass bei einigen Befehlen die komplette Pfadangabe zu dem Programm 
bzw.Skript angegeben werden muss.

Hierzu einige Beispiele:
fli4lctrl dial pppoe		Einwahl ber DSL
fli4lctrl hangup pppoe		Trennen der DSL-Verbindung 
isdnctrl dial ippp0		Einwahl ber ISDN
isdnctrl hangup ippp0		Trennen der ISDN-Verbindung
/sbin/reboot			Router neu starten
/sbin/halt			Router herrunterfahren

Statusanzeige programmieren:
============================
Es gibt vier Mglichkeiten die Status-LED zu belegen.
DSL:     Es wird nur der DSL-Verbindungsstatus abgefragt und angezeigt.
ISDN:    Es wird der ISDN-Verbindungsstatus abgefragt und angezeigt. Hierbei werden alle 
         Circuits zusammengefasst. D.h. sobald ein Circuit online ist, leuchtet LED1.
DSLISDN: Es wird der DSL- und der ISDN-Verbindungsstatus aller Circuits abgefragt 
         und ausgegeben.
SCRIPT:  Hier knnen Sie ihre eigene Abfrage erstellen. Es ist dabei folgendes zu beachten:
         - Es mssen nur die Befehle eingetragen werden. 
         - #!/bin/sh wird automatisch in das Script eingefgt.
         - Damit die LED1 gesetzt wird, muss "on" in die Datei /var/run/cpanel.status 
           geschrieben werden (natrlich ohne " ").
         - Um die LED wieder zu lschen, muss man "off" in die Datei /var/run/cpanel.status 
           schreiben.
         - Wird "blink" in die Datei /var/run/cpanel.status geschrieben, blinkt LED1 bis "off"
           oder "on" gesetzt ist.
         Beispiel: Dies ist der Eintrag um den DSL-Status abzufragen:
                   echo off > /var/run/cpanel.status
                   fli4lctrl status | grep online >/dev/null && echo on > /var/run/cpanel.status
         Hinweis: Es sollte nur dann was eingetragen werden, wenn man sicher ist was man 
                  tut. Da ein fehlerhafter Eintrag zufolge haben knnte das cpanel nicht 
                  startet bzw. nicht richtig funktioniert.

Fehlersuche:
============
Hardware:
Sollte es nicht auf anhieb funktionieren, berprfen Sie zuerst ihre Schaltung. 
Achten Sie dabei auf die richtige Pinbelegung am PC-Stecker. Sollte Ihr Router noch eine 
25 polige Schnittstelle haben, gilt die Pinbelegung im Schaltplan nicht!!! 
Wenn Sie die Schaltung berprft haben und keinen Fehler gefunden haben, berprfen Sie 
das Kabel vom Mainboard zum Gehuse. Da sich die Mainboardhersteller nicht auf einen 
Standart einigen, gibt es verschiedene Adapterkabel. berprfen Sie gegebenfalls die 
Pinbelegung des seriellen Steckers mit der Pinbelegung am Mainboardstecker 
(siehe Mainboard-Handbuch).

Software:
Zuerst sollten Sie berprfen ob die cpanel-Software beim Booten startet. Dies kann man 
daran erkennen das kurz vorm Ende des Bootvorgangs eine Meldung ausgegeben wird. Sollte 
dies nicht der Fall sein oder Sie haben es bersehen, kann der Status auch mit "ps ax" 
auf der Konsole berprft werden. Wenn cpanel nicht in der angezeigten Liste stehen, 
haben Sie vermutlich in der Datei config\cpanel.txt den Eintrag OPT_CPANEL='yes' auf "no" 
gestellt. 
Eine weitere Fehlerquelle knnte die Grafikkarte sein. Wenn Sie keine Grafikkarte in 
ihrem Router haben, wird der erste serielle Port (COM1) als Konsole verwedet. Dann muss 
in der Datei config\cpanel.txt der Eintrag CPANEL_PORT='/dev/ttyS0' auf "/dev/ttyS1" 
umgestellt werden. Natrlich muss die Schaltung dann auch bei COM2 angeteckt sein.

Sollte der Fehler trotzdem nicht behoben sein, bin ich unter der Mail-Adresse 
georgkainzbauer@gmx.net erreichbar. Bitte die Config-File anhngen.

Allgemeines:
============
Der Schaltplan fr die Schaltung ist in der Datei Schematic.jpg abgebildet.

!!! Ich bernehme keine Haftung fr evtl. Schden !!!

Probleme, Erfolgsberichte und Verbesserungsvorschlge bitte in mein Forum posten.
http://www.georgkainzbauer.de/forum/

Vielen Dank das Sie diese Dokumentation gelesen haben. Jetzt kann ich nur noch viel 
Spa mit cpanel wnschen.
