FRITZBOX: Unterschied zwischen den Versionen

FRITZBOX
Zweck / Funktion
	Steuerung einer Fritz!Box über Fhem
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Sonstiges
Modulname	72_FRITZBOX.pm
Ersteller	tupol/Topos (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Version vom 26. Januar 2015, 08:55 Uhr

Das Modul FRITZBOX ermöglicht die Steuerung einer AVM Fritz!Box durch Fhem. Dabei kann es sich dabei sowohl um eine FritzBox handeln, auf der Fhem selbst läuft (lokaler Modus), als auch um eine entfernte (externe) FritzBox.

Voraussetzungen

Um das Modul für den Zugriff auf eine externe FritzBox benutzen zu können, muss

Telnet auf der entsprechenden FritzBox erlaubt/freigeschaltet sein (üblicherweise durch Eingabe von #96*7* an einem direkt an der entsprechenden FritzBox angeschlosssenen Telefon)
Auf dem System, auf dem Fhem läuft (Server) muss Telnet installiert sein; auf einem Raspberry Pi z. B. mit dem Befehl

sudo apt-get install libnet-telnet-perl

Installation

Erste Schritte

Zur Erstinstallation reicht ein einfaches define FritzBox FRITZBOX, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff(FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).

Modul FRITZBOX für Zugriff auf einem externen Server einrichten

Anlegen des Attributs telnetUser

Bei Fernzugriff sind weitere Schritte nötig:

Telnet auf der Fritzbox freischalten (Tastenkombination #96*7* am angeschlossenen Telefon (auch FritzFon)
TelnetUser definieren (wie im Screenshot gezeigt)
Passwort zum Benutzer auf der Fritzbox definieren

Passwort definieren

(bitte die Buttons set und attr bei der Definition der jeweiligen Einträge nicht vergessen)

...für die Profis

(die Telnet auf ihrer FritzBox vermutlich ohnehin längst aktiviert haben)

hier die Befehle für das Befehl-Eingabefeld:

define FritzBox FRITZBOX

attr Fritzbox telnetUser Benutzername - legt den Benutzer fest

set Fritzbox password Passwort - legt das zugehörige Passwort fest

mögliche Fehlermeldungen

Sollte schon bei define FritzBox FRITZBOX die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte prüfen, ob Fhem auf dem aktuellen Stand ist und ggf. aktualisieren.

Kommt jetzt bei der erneuten Definition die Fehlermeldung Error: Perl modul Net::Telnet is missing on this system bitte wie oben schon erwähnt den Befehl

sudo apt-get install libnet-telnet-perl

direkt per Telnet/SSH auf dem FHEM-Server ausführen und neu starten. Sollte alles geklappt haben, seht ihr nun eure Fritzbox und könnt diverse Einstellungen manuell vornehmen und/oder automatisch vornehmen lassen.

Anwendung

Define

Siehe commandref

Attribute

Siehe commandref

Anwendungsbeispiele

FRITZBOX Gerät auf der Fhem Oberfläche

Sollte alles geklappt haben sehr ihr nun unter "Unsortiert" den im nebenstehenden Screenshot gezeigten Eintrag für das "Gerät" (hier mit dem Icon "it_router").

Links

Forenthread zu diesem Modul

@@ Zeile 9: / Zeile 9: @@
 == Voraussetzungen ==
-{{Randnotiz|RNTyp=y|RNText=Dieser Artikel muss noch erweitert werden; dazu ist jeder eingeladen, ich habe den Artikel nicht für mich "reserviert" --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 14:03, 29. Dez. 2014 (UTC)}}
 Um das Modul für den Zugriff auf eine externe FritzBox benutzen zu können, muss
 # Telnet auf der entsprechenden FritzBox erlaubt/freigeschaltet sein (üblicherweise durch Eingabe von #96*7* an einem direkt an der entsprechenden FritzBox angeschlosssenen Telefon)
@@ Zeile 16: / Zeile 15: @@
 == Installation ==
---[[Benutzer:Dangermouse|Dangermouse]] ([[Benutzer Diskussion:Dangermouse|Diskussion]]) 14:14, 25. Jan. 2015 (UTC)
 === Erste Schritte ===
 Zur Erstinstallation reicht ein einfaches <code>define FritzBox FRITZBOX</code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff(FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).
-[[Datei:Screenshot_FritzBox1.png]]
 ==== Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
+[[Datei:Screenshot_FritzBox_TelnetUser.png|mini|300px|rechts|Anlegen des Attributs telnetUser]]
 Bei Fernzugriff sind weitere Schritte nötig:
+# Telnet auf der Fritzbox freischalten (Tastenkombination #96*7* am angeschlossenen Telefon (auch FritzFon)
+# TelnetUser definieren (wie im Screenshot gezeigt)
+# Passwort zum Benutzer auf der Fritzbox definieren
-. Telnet auf der Fritzbox freischalten (Tastenkombination #96*7* am angeschlossenen Telefon (auch FritzFon),siehe [http://fhem.de/commandref_DE.html#FRITZBOX commandref])
+[[Datei:Screenshot_FritzBox_Passwort.png|mini|300px|rechts|Passwort definieren]]
+(bitte die Buttons {{Taste|set}} und {{Taste|attr}} bei der Definition der jeweiligen Einträge nicht vergessen)
-. TelnetUser definieren
-[[Datei:Screenshot_FritzBox_TelnetUser.png]]
-. Passwort zum Benutzer auf der Fritzbox definieren
-[[Datei:Screenshot_FritzBox_Passwort.png]]
-(bitte die Buttons <code> set </code> u. <code> attr </code> bei jedem Eintrag nicht vergessen ;)
 ==== ...für die Profis ====
+(die Telnet auf ihrer FritzBox vermutlich ohnehin längst aktiviert haben)
-(,die sicher eh Telnet auf ihrer FritzBox längst aktiviert haben ;) )
+hier die Befehle für das [[Konfiguration|Befehl-Eingabefeld]]:
-hier die manuelle Eingabe:
-<code>define FritzBox FRITZBOX</code>
-<code>attr Fritzbox telnetUser ''Benutzername'' </code> - legt den Benutzer fest
-<code>set Fritzbox password ''Passwort'' </code> - legt das zugehörige Passwort fest
+:<code>define FritzBox FRITZBOX</code>
+:<code>attr Fritzbox telnetUser ''Benutzername'' </code> - legt den Benutzer fest
+:<code>set Fritzbox password ''Passwort'' </code> - legt das zugehörige Passwort fest
 === mögliche Fehlermeldungen ===
+Sollte schon bei <code>define FritzBox FRITZBOX</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte prüfen, ob Fhem auf dem aktuellen Stand ist und ggf. [[Update|aktualisieren]].
-Sollte schon bei <code>define FritzBox FRITZBOX</code> die Fehlermeldung kommen, daß dieses Modul nicht existiert bitte ein <code>update force</code> ausführen, <code>shutdown restart</code> nicht vergessen. ;)
+Kommt jetzt bei der erneuten Definition die Fehlermeldung <code>Error: Perl modul Net::Telnet is missing on this system</code> bitte wie oben schon erwähnt den Befehl
+:<code>sudo apt-get install libnet-telnet-perl</code>
-Kommt jetzt bei der erneuten Definition die Fehlermeldung <code>Error: Perl modul Net::Telnet is missing on this system</code> bitte wie oben schon erwähnt den Befehl <code>sudo apt-get install libnet-telnet-perl</code> direkt per Telnet/SSH auf dem FHEM-Server ausführen und neu starten.
+direkt per Telnet/SSH auf dem FHEM-Server ausführen und neu starten.
-Sollte alles geklappt haben seht ihr nun eure Fritzbox und könnt diverse Einstellungen manuell und/oder automatisch vornehmen lassen.
+Sollte alles geklappt haben, seht ihr nun eure Fritzbox und könnt diverse Einstellungen manuell vornehmen und/oder automatisch vornehmen lassen.
 == Anwendung ==
@@ Zeile 69: / Zeile 55: @@
 == Anwendungsbeispiele ==
-Sollte alles geklappt haben sehr ihr nun unter "Unsortiert" folgenden Eintrag:
+[[Datei:Screenshot_FritzBox1.png|mini|300px|rechts|FRITZBOX Gerät auf der Fhem Oberfläche]]
+Sollte alles geklappt haben sehr ihr nun unter "Unsortiert" den im nebenstehenden Screenshot gezeigten Eintrag für das "Gerät" (hier mit dem Icon "it_router").
-[[Datei:Screenshot_FritzBox1.png]]
-(hier mit dem Icon it_router)
 == Links ==