Hallo zusammen,
ich möchte euch meine neue externe free@home-Integration für Gladys Assistant vorstellen.
Damit lassen sich Geräte aus dem free@home-System von Busch-Jaeger / ABB in Gladys einbinden: Lichter schalten und dimmen, Rollos bedienen und vorhandene Wandtaster als Auslöser für Gladys-Szenen verwenden.
Die erste stabile Version 1.0.0 ist veröffentlicht. Die Kommunikation mit dem System Access Point erfolgt ausschließlich lokal, ohne Cloud-Verbindung und ohne XMPP.
GitHub und Installation:
Was kann die Integration?
Licht und Schaltausgänge
- Lichter ein- und ausschalten.
- Dimmbare Lichter auf eine bestimmte Helligkeit einstellen.
- Andere Verbraucher an unterstützten Schaltaktoren ein- und ausschalten – es muss also nicht zwingend eine Lampe angeschlossen sein.
- Zustandsrückmeldungen aus free@home in Gladys anzeigen.
Rollos und Jalousien
- Aufwärts und abwärts fahren.
- Eine laufende Bewegung stoppen.
- Eine prozentuale Öffnungsposition einstellen.
- Bei passenden Aktoren die Lamellenöffnung separat regeln.
Die Positionsdarstellung verwendet 0 % geschlossen und 100 % geöffnet. Lamellen werden ebenfalls als Prozentwert angeboten, nicht als kalibrierter Winkel in Grad. Welche Funktionen erscheinen, hängt von den Datenpunkten ab, die der jeweilige Aktor über die lokale API bereitstellt.
Wand- und Paneltaster
Vorhandene free@home-Taster können Gladys-Szenen auslösen. Damit lassen sich auch Geräte und Funktionen außerhalb von free@home ansteuern.
Je nach Tasterkonfiguration werden beispielsweise Ein/Aus-, Dimm- oder Rolloaktionen gemeldet. Auch zwei identische, aufeinanderfolgende Aktionen werden als getrennte Ereignisse verarbeitet.
Wichtig: Das sind die von free@home bereitgestellten Tasteraktionen, keine universelle Rohdaten-Schnittstelle für Drücken, Loslassen oder Doppelklicks.
Wofür kann man das nutzen?
Ein paar mögliche Anwendungen:
- Beim Verlassen des Hauses ausgewählte Lichter und Verbraucher ausschalten.
- Rollos über Gladys-Szenen zu bestimmten Zeiten positionieren.
- Mit einem vorhandenen free@home-Wandtaster eine Abend- oder Abwesenheitsszene starten.
- Mit einem Taster Geräte anderer, bereits in Gladys eingebundener Systeme bedienen.
- Licht und Beschattung gemeinsam über das Gladys-Dashboard steuern.
Die gewünschte Automatisierung legt ihr in euren Gladys-Szenen fest. Die Integration stellt dafür die unterstützten Geräte und Tasterereignisse bereit.
Wie funktioniert die Verbindung?
Die Integration verbindet sich mit der offiziellen lokalen REST- und WebSocket-API des System Access Points:
- REST dient zum Einlesen der Konfiguration und zum Senden von Steuerbefehlen.
- WebSocket liefert laufende Zustandsänderungen und Tasterereignisse.
Für die lokale Kommunikation ist kein Gladys Plus erforderlich. Oberfläche und Dokumentation stehen auf Deutsch, Englisch und Französisch zur Verfügung.
Getestet und wichtige Hinweise
Mit realer Hardware und SysAP-Firmware 3.5.3 wurden unter anderem Lichtschaltung, Dimmen samt Rückmeldung, Rollopositionierung, Aufwärtsfahrt und Stopp sowie wiederholte Tasterereignisse als Szenenauslöser geprüft..
Nicht jede Geräte- oder Firmwarevariante ist damit abgedeckt. Lamellensteuerung, der separate Abwärtsbefehl und die andere Seite des getesteten Tasters sind bislang nur simuliert geprüft. Heizungsfunktionen, weitere Sensorklassen und vorhandene free@home-Szenen gehören noch nicht zum unterstützten Umfang.
Außerdem gilt:
- Manche Aktoren melden ihre Rolloposition erst nach Ende einer Fahrt.
- Während einer Verbindungsunterbrechung verpasste Tasterereignisse werden nicht nachgeholt.
- Steuerbefehle werden nach Fehlern nicht automatisch wiederholt. Bei einem Timeout deshalb zuerst den tatsächlichen Gerätezustand prüfen.
- Die Controller-API nicht ins Internet freigeben. HTTPS mit vertrauenswürdigem Zertifikat ist vorzuziehen; HTTP überträgt die API-Zugangsdaten unverschlüsselt..
Ich freue mich über Rückmeldungen und Erfahrungen – besonders zu weiteren free@home-Aktoren, Tastern und Firmwareversionen. So können wir die Integration gemeinsam weiter ausbauen.