Intégration de la Nuki Smart Lock dans Eedomus

Intégration de la Nuki Smart Lock dans Eedomus

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 😉

 

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.

01 Intégration de la Nuki Smart Lock dans Eedomus

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

01-1 Intégration de la Nuki Smart Lock dans Eedomus

Activez l’ « API http ».

02 Intégration de la Nuki Smart Lock dans Eedomus

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

03 Intégration de la Nuki Smart Lock dans Eedomus

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

04-1 Intégration de la Nuki Smart Lock dans Eedomus

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

05-1 Intégration de la Nuki Smart Lock dans Eedomus

 

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é

06-1 Intégration de la Nuki Smart Lock dans Eedomus

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 :

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.

07-1 Intégration de la Nuki Smart Lock dans Eedomus

 

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 »

08-1 Intégration de la Nuki Smart Lock dans Eedomus

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.

09-1 Intégration de la Nuki Smart Lock dans Eedomus

 

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 »

10 Intégration de la Nuki Smart Lock dans Eedomus

Les valeurs possibles sont :

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

Voici ce que cela donne.

11-1 Intégration de la Nuki Smart Lock dans Eedomus

 

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.

12-1 Intégration de la Nuki Smart Lock dans Eedomus

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 😉

Damien

<p>Chef de projet dans l’informatique, je me suis lancé dans la domotisation de ma maison il y maintenant cinq ans. Aujourd’hui je touche à plusieurs box et test pas mal de produits pour Nord-Domotique.</p>

View more articles Subscribe
Leave a response comment3 Responses
  1. Jorka57
    novembre 29, 21:33 Jorka57

    Hello
    Normal pour tes doublons :
    Il te manque l’ouverture de la porte !
    Jonathan

    reply Reply this comment
  2. Constantin
    décembre 07, 20:28 Constantin

    Salut,
    excellent tuto ! Je te remercie cela me sera bien utile pour ma prochaine intégration de cette serrure 😀

    reply Reply this comment
mode_editLeave a response

Your e-mail address will not be published. Also other data will not be shared with third person. Required fields marked as *

menu
menu