digitalSTROM mit Home Assistant verbinden: lokale Integration und Automationen

In digitalSTROM-Installationen hängen Lichter, Storen und weitere Verbraucher an Klemmen im Sicherungskasten, gesteuert über Taster und einen digitalSTROM-Server (dSS20). Kommen weitere Systeme wie Philips Hue, Sonos und eine FRITZ!Box dazu, liegt es nahe, alles lokal in Home Assistant zusammenzuführen, ohne Cloud-Konto und ohne das Passwort des dSS in Home Assistant abzulegen. Dafür habe ich eine kleine Integration geschrieben und zusammen mit passenden Automationen als pfstr/ha-digitalstrom-local unter MIT-Lizenz veröffentlicht.

Kurzfazit: Der dSS bietet eine brauchbare JSON-API mit Ereignissen. Wer sie schonend nutzt, bekommt Taster, Szenen und die Aktivitäten Gehen und Kommen ohne Verzögerung nach Home Assistant und kann damit Automationen auslösen, die digitalSTROM allein nicht kennt.

Wie die Integration arbeitet

Der dSS stellt seine API auf Port 8080 per HTTPS bereit, mit einem selbstsignierten Zertifikat. Für Programme sieht digitalSTROM App-Tokens vor: Das Programm fordert einen Token an, der Benutzer gibt ihn im Configurator unter System > Zugriffsberechtigung frei, danach meldet sich das Programm damit an. Das Passwort des dSS bleibt beim Benutzer.

DSS=https://dss.local:8080/json
curl -sk "$DSS/system/requestApplicationToken?applicationName=Home%20Assistant"
curl -sk "$DSS/system/loginApplication?loginToken=<APP-TOKEN>"
curl -sk "$DSS/event/subscribe?name=callScene&subscriptionID=42&token=<SESSION>"
curl -sk "$DSS/event/get?subscriptionID=42&timeout=30000&token=<SESSION>"

Die Integration hält eine solche Long-Poll-Verbindung dauerhaft offen. Jede Szene, die ein Taster, die App oder der Configurator auslöst, kommt als Ereignis an. Zustände wie „Licht im Raum an” oder die Anwesenheit stehen im Zwischenspeicher des dSS unter /usr/states und lassen sich abfragen, ohne die Klemmen zu belasten.

Direkte Abfragen von Ausgangswerten (device/getOutputValue) gehen dagegen über den dS485-Bus bis zur Klemme und dauern pro Wert eine halbe bis ganze Sekunde. Viele solche Abfragen in kurzen Abständen können die Meter überlasten. Die Integration liest deshalb nur Storenpositionen und Joker-Ausgänge direkt, alle 15 Minuten und etwa eine Minute nach einer Fahrt.

Zusätzlich meldet die Integration jede Raumszene sowie Gehen und Kommen als Ereignis digitalstrom_local_event an Home Assistant. Damit lassen sich 2× oder 4× Tippen auf einem gewöhnlichen Lichtschalter frei belegen.

Automationen als Blueprints

Die folgenden Automationen sind im Repository als Blueprints enthalten und lassen sich über den Import-Knopf im README in Home Assistant übernehmen.

Bewegungslicht, das von Hand eingeschaltetes Licht nicht löscht

Bei Bewegung geht das Licht an, nach einer einstellbaren Zeit ohne Bewegung wieder aus. Optional gilt das nur unter einer Helligkeitsschwelle, nur in einem Zeitfenster oder nachts gedimmt. Schaltet jemand das Licht am Taster ein, bleibt es an. Ein Hilfsschalter (input_boolean) merkt sich dafür, ob die Automation das Licht eingeschaltet hat; nur dann schaltet sie es auch wieder aus.

Ein Detail fällt erst im Betrieb auf: Der Auslöser „Melder seit 2 Minuten ruhig” ist ein Zähler, den Home Assistant bei jedem Neustart verwirft. Hat sich der Melder vor dem Neustart zuletzt bewegt, folgt kein neuer Wechsel auf „ruhig”, und das Licht bleibt an. Der Blueprint prüft deshalb zusätzlich jede Minute, ob ein von ihm eingeschaltetes Licht brennt, obwohl der Melder lange genug ruhig ist.

Licht aus beim Verlassen des Raums

Die Ausschaltzeit des Bewegungslichts ist ein Kompromiss: Zu kurz, und das Licht geht aus, während jemand still im Raum steht; zu lang, und es brennt nach dem Verlassen minutenlang weiter. Ein weiterer Blueprint nutzt deshalb einen zweiten Melder ausserhalb des Raums, typischerweise im Gang. Erkennt dieser Bewegung, hat der Melder im Raum kurz zuvor (innerhalb von 30 Sekunden) noch Bewegung gesehen und bleibt es dort anschliessend ruhig, geht das Licht im Raum sofort aus. Mit Hue-Meldern, die etwa 10 Sekunden nach der letzten Bewegung „ruhig” melden, sind das rund 10 bis 15 Sekunden nach dem Hinaustreten.

Damit niemand im Dunkeln sitzt, greift die Regel nur unter Bedingungen: Das Licht muss von der Bewegungsautomation eingeschaltet worden sein, ein Duschmodus darf nicht aktiv sein, und es darf höchstens eine Person zu Hause sein. Die Personenzahl ergibt sich aus den Handys, die Home Assistant als Personen kennt. Die 30-Sekunden-Bedingung schützt zusätzlich den Fall, dass jemand länger still im Raum ist und eine andere Person durch den Gang geht.

Duschmodus per 2× Tippen

In der Dusche erkennt ein Bewegungsmelder meist niemanden, und nach der eingestellten Zeit wird es dunkel. 2× Tippen auf den Badtaster löst bei digitalSTROM die Stimmung 2 aus (Szene 17). Die Automation erkennt diese Szene im Raum und schaltet einen Duschmodus ein, der das Ausschalten blockiert. Bewegungen in den ersten 2 Minuten werden ignoriert (Ausziehen, Einsteigen). Die erste Bewegung danach beendet den Duschmodus, ab dann gilt wieder die normale Ausschaltzeit. Nach einer einstellbaren Maximaldauer (Standard 20 Minuten) endet er von selbst.

4× Tippen startet Sonos

Tippt man mehrmals schnell auf einen Taster, schaltet digitalSTROM die Stimmungen der Reihe nach durch: Szene 5, 17, 18 und beim vierten Tippen 19. Stellt man Szene 19 im Configurator bei allen Lampen auf „Ausgang nicht verändern”, ist sie frei für andere Zwecke. Ein Blueprint reagiert auf diese Szene, schaltet das Raumlicht aus und startet den Sonos-Lautsprecher im Raum oder, in Räumen ohne Lautsprecher, mehrere zusammen.

Das Skript dazu achtet auf drei Punkte: Läuft schon ein Lautsprecher, wird der neue Raum dessen Gruppe zugeschaltet, damit die Wiedergabe synchron bleibt. Lässt sich nichts fortsetzen, spielt ein Radiosender aus dem Radio-Browser-Verzeichnis. Und vor jedem Start wird dieselbe Startlautstärke gesetzt, sonst spielt der eine Raum leise und der andere so laut, wie zuletzt jemand Musik gehört hat.

Gehen und Kommen per FRITZ!Box

Die Integration FRITZ!Box Tools meldet, ob ein Handy im WLAN ist; sie wertet die Geräteliste der Box aus und deckt damit 2,4-GHz-Netz, 5-GHz-Netz und LAN gleichzeitig ab. Ist niemand mehr zu Hause und wurde Gehen nicht gedrückt, löst ein Blueprint Gehen aus. Beim Heimkommen folgt Kommen und, wenn es dunkel ist, ein Begrüssungslicht.

Ergänzend kann eine Automation bei Gehen die Lampen anderer Systeme (zum Beispiel Hue) ausschalten und Sonos pausieren. Die digitalSTROM-Lampen schaltet der dSS selbst aus.

Grundriss als Dashboard

Eine übersichtliche Darstellung in Home Assistant ist ein Grundriss mit der eingebauten Karte picture-elements. Pro Raum liegt ein transparentes SVG über dem Plan, das bei eingeschaltetem Licht durch ein leicht gelbes ersetzt wird; ein Tippen auf den Raum schaltet das Licht. Lampen, Lautsprecher, Storen und Melder sitzen als Symbole an ihrem Standort. Die Anleitung mit Beispielkonfiguration liegt im Repository unter docs/floor-plan-dashboard.md.

Probleme aus der Praxis

Eine Gerätesuche an der Hue-Bridge nimmt alle Geräte auf, die sich gerade im Kopplungsmodus befinden. Prüfen Sie danach in der Geräteliste, ob nur die eigenen Lampen dazugekommen sind.

Die Szenen-Tabellen der Klemmen lassen sich über die API auslesen und ändern, etwa mit device/getSceneMode und device/saveScene. Jeder dieser Aufrufe geht über den Bus. Sichern Sie vor Änderungen die alten Werte, zum Beispiel in einer CSV-Datei, um sie bei Bedarf wiederherstellen zu können.