Openhab – Fritz!DECT200 einrichten

Info (25.11.2020): Vor einigen Tagen wurde Openhab 3 offiziell veröffentlicht! Dieses Tutorial ist ausschließlich für Openhab 2.5!

Eine schaltbare smarte Steckdose in sein Haus oder seine Wohnung zu integrieren, ist mit der Fritz!DECT200 schnell und einfach möglich. Wer jedoch eine OpenHab Zentrale betreibt, möchte die Daten der Steckdose natürlich auch in sein System integrieren. Wie immer bei OpenHab ist dies ganz einfach mit einem Binding möglich. Wie genau das funktioniert erkläre ich dir in diesem Tutorial. Zuvor solltest du bereits die Steckdose mit deiner Fritz!Box verbunden haben, wie das genau funktioniert wird in diesem Beitrag erklärt.

Binding Installieren

Öffne wie gewohnt dein Paper UI und klicke im Menü auf „Add-Ons“. Wechsel anschließend in den Reiter „Bindings“ und suche nach „AVM Fritz!“. Hast du das Binding gefunden, installierst du es einfach über einen Klick auf „Install“ auf der rechten Seite der Zeile.

Geräte einrichten

Das AVM Fritz! Binding hat eine Auto-Discovery Option. Das heisst für dich ganz einfach, dass die Geräte automatisch erkannt werden. Ich empfehle dir nun jedoch zuerst einen neuen Benutzer in deiner Fritz!Box anzugeben, diesen benötigst du in der weiteren Einrichtung. Diesem Benutzer solltest du nur die nötigsten Rechte auf deiner Fritz!Box einräumen, sodass keine wichtigen Einstellungen deines Netzwerks damit ausgelesen oder geändert werden können.

Möchtest du alles über dein Paper UI festlegen, so kannst du damit nun loslegen. Im Setup-Wizard sollte deine Fritz!Box auftauchen, wie gewohnt kannst du diese nun hinzufügen und anschließend die Daten des Nutzers eintragen, welchen du angelegt hast. Ist die Einrichtung des Routers abgeschlossen, sollten im Setup-Wizard als nächstes die bereits eingerichteten Smarthome Geräte erscheinen, welche im Router eingerichtet sind. Diese kannst du nun ebenfalls nach und nach hinzufügen. Die Einrichtung über den Setup Wizard ist relativ selbsterklärend, weswegen ich nicht weiter hierauf eingehen möchte

Einrichtung mit Konfigurationsdateien

Möchtest du lieber deine Geräte über Konfigurationsdateien einrichten, was ich generell empfehle, solltest du zuerst das Auto-Discovery ausschalten. Baue hierzu erst einmal eine Verbindung zu deiner Zentrale auf um die Konfigurationsdateien bearbeiten zu können. Begonnen wird mit der Datei „/services/runtime.cfg“. In diese Bindest du folgenden Code ein:

discovery.avmfritz:background=false

Diese Codezeile sorgt dafür, dass das Binding nicht weiter versucht die Geräte automatisch zu erkennen.

Als nächstes legst du die Geräte und die Fritz!Box in einer .things-Datei an. Diese wird im Ordner „/things/“ abgelegt. Beispiel: „/things/fritzbox.things“

Nun öffne die erstellte Datei und füge deine Fritz!Box, sowie deine Bereits verbundenen Geräte zur Fritz!Box hinzu. Du benötigst folgende Daten um für eine erfolgreiche Konfiguration:

• Ip-Adresse deines Routers
• Nutzername und Nutzerpasswort deines neu erstellten Benutzers der Fritz!Box
• Die AIN der DECT Steckdose oder anderer Geräte die du über die Fritz!Box einrichten möchtest (Diese Nummer findest du in den Smarthome-Einstellungen der Fritz!Box)
• Einen Eindeutigen Namen für deine Steckdose
• Einen Namen zur Anzeige in deiner Visualisierung

Hierzu ein Codebeispiel um die Einrichtung zu erleichtern:

Bridge avmfritz:fritzbox:1 "FRITZ!Box" [ ipAddress="IP-Adresse eintragen", password="Nutzerpasswort", user="Nutzername" ] {
    Thing FRITZ_DECT_200 Eindeutiger_Name "Name für Visualisierung" [ ain="AIN_Nummer" ]
}

Denk daran alle Platzhalter mit deinen spezifischen Daten auszufüllen

Es können nicht nur DECT200 Steckdosen eingebunden werden, sondern fast alle Fritz! Smarthome Geräte. Ich möchte mich in diesem Tutorial jedoch lediglich den DECT200 Steckdosen widmen. Eine komplette Beschreibung zum Binding und der Einrichtung anderer Fritz! Smarthome-Geräte gibt es hier

Items Anlegen

Ist die .things-Datei angelegt und alles eingetragen wie im letzten Absatz beschrieben, so kannst du als nächstes eine .items-Datei anlegen. Diese wird im Ordner „/items/“ abgelegt. Beispiel: „/items/fritzbox.items“

Hier legst du nun die Variablen fest, welche du aus der Steckdose auslesen oder an sie schreiben möchtest. Die DECT200 hat folgende mögliche Variablen:

• Schaltkontakt (Steckdose an oder aus): Diese Variable ist sowohl lesbar, als auch beschreibbar.
• Temperatur: In den DECT200 Steckdosen befindet sich ein Raumtemperatursensor, auf diesen sollte man sich jedoch nicht zu 100% verlassen. Durch höhere Leistungen erwärmt sich die Steckdose selbst und es kommt zu Fehlmessungen.
• Stromzähler: Die Steckdose speichert die bisher geflossene Leistung in kWh und liefert den aktuellen Wert.
• Leistung: Die aktuelle Leistung in Watt wird als Variable ausgegeben. Die Aktualisierung dieses Werts erfolgt zyklisch und ist sehr träge. Eine Echtzeitüberwachung ist hiermit nicht möglich!
• Spannung: Auch die aktuelle Spannung an der Steckdose wird ausgegeben und kann mit Openhab erfasst werden.

Zum Anlegen deiner Variablen in der .items-Datei benötigst du den eindeutigen Namen, welchen du in der .things-Konfiguration angegeben hast. Anschließend kannst du die Variablen wie im Beispiel anlegen

Switch Steckdosenschalter "Steckdosenschalter" { channel="avmfritz:FRITZ_DECT_200:1:Eindeutiger_Name:outlet" }

Number:Temperature Temperatur "Aktuelle Raumtemperatur [%.1f %unit%]" { channel="avmfritz:FRITZ_DECT_200:1:Eindeutiger_Name:temperature" }

Number:Energy Stromzaehler "Stromzähler [%.3f kWh]" { channel="avmfritz:FRITZ_DECT_200:1:Eindeutiger_Name:energy" }

Number:Power Leistung "Aktuelle Leistung [%.2f %unit%]" { channel="avmfritz:FRITZ_DECT_200:1:Eindeutiger_Name:power" }

Number:ElectricPotential Spannung "Aktuelle Spannung [%.1f %unit%]" { channel="avmfritz:FRITZ_DECT_200:1:Eindeutiger_Name:voltage" }

Denke wieder daran, den Platzhalter des eindeutigen Namens mit deinem in der .things festgelegten eindeutigen Namen der Steckdose zu tauschen! Auch die anderen Namen kannst du gerne nach deinem belieben ändern.

Die Einrichtung ist nun abgeschlossen und du kannst damit fortfahren die Items im HabPanel oder an beliebiger anderer Stelle in OpenHab verwenden. Solltest du die aktuelle Leistung in Rules verwenden wollen, so bedenke die Trägheit des ganzen Systems.

Schlusswort

Ich hoffe ich konnte dir mit diesem Tutorial bei der Einrichtung einer DECT200 in OpenHab helfen. Solltest du dennoch Fragen haben, so scheue dich nicht diese in den Kommentaren oder dem Forum los zu werden.