Si applica a: LOQED Touch e LOQED Pure.
Questa guida spiega l'integrazione Fibaro/Yubii per le serrature intelligenti LOQED. È destinato agli utenti avanzati che hanno dimestichezza con le integrazioni di rete locale.
La disponibilità delle funzionalità può dipendere dal bridge/gateway LOQED collegato e dal firmware del controller di terze parti. Alcuni screenshot più vecchi potrebbero ancora mostrare la denominazione dell'era Touch.
Quali funzionalità offre la serratura intelligente LOQED con Fibaro?
L'integrazione della serratura intelligente LOQED e Fibaro avviene tramite l'API del bridge locale.
Attualmente sono supportate le seguenti funzionalità:
Invia modifiche allo stato in tempo reale della serratura (aperto, sbloccato, serratura) e della batteria, Wi-Fi, Bluetooth al gateway Fibaro. Il livello della batteria, se inferiore al 5%, verrà visualizzato come esaurito.
Ricevi comandi dal gateway Fibaro per modificare lo stato di blocco (aperto, sbloccato, bloccato).
Lingua inglese, tedesca e olandese. Puoi aggiungere altre lingue aggiungendole tu stesso al codice sorgente.
Quando si utilizzano più blocchi LOQED, è sufficiente aggiungere un'istanza QuickApp aggiuntiva e configurarla con i dati corretti.
Attualmente questa QuickApp non può decodificare i dati JSON pubblicati dal bridge, poiché l'API FIBARO/Yubii/elero/zooz ignora semplicemente qualsiasi dato sconosciuto e accetta solo argomenti chiave JSON:[{}]. Pertanto non è possibile decodificare chi ha aperto/chiuso lo LOQED tramite App (o se è stato manualmente, con manopola).
Considerazione sulla sicurezza: il bridge LOQED invia qualsiasi modifica di stato (ad esempio "la porta è stata aperta") a Fibaro tramite una connessione HTTP non protetta nella rete Wi-Fi, ma con una firma digitale. Fibaro utilizza la firma digitale per garantire che il cambiamento di stato non venga inviato da qualcun altro oltre a LOQED Bridge (quindi, per garantire che nessuno possa far credere al dispositivo Fibaro che la porta si sia aperta, mentre in realtà non era così). Solo l'HC3 (non Yubii Home / HC3L) lo supporta. Tieni presente che ciò non influisce sull'apertura/chiusura della porta, riguarda solo le informazioni sullo stato.
Requisiti
Un gateway supportato, ad esempio:
Fibaro Centro casa 3 (nota che Home Center 2 non è supportato)
Installazione
Passaggio 1: crea la chiave API
Vai a https://app.loqed.com/API-Config e accedi con il tuo indirizzo e-mail e la password LOQED app (nota che verrai disconnesso da LOQED app). Fare clic sul pulsante "Strumento di configurazione API". Fai clic sul pulsante "Aggiungi nuova chiave API". Imposta un nome qualsiasi e crea la chiave API. È normale che la casella di controllo "Rimuovi sblocco/blocco" sia disattivata.
Dopo aver creato la chiave, fare clic sul pulsante "visualizza/modifica". Lascia aperta questa schermata.
Passaggio 2: installa la QuickApp Fibaro
Accedi al tuo gateway Fibaro. Se possiedi un dispositivo con marchio Fibaro, dovresti essere in grado di accedere a http://find.fibaro.com/per trovare l'indirizzo IP del tuo gateway.
Scarica il file dell'app rapida ed estrarre lo ZIP. Vai su "impostazioni" -> "Dispositivi" e fai clic sull'icona più per aggiungere un nuovo dispositivo. Successivamente, trova il dispositivo chiamato "Carica file" e carica il file dell'app rapida.
Passaggio 3: crea un utente sul gateway Fibaro
Crea un utente locale sul tuo gateway con autorizzazioni per l'app rapida LOQED. Si prega di non utilizzare caratteri speciali. Questo utente viene utilizzato per aggiornare il gateway delle modifiche dello stato di blocco non appena si verificano. Sebbene non sia consigliato, puoi anche saltare questo passaggio e utilizzare il nome utente e la password dell'amministratore (se non contengono caratteri speciali).
Passaggio 4: configura l'app rapida
Fare clic sulla scheda delle variabili.
Ora imposta le variabili sul valore corretto. Ogni valore può essere trovato su https://app.loqed.com/API-Config.
Variabile | Dove trovare il valore |
ponte_ip | LOQED Configurazione API -> "Webhook in uscita tramite LOQED Ponte" -> "Indirizzo IP" |
bridge_auth_key | LOQED Configurazione API -> "Webhook in uscita tramite LOQED Bridge" -> "Chiave di autenticazione (base64)" |
chiave | LOQED Configurazione API -> "Chiavi API (webhook in entrata)" -> "Chiave" |
lock_id | LOQED Configurazione API -> "Chiavi API (webhook in entrata)" -> "ID blocco" |
local_key_id | LOQED Configurazione API -> "Chiavi API (webhook in entrata)" -> "ID chiave locale" |
aggiornamento_time (predefinito 600) | La frequenza con cui (in secondi) l'app rapida eseguirà il polling per verificare la modifica dello stato di blocco. Si consiglia di mantenere questo valore basso. In realtà è necessario eseguire il polling solo dopo l'avvio del gateway, poiché qualsiasi modifica dello stato di blocco viene inviata direttamente al gateway. Le informazioni sulla batteria e sullo stato online vengono ricevute solo tramite polling, sebbene il bridge LOQED supporti l'invio. |
extra_errori (default 0) | Imposta su 1 per visualizzare le informazioni HTTP. |
utente_webhook | Utilizza il nome utente del passaggio 3. |
webhook_pass | Utilizzare la password del passaggio 3. Nota: devi eliminare questo campo "segreto", quindi crearlo nuovamente, assegnandogli nuovamente il nome "webhook_pass". |
home_center_ip | Imposta qui l'indirizzo IP del tuo gateway. Non utilizzare un IP di loopback (127.0.0.1), ma l'indirizzo IP della rete locale. |
use_webhooks (predefinito 1) | Se impostato su 1, tutte le funzioni Quick App (relative ai webhook) sono abilitate utilizzando l'utente/password creato. Impostalo su 0 se desideri invece utilizzare loop / poll (vedi refresh_time sopra). |
Passaggio 5: crea webhook sul bridge LOQED
Il bridge LOQED può inviare qualsiasi cambiamento di stato della serratura al tuo gateway non appena si verifica. Per questo è necessario impostare alcuni URL su LOQED Bridge. Ci sono due modi per farlo:
Se hai un Fibaro Home Center 3, puoi farlo semplicemente facendo clic su un pulsante.
Questi pulsanti non sono disponibili sui gateway Home Center 3 Lite, Yubii Home né Z-Box, a causa della mancanza del supporto per i numeri in virgola mobile a 53 bit nell'ambiente LUA CPU a 32 bit (come utilizzato da questi gateway).Altrimenti, devi farlo manualmente.
Passaggio 5a: crea webhook se hai Fibaro Home Center 3
Vai alla scheda "Modifica e anteprima". Fare clic sul pulsante "Crea webhook".
Puoi verificare che l'azione sia andata a buon fine andando su https://app.loqed.com/API-Config --> "Webhook in uscita tramite LOQED Bridge" --> fai clic sul pulsante "Aggiungi/elimina webhook". In quella pagina dovresti vedere più voci con un URL al tuo gateway.
Nota: se clicchi per errore più volte sul pulsante, non preoccuparti, in quanto il bridge non creerà webhook duplicati.
Questa QuickApp genererà solo webhook per eventi "aperto", "latch", "blocco notturno" e "sconosciuto", poiché normalmente sono sufficienti per la maggior parte degli utenti. Per impostazione predefinita, gli eventi di stato della batteria o online vengono interrogati ogni 10 minuti.
Passaggio 5b: crea webhook manualmente (se non disponi di Fibaro Home Center 3)
Salta questo passaggio se hai già eseguito il passaggio 5a.
È necessario creare 4 webhook su LOQED Bridge per informare il gateway sui 4 diversi stati di blocco.
Vai a https://app.loqed.com/API-Config--> "Webhook in uscita tramite LOQED Bridge" --> fai clic sul pulsante "Aggiungi/elimina webhook". In quella pagina, aggiungi i seguenti URL:
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookNightLock (solo per il grilletto del blocco notturno)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookDayLock (solo per il grilletto)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookOpen (solo per il trigger aperto)
http://gw_user:gw_password@gw_ip/api/devices/QAID/action/webhookUnknown (solo per l'attivazione dello stato sconosciuto)
Sopra, "gw_user" e "gw_password" sono il nome utente e la password del gateway creati nel passaggio 3, "gw_ip" è l'IP del gateway, "QAID" è l'ID dispositivo della QuickApp, che può essere trovato nell'elenco dei dispositivi (vedi immagine sotto dove è 22)
Fatto
Questo è tutto! Ora puoi controllare il tuo LOQED Touch utilizzando Fibaro.
Grazie a
Mille grazie a "tinman". Per domande e segnalazioni di bug è possibile contattare Tinman tramite il forum Fibaro o il marketplace Fibaro.