S'applique à : LOQED Touch et LOQED Pure.
Ce guide explique l'intégration Fibaro/Yubii pour les serrures intelligentes LOQED. Il est destiné aux utilisateurs avancés qui sont à l’aise avec les intégrations de réseaux locaux.
La disponibilité des fonctionnalités peut dépendre du pont/passerelle LOQED connecté et du micrologiciel du contrôleur tiers. Certaines captures d'écran plus anciennes peuvent encore afficher la dénomination de l'ère Touch.
Quelles fonctionnalités la serrure intelligente LOQED offre-t-elle avec le Fibaro ?
L'intégration de la serrure intelligente LOQED et de la Fibaro 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 (ouverte, déverrouillée, verrouillée) et de la batterie, Wi-Fi, Bluetooth à la passerelle Fibaro. Le niveau de la batterie, s'il est inférieur à 5 %, affichera la QuickApp comme étant morte.
Recevez des commandes de la passerelle Fibaro pour modifier l'état du verrouillage (ouvrir, déverrouiller, verrouiller).
Langue anglaise, allemande et néerlandaise. Vous pouvez ajouter des langues supplémentaires en les ajoutant vous-même au code source.
Lorsque vous utilisez plusieurs verrous LOQED, ajoutez simplement une instance QuickApp supplémentaire et configurez-la avec les données appropriées.
Actuellement, cette QuickApp ne peut pas décoder les données JSON POSTées par le pont, car l'API FIBARO/Yubii/elero/zooz ignore simplement toutes les données inconnues et n'accepte que les arguments de clé JSON :[{}]. Par conséquent, on ne peut pas décoder qui a ouvert/fermé le LOQED via l’application (ou si c’était manuellement, avec un bouton).
Considération de sécurité : le pont LOQED envoie tout changement d'état (par exemple "la porte a été ouverte") à Fibaro via une connexion HTTP non sécurisée dans votre réseau Wi-Fi, mais avec une signature numérique. Fibaro utilise la signature numérique pour garantir que le changement d'état n'est pas envoyé par quelqu'un d'autre que le LOQED Bridge (ainsi, pour garantir que personne ne puisse faire croire au dispositif Fibaro que la porte est ouverte, alors qu'en fait ce n'était pas le cas). Seul le HC3 (pas le Yubii Home / HC3L) prend en charge cela. Notez que cela n'affecte pas l'ouverture/le verrouillage de la porte, cela concerne uniquement les informations d'état.
Exigences
Une passerelle prise en charge, telle que :
Fibaro Centre d'accueil 3 (notez que le Home Center 2 n'est pas pris en charge)
Mise en place
Étape 1 : créer une clé API
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 « Outil de configuration API ». Cliquez sur le bouton « Ajouter une nouvelle clé API ». Définissez n’importe quel nom et créez la clé API. Il est normal que la case « Supprimer le déverrouillage/verrouillage » soit grisée.
Une fois la clé créée, cliquez sur le bouton "afficher/modifier". Laissez cet écran ouvert.
Étape 2 : installez la QuickApp Fibaro
Connectez-vous à votre passerelle Fibaro. Si vous possédez un appareil de marque Fibaro, vous devriez pouvoir accéder à http://find.fibaro.com/pour trouver l'adresse IP de votre passerelle.
Téléchargez le fichier Quick App et extrayez le ZIP. Allez dans « Paramètres » -> « Appareils » et cliquez sur l'icône plus pour ajouter un nouvel appareil. Ensuite, recherchez l'appareil appelé « Télécharger le fichier » et téléchargez le fichier Quick App.
Étape 3 : Créer un utilisateur sur la passerelle Fibaro
Créez un utilisateur local sur votre passerelle avec des autorisations pour l'application rapide LOQED. Veuillez ne pas utiliser de caractères spéciaux. Cet utilisateur est utilisé pour mettre à jour la passerelle des changements d'état de verrouillage dès qu'ils se produisent. Bien que cela ne soit pas recommandé, vous pouvez également ignorer cette étape et utiliser votre nom d'utilisateur et votre mot de passe administrateur (s'ils ne contiennent pas de caractères spéciaux).
Étape 4 : configurer l'application rapide
Cliquez sur l'onglet Variables.
Maintenant, définissez les variables sur la valeur correcte. Chaque valeur peut être trouvée sur https://app.loqed.com/API-Config.
Variable | Où trouver la valeur |
pont_ip | Configuration de l'API LOQED -> "Webhooks sortants via LOQED Pont" -> "Adresse IP" |
clé_auth_pont | Configuration de l'API LOQED -> "Webhooks sortants via LOQED Bridge" -> "Clé d'authentification (base64)" |
clé | Configuration de l'API LOQED -> "Clés API (webhooks entrants)" -> "Clé" |
lock_id | Configuration de l'API LOQED -> "Clés API (webhooks entrants)" -> "ID de verrouillage" |
local_key_id | Configuration de l'API LOQED -> "Clés API (webhooks entrants)" -> "ID de clé locale" |
actualiser_time (par défaut 600) | À quelle fréquence (en secondes) l'application rapide interrogera un changement d'état de verrouillage. Nous recommandons de maintenir cette valeur basse. En fait, il n'est nécessaire d'interroger qu'après le démarrage de la passerelle, car tout changement d'état de verrouillage est directement envoyé à la passerelle. Les informations sur la batterie et l'état en ligne ne sont reçues que via une interrogation, bien que le pont LOQED prenne en charge leur envoi. |
extra_errors (par défaut 0) | Définissez sur 1 pour afficher les informations HTTP. |
utilisateur_webhook | Utilisez le nom d'utilisateur de l'étape 3. |
webhook_pass | Utilisez le mot de passe de l'étape 3. Remarque : vous devez supprimer ce champ "secret", puis le recréer en lui donnant à nouveau le nom "webhook_pass". |
home_center_ip | Définissez ici l'adresse IP de votre passerelle. N'utilisez pas une IP de bouclage (127.0.0.1), mais l'adresse IP du réseau local. |
use_webhooks (par défaut 1) | Lorsqu'elle est définie sur 1, toutes les fonctions de Quick App (liées aux webhooks) sont activées à l'aide de l'utilisateur/mot de passe que vous avez créé. Réglez-le sur 0 si vous souhaitez utiliser loop/pol à la place (voir rafraîchir_time ci-dessus). |
Étape 5 : créer des webhooks sur le pont LOQED
Le pont LOQED peut envoyer tout changement d'état de la serrure à votre passerelle dès qu'il se produit. Pour cela, vous devez définir certaines URL sur le LOQED Bridge. Il existe deux manières de procéder :
Si vous possédez un Home Center 3 Fibaro, vous pouvez le faire en cliquant simplement sur un bouton.
Ces boutons ne sont pas disponibles sur les passerelles Home Center 3 Lite, Yubii Home ni Z-Box, en raison de l'absence de prise en charge des nombres à virgule flottante 53 bits dans l'environnement CPU LUA 32 bits (tel qu'utilisé par ces passerelles).Sinon, vous devez le faire manuellement.
Étape 5a : créez des webhooks si vous disposez de Fibaro Home Center 3
Allez dans l'onglet "Modifier et prévisualiser". Cliquez sur le bouton "Créer des webhooks".
Vous pouvez vérifier que l'action a réussi en allant sur https://app.loqed.com/API-Config --> "Webhooks sortants via LOQED Bridge" --> cliquez sur le bouton "Ajouter/supprimer des webhooks". Sur cette page, vous devriez voir plusieurs entrées avec une URL vers votre passerelle.
Remarque : si vous cliquez plusieurs fois par erreur sur le bouton, ne vous inquiétez pas, car le pont ne créera pas de webhooks en double.
Cette QuickApp générera uniquement des webhooks pour les événements « ouvert », « verrou », « verrouillage de nuit » et « inconnu », car ceux-ci sont normalement suffisants pour la plupart des utilisateurs. Les événements d’état de la batterie ou en ligne sont interrogés toutes les 10 minutes par défaut.
Étape 5b : créez des webhooks manuellement (si vous n'avez pas de Fibaro Home Center 3)
Ignorez cette étape si vous avez effectué l'étape 5a.
Vous devez créer 4 webhooks sur le LOQED Bridge pour informer la passerelle des 4 statuts de verrouillage différents.
Aller à https://app.loqed.com/API-Config--> "Webhooks sortants via LOQED Bridge" --> cliquez sur le bouton "Ajouter/supprimer des webhooks". Sur cette page, ajoutez les URL suivantes :
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookNightLock (uniquement pour le déclencheur de verrouillage de nuit)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookDayLock (uniquement pour la gâchette du loquet)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookOpen (uniquement pour la gâchette ouverte)
http://gw_user:gw_password@gw_ip/api/devices/QAID/action/webhookUnknown (uniquement pour le déclencheur d'état inconnu)
Ci-dessus, "gw_user" et "gw_password" sont le nom d'utilisateur et le mot de passe de votre passerelle créés à l'étape 3, "gw_ip" est l'adresse IP de la passerelle, "QAID" est l'ID de périphérique de QuickApp, qui peut être trouvé dans la liste des périphériques (voir l'image ci-dessous où il est 22).
Terminé
C'est tout ! Vous pouvez désormais contrôler votre LOQED Touch à l'aide de Fibaro.
Merci à
Un grand merci à "tinman". Pour toute question et rapport de bug, Tinman peut être contacté via le forum Fibaro ou le marché Fibaro.