Lors de mon dernier article sur la Nuki Smart Lock, je vous annonçais que celle-ci disposait d’une API HTTP, ce qui pourrait être utile pour une éventuelle intégration et gestion de celle-ci via nos box domotique.

Je me suis donc attelé à essayer d’intégrer la Nuki Smart Lock dans ma Eedomus. C’est chose faite depuis hier soir 🙂

J’ai de suite prévenu l’équipe de chez Connected Object afin qu’ils ajoutent la Nuki Smart Lock dans la liste des périphériques compatibles via une prochaine mise à jour et qu’ils automatisent son intégration.

Pour ceux qui n’auraient pas la patience d’attendre, voici la procédure à suivre pour tout créer manuellement 😉

La Smart Lock de Nuki – serrure électronique Bluetooth – ouverture automatique de la porte via...

• CONFORT AU QUOTIDIEN - Ouvrez et fermez votre porte d'entrée avec votre smartphone (iOS & Android) ou une smartwatch.
• AUTO UNLOCK - La serrure électronique Nuki ouvre automatiquement la porte à votre retour à la maison. Il suffit d'avoir votre smartphone dans votre poche!

Acheter sur Amazon

Action préalable à exécuter via l’application Nuki

Dans un premier temps il y a un certain nombre d’actions à exécuter sur l’application Nuki afin de connaitre les informations pour se connecter à votre Nuki Smart Lock.

Pour commencer il faut mettre votre Nuki Bridge en mode maintenance. Pour cela :

• Débranchez-le s’il est branché.
• Appuyez sur le bouton puis tout en le maintenant rebranchez le Nuki Bridge.
• Laissez appuyé jusqu’à ce que la led clignote.

Une fois en mode maintenance, entrez dans l’application Nuki puis cliquez sur « Gérer la bridge » depuis le menu de l’application.

Activez l’ « API http ».

L’adresse IP et le port seront spécifiés. Un jeton vous sera également donné.

Notez les !

Rendez-vous ensuite sur le portail Eedomus.

Intégration de la Nuki Smart Lock dans Eedomus

Une fois connecté à votre compte Eedomus, cliquez sur « Configuration », sur « Ajouter ou supprimer un périphérique » puis sur « Ajouter un autre type de périphérique ».

Il y aura 4 périphériques à créer :

• 2 actionneurs HTTP (dont 1 pourra être supprimé à la fin de la procédure).
• 2 capteurs HTTP.

Création de l’actionneur permettant de récupérer le Nuki ID

Créez un premier « HTTP – Actionneur » sans variables. Pour ma part je l’ai nommé « test list » de toute façon c’est ce capteur qui pourra être supprimé par la suite.

Cliquez sur l’onglet « Valeurs » afin de renseigner une valeur avec :

• En URL: l’adresse_IP_de_votre_Nuki_Bridge:Le_port/list
• En Type: GET
• En paramètre: ?token=le_code_jeton_relevé_avant

Appuyez sur « Tester » afin de tester la requête et notez le nukiId dans le résultat renvoyé.

Création de l’actionneur permettant de verrouiller ou déverrouiller la Nuki Smart Lock

Créer un nouvel « HTTP – Actionneur ». Choisissez un nom, un usage ouverture et une pièce.

Remplissez les champs « Variables utilisateurs » avec :

• En VAR1: l’adresse_IP_du_nuki_Bridge:le port
• En VAR2: Le Nuki ID relevé
• En VAR3: Le jeton relevé

Cliquez sur l’onglet « Valeurs » afin de créer les 3 valeurs possibles.

• Déverrouiller
• Verrouiller
• Lock n’ Go

Pour chacune des 3 valeurs mettre :

• En URL: http://[VAR1]/lockAction
• En type: GET
• En paramètre: ?nukiId=[VAR2]&Action=n°_action&token=[VAR3]

Remplacez dans la ligne « paramètre » le n°_action par l’action à effecuer sur la Nuki Smart Lock, à savoir :

• 1 : Déverrouiller
• 2 : Verrouiller
• 3 : Lock n’ Go

Voici ce que cela donne.

Création du capteur HTTP pour connaître l’état de la Nuki Smart Lock

Créer un « HTTP – Capteur » pour remonter l’état de la Nuki avec :

• En « Liste de valeurs »
• En URL: http://[VAR1]/lockState?nukiId=[VAR2]&token=[VAR3]
• En XPath: /root/state
• En VAR1: l’adresse_IP_du_Nuki_Bridge :le_port
• En VAR2: Le Nuki ID relevé
• En VAR3: Le jeton relevé
• Ne pas oublier de cocher la case « Convertir le JSON en XML »

Les valeurs possibles sont les suivantes :

• 0 : Serrure non calibrée
• 1 : Verrouillée
• 2 : Se déverouille
• 3 : Déverouillée
• 4 : Se verrouille
• 5 : Déverrouillée
• 6 : Lock n’ Go
• 7 : Se déverouille
• 254 : Moteur bloqué
• 255 : indéfini

Il y a deux fois « Déverrouillée » et se « Se déverrouille » ne me demandez pas pourquoi lol 🙂

Voici ce que cela donne.

Création du capteur permettant de remonter l’état des piles

Créer un autre « HTTP – Capteur » pour l’état de la batterie avec :

• En « Liste de valeurs »
• En URL: http://[VAR1]/lockState?nukiId=[VAR2]&token=[VAR3]
• En XPath: /root/batteryCritical
• En fréquence de requête: J’ai mis 120mn, j’aurais même pu mettre plus pas besoin de connaitre l’état des piles toutes les 5mn !!
• En VAR1: l’adresse IP + le port
• En VAR2: Le Nuki ID relevé
• En VAR3: Le jeton relevé
• Ne pas oublier de cocher la case « Convertir le JSON en XML »

Les valeurs possibles sont :

• 0 : Niveau de batterie correct
• 1 : Niveau de batterie critique

Voici ce que cela donne.

Conclusion

Maintenant que tout est créé, vous pouvez supprimer le premier actionneur HTTP permettant de récupérer le Nuki ID.

Voilà votre Nuki Smart Lock est prête à être utilisée via votre Eedomus grâce à ses 3 périphériques.

Vous-pouvez maintenant imaginer tout un tas de règles du genre faire un Lock n’ Go lorsque vous faite le code d’activation de l’alarme, envoyer un sms lorsque l’état de la Nuki Smart Lock devient déverrouillée, …

Pour ceux qui ne voudraient pas se lancer dans l’intégration manuellement, sachez que l’équipe de Connected Object devrait intégrer la Nuki Smart Lock dans une mise à jour prochainement 😉