From df2d636977de31e6b10f8d182b751bd127c6af55 Mon Sep 17 00:00:00 2001 From: tpoitzsch Date: Tue, 16 Dec 2014 18:10:50 +0000 Subject: [PATCH] FRITZBOX: docu git-svn-id: svn://svn.code.sf.net/p/fhem/code/trunk@7233 2b470e98-0d58-463d-a4d8-8e2adae1ed80 --- fhem/FHEM/72_FRITZBOX.pm | 47 ++++++++++++++++++++-------------------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/fhem/FHEM/72_FRITZBOX.pm b/fhem/FHEM/72_FRITZBOX.pm index 54be7ef34..be4124a68 100644 --- a/fhem/FHEM/72_FRITZBOX.pm +++ b/fhem/FHEM/72_FRITZBOX.pm @@ -932,7 +932,7 @@ sub ########################################## FRITZBOX_Ring_Run($) { my ($string) = @_; - my ($name, @val) = split /\|/, $string; + my ($name, @val) = split "\\|", $string; my $hash = $defs{$name}; return "$name|0|Error: At least one parameter must be defined." @@ -1205,7 +1205,7 @@ sub FRITZBOX_Open_Connection($) FRITZBOX_Log $hash, 4, "Open Telnet Connection to $host"; $telnet = new Net::Telnet ( Host=>$host, Port => 23, Timeout=>10, Errmode=>'return', Prompt=>'/# $/'); if (!$telnet) { - $msg = "Error while opening telnet connection: ".$telnet->errmsg; + $msg = "Could not open telnet connection to $host"; FRITZBOX_Log $hash, 2, $msg; $telnet = undef; return $msg; @@ -1515,6 +1515,7 @@ sub FRITZBOX_fritztris($)

FRITZBOX

+(en | de)
@@ -1715,7 +1716,7 @@ sub FRITZBOX_fritztris($)
  • dect1_model - Model of the DECT device 1
  • dect1 - Internal name of the analog FON connection 1
  • dect1_intern - Internal number of the analog FON connection 1
    • -
  • diversity1 - Incoming phone number of the call diversity 1
    • +
  • diversity1 - Own (incoming) phone number of the call diversity 1
  • diversity1_dest - Destination of the call diversity 1
  • diversity1_state - Current state of the call diversity 1
  • radio01 - Name of the internet radio station 01
    • @@ -1738,11 +1739,12 @@ sub FRITZBOX_fritztris($)

    FRITZBOX

    +(en | de)
      Steuert gewisse Funktionen eines Fritz!Box Routers. Verbundene Fritz!Fon's (MT-F, MT-D, C3, C4) können als Signalgeräte genutzt werden. Das Modul schaltet in den lokalen Modus, wenn FHEM auf einer Fritz!Box läuft (als root-Benutzer!).

      - Wenn FHEM nicht auf einer Fritz!Box läuft, versucht es eine Telnet Verbindung zu "fritz.box" zu öffnen. D.h. Telnet (#96*7*) muss auf der Fritz!Box erlaubt sein. Fü diesen Fernzugriff muss das Passwort in der Datei 'fb_pwd.txt' im Wurzelverzeichnis von FHEM gespeichert sein. + Wenn FHEM nicht auf einer Fritz!Box läuft, versucht es eine Telnet Verbindung zu "fritz.box" zu öffnen. D.h. Telnet (#96*7*) muss auf der Fritz!Box erlaubt sein. Für diesen Fernzugriff muss das Passwort in der Datei 'fb_pwd.txt' im Wurzelverzeichnis von FHEM gespeichert sein.

      Bitte auch die anderen Fritz!Box-Module beachten: SYSMON und FB_CALLMONITOR.
      @@ -1758,9 +1760,9 @@ sub FRITZBOX_fritztris($)

      Beispiel: define Fritzbox FRITZBOX

      - Das Fritz!Box OS hat eine versteckte Funktion (Osterei). + Das FritzOS hat eine versteckte Funktion (Osterei).
      - Teste sie mit: define MyEasterEgg weblink htmlCode { FRITZBOX_fritztris("Fritzbox") } + define MyEasterEgg weblink htmlCode { FRITZBOX_fritztris("Fritzbox") }

    @@ -1789,7 +1791,7 @@ sub FRITZBOX_fritztris($)
  • set <name> createPwdFile <password>
    - Erzeugt eine Datei welche das Telnet-Passwort enthält. Der Dateiname entspricht demjenigen, der für den Telnetzugriff genutzt wird. + Erzeugt eine Datei welche das Telnet-Passwort enthält. Der Dateiname entspricht demjenigen, der für den Telnetzugriff genutzt wird.

  • set <name> customerRingTone <internalNumber> <fullFilePath> @@ -1832,10 +1834,10 @@ sub FRITZBOX_fritztris($) Standard-Dauer ist 5 Sekunden. Standard-Klingelton ist der interne Klingelton des Gerätes. Der Klingelton wird für Rundrufe (9 oder 50) ignoriert.
    - Wenn das Attribute 'ringWithIntern' existiert, wird der Text hinter 'msg:' als Name des Anrufers angezeigt. + Wenn das Attribut 'ringWithIntern' existiert, wird der Text hinter 'msg:' als Name des Anrufers angezeigt. Er darf maximal 30 Zeichen lang sein.
    - Wenn der Anruf angenommen wird, hört der Angerufene die Wartemusik (music on hold) welche zur Nachrichtenübermittlung genutzt werden kann. + Wenn der Anruf angenommen wird, hört der Angerufene die Wartemusik (music on hold), welche zur Nachrichtenübermittlung genutzt werden kann.

  • set <name> sendMail [to:<Address>] [subject:<Subject>] [body:<Text>] @@ -1886,7 +1888,7 @@ sub FRITZBOX_fritztris($)
    Standard-Text, der auf dem angerufenen internen Telefon als "Anrufer" gezeigt wird.
    - Dies erfolgt, indem während des Klingelns kurzzeitige der Name der internen anrufenden Nummer geändert wird. + Dies erfolgt, indem während des Klingelns kurzzeitig der Name der internen anrufenden Nummer geändert wird.
    Es ist maximal 30 Zeichen erlaubt. Das Attribute "ringWithIntern" muss ebenfalls spezifiziert sein.

    • @@ -1894,7 +1896,7 @@ sub FRITZBOX_fritztris($)
    Dies ist der Standard-Pfad der für Dateinamen benutzt wird, die nicht mit einem / (Schrägstrich) beginnen.
    - Es muss ein Pfad auf der Fritz!Box sein. D.h., es sollte mit /var/InternerSpeicher starten, wenn es in Windows unter \\ip-address\fritz.nas erreichbar ist. + Es muss ein Pfad auf der Fritz!Box sein. D.h., er sollte mit /var/InternerSpeicher starten, wenn es in Windows unter \\ip-address\fritz.nas erreichbar ist.
  • fritzBoxIP
    @@ -1902,19 +1904,18 @@ sub FRITZBOX_fritztris($)

  • pwdFile <fileName>
    - Datei welche das Passwort für den Telnetzugang enthät. Der Standard ist 'fb_pwd.txt' im Wurzelverzeichnis von FHEM. + Damit kann die Datei geündert werden, welche das Passwort für den Telnetzugang enthält. Der Standard ist 'fb_pwd.txt' im Wurzelverzeichnis von FHEM.

  • telnetUser <user name>
    Benutzername für den Telnetzugang. Normalerweise wird keine Benutzername für das Login benötigt. -
    - Wenn die Fritz!Box anders konfiguriert ist, kann der Nutzer über dieses Attribute definiert werden. + Wenn die Fritz!Box anders konfiguriert ist, kann der Nutzer über dieses Attribut definiert werden.

  • ringWithIntern <internalNumber>
    Um ein Telephone anzurufen, muss eine Anrufer spezifiziert werden. Normalerweise ist dies in diesem Modul die Nummer 50 "ISDN:Wählhilfe".
    - Um während des Klingelns eine Nachricht (Standard: "FHEM") anzuzeigen, kann hier die interner Nummer 1 oder 2 angegeben werden. + Um während des Klingelns eine Nachricht (Standard: "FHEM") anzuzeigen, kann hier die interne Nummer 1 oder 2 angegeben werden.

  • readingFnAttributes
    • @@ -1934,14 +1935,14 @@ sub FRITZBOX_fritztris($)
  • box_wlan_2.4GHz - Aktueller Status des 2.4-GHz-WLAN
  • box_wlan_5GHz - Aktueller Status des 5-GHz-WLAN
  • dect1 - Name des DECT Telefons 1
    • -
  • dect1_alarmRingTone - Klingelton des Weckers für das DECT Telefons 1
    • +
  • dect1_alarmRingTone - Klingelton beim Wecken über das DECT Telefon 1
  • dect1_custRingTone - Benutzerspezifischer Klingelton des DECT Telefons 1
  • dect1_fwVersion - Firmware-Version des DECT Telefons 1
  • dect1_intern - Interne Nummer des DECT Telefons 1
  • dect1_intRingTone - Interner Klingelton des DECT Telefons 1
  • dect1_manufacturer - Hersteller des DECT Telefons 1
  • dect1_model - Modell des DECT Telefons 1
    • -
  • dect1 - Interner Name des analogen Telefonanschlusses 1
    • +
  • dect1 - Name des analogen Telefonanschlusses 1 an der Fritz!Box
  • dect1_intern - Interne Nummer des analogen Telefonanschlusses 1
  • diversity1 - Eigene Rufnummer der Rufumleitung 1
  • diversity1_dest - Zielnummer der Rufumleitung 1
    • @@ -1951,10 +1952,10 @@ sub FRITZBOX_fritztris($)
  • tam1_newMsg - Anzahl neuer Nachrichten auf dem Anrufbeantworter 1
  • tam1_oldMsg - Anzahl alter Nachrichten auf dem Anrufbeantworter 1
  • tam1_state - Aktueller Status des Anrufbeantworters 1
    • -
  • user01 - Name des Benutzers bzw. der IP 1 für die eine Zugangsbeschränkung (Kindersicherung) eingerichtet ist
    • -
  • user01_thisMonthTime - this month internet usage of user/IP 1 (parental control)
    • -
  • user01_todaySeconds - today's internet usage in seconds of user/IP 1 (parental control)
    • -
  • user01_todayTime - today's internet usage of user/IP 1 (parental control)
    • +
  • user01 - Name von Nutzer/IP 1 für den eine Zugangsbeschränkung (Kindersicherung) eingerichtet ist
    • +
  • user01_thisMonthTime - Internetnutzung des Nutzers/IP 1 im aktuellen Monat (Kindersicherung)
    • +
  • user01_todaySeconds - heutige Internetnutzung des Nutzers/IP 1 in Sekunden (Kindersicherung)
    • +
  • user01_todayTime - heutige Internetnutzung des Nutzers/IP 1 (Kindersicherung)