Dooya Connector Smart-Home-Integration, kostenlos und Open Source
Steuere Rollos, Rollläden und Vorhänge eines Dooya-Connector-Gateways, lokal.
Veröffentlicht von prohand
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Diese Integration steuert aus Gladys die Motoren, die mit einem Dooya Connector gekoppelt sind: Rollos, Rollläden, Jalousien, Markisen, Tore und Vorhänge. Dasselbe Gateway wird unter anderen Marken verkauft (Brel, Bloc Blinds, Coulisse Motion, Smart Blinds…): Wenn deine Motoren in der App Connector gekoppelt sind, spricht diese Integration mit ihnen.
Alles läuft in deinem lokalen Netzwerk: Gladys spricht mit dem Gateway über UDP-Port 32100. Es wird kein Cloud-Konto verwendet, und nichts verlässt dein Zuhause.
Bevor du anfängst
- Das Gateway ist in der App Connector eingerichtet und deine Motoren sind damit gekoppelt. Gib jedem Motor in der App seinen Typ (Rollo, Vorhang, Jalousie…): Gladys wählt damit die passende Karte.
- Das Gateway hat eine feste IP-Adresse: Reserviere sie in deinem Router (DHCP-Reservierung). Die Integration erreicht es unter dieser Adresse; ändert sie sich, verliert Gladys das Gateway.
- Gladys und das Gateway sind im selben Netzwerk.
Den Schlüssel holen
Das Gateway nimmt nur Befehle an, die seinen Schlüssel (16 Zeichen) mitbringen:
- Öffne die App Connector.
- Gehe zu Einstellungen (oder Ich), dann Über.
- Tippe fünfmal schnell auf den Bildschirm: Der Schlüssel erscheint, zum Beispiel
12ab345c-d67e-8f.
Übernimm ihn genau, mit Bindestrichen: Sie gehören zu den 16 Zeichen.
Die IP-Adresse herausfinden
- In der Connector-App zeigen die Details des Gateways oft seine IP-Adresse;
- sonst in der Liste der mit deinem Router verbundenen Geräte;
- oder drücke in der Konfiguration der Integration auf Gateway suchen (siehe unten).
Konfiguration
| Feld | Was einzutragen ist |
|---|---|
| IP-Adresse des Gateways | Die IPv4-Adresse des Gateways, z. B. 192.168.1.50. |
| Schlüssel der Connector-App | Der 16-stellige Schlüssel (siehe oben). Wird nie in die Protokolle geschrieben. |
| Aktualisierungsintervall (s) | Wie oft der Zustand jedes Motors gelesen wird, 30 bis 3600 Sekunden (Standard 60). |
| Schwelle für schwachen Akku (%) | Unter diesem Wert löst der Szenenauslöser battery_low aus (Standard 20 %). |
Speichere und drücke dann Verbindung testen: Die Antwort nennt die Adresse des Gateways, die Zahl der Motoren, die Firmware und das WLAN-Signal und bestätigt, dass der Schlüssel akzeptiert wird.
Die Motoren hinzufügen
Öffne den Reiter Erkennung der Integration: Jeder Motor des Gateways ist dort aufgeführt. Füge die gewünschten hinzu und benenne sie um (das Gateway kennt keine Namen: Ein Motor erscheint zuerst als „Roller blind 0001“, mit den letzten Ziffern seiner Adresse).
Was jeder Motor zeigt
| Funktion | Wann | Werte |
|---|---|---|
| Zustand | immer | öffnen / stopp / schließen |
| Position | der Motor meldet seine Position | 0 % (geschlossen) bis 100 % (offen) |
| Akku | Akkumotor | 0 bis 100 % |
Ein Top-Down-Bottom-Up-Rollo hat zwei Schienen, also zwei Zustände und zwei Positionen: „top“ (oben) und „bottom“ (unten).
Ein Einweg-Funkmotor nimmt nur Befehle an: Er hat keine Position, und Gladys zeigt den zuletzt gesendeten Befehl.
Wie der Zustand aktuell bleibt
Das Gateway hält den letzten Zustand jedes Motors im Speicher. Gladys liest ihn im Aktualisierungsintervall: Das kostet weder Funkverkehr noch Akku. Nach einem Befehl von Gladys wird der Motor alle 2 Sekunden verfolgt, bis er anhält: Die Position folgt der Bewegung.
Ein Motor, der über seine Fernbedienung, die App oder einen Wandschalter bewegt wurde, wird beim nächsten Lesen erkannt.
Das Abzeichen jedes Motors zeigt lokal, solange das Gateway antwortet, sonst nicht erreichbar.
Aktionen
In der Konfiguration der Integration:
- Verbindung testen: prüft Adresse und Schlüssel und fasst zusammen, was das Gateway meldet.
- Gateway suchen: Gladys sendet eine Suchanfrage in dein Netzwerk und listet die Gateways auf, die antworten, mit ihrer IP-Adresse. Manche Gateways antworten nur ihrer eigenen Multicast-Gruppe und bleiben stumm: Lies die Adresse dann in deinem Router ab.
- Motor identifizieren: Der gewählte Motor fährt einen kleinen Schritt hoch und wieder zurück. Praktisch, um zu wissen, welches Rollo welches ist.
Szenen (Gladys 5.1+)
Szenenauslöser
| Auslöser | Schlüssel | Filter | Variablen |
|---|---|---|---|
| Ein Rollo hat sich ohne Gladys bewegt | moved_outside_gladys | Motor, Richtung | device_name, direction, position |
| Der Akku eines Motors ist schwach | battery_low | Motor | device_name, battery |
| Die Verbindung zum Gateway hat sich geändert | hub_connection_changed | verloren / wiederhergestellt | status |
moved_outside_gladyslöst aus, wenn ein Motor an einer neuen Position stehen bleibt, nachdem eine Fernbedienung, die Connector-App oder ein Wandschalter ihn bewegt hat. Eine von Gladys befohlene Bewegung löst es nie aus (2 Minuten lang nach dem Befehl): Eine Szene kann keine Schleife bilden.battery_lowlöst einmal aus, wenn der Akku unter die Schwelle fällt, und erst nach dem Laden wieder.hub_connection_changedlöst aus, wenn das Gateway nicht mehr antwortet (lost) und wenn es wieder antwortet (restored).
Verwende die Variablen in den folgenden Aktionen, z. B.
{{triggerEvent.data.device_name}}.
Szenenaktionen
| Aktion | Schlüssel | Parameter |
|---|---|---|
| Lieblingsposition anfahren | favorite_position | Motor |
| Einen Schritt fahren | jog | Motor, hoch oder runter |
| Lamellen neigen | set_tilt | Motor, Winkel 0 bis 180° |
| Alle Rollos bewegen | move_all | öffnen, schließen oder stoppen |
move_all gibt den folgenden Aktionen zwei Ergebnisse: sent (erreichte Motoren) und
failed (Motoren ohne Antwort).
Um einen einzelnen Motor zu öffnen, zu schließen oder zu positionieren, nutze die Standardaktion von Gladys „Geräte steuern“ auf seinem Zustand oder seiner Position.
Widget „Dooya Connector“
Füge es einem Dashboard hinzu: Es zeigt die Position der ersten vier Motoren (live), den Status des Gateways (verbunden oder nicht, Zahl der Motoren, WLAN-Signal, Firmware), die Motoren mit schwachem Akku und drei Schaltflächen: Alle öffnen, Alle schließen (mit Bestätigung) und Alle stoppen.
Gut zu wissen
- Das Gateway zählt die Positionen von oben (0 = offen), Gladys von unten (100 = offen). Die Integration rechnet um: Du siehst nur die Gladys-Richtung.
- Die Lieblingsposition ist die im Motor gespeicherte (mit seiner Fernbedienung oder der App).
- Die Integration liest den Speicher des Gateways: Ein Motor, der die Funkverbindung zum Gateway verloren hat, behält seinen letzten bekannten Zustand.
Fehlerbehebung
| Symptom | Was zu prüfen ist |
|---|---|
| „Keine Antwort von … auf UDP-Port 32100“ | Die IP-Adresse, ob das Gateway eingeschaltet und im selben Netzwerk wie Gladys ist und ob keine Firewall UDP 32100 blockiert. |
| „Der Schlüssel muss genau 16 Zeichen lang sein“ | Kopiere den Schlüssel erneut, mit Bindestrichen, ohne Leerzeichen. |
| „Das Gateway antwortet, lehnt aber den Schlüssel ab“ | Der Schlüssel gehört zu einem anderen Gateway oder wurde falsch eingegeben: Kopiere ihn erneut aus der App. |
| Kein Motor im Reiter Erkennung | Die Motoren müssen zuerst in der Connector-App gekoppelt werden. |
| Die Position bewegt sich nicht | Einweg-Motoren melden sie nicht; bei den anderen prüfe den Motor in der Connector-App. |
| „Gateway suchen“ findet nichts | Bei manchen Gateways normal: Trage die im Router abgelesene Adresse ein. |
Die Protokolle der Integration in Gladys zeigen, wann das Gateway nicht mehr antwortet und warum ein Befehl fehlgeschlagen ist. Der Schlüssel und die Tokens werden dort nie geschrieben.
Konfigurationseinstellungen
Diese Einstellungen fragt Dooya Connector in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Die Integration spricht mit dem Connector-Gateway in deinem Netzwerk (UDP-Port 32100): Es wird kein Cloud-Konto verwendet. Sie braucht zwei Dinge: die IP-Adresse des Gateways und den 16-stelligen Schlüssel, den die Connector-App anzeigt (Einstellungen, Über, fünfmal auf den Bildschirm tippen). Die in der App gekoppelten Motoren erscheinen dann im Reiter Erkennung. |
| IP-Adresse des Gateways | string | Ja | Die IPv4-Adresse des Connector-Gateways in deinem Netzwerk. Gib ihm im Router eine feste Adresse. Unbekannt? Probiere die Schaltfläche „Gateway suchen“. |
| Schlüssel der Connector-App | secret | Ja | 16 Zeichen, Bindestriche inklusive. In der Connector-App: Einstellungen, Über, fünfmal auf den Bildschirm tippen. Er wird nie in die Protokolle geschrieben. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft der Zustand jedes Motors beim Gateway gelesen wird, in Sekunden. Das Gateway antwortet aus dem Speicher: kein Funkverkehr, kein Akkuverbrauch. Nach einem Befehl wird der Motor alle 2 Sekunden verfolgt, bis er anhält. |
| Schwelle für schwachen Akku (%) | number | Nein | Unter diesem Wert löst der Szenenauslöser „Akku schwach“ aus, einmal pro Motor. |
So installierst du Dooya Connector in Gladys
- Öffne in Gladys Integrationen: Dooya Connector erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-dooyaconnector:0.1.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/prohand/gladys-dooyaconnector.
Dooya Connector 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
Dooya Connector 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 prohand 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