Intégration de la serrure connectée Nuki sous Eedomus

 

Bonjour après vous avoir fait la présentation complète de la serrure Nuki en deux parties ICI et ICI ainsi que le pilotage à la voix via le Google Home ICI, je continue son intégration cette fois dans une solution domotique qui est Eedomus via le petit tutoriel que je vous présente maintenant.

Ce que j’apprécie beaucoup avec cette intégration, c’est la possibilité d’intégrer la serrure directement dans des scénarios que vous allez ou vous aurez déjà mis en place.

Son intégration se fait directement depuis le Store qui a été mis en place au mois de Septembre et dont je me répète ne cesse de grandir. Il a été développé par « Nikya63 » dont je tiens à remercier et à féliciter pour son travail. Comme indiquer dans la documentation, il ne sera pour le moment possible de gérer qu’une seule serrure à la fois. Par contre vous le verrez dans le tutoriel, la remontée d’information ne sera pas complète mais vous verrez il sera possible de contourner ce soucis.

Vous pouvez retrouver cette serrure connectée seule au tarif de 229.00 € que vous pouvez retrouver ICI ou dans sa version combo ( serrure + bridge ) à 299.00 € en cliquant ICI. Le bridge est également disponible séparément pour les personnes ayant déjà la serrure au tarif de 99.00 € que vous pouvez retrouver ICI.

 

1° Pré-recquis avant intégration sous Eedomus :

Dans un premier avant toute chose, je vous invite à relire la partie « Nuki Web » qui sera obligatoire avant de vouloir entreprendre l’intégration sous Eedomus.

Vous pouvez retrouver ce tutoriel dans l’article concernant le pilotage de la serrure via le Google Home que vous pouvez retrouver ICI.

 

Dans l’application :

En restant toujours sur l’application, il faudra aller chercher quelques informations comme :

• L’adresse IP.
• Le port.
• Le jeton de l’API.

Pour se faire lorsque vous êtes sur la page d’accueil, il faut aller dans « Gérer la Bridge ».

 

Maintenant vous pouvez de nouveau cliquer sur « Gérer la Bridge ».

 

Comme il l’est demandé, il suffit d’appuyer sur le bouton se situant au milieu de la Bridge pendant 10 secondes. Attention à environ 5 secondes, la LED s’allume mais il faut maintenir jusqu’à temps que le voyant clignote.

 

Cliquez sur la Bridge pour accéder à son paramétrage.

 

Maintenant vous avez accès à une partie des informations que vous aurez besoin, cité plus haut. Il faudra bien entendu noter ces informations pour la suite.

 

Dans l’Eedomus :

Malheureusement encore un peu de manipulation sera requis mais cette fois-ci sous Eedomus. Il va nous falloir créer un actionneur http pour récupérer le numéro d’ID de la serrure car malheureusement celui que relève le périphérique dans le store c’est celui de la Bridge et ne fonctionnera pas.

Pour se faire, sur la page d’accueil d’Eedomus, il faut allez dans « Configuration ».

 

Puis « Ajouter ou supprimer un périphérique ».

 

Cliquez sur « Ajouter un autre type de périphérique »

 

Sélectionner le « http Capteur » et enfin cliquez sur « Créer ».

 

Pour cette partie, pas besoin de s’attarder dessus car ce périphérique va juste nous être utile une seule fois et après on pourra le supprimer. Il faut simplement lui mettre un « Usage », de « Sauver et continuer à éditer » et enfin de cliquer sur l’onglet « Valeurs ».

 

Cliquez sur « Ajouter » pour intégrer une valeur. Maintenant il faut servir de nos précédentes annotations sur l’application :

• Dans valeurs brutes, il faudra noter l’adresse IP + Le port attribué : http://XXX.XXX.X.XX:XXXX/list
• Dans le type : laisser sur « GET ».
• Dans les paramètres, il faudra noter le numéro de jeton API : ?token=XXXXXXX

Une fois le tout de rentre, il faut simplement cliquer sur « Tester ».

 

Voilà maintenant vous avez l’ID de votre serrure :

 

Une fois le numéro d’ID de noté, on peut supprimer le périphérique que l’on vient de créer.

 

2° Intégration sous Eedomus via le Store :

Maintenant que l’on a tout en main et tout de noté, on peut passer à son intégration.

Pour se faire, sur la page d’accueil d’Eedomus, il faut allez dans « Configuration ».

 

Puis « Ajouter ou supprimer un périphérique ».

 

Cliquez sur « Store Eedomus ».

 

Faites une recherche dans les « Objets connectés » et enfin sélectionner « Nuki serrure intelligente ».

Cliquez Sur « Créer ».

 

Dans la partie « Configuration du périphérique », il faudra ajouter :

• Le nom personnalisé.
• La pièce dans laquelle elle sera attribuée.
• L’adresse IP ainsi que le port (XXX.XXX.X.XX:XXXX).
• Le numéro d’ID de la serrure.
• Le numéro de Jeton.

 

Voici ce que cela donne une fois de retour sur le Dashboard. Et oui comme vous avez pu le voir, la remontée de l’état de la porte ainsi que la remontée de l’état des piles ne remonte pas. La demande a été faite auprès de son développeur mais pour le moment pas de nouvelle. Par contre l’action que ce soit pour le verrouillage ou le déverrouillage fonction sans soucis.

 

3° Intégration sous Eedomus en manuel :

Vu que l’intégration ne fonctionne pas complètement via le store et si vous souhaité avoir la totalité des informations remontant de votre serrure, il est tout à fait possible de créer un actionneur http ainsi que deux capteurs http.

Si toutefois vous avez déjà inclus votre serrure via le store, il est tout à fait possible de faire disparaître les deux capteurs ne fonctionnant pas pour le moment en ne les attribuant à aucune pièce.

Je vais vous montrer dans ce chapitre, pour les trois périphériques à créer :

Actionneur pour la serrure Nuki :

Pour se faire, sur la page d’accueil d’Eedomus, il faut allez dans « Configuration ».

 

Puis « Ajouter ou supprimer un périphérique ».

 

Cliquez sur « Ajouter un autre type de périphérique »

 

Sélectionner le « http actionneur » et enfin cliquez sur « Créer ».

 

Dans la partie « Configuration du périphérique », il faudra ajouter :

• Le nom personnalisé.
• L’usage auquel il est destiné. Pour ma part cela sera « Autre ».
• La pièce dans laquelle elle sera attribuée.
• Dans la variable 1 [VAR1] indiqué l’adresse IP ainsi que le port (XXX.XXX.X.XX:XXXX).
• Dans la variable 2 [VAR2] indiqué le numéro d’ID de la serrure.
• Dans la variable 3 [VAR3] indiqué le numéro de Jeton.

Une fois le tout indiqué, il va falloir aller dans l’onglet « Valeur ».

 

Pour la partie « Valeurs » il va falloir ajouter quatre lignes pour les différentes commandes :

• 1 : Déverrouiller.
• 2 : Verrouiller.
• 3 : Débloquer.
• 4 : Lock N’Go.

On va prendre exemple de la première ligne « Déverrouiller », il va falloir rentrer les différentes valeurs dans les cases qui vont bien dans :

• La valeur brute : 1
• Image : vous pouvez importer votre propre image ou choisir parmi la banque d’image disponible.
• Description : Déverrouiller.
• URL : http://[VAR1]/lockAction
• Type : GET.
• Paramètres : ?nukiId=[VAR2]&action=1&token=[VAR3]

A chaque nouvelle ligne, il faudra changer le numéro de l’action par sa valeur brute.

 

Capteur pour connaître l’état de la serrure Nuki :

Pour la partie des capteurs, on refait la même procédure qu’au départ mais au lieu de choisir un « http actionneur », il va falloir cliquer sur « http capteur ».

 

Dans la partie « Configuration du périphérique », il faudra ajouter :

• Le nom personnalisé.
• L’usage auquel il est destiné. Pour ma part cela sera « Autre indicateur ».
• La pièce dans laquelle elle sera attribuée.
• Type de données : Liste de valeurs.
• URL de la requête : http://[VAR1]/lockState?nukiId=[VAR2]&token=[VAR3]
• Chemin XPATH : /root/state
• Fréquence de la requête : j’ai laissé sur 60 minutes.
• Dans la variable 1 [VAR1] indiqué l’adresse IP ainsi que le port (XXX.XXX.X.XX:XXXX).
• Dans la variable 2 [VAR2] indiqué le numéro d’ID de la serrure.
• Dans la variable 3 [VAR3] indiqué le numéro de Jeton.
• Ne pas oublier de cocher la case « Convertir le JSON en XXML sinon vous aurez un message d’erreur.

Une fois le tout indiqué, il va falloir aller dans l’onglet « Valeur ».

 

Voici le message d’erreur auquel vous aurez le droit.

 

Pour la partie « Valeurs » il va falloir ajouter neuf lignes pour les différentes commandes :

• 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.

 

Capteur pour connaître l’état des piles de la serrure Nuki :

Toujours la même procédure que précédemment, il va nous falloir créer à nouveau un « http capteur » pour en savoir plus sur l’état des piles.

Dans la partie « Configuration du périphérique », il faudra ajouter :

• Le nom personnalisé.
• L’usage auquel il est destiné. Pour ma part cela sera « Autre indicateur ».
• La pièce dans laquelle elle sera attribuée.
• Type de données : Liste de valeurs.
• URL de la requête : http://[VAR1]/lockState?nukiId=[VAR2]&token=[VAR3]
• Chemin XPATH : /root/batteryCritical
• Fréquence de la requête : j’ai laissé sur 60 minutes.
• Dans la variable 1 [VAR1] indiqué l’adresse IP ainsi que le port (XXX.XXX.X.XX:XXXX).
• Dans la variable 2 [VAR2] indiqué le numéro d’ID de la serrure.
• Dans la variable 3 [VAR3] indiqué le numéro de Jeton.
• Ne pas oublier de cocher la case « Convertir le JSON en XXML sinon vous aurez le message d’erreur que je vous ai montré précédemment.

Une fois le tout indiqué, il va falloir aller dans l’onglet « Valeur ».

 

Dans la partie « Valeurs » on aura besoin de seulement deux lignes :

• 0 : Piles Ok.
• 1 : Piles à Remplacer.

 

Voici ce que cela donne les périphériques.

 

4° Conclusion :

Comme vous avez pu le voir, l’intégration via le store n’est pas pleinement opérationnelle c’est pour cela que je vous ai également mis son intégration via les différentes capteurs et actionneurs. Sinon autrement son pilotage est légèrement plus long que de passer via l’application en elle-même mais pour moi son intégration sous Eedomus me permet surtout de pouvoir interagir avec mes scénarios que j’ai mis en place dans différentes situations.

Je trouve que cela est vraiment pas mal pour ceux qui ne veulent pas laisser activer le GPS de leur Smartphone ( pour économiser de la batterie ) et de l’intégrer via le système de géolocalisation de leur box domotique.

Le dernier article sur la serrure Nuki sera sur l’intégration de celle-ci sous Jeedom et il sera largement plus rapide car elle s’intègre très rapidement.