Motionblinds Smart-Home-Integration, kostenlos und Open Source
Motionblinds-Rollos, Rollläden und Vorhänge über die lokale Motion-Bridge: Position, Lamellen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration steuert Motionblinds-Rollos, -Rollläden und -Vorhänge (Coulisse) und die Schwestermarken, die in Europa auf derselben Plattform verkauft werden (Brel Home, Bloc Blinds, Dooya, Acmeda Automate Pulse 2…), aus Gladys, lokal, über die Motion-WLAN-Bridge (CM-20, CM-32…) oder einen Motion-WLAN-Motor. Keine Cloud, kein Konto: Gladys spricht mit der Bridge in deinem Netzwerk, mit demselben Protokoll wie die Motion-App.
Jedes Rollo wird ein Gladys-Gerät: öffnen / schließen / stoppen, seine Position, die Lamellenneigung von Jalousien, der Akku von Akkumotoren und das Funksignal.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Die Integration wurde nach dem Protokoll geschrieben, wie es die freie Bibliothek motionblinds und Home Assistant verwenden, und gegen eine simulierte Bridge getestet. Wenn sich etwas mit deinen Rollos seltsam verhält, eröffne ein Issue auf github.com/guim31/gladys-motionblinds/issues.
Diese Integration ist nicht mit Coulisse / Motionblinds verbunden.
Voraussetzungen
- Gladys Assistant 5.1 oder neuer.
- Eine Motion-WLAN-Bridge (oder Motion-WLAN-Motoren), in der Motion-App eingerichtet, im selben Netzwerk wie Gladys.
- Der Schlüssel der Motion-App (siehe unten).
- Besser: eine feste IP-Adresse für die Bridge (eine DHCP-Reservierung in deinem Router).
Konfiguration
Installiere die Integration aus dem Gladys-Store und öffne dann ihren Tab Konfiguration.
Der Schlüssel der Motion-App
Die Bridge gehorcht nur Anfragen, die mit dem Schlüssel deines Motion-Kontos signiert sind:
- öffne die Motion-App auf deinem Telefon;
- tippe auf ⋮ (oben rechts), dann auf Einstellungen;
- öffne die Seite Über („Motion APP About“) und tippe fünfmal schnell darauf;
- ein Fenster zeigt den Schlüssel: 16 Zeichen mit Bindestrichen, etwa
12ab345c-d67e-8f.
Übernimm ihn genau so, mit Bindestrichen, in Schlüssel der Motion-App. Gladys speichert ihn als Geheimnis, und er erscheint nie in den Protokollen der Integration. Nutzen deine Rollos die App einer anderen Marke auf der Motion-Plattform, versteckt sich der Schlüssel meist genauso auf deren Seite „Über“.
Die Adresse der Bridge
IP-Adresse der Motion-Bridge: die Adresse, die dein Router der Bridge gegeben hat. Bei mehreren Bridges oder Motion-WLAN-Motoren (jeder ist seine eigene Bridge) trennst du die Adressen mit Kommas.
Bleibt das Feld leer, sucht Gladys selbst nach Motion-Bridges im Netzwerk (eine Erkennungsanfrage auf UDP-Port 32100, die Gladys für die Integration sendet). Manche Bridges antworten nur der Multicast-Gruppe der Motion-App: Wird nichts gefunden, gib die Adresse ein.
Die übrigen Einstellungen
- Aktualisierungsintervall: wie oft Gladys den Zustand der Rollos liest (10 bis 60 Sekunden, Standard 30). Siehe „Wie der Zustand aktualisiert wird“.
- Steuerung von Garagentoren erlauben: standardmäßig aus (siehe unten).
- Sprache der Gerätenamen: Namen für neue Geräte und ihre Funktionen.
Starte dann Bridges und Rollos suchen: Die Aktion listet die gefundenen Bridges und ihre Rollos auf und prüft den Schlüssel mit einer Statusabfrage (nichts bewegt sich). Öffne den Tab Entdecken und füge deine Rollos hinzu.
Geräte
Ein Gerät pro Rollo, benannt nach seinem Typ in der Motion-App („Rollo 0001“, „Jalousie 0002“…): Benenne es in Gladys um. Vorhänge sind in der Kategorie Vorhang, alles andere in der Kategorie Rollladen.
Funktionen
| Funktion | Was sie tut |
|---|---|
| Öffnen / Schließen | Öffnen, stoppen, schließen. Zeigt offen oder geschlossen an den Enden, gestoppt dazwischen. |
| Position | 0 % = geschlossen, 100 % = offen, wie jeder Rollladen in Gladys. |
| Lamellenneigung | Jalousien, Shangri-La- und Vertikaljalousien, Doppelrollos: 100 % = Lamellen offen. |
| Position der oberen Schiene | Plissees oben/unten: die obere Schiene (die Position ist die untere Schiene). |
| Akku | Akkumotoren: der Ladestand, berechnet aus der Spannung des Akkus. |
| Lädt | Akkumotoren, die es melden (Solarpanel, Ladegerät). |
| Funksignal | Zwei-Wege-Motoren: das Funksignal zwischen Motor und Bridge, in dBm. |
Was ein Motor nicht sagen kann, wird nicht veröffentlicht: Ein Ein-Weg-Motor hat nur Öffnen / Schließen (er zeigt den letzten gesendeten Befehl), ein Motor, der nur seine Endlagen kennt, hat keine Position. Ist die Lamellenneigung eingestellt, behält eine neue Position sie bei, wie in der Motion-App.
Die Lamellenneigung ist ein zweiter Schieberegler, da Gladys keine Neigungsfunktion hat: In HomeKit erscheint sie als zweite Abdeckung mit ihrem Namen.
Garagentore und Rolltore
Ein Motion-WLAN-Garagentormotor und ein Rollo vom Typ „Rolltor“ öffnen das Haus. Standardmäßig werden sie nur lesbar veröffentlicht: Der Zustand wird angezeigt, aber weder Gladys noch eine Szene noch ein Sprachassistent kann sie bewegen. Schalte Steuerung von Garagentoren erlauben ein, um sie zu steuern, und nimm dann das Update an, das Gladys im Tab „Entdecken“ anbietet. Die Widget-Schaltflächen bewegen sie auch dann nie.
Widget
Motion-Rollos: alle zu Gladys hinzugefügten Motion-Rollos auf einer Karte, nach Namen sortiert, mit der Position jedes Rollos, einem Akku unter 20 % und den Rollos, die nicht mehr antworten. Die Schaltflächen wirken auf alle gleichzeitig:
- Alle öffnen und Alle schließen (mit Bestätigung);
- Alle stoppen.
Garagentore und Rolltore werden aufgelistet, aber von diesen Schaltflächen nie bewegt.
Szenenauslöser
Rollo außerhalb von Gladys bewegt: Ein Rollo hat seine Position ohne Befehl von Gladys geändert: über seine
Fernbedienung, die Motion-App, einen Motion-Zeitplan oder einen Sonnensensor. Filter: das Rollo und die Richtung
(Geöffnet, Geschlossen; leer für beides). Die Szene erhält die Richtung (opening, closing) und die neue Position in
%.
Eine Änderung wird beim nächsten Lesen erkannt (standardmäßig 30 s). Änderungen in den 3 Minuten nach einem Befehl von Gladys zählen als Gladys' eigene.
Szenenaktion
Lieblingsposition anfahren: Das Rollo fährt in die Lieblingsposition, die in seinem Motor gespeichert ist (vorher mit der Motion-Fernbedienung eingestellt). Öffnen, schließen, eine Position und eine Lamellenneigung sind die üblichen Gladys-Aktionen „Gerät steuern“.
Szenenbeispiele
- Bei Sonnenuntergang das Schlafzimmer schließen: Auslöser „Sonnenuntergang“, Aktion „Gerät steuern“ → Öffnen / Schließen des Schlafzimmerrollos auf „Schließen“.
- Sommerhitze: Steigt die Außentemperatur zwischen 12 und 17 Uhr über 28 °C, setze die Position der Südrollos auf 20 % und ihre Lamellenneigung auf 30 %.
- Manuelle Übersteuerung: Auslöser Rollo außerhalb von Gladys bewegt im Wohnzimmer, Richtung „Geöffnet“ → sende eine Nachricht „Wohnzimmerrollo von Hand geöffnet“ und lass deine automatischen Szenen das prüfen, bevor sie es wieder schließen.
- Aufwachen: um 7:30 Uhr an Wochentagen Lieblingsposition anfahren für das Schlafzimmerrollo.
- Akku: Wenn ein Akku unter 15 % fällt, sende eine Nachricht.
Wie der Zustand aktualisiert wird
Die Bridge sendet jede Änderung per Multicast, das nie den Container der Integration erreicht (Gladys führt ihn in einem privaten Docker-Netzwerk aus). Daher liest die Integration die Rollos selbst:
- in jedem Aktualisierungsintervall (standardmäßig 30 s) liest sie den Zustand, den die Bridge für jedes zu Gladys hinzugefügte Rollo speichert. Das kostet die Motoren nichts: kein Funkverkehr, die Bridge antwortet aus ihrem Speicher, der den Meldungen der Motoren selbst folgt;
- alle 15 Minuten fragt sie jeden Zwei-Wege-Motor per Funk nach seinem Zustand (Home Assistant tut es alle 10). Ein Akkumotor wacht dafür kurz auf;
- nach einem Befehl fragt sie den Motor alle 5 Sekunden (10 bei einem WLAN-Motor), bis er anhält, höchstens 2 Minuten.
Keine Cloud, kein Kontingent: Alles bleibt zwischen Gladys und der Bridge, eine Anfrage nach der anderen, wie die Bridge es erwartet. Gladys kann die Rollos ebenfalls abfragen; ein Rollo, das vor weniger als einem halben Intervall gelesen wurde, wird dann übersprungen.
Fehlerbehebung
- „Keine Motion-Bridge gefunden“: Gib die Adresse der Bridge in der Konfiguration ein. Prüfe, ob Gladys und die Bridge im selben Netzwerk sind und ob die Bridge in der Motion-App antwortet.
- „Die Motion-Bridge hat den Schlüssel abgelehnt“: Kopiere den Schlüssel erneut aus der Motion-App, mit Bindestrichen (16 Zeichen). Ein neues Motion-Konto ändert den Schlüssel.
- „Keine Motion-Bridge antwortet“: Die Bridge ist aus oder hat eine neue Adresse: Gib ihr eine feste Adresse in deinem Router.
- Ein Rollo fehlt: Kopple es in der Motion-App mit der Bridge und starte dann Bridges und Rollos suchen.
- Die Position hinkt hinterher: Eine Änderung mit der Fernbedienung erscheint beim nächsten Lesen; verkürze das Aktualisierungsintervall.
- Mehr Details: Setze
LOG_LEVEL=debugfür die Integration (die Protokolle zeigen nie den Schlüssel).
Einschränkungen
- Ohne die Hardware entwickelt: Die Details des Protokolls stammen aus der freien Bibliothek motionblinds und aus Home Assistant; ungetestete Rollotypen (Plissees oben/unten, Dreieck-Plissees, Doppelrollos, WLAN-Garagentore) brauchen vielleicht Korrekturen.
- Änderungen außerhalb von Gladys erscheinen beim nächsten Lesen, nicht sofort (kein Multicast im Container).
- Die automatische Erkennung findet vielleicht nicht jede Bridge: Die Adresse kann immer eingegeben werden.
- Ein Ein-Weg-Motor sagt nichts: Gladys zeigt den letzten gesendeten Befehl, nicht was das Rollo getan hat.
- Ein Plissee oben/unten: Öffnen / Schließen bewegt beide Schienen; die zwei Schieberegler bewegen je eine Schiene.
- Das WLAN-Signal der Bridge und die Endlagen-Einstellungen sind nicht verfügbar: Stelle sie in der Motion-App ein.
Hilfe
Fragen und Fehlermeldungen: github.com/guim31/gladys-motionblinds/issues oder das Forum der Gladys-Community. Gib bitte dein Bridge-Modell, die Rollotypen und die Protokolle der Integration an (sie enthalten nie den Schlüssel).
Konfigurationseinstellungen
Diese Einstellungen fragt Motionblinds in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Mit der Motion-Bridge verbinden | section | Nein | Gladys spricht mit deiner Motion-WLAN-Bridge in deinem Netzwerk, ohne Cloud. Dafür braucht es den Schlüssel der Motion-App: Öffne die App, tippe auf ⋮, Einstellungen, dann tippe fünfmal schnell auf die Seite „Über“. Der Schlüssel erscheint, 16 Zeichen mit Bindestrichen. |
| IP-Adresse der Motion-Bridge | string | Nein | Steht in deinem Router. Mehrere Bridges oder WLAN-Motoren: durch Kommas trennen. Bleibt das Feld leer, sucht Gladys die Bridge selbst. |
| Schlüssel der Motion-App | secret | Ja | 16 Zeichen, Bindestriche eingeschlossen, so wie die App ihn anzeigt. |
| Aktualisierungsintervall | select | Nein | Wie oft Gladys den Zustand liest, den die Bridge für jedes Rollo speichert, um Fernbedienung, Motion-App und Zeitpläne zu verfolgen. Das kostet die Motoren nichts. |
| Steuerung von Garagentoren erlauben | boolean | Nein | Aus: Garagentore und Rolltore werden ohne ihre Bedienelemente angezeigt, und das Widget bewegt sie nie. Diese Tore öffnen das Haus: Schalte es nur ein, wenn du es brauchst. |
| Sprache der Gerätenamen | select | Nein | Namen, die neuen Rollos und ihren Funktionen gegeben werden (Rollo, Position, Lamellenneigung…). |
So installierst du Motionblinds in Gladys
- Öffne in Gladys Integrationen: Motionblinds erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-motionblinds:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-motionblinds.
Motionblinds benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Motionblinds ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation