Ich habe eine Fritz!Box 7590.¹Im Mesh-Set mit dem Repeater 1750 für 231,98€ bei Expert gekauft. Außerden habe ich einen Repeater 2400 für 79,90€ bei Amazon gekauft. Diese kann man auch einbinden. So kann z.B. im Falle eines Anrufes automatisch das Fernsehprogramm pausiert oder stummgeschaltet werden. Das hätte ich gerne.

Achtung: Seit meinem Update auf openHAB 3.0 funktioniert das in diesem Artikel beschriebene Vorgehen nicht mehr. Die openHAB 3.0-Variante habe ich in einem separaten Artikel dokumentiert.

Tag 1: Installation des Bindings

Es gibt eine wunderbare Anleitung für die Fritz!Box-Integration: Hier zu finden. Die arbeite ich jetzt ab. Als Vorarbeit erhält mein RasPi im Fritz!Box-Menü eine feste IP (x.x.x.10). Außerdem lege ich einen Benutzer für openhab auf der Fritz!Box an, und aktiviere „Zugriff für Anwendungen zulassen“. Anschließend installiere ich das Fritz!Box-Binding. Aber, oh weh, es gibt tatsächlich drei verschiedene Bindings für die Fritz!Box:

• AVM FRITZ!Box Binding (binding-avmfritz – 2.5.3): Das ist wohl aktuell, für die Smart-Home-Features der Fritz!Box. Diese nutze ich (noch) nicht, daher ist es (derzeit) nicht relevant für mich.
• Fritzbox Binding (binding-fritzbox1 – 1.14.0): Das ist wohl veraltet, und nutzt veraltete Schnittstellen. Also wird es nicht installiert.
• Fritzbox TR064 Binding (binding-fritzboxtr0641 – 1.14.0): Das ist das aktuelle Binding. Das wird genutzt.

In Configuration > Bindings hinterlege ich noch Benutzername und Passwort für den openhab-Zugang, damit das Binding auch wirklich etwas schalten kann.

Gut. Nachdem das Binding installiert wurde, lege ich ein Item an. Also navigiere ich per SSH in das Items-Verzeichnis, und lege die Datei fritzbox.items an. Im Prinzip mache ich einmal copy&paste der Item-Konfiguration. Diese Datei enhält also folgende Zeilen:

String  fboxName            "FBox Model [%s]"           {fritzboxtr064="modelName"}
String  fboxManufacturer    "FBox Manufacturer [%s]"    {fritzboxtr064="manufacturerName"}
String  fboxSerial          "FBox Serial [%s]"          {fritzboxtr064="serialNumber"}
String  fboxVersion         "FBox Version [%s]"         {fritzboxtr064="softwareVersion"}
Number  fboxUptime          "FBox Uptime [%d s]"        {fritzboxtr064="upTime"}                 
// get wan ip if FritzBox establishes the internet connection (e. g. via DSL)
String  fboxWanIP           "FBox WAN IP [%s]"          {fritzboxtr064="wanip"}
// get wan ip if FritzBox uses internet connection of external router
String  fboxWanIPExternal   "FBox external WAN IP [%s]" {fritzboxtr064="externalWanip"}
Switch  fboxWifi24          "2,4GHz Wi-Fi"               {fritzboxtr064="wifi24Switch"}
Switch  fboxWifi50          "5,0GHz Wi-Fi"               {fritzboxtr064="wifi50Switch"}
Switch  fboxGuestWifi       "Guest Wi-Fi"                {fritzboxtr064="wifiGuestSwitch"}    
Contact cFboxMacOnline      "Presence (Wi-Fi) [%s]"      {fritzboxtr064="maconline:11-11-11-11-11-11" }
Switch  fboxReboot          "Reboot"                    {fritzboxtr064="reboot"}

// WAN statistics

String  fboxWanAccessType "FBox WAN access type [%s]" {fritzboxtr064="wanWANAccessType"}
Number  fboxWanLayer1UpstreamMaxBitRate "FBox WAN us max bit rate [%s]" {fritzboxtr064="wanLayer1UpstreamMaxBitRate"}
Number  fboxWanLayer1DownstreamMaxBitRate "FBox WAN ds max bit rate [%s]" {fritzboxtr064="wanLayer1DownstreamMaxBitRate"}
String  fboxWanPhysicalLinkStatus "FBox WAN physical link status [%s]" {fritzboxtr064="wanPhysicalLinkStatus"}
Number  fboxWanTotalBytesSent "WAN total bytes sent [%s]" {fritzboxtr064="wanTotalBytesSent"}
Number  fboxWanTotalBytesReceived "WAN total bytes received [%s]" {fritzboxtr064="wanTotalBytesReceived"}

// DSL statistics

Contact fboxDslEnable       "FBox DSL Enable [%s]"      {fritzboxtr064="dslEnable"}
String  fboxDslStatus       "FBox DSL Status [%s]"      {fritzboxtr064="dslStatus"}
Number  fboxDslUpstreamCurrRate "DSL Upstream Current [%s kbit/s]" {fritzboxtr064="dslUpstreamCurrRate"}    
Number  fboxDslDownstreamCurrRate "DSL Downstream Current [%s kbit/s]" {fritzboxtr064="dslDownstreamCurrRate"} 
Number  fboxDslUpstreamMaxRate "DSL Upstream Max [%s kbit/s]" {fritzboxtr064="dslUpstreamMaxRate"}               
Number  fboxDslDownstreamMaxRate "DSL Downstream Max [%s kbit/s]" {fritzboxtr064="dslDownstreamMaxRate"}        
Number  fboxDslUpstreamNoiseMargin "DSL Upstream Noise Margin [%s dB*10]" {fritzboxtr064="dslUpstreamNoiseMargin"}
Number  fboxDslDownstreamNoiseMargin "DSL Downstream Noise Margin [%s dB*10]" {fritzboxtr064="dslDownstreamNoiseMargin"}
Number  fboxDslUpstreamAttenuation "DSL Upstream Attenuation [%s dB*10]" {fritzboxtr064="dslUpstreamAttenuation"}
Number  fboxDslDownstreamAttenuation "DSL Downstream Attenuation [%s dB*10]" {fritzboxtr064="dslDownstreamAttenuation"}
Number  fboxDslFECErrors "DSL FEC Errors [%s]" {fritzboxtr064="dslFECErrors"}
Number  fboxDslHECErrors "DSL HEC Errors [%s]" {fritzboxtr064="dslHECErrors"}
Number  fboxDslCRCErrors "DSL CRC Errors [%s]" {fritzboxtr064="dslCRCErrors"}

// only when using call monitor
Switch  fboxRinging         "Phone ringing [%s]"                {fritzboxtr064="callmonitor_ringing" }
Switch  fboxRinging_Out     "Phone ringing [%s]"                {fritzboxtr064="callmonitor_outgoing" }
Switch  fboxCallConnecting  "Call established [%s]"             {fritzboxtr064="callmonitor_active" }
Call    fboxIncomingCall    "Incoming call: [%1$s to %2$s]"     {fritzboxtr064="callmonitor_ringing" } 
Call    fboxOutgoingCall    "Outgoing call: [%1$s to %2$s]"     {fritzboxtr064="callmonitor_outgoing" }
Call    fboxConnectedCall   "Call established [%1$s to %2$s]"   {fritzboxtr064="callmonitor_active" }

// resolve numbers to names based on phonebook
Call    fboxIncomingCallResolved    "Incoming call: [%1$s to %2$s]"     {fritzboxtr064="callmonitor_ringing:resolveName" } 

// Telephone answering machine (TAM) items
// Number after tamSwitch is ID of configured TAM, start with 0
Switch  fboxTAM0Switch   "Answering machine ID 0"       {fritzboxtr064="tamSwitch:0"}
Number  fboxTAM0NewMsg   "New Messages TAM 0 [%s]"      {fritzboxtr064="tamNewMessages:0"}

// Missed calls: specify the number of last days which should be searched for missed calls
Number  fboxMissedCalls  "Missed Calls [%s]"            {fritzboxtr064="missedCallsInDays:5"}

// Call deflection items
// Number after callDeflectionSwitch is ID of configured call deflection
// The ID count includes the entries from the "Call Blocks" page.
// If you have no "Call Blocks", the first entry on the "Call Diversions" page has ID 0.
// If you have 3 "Call Blocks", the first entry on the "Call Diversions" page has ID 3.
Switch  fboxCD0Switch    "Call Deflection ID 0"         {fritzboxtr064="callDeflectionSwitch:0"}

Als nächstes geht es an die Sitemap. Ich ergänze in der default.sitemap folgendes Snippet:

    Frame label="Fritz!Box" {
        Text item=fboxDslDownstreamCurrRate label="Downloadspeed aktuell"
        Text item=fboxDslUpstreamCurrRate label="Uploadspeed aktuell"
        Text item=fboxUptime label="Fritz!Box-Uptime"
        Switch item=fboxGuestWifi label="Gäste-WLAN"
    }

Nun besitze ich einen Schalter, mit dem ich das Gäste-WLAN an- und ausschalten kann. Außerdem bekomme ich die aktuellen Upload- und Downloadgeschwindigkeiten sowie die Uptime der Fritz!Box angezeigt. Das ist natürlich noch nicht optimal, denn ich bekomme die Geschwindigkeiten in kbit/s angezeigt. Dies ist in obiger Item-Konfiguration, Zeile 29-32, bereits korrigiert. Im Tutorial ist es falsch hinterlegt, dort steht mbit/s. Was ich eigentlich gerne hätte. Außerdem hätte ich gerne Icons auf der Sitemap. Das ist ein Projekt für einen anderen Tag.

Tag 2: Schönere Icons und bessere Textformatierung

Wie erwähnt möchte ich schönere Icons auf meiner Sitemap. Also bearbeite ich die Sitemap. Ich ändere daher obiges Snippet in der default.sitemap zu:

    Frame label="Fritz!Box" {
        Text item=fboxDslDownstreamCurrRate icon="returnpipe" label="Downloadspeed aktuell"
        Text item=fboxDslUpstreamCurrRate icon="flowpipe" label="Uploadspeed aktuell"
        Text item=fboxUptime icon="line" label="Fritz!Box-Uptime"
        Switch item=fboxGuestWifi icon="network" label="Gäste-WLAN"
    }

Nun wollte ich einen Screenshot einbinden, wie dies derzeit aussieht. Aber, oh weh, es funktioniert nicht. In den Logs standen folgende verräterische Zeilen:

2020-04-27 11:56:49.235 [ERROR] [ing.fritzboxtr064.internal.Tr064Comm] - Failed to receive valid response from httpGet: Read timed out
[ERROR] [ing.fritzboxtr064.internal.Tr064Comm] - Releasing connection to FritzBox because of error!
[ERROR] [ing.fritzboxtr064.internal.Tr064Comm] - Could not read xml response services
[ERROR] [ing.fritzboxtr064.internal.Tr064Comm] - Failed to receive valid response from httpGet: Connect to fritz.box:49443 [fritz.box/192.168.178.1, fritz.box/2a01:c22:b40b:500:de39:6fff:fede:37f4, fritz.box/fd00:0:0:0:de39:6fff:fede:37f4] failed: connect timed out
[ERROR] [ing.fritzboxtr064.internal.Tr064Comm] - Releasing connection to FritzBox because of error!
[ERROR] [ing.fritzboxtr064.internal.Tr064Comm] - Could not read xml response services
[WARN ] [ing.fritzboxtr064.internal.Tr064Comm] - No tr064 service found for service id urn:WLANConfiguration-com:serviceId:WLANConfiguration2
[WARN ] [ing.fritzboxtr064.internal.Tr064Comm] - No tr064 service found for service id urn:WLANConfiguration-com:serviceId:WLANConfiguration3

Nach kurzer Analyse zeigte sich, dass in der Konfigurations-Datei services/fritzboxtr064.cfg ein falscher Username und Passwort eingetragen war. Anscheinend speichert die PaperUI den Benutzernamen und das Passwort nicht (oder inkorrekt), denn eigentlich hatte ich das geändert. Also trage ich die richtigen Zugangsdaten ein, starte openHAB neu (sudo systemctl restart openhab2.service), und es funktioniert. Yeah!

Hier ist der versprochene Screenshot:

So weit, so gut. Mir gefällt die Textformatierung noch nicht. Erstens steht da kbit/s, ich hätte aber gerne Mbit/s. Und die Uptime in Sekunden ist auch seltsam. Leider kann man die Formatierung von Items nicht direkt ändern, sondern muss den veränderten Wert über eine Rule in ein neues Item schreiben. Naja, ich wollte sowieso lernen, wie das mit den Rules geht.

Als erstes lege ich mir various.items an, in der ich die neuen Items definiere:

Number fboxDslUpstreamCurrRate_mbit "DSL Upstream Current [%.1f Mbit/s]"
Number fboxDslDownstreamCurrRate_mbit "DSL Downstream Current [%.1f Mbit/s]"
String fboxUptime_hms "FBox Uptime [%s]"

Ich bin nicht sicher, ob dies in einer separaten Items-Datei sein muss, oder ob ich dies auch in fritzbox.items hätte ergänzen können. Zuerst habe ich es natürlich in fritzbox.items ergänzt, aber dort erhielt ich einen Fehler, dass diese Items nicht mit echten Werten verknüpft werden können. Vermutlich benötigt jedes Item eines Bindings ein echtes Gegenstück im Thing. Ich glaube, ich habe gerade gelernt, was ein Channel ist…

Und ich ändere das Sitemap-Snippet in default.sitemap zu:

    Frame label="Fritz!Box" {
        Text item=fboxDslDownstreamCurrRate_mbit icon="returnpipe" label="Downloadspeed aktuell"
        Text item=fboxDslUpstreamCurrRate_mbit icon="flowpipe" label="Uploadspeed aktuell"
        Text item=fboxUptime_hms icon="line" label="Fritz!Box-Uptime"
        Switch item=fboxGuestWifi icon="network" label="Gäste-WLAN"
    }

Jetzt fehlen noch die Rules. Ich erstelle eine neue Datei fritzbox.rules. Als erstes möchte ich, dass Up- und Downstream in Mbit/s anstatt kbit/s angezeigt werden. Das ist einfach, ich muss nur durch 1000 teilen:

rule "Adjust fboxUpstream"
when
    Item fboxDslUpstreamCurrRate received update
then
    fboxDslUpstreamCurrRate_mbit.sendCommand((fboxDslUpstreamCurrRate.state as DecimalType) / 1000)
end

rule "Adjust fboxDownstream"
when
    Item fboxDslDownstreamCurrRate received update
then
    fboxDslDownstreamCurrRate_mbit.sendCommand((fboxDslDownstreamCurrRate.state as DecimalType) / 1000)
end

Das ist im Prinzip zweimal die gleiche Regel. Für die Uptime habe ich diese Anleitung genutzt, und noch etwas mit if-else rumgespielt:

rule "Adjust fboxUptime"
when
    Item fboxUptime changed
then
    val totalSecs = (fboxUptime.state as Number).intValue
    val sec = totalSecs % 60
    val min = (totalSecs / 60) % 60
    val hrs = (totalSecs / (60*60)) % 24
    val day = totalSecs / (60*60*24)
    val tage = "Tage"
    val stunden = "Stunden"
    val minuten = "Minuten"
    val sekunden = "Sekunden"
    
    if (day==1){
        tage = "Tag"
    }
    if (hrs==1){
        stunden = "Stunde"
    }
    if  (min==1){
        minuten = "Minute"
    }
    if  (sec==1){
        sekunden = "Sekunde"
    }
       
    if (day==0){
        if (hrs==0){
            fboxUptime_hms.postUpdate(String::format("%d %s, %d %s", min, minuten, sec, sekunden))
        }
        fboxUptime_hms.postUpdate(String::format("%d %s, %d %s", hrs, stunden, min, minuten))
    } else {
        fboxUptime_hms.postUpdate(String::format("%d %s, %d %s", day, tage, hrs, stunden))
    } 
end

Nun werden immer zwei Zahlen angezeigt: In der ersten Stunde werden nur Minuten und Sekunden angezeigt. Am restlichen ersten Tag werden Stunden und Minuten angezeigt, und danach Tage und Stunden. Das hat erstens Platzgründe, und zweitens interessiert es mich wenig, wie viele Sekunden das System schon läuft, wenn es seit 243 Tagen und 16 Stunden läuft. Und außerdem ist eine kleine Umformatierung der Worte vorhanden, da beim Zahlenwert von 1 die Einzahl, ansonsten die Mehrzahl verwendet wird.

Das Ganze sieht jetzt so aus:

Tag 3: openHAB 3.0

Seit meinem Update auf openHAB 3.0 funktioniert das in diesem Artikel beschriebene Vorgehen nicht mehr. Die openHAB 3.0-Variante habe ich in einem separaten Artikel dokumentiert.