OpenHAB TR-064 Bindung für die Fritzbox


Mit der Version 1.8.0 ist ein neues Addon für OpenHAB veröffentlicht worden. Auf dieses Plugin habe ich mich schon sehr gefreut, da es mit diesem Addon eine einfache Möglichkeit gibt, die Anwesenheit einer Person zu erfassen. Da AVM mit der Software Version 6.30 den Telnet-Zugang entfernt hat, gibt es für externe Applikationen nur noch die von AVM bereitgestellten Webservices um mit der Fritzbox zu kommunizieren. AVM hat die Schnittstelle nach der TR-064 Spezifikation und sehr umfangreich gestaltet.Um die TR-064 Schnittstelle zu aktivieren muss man in der Fritzbox unter Heimnetz –> Netzwerk –> Netzwerkeinstellungen die Option „Zugriff für Anwendungen zulassen“ aktivieren.

Fritzbox TR-064 aktivieren
Nach einem Neustart der Fritzbox kann man den Webservice unter den folgenden URLs erreichen:

  • http://fritz.box:49000/tr64desc.xml
  • https://fritz.box:49443/tr64desc.xml

Installation

Da das Addon noch nicht im Repository aufgetaucht ist, muss man es leider selbst herunterladen und an die richtige Stelle kopieren.

wget https://github.com/gitbock/fritzboxtr064/releases/download/v1.0/org.openhab.binding.fritzboxtr064_1.8.0.201601021955.jar

Ist der Download fertig, muss die Datei nur noch in das Addon- Verzeichnis kopiert werden.

mv org.openhab.binding.fritzboxtr064_1.8.0.201601021955.jar /usr/share/openhab/addons/

Konfiguration

Ist das erledigt gehts an die Konfiguration von OpenHAB. In der OpenHAB Konfiguration (openhab.cfg) sind nur ein paar Einträge notwendig, damit das Addon mit der Fritzbox Kontakt aufnehmen kann.

fritzboxtr064:url=http://fritz.box:49000
fritzboxtr064:refresh=10000
fritzboxtr064:pass=sEhR-gEhEiM

Mit diesen Parametern wird die Verbindung zur Fritzbox unverschlüsselt aufgebaut und alle 10 Sekunden abgefragt. Sollte in der Fritzbox der Zugang mit Benutzername und Passwort konfiguriert sein, so muss noch folgender Parameter in die Konfiguration übernommen werden.

fritzboxtr064:user=

Items anlegen

Nach dem Neustart des OpenHAB Daemon, kann mit der Konfiguration der Items begonnen werden. Es gibt für folgende Funktionen Items.

Fritzbox LAN/WLAN Funktionen

  • Modelname (String)
  • WAN-IP (String)
  • Wifi 2.4 GHz (Switch)
  • Wifi 5 GHz (Switch)
  • Gäste WLAN (Switch)
  • MAC-Online (Contract)

Fritzbox Call Monitor

  • Telefon klingelt (Switch)
  • Rufnummer von ankommenden Gesprächen (String)
  • Rufnummer von abgehenden Gesprächen (String)
  • Anrufbeantworter (Switch)
  • Anzahl Nachrichten auf dem AB (Number)
  • verpasste Anrufe der letzten Tage  (Number)

Da meine Fritzbox keinen Telefonieanteil hat, habe ich mich den Funktion MAC-Online, Gäste WLAN, WAN-IP-Adresse und Model gewidmet.

String  fbName          "FBox Model [%s]"       { fritzboxtr064="modelName" }
String  fbWanIP         "FBox WAN IP [%s]"      { fritzboxtr064="wanip" }
Switch  fbGWifi         "Guest Wifi"    { fritzboxtr064="wifiGuestSwitch" }
Contact fbMACOnline     "Presence (Wifi) [MAP(presence.map):%d]"        <present>       { fritzboxtr064="maconline:11-22-33-44-55-66" }

Zusätzlich muss eine Translation-MAP eingerichtet werden, in der die Zustände „0“ und „1“ gegen den Text „nicht anwesend“ und „anwesend“ ersetzt werden. In diesem Beispiel heißt diese MAP-Datei „presence.map“.

1=anwesend
0=nicht anwesend

Ist dies geschehen, so kann eine Sitemap erstellt werden.

sitemap default label="Main Menu"
{
        Frame {
                Text item=fbName label="Model [%s]"
                Text item=fbMACOnline label="Anwesend [MAP(presence.map):%d]"
                Text item=fbWanIP label="WAN IP-Adresse [%s]"
                Switch item=fbGWifi label="Gäste WLAN"
        }
}

Die Beispiel OpenHAB Seite sieht nun wie folgt aus.

openhab-fritzbox-tr064-addon

Links:

AVM TR-064 Protokollbeschreibung
Fritzbox-TR064 OpenHAB Addon

 


Schreibe einen Kommentar