Si applica a: LOQED Touch e LOQED Pure.
Questa guida spiega come integrare una serratura intelligente LOQED con Loxone. È destinato agli utenti avanzati di casa intelligente.
Alcuni screenshot e modelli meno recenti potrebbero ancora menzionare LOQED Touch o una dicitura specifica di Bridge. Controlla il tuo modello e il dispositivo di connessione online prima di configurare i comandi.
Quali funzionalità offre la serratura intelligente LOQED con Loxone?
L'integrazione della serratura intelligente LOQED e Loxone avviene tramite l'API del bridge locale.
Attualmente sono supportate le seguenti funzionalità:
Invia modifiche allo stato della serratura in tempo reale (aperto, sbloccato, bloccato) al server Loxone.
Ricevi comandi dal server Loxone per modificare lo stato di blocco (aperto, sbloccato, bloccato).
Crea un output virtuale per inviare comandi alla serratura
1. Crea una chiave API del bridge in uscita
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). Fai clic sul pulsante "Aggiungi nuova chiave API". Imposta un nome qualsiasi (usiamo il server Loxone) e crea la chiave API. È normale che la casella di controllo "Rimuovi sblocco/blocco" sia disattivata.
Dopo aver creato la chiave API, ora dovresti vedere quattro URL API Bridge, che ti serviranno in seguito. Tieni aperta questa pagina.
2. Creare un output virtuale
Selezionare 'Uscite virtuali' dall'elenco Periferiche.
Fare clic su "Modelli dispositivo" e quindi su "Importa modello...".
Seleziona il file che hai appena scaricato sul tuo computer.
Fare nuovamente clic su "Modelli dispositivo" e scegliere "LOQED".
Fare clic sull'output virtuale "LOQED".
Fai clic su "Indirizzo" nella scheda delle proprietà e modifica l'URL nell'IP del tuo bridge.
(Assicurati che il tuo bridge abbia un indirizzo IP statico).
Seleziona la voce 'Latch' dall'output virtuale
Modifica il "Comando per ON" nell'URL dell'API Latch Bridge creato nel passaggio 1
a partire da /stato? Dovrebbe assomigliare a:
/state?command=DAY_LOCK&local_key_id=[LOCAL_KEY_ID]&secret=[SECRET]Fai lo stesso per Blocco notturno e Apri.
3. Testare l'output virtuale
Salva la configurazione sul tuo server Loxone, attiva la visualizzazione live con la regolazione manuale dei valori e verifica se i comandi funzionano.
Crea un ingresso virtuale per ricevere lo stato della serratura
Il bridge LOQED può aggiornare il tuo server Loxone con ogni cambiamento di stato, anche quando viene utilizzata l'app o quando apri o chiudi manualmente la serratura. Per fare ciò, è necessario un ingresso virtuale in Loxone per ricevere lo stato corrente.
4. Creazione di un ingresso virtuale
Selezionare 'Ingressi virtuali' dall'elenco Periferiche.
Importa il modello di input virtuale.
Se ricevi l'errore "Errore durante il salvataggio nella posizione di destinazione", crea prima la directory "VirtualIn" nella directory "Loxone\Loxone Config\Templates" (con distinzione tra maiuscole e minuscole).Copia l'URL "Stato" dalla pagina API e incollalo in "Impostazioni -> URL
Dovrebbe assomigliare a: http://BRIDGE_IP/statusImpostare l''Intervallo' su '3600' (un'ora).
Ora il server Loxone chiederà al bridge lo stato corrente ogni ora.
Attualmente, non è possibile fare in modo che Loxone richieda lo stato corrente all'avvio. Pertanto, dopo l'avvio del server, sarà necessaria un'ora affinché lo stato venga visualizzato se il blocco stesso non è stato utilizzato entro quella prima ora.
5. Creare un blocco di stato
Andare su “Aggiungi blocco funzione -> Generale -> Stato” e aggiungere il blocco di stato (non utilizzare il blocco di stato virtuale). Configurare il blocco come segue:
Collega il blocco di stato all'ingresso virtuale LOQED_LOCK_STATE disegnando una linea e mostrando i valori abilitando le caselle di controllo TQ e AQ.
6. Creare un utente
Crea un nuovo utente “loqed”. Il nome utente fa distinzione tra maiuscole e minuscole e non supporta caratteri speciali.
Fare clic con il tasto destro su Gestione utenti e aggiungere un nuovo utente.
Concedi a questo utente l'accesso a:
Loxone Configurazione (nella scheda "Diritti")
Ingresso virtuale “LOQED_BATTERY” (nella scheda “Blocchi”)
“LOQEDBLOCCARESTATO” (nella scheda “Blocchi”)
Dopo aver creato l'utente, assicurati di impostare anche una password. La password fa distinzione tra maiuscole e minuscole e non supporta caratteri speciali.
7. Test
Salva la configurazione sul tuo Miniserver Loxone e verifica se funziona visitando l'URL: http://loqed:password@LoxoneServerIP/dev/sps/io/LOQED_LOCK_STATE/2
Sostituisci "loqed" con il nome utente del passaggio 6 e "password" con la password del passaggio 6. Il tuo browser potrebbe mostrare una finestra di dialogo di autenticazione (perché il tuo browser viene reindirizzato), inserisci nuovamente gli stessi dettagli di accesso. Il tuo browser dovrebbe quindi mostrare il seguente output:
<LL control="dev/sps/io/LOQED_LOCK_STATE/2" value="2.000" Code="200"/>
Se non vedi l'output sopra, l'input virtuale non funziona correttamente.
Puoi anche premere il pulsante "Avvia LiveView" e verificare che lo stato del blocco cambi in DAY_LOCK.
8. Connetti l'API LOQED all'input virtuale
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).
Crea un nuovo 'Webhook in uscita tramite LOQED Bridge'. facendo clic su Aggiungi/Elimina webhook.
Ricrea il modulo come l'immagine qui sotto. Utilizza il tuo nome utente, password e IP bridge.
Fare clic su "Invia".
Aggiungi un altro webhook in uscita per la percentuale della batteria. URL:
http://loqed:loqed@192.168.2.53/dev/sps/io/PERCENTUALE_BATTERIA/[percentuale_batteria]
Controlla solo "Batteria".
Ora dovresti avere qualcosa del genere:
Ora lo stato del blocco e la percentuale della batteria verranno inviati al server Loxone ad ogni modifica dello stato.
Considerazioni sulla sicurezza
Ti consigliamo vivamente di effettuare un'integrazione locale tra Loxone e LOQED solo se la tua rete Wi-Fi è adeguatamente protetta e ti fidi di tutti i dispositivi con accesso a questa rete Wi-Fi. Se non puoi garantirlo, ti consigliamo di utilizzare invece la nostra API Web (Leggi l'articolo Web API qui).
Spiegazione tecnica:
Aggiornamenti di stato a Loxone: all'interno della tua rete locale, le connessioni non possono essere protette tramite certificati TLS firmati da un'autorità di certificazione. LOQED Bridge include quindi una firma che teoricamente potrebbe essere convalidata da Loxone. Tuttavia, al momento in cui scrivo, questo non è ancora supportato da Loxone. Ciò significa che qualsiasi persona o dispositivo con accesso alla rete locale potrebbe far “pensare” a Loxone che la porta sia stata aperta. Ciò potrebbe attivare altre azioni sensibili a seconda della situazione (ad esempio spegnere il sistema di allarme).
Una soluzione alternativa a questo problema consiste nell'utilizzare l'API Web LOQED, che convalida il certificato di sicurezza del dominio a cui si sta connettendo. Comandi di apertura/blocco su LOQED Bridge: all'interno della rete locale, le connessioni non possono essere protette tramite certificati TLS firmati da un'autorità di certificazione. Pertanto, i comandi al bridge possono essere firmati digitalmente, in modo tale che il bridge LOQED possa convalidare se il messaggio è stato inviato da una parte attendibile. Al momento in cui scrivo, Loxone non supporta la generazione di tale firma. Pertanto, la chiave di crittografia viene inviata al bridge da Loxone in testo semplice. Qualsiasi persona o dispositivo con accesso alla tua rete locale può potenzialmente vedere questa chiave di crittografia. Una soluzione alternativa a questo problema consiste nell'utilizzare l'API Web LOQED, che è protetta tramite HTTPS.
Suggerimenti
Dopo un riavvio del miniserver Loxone, lo stato di blocco sarà sconosciuto finché lo stato di blocco non cambia una volta o non si attiva l'intervallo dello stato dell'ingresso virtuale.
Se invii lo stesso comando (ad esempio APRI) due volte entro 10 secondi, la serratura intelligente LOQED ruoterà la serratura il più lontano possibile (un'apertura di emergenza). Questo è un comportamento normale, semplicemente non inviare comandi duplicati troppo velocemente.
Lo stato di serratura “APERTO” è disponibile solo per serrature senza maniglia mobile sul lato esterno della porta. Tali serrature hanno tre stati. Circa 2 secondi dopo che tale blocco ha raggiunto lo stato OPEN, il blocco rilascerà automaticamente il fermo e invierà lo stato "DAY_LOCK" al server Loxone.
Se si invia il comando “APRE” ad una serratura con soli due stati (GIORNOSERRATURA e NOTTELOCK), la serratura lo interpreterà come se avesse ricevuto il comando DAY_LOCK.
LOQED Bridge attualmente non può connettersi alle reti Wi-Fi con caratteri speciali nel nome della rete SSID o nella password (ad esempio, le lettere é o ï).
Funzionalità future:
Supporto per la richiesta dello stato di blocco corrente all'avvio del miniserver Loxone.
Sicurezza Informazioni sulla sicurezza della serratura quando si utilizza questa integrazione
Fisicamente, la serratura intelligente LOQED ha la valutazione a tre stelle SKG più alta ottenibile (SKG è l'autorità olandese di certificazione della sicurezza delle serrature, con requisiti più severi rispetto a quelli prescritti dalla legislazione UE). La serratura è fissata saldamente alla porta e viene fornita con un cilindro incluso. Soprattutto per le aziende, questo è più sicuro, poiché rispetto alle serrature intelligenti posizionate sopra una chiave esistente, si potrebbe facilmente accedere alla chiave tradizionale.
Le chiavi digitali della serratura intelligente LOQED sono memorizzate sulla serratura stessa e sul telefono. Le chiavi vengono archiviate anche sul server LOQED, ma crittografate con la password del tuo account. Questo può essere paragonato al funzionamento degli strumenti di gestione delle password online. Garantisce che anche se i server LOQED venissero compromessi, le tue chiavi sarebbero comunque al sicuro. Ciò significa anche che non possiamo non offrire la funzionalità “password dimenticata”, quindi non dimenticare la password.
Quando utilizzi questa integrazione, memorizzerai una chiave digitale sul tuo Miniserver Loxone. Poiché il sistema Loxone non può calcolare la "firma" per i comandi inviati al server LOQED, il miniserver Loxone invierà la chiave nel comando HTTPS e la firma verrà calcolata dal server LOQED. Il server LOQED invia il comando con firma alla serratura intelligente LOQED e subito dopo dimentica la chiave.