Gilt für: LOQED Touch und LOQED Pure.

In dieser Anleitung wird die Fibaro/Yubii-Integration für LOQED-Smart-Schlösser erläutert. Es ist für fortgeschrittene Benutzer gedacht, die mit lokalen Netzwerkintegrationen vertraut sind.

Die Verfügbarkeit der Funktionen kann von der angeschlossenen LOQED-Bridge/Gateway und der Controller-Firmware eines Drittanbieters abhängen. Einige ältere Screenshots zeigen möglicherweise noch Namen aus der Touch-Ära.

Welche Funktionen bietet das Smart Lock LOQED mit Fibaro?

Die Integration des LOQED Smart Lock und der Fibaro erfolgt über die lokale Bridge-API.

Derzeit werden folgende Funktionalitäten unterstützt:

Senden Sie Echtzeit-Statusänderungen des Schlosses (offen, entriegelt, verriegelt) und des Batterie-, Wi-Fi-, Bluetooth-Status an das Fibaro-Gateway. Wenn der Akkuladestand unter 5 % liegt, wird die QuickApp als leer angezeigt.
Empfangen Sie Befehle vom Fibaro-Gateway, um den Sperrstatus zu ändern (offen, entsperrt, gesperrt).
Englische, deutsche und niederländische Sprache. Sie können weitere Sprachen hinzufügen, indem Sie diese selbst zum Quellcode hinzufügen.
Wenn Sie mehrere LOQED-Sperren verwenden, fügen Sie einfach eine zusätzliche QuickApp-Instanz hinzu und richten Sie sie mit den richtigen Daten ein.
Derzeit kann diese QuickApp keine von der Bridge geposteten JSON-Daten dekodieren, da die API FIBARO/Yubii/elero/zooz einfach alle unbekannten Daten ignoriert und nur JSON-Schlüsselargumente akzeptiert:[{}]. Daher lässt sich nicht entschlüsseln, wer den LOQED per App geöffnet/geschlossen hat (oder, falls manuell, mit dem Knopf).
Sicherheitsaspekt: Die LOQED-Brücke sendet jede Statusänderung (z. B. „die Tür wurde geöffnet“) über eine unsichere HTTP-Verbindung in Ihrem Wi-Fi-Netzwerk an Fibaro, jedoch mit einer digitalen Signatur. Fibaro verwendet die digitale Signatur, um sicherzustellen, dass die Statusänderung nicht von jemand anderem als LOQED Bridge gesendet wird (um sicherzustellen, dass niemand das Fibaro-Gerät glauben lassen kann, die Tür sei geöffnet, obwohl dies tatsächlich nicht der Fall war). Nur der HC3 (nicht der Yubii Home / HC3L) unterstützt dies. Beachten Sie, dass sich dies nicht auf das Öffnen/Verriegeln der Tür auswirkt, sondern lediglich die Statusinformationen betrifft.

Anforderungen

Ein unterstütztes Gateway, wie zum Beispiel:
- Fibaro Home Center 3 (Beachten Sie, dass das Home Center 2 nicht unterstützt wird)
- Fibaro Home Center 3 Lite
- Yubii Startseite
- elero Yubii Startseite
- zooz Z-Box Hub

Installation

Schritt 1: API-Schlüssel erstellen

Gehe zu https://app.loqed.com/API-Config und melden Sie sich mit Ihrer LOQED app-E-Mail-Adresse und Ihrem Passwort an (beachten Sie, dass Sie vom LOQED app abgemeldet werden). Klicken Sie auf die Schaltfläche „API-Konfigurationstool“. Klicken Sie auf die Schaltfläche „Neuen API-Schlüssel hinzufügen“. Legen Sie einen beliebigen Namen fest und erstellen Sie den API-Schlüssel. Es ist normal, dass das Kontrollkästchen „Entriegelung/Sperrung entfernen“ ausgegraut ist.

Nachdem der Schlüssel erstellt wurde, klicken Sie auf die Schaltfläche „Anzeigen/Bearbeiten“. Lassen Sie diesen Bildschirm geöffnet.

Schritt 2: Installieren Sie die Fibaro QuickApp

Melden Sie sich bei Ihrem Fibaro-Gateway an. Wenn Sie ein Gerät der Marke Fibaro haben, sollten Sie zu gehen können http://find.fibaro.com/um die IP-Adresse Ihres Gateways zu finden.

Laden Sie die Quick App-Datei herunter und extrahieren Sie die ZIP-Datei. Gehen Sie zu „Einstellungen“ -> „Geräte“ und klicken Sie auf das Plus-Symbol, um ein neues Gerät hinzuzufügen. Suchen Sie als Nächstes das Gerät mit der Bezeichnung „Datei hochladen“ und laden Sie die Quick App-Datei hoch.

Schritt 3: Erstellen Sie einen Benutzer auf dem Fibaro-Gateway

Erstellen Sie auf Ihrem Gateway einen lokalen Benutzer mit Berechtigungen für die LOQED Quick App. Bitte verwenden Sie keine Sonderzeichen. Dieser Benutzer wird verwendet, um das Gateway über Änderungen des Sperrstatus zu aktualisieren, sobald diese auftreten. Obwohl dies nicht empfohlen wird, können Sie diesen Schritt auch überspringen und Ihren Administrator-Benutzernamen und Ihr Administratorkennwort verwenden (sofern diese keine Sonderzeichen enthalten).

Schritt 4: Konfigurieren Sie die Quick App

Klicken Sie auf die Registerkarte Variablen.

Stellen Sie nun die Variablen auf den richtigen Wert ein. Jeder Wert kann auf gefunden werden https://app.loqed.com/API-Config.

Variabel	Wo finde ich den Wert?
Bridge_ip	LOQED API-Konfiguration -> „Ausgehende Webhooks über LOQED Brücke" -> "IP-Adresse"
Bridge_auth_key	LOQED API-Konfiguration -> „Ausgehende Webhooks über LOQED Bridge“ -> „Authentifizierungsschlüssel (base64)“
Schlüssel	LOQED API-Konfiguration -> „API-Schlüssel (eingehende Webhooks)“ -> „Schlüssel“
lock_id	LOQED API-Konfiguration -> „API-Schlüssel (eingehende Webhooks)“ -> „Sperr-ID“ Sie können auch einen beliebigen Namen verwenden, dieser dient lediglich der Identifizierung des Schlosses.
local_key_id	LOQED API-Konfiguration -> „API-Schlüssel (eingehende Webhooks)“ -> „Lokale Schlüssel-ID“
Refresh_time (Standard 600)	Wie oft (in Sekunden) die Quick App nach einer Änderung des Sperrstatus fragt. Wir empfehlen, diesen Wert niedrig zu halten. Eigentlich ist eine Abfrage erst nach dem Gateway-Start erforderlich, da jede Änderung des Sperrstatus direkt an das Gateway gesendet wird. Batterie- und Online-Statusinformationen werden nur per Abfrage empfangen, obwohl die LOQED-Brücke das Senden dieser Informationen unterstützt.
extra_errors (Standard 0)	Auf 1 setzen, um HTTP-Informationen anzuzeigen.
webhook_user	Verwenden Sie den Benutzernamen aus Schritt 3.
webhook_pass	Verwenden Sie das Passwort aus Schritt 3. Hinweis: Sie müssen dieses „geheime“ Feld löschen und es dann erneut erstellen und ihm erneut den Namen „webhook_pass“ geben.
home_center_ip	Stellen Sie hier die IP-Adresse Ihres Gateways ein. Verwenden Sie keine Loopback-IP (127.0.0.1), sondern die lokale Netzwerk-IP-Adresse.
use_webhooks (Standard 1)	Bei der Einstellung 1 werden alle Quick App-Funktionen (im Zusammenhang mit Webhooks) mit dem von Ihnen erstellten Benutzer/Passwort aktiviert. Setzen Sie es auf 0, wenn Sie stattdessen Schleife/Abfrage verwenden möchten (siehe „refresh_time“ oben).

Schritt 5: Webhooks auf der LOQED-Bridge erstellen

Die LOQED-Bridge kann jede Statusänderung des Schlosses an Ihr Gateway senden, sobald sie auftritt. Dazu müssen Sie einige URLs auf dem LOQED Bridge festlegen. Hierzu gibt es zwei Möglichkeiten:

Wenn Sie über ein Fibaro Home Center 3 verfügen, können Sie dies tun, indem Sie einfach auf eine Schaltfläche klicken.
Diese Schaltflächen sind auf den Gateways Home Center 3 Lite, Yubii Home und Z-Box nicht verfügbar, da die Unterstützung für 53-Bit-Gleitkommazahlen in der 32-Bit-CPU-LUA-Umgebung (wie sie von diesen Gateways verwendet wird) fehlt.
Andernfalls müssen Sie dies manuell tun.

Schritt 5a: Erstellen Sie Webhooks, wenn Sie Fibaro Home Center 3 haben

Gehen Sie zur Registerkarte „Bearbeiten & Vorschau“. Klicken Sie auf die Schaltfläche „Webhooks erstellen“.

Sie können überprüfen, ob die Aktion erfolgreich war, indem Sie auf gehen https://app.loqed.com/API-Config --> "Ausgehende Webhooks über LOQED Bridge" --> klicken Sie auf die Schaltfläche "Webhooks hinzufügen/löschen". Auf dieser Seite sollten mehrere Einträge mit einer URL zu Ihrem Gateway angezeigt werden.

Hinweis: Machen Sie sich keine Sorgen, wenn Sie versehentlich mehrmals auf die Schaltfläche klicken, da die Bridge keine doppelten Webhooks erstellt.

Diese QuickApp generiert nur Webhooks für die Ereignisse „offen“, „latch“, „Nachtsperre“ und „unbekannt“, da diese für die meisten Benutzer normalerweise ausreichend sind. Batterie- oder Online-Statusereignisse werden standardmäßig alle 10 Minuten abgefragt.

Schritt 5b: Webhooks manuell erstellen (falls Sie kein Fibaro Home Center 3 haben)

Überspringen Sie diesen Schritt, wenn Sie Schritt 5a durchgeführt haben.

Sie müssen 4 Webhooks auf dem LOQED Bridge erstellen, um das Gateway über die 4 verschiedenen Sperrstatus zu informieren.

Gehe zu https://app.loqed.com/API-Config--> "Ausgehende Webhooks über LOQED Bridge" --> klicken Sie auf die Schaltfläche "Webhooks hinzufügen/löschen". Fügen Sie auf dieser Seite die folgenden URLs hinzu:

http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookNightLock (nur für den Nachtsperrauslöser)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookDayLock (Nur für den Latch-Trigger)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookOpen (Nur für den offenen Abzug)
http://gw_user:gw_password@gw_ip/api/devices/QAID/action/webhookUnknown (nur für den unbekannten Statusauslöser)

Oben sind „gw_user“ und „gw_password“ der Benutzername und das Passwort Ihres Gateways, die in Schritt 3 erstellt wurden, „gw_ip“ ist die IP des Gateways, „QAID“ ist die Geräte-ID der QuickApp, die in der Geräteliste zu finden ist (siehe Abbildung unten, dort ist sie 22).