Geldt voor: LOQED Touch en LOQED Pure.
In deze handleiding wordt de Fibaro/Yubii-integratie voor LOQED slimme sloten uitgelegd. Het is bedoeld voor geavanceerde gebruikers die vertrouwd zijn met lokale netwerkintegraties.
De beschikbaarheid van functies kan afhankelijk zijn van de aangesloten LOQED bridge/gateway en de controllerfirmware van derden. Sommige oudere schermafbeeldingen laten mogelijk nog steeds de naam uit het Touch-tijdperk zien.
Welke functies biedt het slimme slot LOQED met Fibaro?
De LOQED smart lock & Fibaro-integratie gebeurt via de lokale bridge-API.
Momenteel worden de volgende functionaliteiten ondersteund:
Stuur realtime statuswijzigingen van het slot (openen, ontgrendelen, vergrendelen) en batterij, Wi-Fi, Bluetooth-status naar de Fibaro-gateway. Als het batterijniveau lager is dan 5%, wordt de QuickApp als leeg weergegeven.
Ontvang opdrachten van de Fibaro-gateway om de vergrendelingsstatus te wijzigen (openen, ontgrendelen, vergrendelen).
Engelse, Duitse en Nederlandse taal. U kunt extra talen toevoegen door deze zelf aan de broncode toe te voegen.
Wanneer u meerdere LOQED-sloten gebruikt, voegt u eenvoudig een extra QuickApp-instantie toe en stelt u deze in met de juiste gegevens.
Momenteel kan deze QuickApp geen json-gegevens decoderen die door de bridge zijn gepost, omdat de FIBARO/Yubii/elero/zooz API eenvoudigweg alle onbekende gegevens negeert en alleen JSON-sleutelargumenten accepteert:[{}]. Daarom kan men niet decoderen wie de LOQED via de app heeft geopend/gesloten (of als dit handmatig was, met de knop).
Beveiligingsoverweging: de LOQED-bridge verzendt elke statuswijziging (bijvoorbeeld "de deur is geopend") naar Fibaro via een onbeveiligde HTTP-verbinding in uw Wi-Fi-netwerk, maar met een digitale handtekening. Fibaro gebruikt de digitale handtekening om ervoor te zorgen dat de statuswijziging niet door iemand anders dan de LOQED Bridge wordt verzonden (dus om ervoor te zorgen dat niemand het Fibaro-apparaat kan laten denken dat de deur open is gegaan, terwijl dat in werkelijkheid niet het geval was). Alleen de HC3 (niet de Yubii Home / HC3L) ondersteunt dit. Let op: dit heeft geen invloed op het openen/vergrendelen van de deur, het gaat alleen om de statusinformatie.
Vereisten
Een ondersteunde gateway, zoals:
Fibaro Thuiscentrum 3 (merk op dat het Home Center 2 niet wordt ondersteund)
Installatie
Stap 1: maak een API-sleutel aan
Ga naar https://app.loqed.com/API-Config en log in met uw LOQED app e-mailadres en wachtwoord (houd er rekening mee dat u wordt afgemeld bij de LOQED app). Klik op de knop “API-configuratietool”. Klik op de knop ‘Nieuwe API-sleutel toevoegen’. Stel een naam in en maak de API-sleutel. Het is normaal dat het selectievakje 'Ontgrendelen/vergrendelen verwijderen' grijs is.
Nadat de sleutel is aangemaakt, klikt u op de knop "bekijken/bewerken". Laat dit scherm open.
Stap 2: installeer de Fibaro QuickApp
Log in op uw Fibaro-gateway. Als u een apparaat van het merk Fibaro heeft, zou u naar http://find.fibaro.com/om het IP-adres van uw gateway te vinden.
Download het Quick App-bestand en pak de ZIP uit. Ga naar "instellingen" -> "Apparaten" en klik op het plus-icoon om een nieuw apparaat toe te voegen. Zoek vervolgens het apparaat met de naam "Bestand uploaden" en upload het Quick App-bestand.
Stap 3: Maak een gebruiker aan op de Fibaro-gateway
Maak een lokale gebruiker op uw gateway met machtigingen voor de LOQED Quick App. Gebruik alstublieft geen speciale tekens. Deze gebruiker wordt gebruikt om de gateway op de hoogte te stellen van wijzigingen in de slotstatus zodra deze zich voordoen. Hoewel dit niet wordt aanbevolen, kunt u deze stap ook overslaan en uw beheerdersgebruikersnaam en -wachtwoord gebruiken (als deze geen speciale tekens bevatten).
Stap 4: configureer de Snelle App
Klik op het tabblad Variabelen.
Stel nu de variabelen in op de juiste waarde. Elke waarde is te vinden op https://app.loqed.com/API-Config.
Variabel | Waar de waarde te vinden |
brug_ip | LOQED API-configuratie -> "Uitgaande webhooks via LOQED Brug" -> "IP-adres" |
bridge_auth_key | LOQED API-configuratie -> "Uitgaande webhooks via LOQED Bridge" -> "Authenticatiesleutel (base64)" |
sleutel | LOQED API-configuratie -> "API-sleutels (inkomende webhooks)" -> "Sleutel" |
lock_id | LOQED API-configuratie -> "API-sleutels (inkomende webhooks)" -> "Vergrendel-ID" |
lokale_sleutel_id | LOQED API-configuratie -> "API-sleutels (inkomende webhooks)" -> "Lokale sleutel-ID" |
ververstijd (standaard 600) | Hoe vaak (in seconden) de Quick App zal peilen naar een wijziging in de slotstatus. Wij adviseren deze waarde laag te houden. Het is eigenlijk alleen nodig om te pollen nadat de gateway is opgestart, omdat elke wijziging in de slotstatus rechtstreeks naar de gateway wordt verzonden. Batterij- en onlinestatusinformatie wordt alleen ontvangen via polling, hoewel de LOQED-bridge het verzenden ervan ondersteunt. |
extra_errors (standaard 0) | Stel in op 1 om HTTP-informatie te zien. |
webhook_gebruiker | Gebruik de gebruikersnaam uit stap 3. |
webhook_pass | Gebruik het wachtwoord uit stap 3. Let op: u moet dit "geheime" veld verwijderen en vervolgens opnieuw aanmaken, waarbij u het opnieuw de naam "webhook_pass" geeft. |
home_center_ip | Stel hier het IP-adres van uw gateway in. Gebruik geen loopback IP (127.0.0.1), maar het IP-adres van het lokale netwerk. |
use_webhooks (standaard 1) | Wanneer ingesteld op 1, worden alle Quick App-functies (gerelateerd aan webhooks) ingeschakeld met behulp van de gebruiker/wachtwoord die u heeft aangemaakt. Stel dit in op 0 als u in plaats daarvan loop / poll wilt gebruiken (zie refresh_time hierboven). |
Stap 5: maak webhooks op de LOQED-bridge
De LOQED-bridge kan elke statuswijziging van het slot naar uw gateway sturen zodra deze plaatsvindt. Hiervoor moet u enkele URL's instellen op de LOQED Bridge. Er zijn twee manieren om dit te doen:
Als je een Fibaro Home Center 3 hebt, kun je dit doen door gewoon op een knop te klikken.
Deze knoppen zijn niet beschikbaar op Home Center 3 Lite, Yubii Home of Z-Box-gateways, vanwege ontbrekende ondersteuning voor 53-bit drijvende-kommagetallen in een 32-bit CPU LUA-omgeving (zoals gebruikt door deze gateways).Anders moet u dit handmatig doen.
Stap 5a: maak webhooks als je Fibaro Home Center 3 hebt
Ga naar het tabblad 'Bewerken en voorbeeld'. Klik op de knop ‘Webhooks maken’.
U kunt controleren of de actie succesvol was door naar te gaan https://app.loqed.com/API-Config --> "Uitgaande webhooks via LOQED Bridge" --> klik op de knop "Webhooks toevoegen/verwijderen". Op die pagina zou u meerdere vermeldingen moeten zien met een URL naar uw gateway.
Let op: als u per ongeluk meerdere keren op de knop klikt, hoeft u zich geen zorgen te maken, aangezien de bridge geen dubbele webhooks zal creëren.
Deze QuickApp genereert alleen webhooks voor "open", "latch", "nachtslot" en "onbekende" gebeurtenissen, aangezien deze normaal gesproken voldoende zijn voor de meeste gebruikers. Batterij- of onlinestatusgebeurtenissen worden standaard elke 10 minuten opgevraagd.
Stap 5b: webhooks handmatig aanmaken (als je geen Fibaro Home Center 3 hebt)
Sla deze stap over als u stap 5a heeft gedaan.
U moet 4 webhooks op de LOQED Bridge maken om de gateway te informeren over de 4 verschillende slotstatussen.
Ga naar https://app.loqed.com/API-Config--> "Uitgaande webhooks via LOQED Bridge" --> klik op de knop "Webhooks toevoegen/verwijderen". Voeg op die pagina de volgende URL's toe:
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookNightLock (alleen voor de nachtslottrigger)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookDayLock (alleen voor de grendeltrigger)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookOpen (alleen voor de open trigger)
http://gw_user:gw_password@gw_ip/api/devices/QAID/action/webhookUnknown (alleen voor de onbekende statustrigger)
Hierboven zijn "gw_user" en "gw_password" de gebruikersnaam en het wachtwoord van uw gateway, aangemaakt in stap 3, "gw_ip" is het IP-adres van de gateway, "QAID" is de apparaat-ID van de QuickApp, die u kunt vinden in de apparatenlijst (zie onderstaande afbeelding waar deze staat 22)
Klaar
Dat is het! U kunt uw LOQED Touch nu bedienen met Fibaro.
Dankzij
Veel dank aan "tinman". Voor vragen en bugrapporten kan contact worden opgenomen met Tinman via het Fibaro-forum of de Fibaro-marktplaats.