Änderungen

ShellScript:FritzBox

14.829 Byte hinzugefügt, 22:40, 16. Apr. 2015

/* Befehlsübersicht */

==Voraussetzungen==~~[http://homematic-inside.de/software/cuxdaemon CUxD] muß installiert und sollte auf aktuellem Stand sein.~~

'''[http://homematic-inside.de/software/cuxdaemon CUxD]''' muß installiert und sollte auf aktuellem Stand sein. Wegen geändertem Loginverfahren muß auf der FritzBox mindestens die Version '''Fritz!OS 5.50 ''' installiert sein. == Beschreibung ==

~~==Beschreibung==~~

Das Programm dient zur Steuerung der FritzBox und dazu, diverse Informationen von dieser zu holen.

Ein kleiner Auszug hiervon: *WLAN ein/ausschalten und visualisieren*Telefonbuch auslesen*Anrufe tätigen*Dect200 Schalter ein/ausschalten und visualisieren*Temperatur und Entergiemessung der Dect200 auslesen*Onlinestatus von Geräten auslesen Das Auslesen aus der FritzBox und setzten der Stati in der CCU übernimmt der mit CUxD mitgelieferte CURL-Befehl. ==~~Installation~~= Visualisierung in der CCU ===*Die Visualisierung der Stati in der CCU kann klassisch über '''SystemVariable''' oder auch direkt mit CUxD erfolgen, welche den Vorteil birgt, daß vor allem ein/ausschaltbare Geräte nicht nur über eine Schaltfläche bedient werden können, sondern auch den korrekten Status anzeigen, falls eine Schaltung direkt über die FritzBox erfolgt ist. Dies wird mit einem '''CUxD (28)System.Exec (Schalter)''' verwirklicht. Weitere Alternativen zur SystemVariable die CUxD zur Verfügung stellt und genutzt werden können sind das '''(90)State-Monitor Device, '''das'''(90)Transform Device '''und das '''(90)Thermostat Device'''. === Scriptaufruf === Um eine korrekte Visualisierung zu erhalten oder eine Schaltung tätigen zu können, muß natürlich das Script aufgerufen werden. Dies erfolgt entweder durch ein '''Script in einem Programm der WebUI''', durch ein '''CUxD (28)System.Exec '''oder einem '''CUxD (28)System.Timer'''. == Installation == zur Konfiguration stehen 3 Varianten zur Auswahl (Dateien mit einem Texteditor bearbeiten): *FritzBox.sh ~~und~~ -> es muß nur diese Datei hochgeladen werden*FritzBox.cfg ~~herunterladen~~-> bei einem Update der FritzBox.sh muß nicht neu konfiguriert werden*~~die Datei~~ direkt beim Aufruf (''sh FritzBox.~~cfg konfigurieren~~sh '''x [IP] [Username|-] [Passwd]''' ...'') -> andere Konfigurationen werden ignoriert, die Verwendung von mehreren Boxen ist möglich Hochladen auf die CCU: *~~beide Dateien~~ mit FTP zu folgenden Pfad kopieren: ''/usr/local/addons/cuxd/user/''

*Rechte von beiden auf 755 setzen

erster Aufruf: *mit ~~Putty~~ [[Telnet]] in den Ordner wechseln, in dem sich das Script sich befindet: ''cd /usr/local/addons/cuxd/user/''*einen beliebigen Befehl aufrufen**''sh FritzBox.sh WLAN 0'' (oder ''sh /usr/local/addons/cuxd/user/ FritzBox.sh WLAN 0'' ohne Wechsel in den Ordner)**''sh FritzBox.sh WLAN 1'' ~~(oder~~ **''sh FritzBox.sh WLAN state'' Nun sieht man, ob das Script Zugriff auf die Fritzbox hat. Gleichzeitig wird auch für CCU1 Besitzer die Datei CPWMD5 im Verzeichnis /usr/local/addons/cuxd/user/ installiert, da diese hier noch nötig ist. Die CCU2 kommt ohne sie aus. Ruft man das Script mit dem Parameter "h" auf, bekommt man eine Übersicht der Befehle: ''sh FritzBox.sh h'' der Debug-Modus kann deaktiviert werden: *FritzBox.sh in einem Texteditor öffenen*Debug="1" nach Debug="0" ändern*FritzBox.sh hochladen == Befehlsübersicht == *'''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh FB-AHA [AIN|MAC] [state CUX9001xxx:x]''' Status an CUxD (90)State-Monitor Device*'''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state1 CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter)) und SysVar [CUX2801xxx:x-Status] -> Werteliste: nicht erreichbar;erreichbar;unbekannt*'''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state1-p CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter)) und SysVar: [CUX2801xxx:x-Status] [CUX2801xxx:x-Leistung] -> Zahl*'''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state1-t CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter)) und SysVar: [CUX2801xxx:x-Status] [CUX2801xxx:x-Temperatur] -> Zahl*'''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state1-pt CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter)) und SysVar: [CUX2801xxx:x-Status] [CUX2801xxx:x-Leistung] [CUX2801xxx:x-Temperatur]*'''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state1-pts CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter)) und SysVar: [CUX2801xxx:x-Status] [CUX2801xxx:x-Leistung] [CUX2801xxx:x-Temperatur] [CUX2801xxx:x-Schaltzustand]*'''sh FritzBox.sh FB-AHA [AIN|MAC] [power CUX2801xxx:x]''' Status an SysVar [CUX2801xxx:x-Leistung] -> Zahl*'''sh FritzBox.sh FB-AHA [AIN|MAC] [power1 CUX9000xxx:x]''' Status an CUxD (90)Transform Device*'''sh FritzBox.sh FB-AHA [AIN|MAC] [temperature CUX2801xxx:x]''' Status an SysVar [CUX2801xxx:x-Temperatur] -> Zahl*'''sh FritzBox.sh FB-AHA [AIN|MAC] [temperature1 CUX9000xxx:x]''' Status an CUxD (90)Transform Device*'''sh FritzBox.sh FB-AHA [AIN|MAC] [temperature2 CUX9002xxx:x]''' Status an CUxD (90)Thermostat Device*'''sh FritzBox.sh FON-alarm [610|611|...] [1|2|3] [0|1|...] [Text]''' Beispiel: ''sh FritzBox.sh FON-alarm 610 1 8 Hallo%20Welt''*'''sh FritzBox.sh FON-RingTone [610|611|...] [0|1|...]''' Beispiel: ''shFritzBox.sh FON-RingTone 610 16''*'''sh FritzBox.sh FON-Name [610|611|...] [Name]''' Beispiel: ''sh FritzBox.sh FON-Name 610 Name''*'''sh FritzBox.sh WLAN [0|1|state CUX2801xxx:x]'' ~~ohne Wechsel~~ ' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh WLAN5 [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh WLANGast [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh WLANNacht [0|1]'''*'''sh FritzBox.sh WLANAnwesend [Name des WLAN Geraetes] [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh WLANAnwesend Geraet CCUVariable''*'''sh FritzBox.sh WLANOnline [Name des WLAN Geraetes] [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh WLANOnline Geraet CCUVariable''*'''sh FritzBox.sh LANAnwesend [Name des LAN Geraetes] [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh LANAnwesend Geraet CCUVariable''*'''sh FritzBox.sh LANOnline [Name des LAN Geraetes] [Name der logischen Variable (Bool)in der CCU]''' Beispiel:''sh FritzBox.sh LANOnline Geraet CCUVariable''*'''sh FritzBox.sh WakeOnLan [Name des LAN Geraetes]''' Beispiel: ''sh FritzBox.sh WakeOnLan Geraetename''*'''sh FritzBox.sh DECT [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh UMTS [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh CallThrough [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*'''sh FritzBox.sh NACHTRUHE [0|1]'''*'''sh FritzBox.sh KLINGELSPERRE [0|1]'''*'''sh FritzBox.sh ANRUFEN [(Telefonnummer z.B. **610)]'''*'''sh FritzBox.sh RUFUMLEITUNG [0|1|2|3(Rufumleistung)] [0|1]'''*'''sh FritzBox.sh Diversity [0|1|2|3(Rufumleistung)] [0|1]'''*'''sh FritzBox.sh DECT200 [16|17|18|19] [0|1]'''*'''sh FritzBox.sh DECT200Energie [Nummer des Aktors:16|17|18|19] [Name der Variable in der CCU]''' Beispiel: ''sh FritzBox.sh DECT200Energie 16 DECT200''*'''sh FritzBox.sh AB [0|1|2...-9] [0|1|state CUX2801xxx:x]''' aus/ein, Status an das sendende Gerät (CUxD (28)System.Exec (Schalter))*Beispiel schaltet den ~~Ordner~~2. AB ein: ''sh FritzBox.sh AB 1 1''*'''sh FritzBox.sh Status-AB [1|2...-10] [Name der logischen Variable (Bool)in der CCU]''' Beispiel Status 2. AB:''sh FritzBox.sh Status-AB 2 CCUVariableAB2''*'''sh FritzBox.sh Anrufliste'''*'''sh FritzBox.sh Anrufliste2CCU [0000(HOMEMATIC Webmatic SYSVAR ID)] [Anzahl Eintraege]'''*'''sh FritzBox.sh Status-Rufumleitung [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-Rufumleitung RufumleitungVariableCCU''*'''sh FritzBox.sh Status-DECT [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-DECT DECTanausVariableCCU''*'''sh FritzBox.sh Status-UMTS [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-UMTS UMTSanausVariableCCU''*'''sh FritzBox.sh Status-DECT200 [16|17|18|19] [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-DECT200 16 DECT16VariableCCU''*'''sh FritzBox.sh Status-IP [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh SStatus-IP ExterneIPVariableCCU''*'''sh FritzBox.sh Status-KLINGELSPERRE [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-KLINGELSPERRE KLINGELSPERREVariableCCU''*'''sh FritzBox.sh Status-Verbindung [Name der logischen Variable (Bool)in der CCU] ''' Beispiel: ''sh FritzBox.sh Status-Verbindung InternetverbundenVariableCCU''*'''sh FritzBox.sh Status-Verbindungszeit [Name der logischen Variable (Zeichenkette)in der CCU] ''' Beispiel:''sh FritzBox.sh Status-Verbindungszeit InternetVerbindungszeitVariableCCU''*'''sh FritzBox.sh Status-WLAN [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-WLAN WLANanausVariableCCU''*'''sh FritzBox.sh Status-WLAN5 [Name der logischen Variable (Bool)in der CCU] ''' Beispiel:''sh FritzBox.sh Status-WLAN5 WLAN5anausVariableCCU''*'''sh FritzBox.sh Status-WLANGast [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-WLANGast WLANGastanausVariableCCU''*'''sh FritzBox.sh Status-WLANZeitschaltung [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-WLANZeitschaltung WLANZeitschaltungVariableCCU''*'''sh FritzBox.sh Weckruf [0|1|2] [0|1]''' Beispiel - schaltet den ersten Weckruf ein: ''sh FritzBox.sh Weckruf 0 1''*'''sh FritzBox.sh Status-Weckruf [0|1|2] [Name der logischen Variable (Bool)in der CCU]''' Beispiel: ''sh FritzBox.sh Status-Weckruf 0 CCUvarWeckruf1''*'''sh FritzBox.sh reboot''' == Integration == === CUxD - (28)System.Exec ===Dieses Gerät ruft das Shellscript auf. Installation und Beschreibung des Gerätes ist aus der CUxD-Doku zu entnehmen. ==== ein-/ausschalten mit Statusanzeige ==== (28)System.Exec wird hier als Schalter verwendet (ein/aus). Geräteparameter einstellen: PARAM1 [sh /usr/local/addons/cuxd/user/FritzBox.sh] -> ruft das Script auf PARAM2 [x 192.168.125.1 CCU HomeMatic] -> der Login [[File:FritzBox geraete-parameter.jpg|RTENOTITLE]] Scriptaufruf und Login via Parameter: SWITCH|CMD_SHORT [$_P1$ $_P2$ WLAN 0] -> ausschalten SWITCH|CMD_LONG [$_P1$ $_P2$ WLAN 1] -> einschalten SWITCH|CMD_TIMER [$_P1$ $_P2$ WLAN state $CHANNEL$] -> Status-Abfrage für diesen Kanal [[File:FritzBox wlan.jpg|RTENOTITLE]] Scriptaufruf via Parameter, Login über die Config im Script: SWITCH|CMD_SHORT [$_P1$ WLAN5 0]-> ausschalten SWITCH|CMD_LONG [$_P1$ WLAN5 1] -> einschalten SWITCH|CMD_TIMER [$_P1$ WLAN5 state $CHANNEL$] -> Status-Abfrage für diesen Kanal [[File:FritzBox wlan5.jpg|RTENOTITLE]] Hier wurde auch der Parameter $CHANNEL$ verwendet - dieser ersetzt SN:Kanal des Gerätes, von dem er aufgerufen wird. Verwendung eines Kanalparamters mit einem DECT200.Eintrag in den Geräteparametern: PARAM1 [sh /usr/local/addons/cuxd/user] SWITCH|CMD_SHORT [$_P1$/FritzBox.sh FB-AHA $_C1$ 0]-> ausschalten SWITCH|CMD_LONG [$_P1$/FritzBox.sh FB-AHA $_C1$ 1] -> einschalten SWITCH|CMD_TIMER [$_P1$/FritzBox.sh FB-AHA $_C1$ state1 $CHANNEL$] -> Status-Abfrage für diesen Kanal [[File:FritzBox dect200.jpg|RTENOTITLE]] Mit Hilfe von Kanalparametern können für mehrere DECT200 die Befehle immer gleich bleiben. Es ist nur die AIN-Nummer einzutragen. ==== ein-/ausschalten mit Statusanzeige und SystemVariablen ==== Funktion und Aufruf ist hier gleich wie bei "ein-/ausschalten mit Statusanzeige". Zusätzlich werden hier aber SystemVariablen benötigt, die von einem erweiterten "state"-Befehl befüllt werden. Je nach Befehl werden unterschiedliche SysVars benötigt. [[File:FritzBox exec.jpg|RTENOTITLE]] Befehl für dieses Beispiel: ''sh FritzBox.sh FB-AHA [AIN|MAC] [0|1|state1-pt CUX2801234:6]'' In "SWITCH|CMD_TIMER" ist also "state1-pt" anstelle von "state" einzutragen, da dieser Befehl die 3 SysVars befüllen kann. Die hier verwendete SN:Kanal ist jene, vom aufrufenden (28)System.Exec-Gerät. SystemVariablen sind in dieser Form anzulegen, damit eine die Zuordnung erfolgten kann. Die SystemVariablen wurden beim Erstellen dem entsprechenden (28)System.Exec-Gerät zugeordnet und dient nur einer schöneren Visualisierung.

~~Nun sieht man, ob das Script Zugriff auf die Fritzbox hat.Gleichzeitig wird auch für CCU1 Besitzer die Datei CPWMD5 im Verzeichnis~~ Namen und eigenschaften der Systemvariablen:</~~usr~~u><br/~~local~~>[CUX2801xxx:x-Status] -> Werteliste: nicht erreichbar;erreichbar;unbekannt<br/~~addons~~>[CUX2801xxx:x-Leistung] -> Zahl<br/~~cuxd~~>[CUX2801xxx:x-Temperatur] -> Zahl</~~user/ installiert, da diese hier noch nötig ist. Die CCU2 kommt ohne sie aus.~~span>

Dragonfly

95

Bearbeitungen

Änderungen

ShellScript:FritzBox

Navigationsmenü

Meine Werkzeuge

Namensräume

Varianten

Ansichten

Mehr

Suche

Navigation

Werkzeuge