Si applica a: LOQED Touch e LOQED Pure.
Utilizza questo articolo per connettere una serratura intelligente LOQED a Home Assistant. È destinato agli utenti che già eseguono Home Assistant e comprendono le integrazioni di rete locale.
A seconda del modello e della configurazione, gli aggiornamenti di stato possono fare riferimento a LOQED Bridge o al gateway. Alcuni screenshot più vecchi potrebbero ancora mostrare la denominazione dell'era Touch.
Controlla la tua serratura intelligente LOQED con Home Assistant (HASS).
Funzionalità supportate
Blocca/sblocca/apri la serratura intelligente LOQED
Intraprendere azioni quando il lucchetto è bloccato/sbloccato/aperto.
Ultimo "ID chiave locale" utilizzato quando la serratura è stata bloccata/sbloccata/aperta. Ogni ID corrisponde a una chiave LOQED univoca. Tieni presente che quando elimini una chiave e ne crei una nuova, gli ID delle chiavi locali vengono riutilizzati.
Futuro: l'API cloud LOQED può connettere l'indirizzo e-mail di un utente a un ID chiave locale, ma questa funzionalità non è ancora disponibile nell'integrazione.
L'integrazione è stata creata dalla community e non è ufficialmente supportata da LOQED. Tuttavia, intendiamo aiutarti in caso di domande.
Sicurezza
Questa integrazione utilizza l'API bridge locale. Durante il processo di configurazione, l'API Web viene utilizzata per creare una chiave. L'API Web non memorizzerà la tua chiave.
Quando LOQED Bridge invia un aggiornamento di stato a HASS, include una firma digitale. Anche se si utilizza una connessione non protetta (non HTTPS), come di solito accade su una rete interna, ciò significa che le informazioni non possono essere alterate (ma i contenuti possono essere letti).
Installazione
1. Assicurati di eseguire almeno Home Assistant 2023.7.0
Questa versione supporta "apertura", "sblocco" e "blocco" di un lucchetto (invece solo di "sblocco" e "blocco") e supporta LOQED.
2. Assicurarsi che non esistano vecchi webhook nello LOQED Bridge
Hai avuto un'installazione precedente di qualsiasi tipo di integrazione e LOQED? Quindi assicurati che non siano presenti vecchi webhook impostati in LOQED Bridge, che puntino a una vecchia installazione HASS. Ciò potrebbe rallentare o non funzionare affatto la ricezione dell'aggiornamento dello stato dalla serratura. Accedi semplicemente a app.loqed.com, vai alla voce "Webhook in uscita tramite LOQED Ponte", e fai clic sul pulsante accanto al bridge. Se vedi un avviso sulla politica di rete CORS, disabilita temporaneamente questo flag nel tuo browser, riavviare il tuo browser e riprova. Quindi, elimina tutti i webhook che vedi. Ora il bridge è libero da webhook ed è possibile installare nuovamente l'integrazione HASS, che creerà una nuova voce.
Di seguito è riportato uno screenshot di un LOQED Bridge con una voce webhook (come dovrebbe essere, dopo l'integrazione LOQED per HASS è installata correttamente).
3. Assicurati che gli URL Home Assistant siano impostati correttamente
Quando lo stato di blocco cambia, LOQED Bridge pubblica i dati sul tuo URL Home Assistant. L'integrazione preferisce l'URL interno rispetto a quello esterno. Puoi impostare gli URL in Impostazioni -> Sistema -> Rete, sotto l'intestazione "URL Home Assistant".
Nel caso in cui venga utilizzato un URL HTTPS, LOQED Bridge convalida il certificato (assicurati che sia valido!). L'integrazione verifica sempre una firma digitale dei dati inviati dal bridge, quindi, anche se viene utilizzata una connessione non sicura, nessuno può inviare dati falsi a HASS sullo stato della porta.
Con le impostazioni seguenti (Home Assistant versione 2023.6.3), le integrazioni utilizzeranno "http://homeassistant.local:8123" come URL. Se imposti "Rete locale" su automatico, l'integrazione utilizza 'https://MYSUB.duckdns.org(il che non sembra logico neanche a noi).
⚠️ Se utilizzi HTTPS, ti consigliamo vivamente di utilizzare il "proxy SSL NGINX Home Assistant" con "Let's Encrypt". Se installi certificati TLS senza utilizzare un server proxy, anche l'URL HASS interno utilizzerà i certificati TLS, ma poiché il nome host interno non è presente sul certificato TLS, LOQED Bridge non si connetterà per motivi di sicurezza. TLDR; assicurati di poterti connettere al tuo nome host interno senza alcun avviso di certificato TLS (quindi, senza HTTPS).
4. Genera un token di accesso personale
Su Sito Web del token di accesso personale LOQED, procedi nel seguente modo:
Accedi con l'indirizzo e-mail dell'app LOQED (devi essere amministratore)
Tocca "Crea"
Dai un nome al tuo token di accesso personale (questo non verrà utilizzato in seguito, ma consigliamo qualcosa come "Home Assistant" per poterlo riconoscere come utilizzato da Home Assistant)
Tocca Salva
Conserva il token di accesso in un posto da cui puoi facilmente copiare/incollare poiché ti servirà nel passaggio successivo (e verrà mostrato solo una volta). Tieni presente che puoi utilizzare questo token per impostare più blocchi.
Assicurati di copiare e incollare il token completo! Il doppio clic a volte copia solo una parte del token.
5. Riavviare Home Assistant
Il modo più semplice per installare l'integrazione è riavviare HASS dopo l'installazione (quindi si riavvierà più volte). HASS rileverà automaticamente LOQED Bridge (utilizzando Zero Conf) se si trova all'interno della rete locale. L'integrazione attualmente non supporta bridge al di fuori della rete locale.
6. Configurare l'integrazione Home Assistant
Vai su "Impostazioni" -> "Dispositivi e servizi". Fare clic sul pulsante "Configura" della serratura intelligente rilevata automaticamente. Fornire il token di accesso personale del passaggio precedente.
Non consigliato: se desideri installare questa integrazione senza riavviare, devi inserire il nome della chiave del tuo lucchetto esattamente come mostrato nell'elenco dei blocchi dell'app LOQED (nota: questo non è il nome del blocco per gli amministratori, è il nome che scegli tu stesso e si trova nella primissima schermata dell'app LOQED).
Puoi anche impostare manualmente un blocco quando per qualche motivo non viene rilevato automaticamente. In tal caso è necessario fornire sia la chiave API del passaggio precedente sia il nome del lucchetto come noto nell'app complementare LOQED.
Maggiori informazioni
Debug
Innanzitutto, verifica se il tuo token di accesso personale funziona
Vai a reqbin.com
Inserisci "https://integrations.production.loqed.com/api/locks/" come URL con il metodo "GET".
Inserisci "Autorizzazione: Portatore YOUR-TOKEN-HERE" come token di autorizzazione. Naturalmente, sostituisci la parola "YOUR-TOKEN-HERE" con il tuo token.
Premere "Invia". Dovresti ottenere un array con dati come nello screenshot qui sotto.
Debug in Home Assistant
Abilita registrazione:
servizio: logger.set_level
dati:
homeassistant.components.loqed: debug
loqedAPI: debug