S'applique à : LOQED Touch et LOQED Pure.
Ce guide explique comment intégrer une serrure intelligente LOQED à Loxone. Il est destiné aux utilisateurs avancés de maisons intelligentes.
Certaines captures d'écran et modèles plus anciens peuvent encore mentionner LOQED Touch ou une formulation spécifique à Bridge. Vérifiez votre modèle et votre périphérique de connexion en ligne avant de configurer les commandes.
Quelles fonctionnalités la serrure intelligente LOQED offre-t-elle avec le Loxone ?
L'intégration de la serrure intelligente LOQED et de la Loxone se fait via l'API du pont local.
Actuellement, les fonctionnalités suivantes sont prises en charge :
Envoyez les changements d'état en temps réel de la serrure (ouverture, déverrouillage, verrouillage) au serveur Loxone.
Recevez des commandes du serveur Loxone pour modifier l'état du verrouillage (ouvrir, déverrouiller, verrouiller).
Créez une sortie virtuelle pour envoyer des commandes à la serrure
1. Créez une clé API de pont sortant
Aller à https://app.loqed.com/API-Config et connectez-vous avec votre adresse e-mail et votre mot de passe LOQED app (notez que vous serez déconnecté du LOQED app). Cliquez sur le bouton « Ajouter une nouvelle clé API ». Définissez n’importe quel nom (nous utilisons le serveur Loxone) et créez la clé API. Il est normal que la case « Supprimer le déverrouillage/verrouillage » soit grisée.
Une fois la clé API créée, vous devriez maintenant voir quatre URL d'API Bridge, dont vous aurez besoin plus tard. Gardez cette page ouverte.
2. Créez une sortie virtuelle
Sélectionnez « Sorties virtuelles » dans la liste Périphérie.
Cliquez sur « Modèles de périphérique » et cliquez sur « Importer un modèle... ».
Sélectionnez le fichier que vous venez de télécharger sur votre ordinateur.
Cliquez à nouveau sur « Modèles de périphérique » et choisissez « LOQED ».
Cliquez sur la sortie virtuelle « LOQED ».
Cliquez sur « Adresse » dans l'onglet Propriétés et remplacez l'URL par l'adresse IP de votre pont.
(Assurez-vous que votre pont a une adresse IP statique).
Sélectionnez l'élément « Latch » dans la sortie virtuelle
Remplacez la « Commande pour ON » par l'URL de l'API Latch Bridge que vous avez créée à l'étape 1.
à partir de /state ? Cela devrait ressembler à :
/state?command=DAY_LOCK&local_key_id=[LOCAL_KEY_ID]&secret=[SECRET]Faites de même pour Night Lock et Open.
3. Test de la sortie virtuelle
Enregistrez la configuration sur votre serveur Loxone, activez la vue en direct avec ajustement manuel des valeurs et testez si les commandes fonctionnent.
Créer une entrée virtuelle pour recevoir l'état du verrou
Le pont LOQED peut mettre à jour votre serveur Loxone à chaque changement d'état, même lorsque l'application est utilisée ou lorsque vous ouvrez ou fermez manuellement le verrou. Pour ce faire, vous avez besoin d'une entrée virtuelle dans Loxone pour recevoir l'état actuel.
4. Création d'une entrée virtuelle
Sélectionnez « Entrées virtuelles » dans la liste Périphérie.
Importez le modèle d'entrée virtuelle.
Si vous obtenez l'erreur "Erreur lors de l'enregistrement dans l'emplacement cible", veuillez d'abord créer le répertoire "VirtualIn" dans le répertoire "Loxone\Loxone Config\Templates" (sensible à la casse).Copiez l'URL « Statut » de la page API et collez-la dans « Paramètres -> URL ».
Cela devrait ressembler à : http://BRIDGE_IP/statusRéglez « Intervalle » sur « 3 600 » (une heure).
Désormais, le serveur Loxone demandera au pont l'état actuel toutes les heures.
Actuellement, il n'existe aucun moyen pour que Loxone demande l'état actuel au démarrage. Ainsi, après le démarrage de votre serveur, il faudra une heure pour que l'état apparaisse si le verrou lui-même n'a pas été utilisé au cours de cette première heure.
5. Créez un bloc de statut
Allez dans « Ajouter un bloc fonctionnel -> Général -> Statut » et ajoutez le bloc de statut (n'utilisez pas le bloc de statut virtuel). Configurez le bloc comme suit :
Connectez le bloc d'état à l'entrée virtuelle LOQED_LOCK_STATE en traçant une ligne et en affichant les valeurs en cochant les cases TQ et AQ.
6. Créez un utilisateur
Créez un nouvel utilisateur « loqed ». Le nom d'utilisateur est sensible à la casse et ne prend pas en charge les caractères spéciaux.
Cliquez avec le bouton droit sur Gestion des utilisateurs et ajoutez un nouvel utilisateur.
Donnez à cet utilisateur l'accès à :
Loxone Config (sur l'onglet « Droits »)
Entrée virtuelle « LOQED_BATTERY » (sur l'onglet « Blocs »)
"LOQEDVERROUILLAGEEntrée virtuelle STATE » (sur l’onglet « Blocs »)
Une fois l'utilisateur créé, veillez également à définir un mot de passe. Le mot de passe est sensible à la casse et ne prend pas en charge les caractères spéciaux.
7. Tests
Enregistrez la configuration sur votre miniserveur Loxone et testez si elle fonctionne en visitant l'URL : http://loqed:password@LoxoneServerIP/dev/sps/io/LOQED_LOCK_STATE/2
Remplacez « loqed » par le nom d'utilisateur de l'étape 6 et « password » par le mot de passe de l'étape 6. Votre navigateur peut afficher une boîte de dialogue d'authentification (car votre navigateur est redirigé), saisissez à nouveau les mêmes informations de connexion. Votre navigateur devrait alors afficher le résultat suivant :
<LL control="dev/sps/io/LOQED_LOCK_STATE/2" value="2.000" Code="200"/>
Si vous ne voyez pas la sortie ci-dessus, l'entrée virtuelle ne fonctionne pas correctement.
Vous pouvez également appuyer sur le bouton « Démarrer LiveView » et vérifier que l'état du verrou passe à DAY_LOCK.
8. Connectez l'API LOQED à l'entrée virtuelle
Aller à https://app.loqed.com/API-Config et connectez-vous avec votre adresse e-mail et votre mot de passe LOQED app (notez que vous serez déconnecté du LOQED app).
Créer un nouveau 'Webhooks sortants via LOQED Bridge'. en cliquant sur Ajouter/Supprimer des webhooks.
Recréez le formulaire comme l'image ci-dessous. Utilisez votre propre nom d'utilisateur, mot de passe et adresse IP de pont.
Cliquez sur « Soumettre ».
Ajoutez un autre webhook sortant pour le pourcentage de batterie. URL :
http://loqed:localisé@192.168.2.53/dev/sps/io/BATTERY_PERCENTAGE/[battery_percentage]
Cochez uniquement « Batterie ».
Maintenant, vous devriez avoir quelque chose comme ceci :
Désormais, l'état de verrouillage et le pourcentage de batterie seront envoyés au serveur Loxone à chaque changement d'état.
Considérations de sécurité
Nous vous recommandons fortement de réaliser une intégration locale entre Loxone et LOQED uniquement si votre réseau Wi-Fi est correctement sécurisé et que vous faites confiance à tous les appareils ayant accès à ce réseau Wi-Fi. Si vous ne pouvez pas vous en assurer, nous vous recommandons d'utiliser plutôt notre API Web (Lisez l'article Web API ici).
Explication technique :
Mises à jour du statut de Loxone : au sein de votre réseau local, les connexions ne peuvent pas être sécurisées via des certificats TLS signés par une autorité de certification. Le LOQED Bridge comprend donc une signature qui pourrait théoriquement être validée par Loxone. Cependant, au moment de la rédaction de cet article, cela n'est pas encore pris en charge par Loxone. Cela signifie que toute personne ou appareil ayant accès à votre réseau local pourrait faire « penser » à Loxone que la porte a été ouverte. Cela peut déclencher d'autres actions sensibles en fonction de votre situation (par exemple, éteindre votre système d'alarme).
Une solution de contournement à ce problème consiste à utiliser l'API Web LOQED, qui valide le certificat de sécurité du domaine auquel il se connecte. Commandes d'ouverture/verrouillage du LOQED Bridge : au sein de votre réseau local, les connexions ne peuvent pas être sécurisées via des certificats TLS signés par une autorité de certification. Par conséquent, les commandes adressées au pont peuvent être signées numériquement, de sorte que le pont LOQED puisse valider si le message a été envoyé par une partie de confiance. Au moment de la rédaction, Loxone ne prend pas en charge la génération d'une telle signature. Par conséquent, la clé de chiffrement est envoyée au pont par Loxone en texte brut. Toute personne ou appareil ayant accès à votre réseau local peut potentiellement voir cette clé de cryptage. Une solution de contournement à ce problème consiste à utiliser l'API Web LOQED, qui est sécurisée via HTTPS.
Conseils
Après un redémarrage du miniserveur Loxone, l'état du verrouillage sera inconnu, jusqu'à ce que l'état du verrouillage change une fois ou que l'intervalle d'état de l'entrée virtuelle se déclenche.
Si vous envoyez la même commande (par exemple OUVERT) deux fois en 10 secondes, la serrure intelligente LOQED fera tourner la serrure aussi loin qu'elle le peut (une ouverture d'urgence). Il s’agit d’un comportement normal, n’envoyez simplement pas de commandes en double trop rapidement.
L'état de serrure « OUVERT » n'est disponible que pour les serrures sans poignée mobile à l'extérieur de la porte. De tels verrous ont trois états. Environ 2 secondes après qu'un tel verrou ait atteint l'état OUVERT, le verrou relâchera automatiquement le loquet et enverra l'état « DAY_LOCK » au serveur Loxone.
Si vous envoyez la commande « OUVERT » à une serrure avec seulement deux états (JOURSERRURE et NUITLOCK), la serrure interprétera cela comme si elle avait reçu la commande DAY_LOCK.
Le LOQED Bridge ne peut actuellement pas se connecter aux réseaux Wi-Fi avec des caractères spéciaux dans le nom de réseau SSID ou le mot de passe (par exemple, les lettres é ou ï).
Fonctionnalité future :
Prise en charge de la demande de l'état de verrouillage actuel au démarrage du miniserveur Loxone.
Informations de sécurité sur la sécurité de votre serrure lors de l'utilisation de cette intégration
Physiquement, la serrure intelligente LOQED possède la note trois étoiles SKG la plus élevée possible (SKG est l'autorité néerlandaise de certification de sécurité des serrures, avec des exigences plus strictes que celles prescrites par la législation européenne). La serrure est solidement fixée à la porte et est livrée avec un cylindre inclus. C'est plus sûr, en particulier pour les entreprises, car par rapport aux serrures intelligentes placées au-dessus d'une clé existante, on pourrait facilement accéder à la clé traditionnelle.
Les clés numériques de la serrure intelligente LOQED sont stockées sur la serrure elle-même et sur votre téléphone. Les clés sont également stockées sur le serveur LOQED, mais cryptées avec le mot de passe de votre compte. Cela peut être comparé au fonctionnement des outils de gestion de mots de passe en ligne. Il garantit que même si les serveurs LOQED étaient compromis, vos clés sont toujours en sécurité. Cela signifie également que nous ne pouvons pas ne pas proposer une fonctionnalité « Mot de passe oublié » – alors n’oubliez pas votre mot de passe.
Lorsque vous utilisez cette intégration, vous stockerez une clé numérique sur votre miniserveur Loxone. Étant donné que le système Loxone ne peut pas calculer la « signature » pour les commandes envoyées au serveur LOQED, le miniserveur Loxone enverra la clé dans la commande HTTPS et la signature est calculée par le serveur LOQED. Le serveur LOQED envoie la commande avec signature à la serrure intelligente LOQED et oublie la clé juste après.