Vai al contenuto principale

Integrazione Domoticz e LOQED

Come integrare una serratura intelligente LOQED con Domoticz utilizzando i webhook/comandi API LOQED.

Si applica a: LOQED Touch e LOQED Pure.

Questa guida spiega come aggiungere e utilizzare una serratura intelligente LOQED da Domoticz. Utilizzalo solo se hai dimestichezza con la creazione di URL API e opzioni in Domoticz.

A seconda del modello, il dispositivo di connessione online è LOQED Bridge per Touch o LOQED BLU Gateway per Pure. Alcuni screenshot più vecchi potrebbero ancora indicare LOQED Bridge o LOQED Touch.

Questa guida ti mostrerà come aggiungere e utilizzare la serratura intelligente LOQED con la tua installazione Domoticz.

Ti ritroverai con due interruttori:

latch_frontdoor.png


Questo ti consentirà di aprire la porta sbloccando la serratura.

unlock-lock_frontdoor.png


Questo ti consentirà di sbloccare/chiudere la porta e bloccarla.
Mostrerà anche lo stato attuale della serratura, anche se la utilizzi al di fuori di Domoticz

Crea l'interruttore della porta Latch

1 Crea un nuovo dispositivo

- Vai su Configurazione -> Hardware e inserisci il nome del tuo dispositivo. ad esempio: dispositivo_porta
- Scegli il tipo di dispositivo "Fitticcio" e fai clic su "Aggiungi".

2 Creare un sensore virtuale

Il nuovo dispositivo sarà visibile nella parte superiore della pagina.

cvs.png

- Fare clic
- Inserisci il nome del tuo interruttore. ad esempio: porta con serratura.
- Scegliere il tipo di sensore 'Selettore'.
- Fare clic su "Ok"

Nella scheda "Interruttori" in Domoticz dovresti avere un interruttore simile a questo:

latch_door.png

Ripetere il passaggio 2 per creare un altro tipo di sensore virtuale "Selettore" e denominarlo "sblocca/blocca porta".

3. Crea URL API

Visita https://webhooks.loqed.com, accedi con il tuo account amministratore e crea una chiave API. Dovresti ritrovarti con una voce simile alla seguente. Lascia aperta questa pagina. Avrai bisogno dei tre URL nel passaggio successivo.
* Questo passaggio ti disconnetterà dall'app mobile LOQED.

URL del webhook

Aperto

url/v1/locks/0000/state?lock_api_key=xx&api
_token=xx&lock_state=APERTO&local_key_id=0

Fermo

url/v1/locks/0000/state?lock_api_key=xx&api
_token=xx&lock_state=GIORNO_BLOCCO&local_key_id=0

Blocco notturno

url/v1/locks/0000/state?lock_api_key=xx&api
_token=xx&lock_state=NOTTE_LOCK&local_key_id=0

Stato

url/API/lock_status.php?api_token=xx&lock_id=xx

4 Aggiungere gli URL API ai sensori

Interruttore della porta con serratura
- Nella scheda "Interruttori" fare clic su "Modifica" per il sensore "Porta con serratura".
- Cambia il tipo di interruttore in: 'Serratura della porta invertita'.
- Nel'Su Campo "Azione", incolla il "Aperto'URL del webhook.
- Impostare il 'Ritardo spegnimento' su 5
- Fare clic su "Salva"

Interruttore di sblocco/blocco della porta
- Nella scheda "Interruttori" fare clic su "Modifica" per il sensore "Porta con serratura".
- Cambia il tipo di interruttore in: 'Serratura della porta'.
- Nel'Su Campo "Azione", incolla il "BLOCCO_NOTTE'URL del webhook.
- Nel'Spento Campo "Azione", incolla il "GIORNO_BLOCCO'URL del webhook.
- Fare clic su "Salva"

Ora puoi sbloccare e bloccare la serratura intelligente LOQED e aprire la porta.
Se fai clic sulla stella dei preferiti sugli interruttori, questi verranno visualizzati nella dashboard.
Per utilizzare le icone LOQED di build personalizzate, scarica questo file e carica Configurazione -> Altre opzioni -> Icone personalizzate.

Ottieni lo stato corrente LOQED nell'interruttore di sblocco/blocco

Quando si aziona la porta manualmente o tramite l'app LOQED, lo stato della serratura cambia senza che Domoticz ne sia consapevole. Le seguenti istruzioni ti aiuteranno a comunicare in ogni momento lo stato corrente a Domoticz nell'interruttore di sblocco/blocco.

- Crea un terzo interruttore virtuale (Tipo: Serratura - Nome: Stato)
- Ricorda il numero Idx

Crea e testa gli URL per modificare lo stato dell'interruttore "Stato LOQED".

Ora formatteremo un URL che il backend LOQED può chiamare per far sapere a Domoticz che lo stato LOQED è cambiato. L'URL è simile al seguente, ma alcune parti devono essere modificate:

  • [NOME UTENTE]: inserisci qui il tuo nome utente nel formato BASE64. Puoi convertire il tuo nome utente in questo formato utilizzando (ad esempio) https://codebeautify.org/base64-encode

  • [PASSWORD]: inserisci qui la tua password nel formato BASE64. Puoi convertire il tuo nome utente in questo formato utilizzando (ad esempio) https://codebeautify.org/base64-encode

  • [IDX]: inserisci l'IDX dello switch ID (che hai annotato nel passaggio precedente)

  • [LIVELLO]: inserisci il livello del selettore "Latch" (che hai annotato nel passaggio precedente)

Una volta terminato, inserisci questo URL nel browser e verifica che l'interruttore "Stato LOQED" cambi lo stato nello stato richiesto! Quindi, crea un secondo URL per l'altro livello di selettore "Blocco notturno" (solo la parte [LIVELLO] dell'URL sarà diversa).

4 Immettere gli URL nel sistema LOQED

Vai a https://webhooks.loqed.com e accedi con il tuo account amministratore. Fai clic su "Aggiungi nuovo webhook". Assicurati di selezionare solo la casella di controllo "Latch" e copia e incolla l'URL dello stato "Latch" qui. Salva. Aggiungi un altro webhook, ora seleziona solo la casella di controllo "Blocco notturno" e copia e incolla qui l'altro URL del passaggio 3. Risparmia pure.

Ora è tutto pronto! Una volta che la serratura cambia stato, il nuovo stato verrà inviato a Domoticz.

Hai ricevuto la risposta alla tua domanda?