topic unique The Keys

[flamalex]

Bonsoir,

pour les intéressés de door lock, smart lock, toc toc !!!! 

une idée, un projet, un objet connecté voit le jour fin mars de cette année

fort sympathique tt ça !!!

qu'en pensez vous ? 

la communauté jeedom sur le sujet

https://www.jeedom.com/forum/viewtopic.php?f=39&t=25042

 

 

 

liens:

https://www.the-keys.fr/#grand_public

 

http://bfmbusiness.bfmtv.com/mediaplayer/video/start-up-co-the-keys-la-serrure-connectee-2508-615053.html

 

pour info: le fondateur est tres réactif aux messages 

une demande d'integration sur fibaro est en cours, fibaro tarde à répondre

 

après discussion avec le fondateur, et inscription sur l'appli Ios, celui ci m'a donné un accès "ROLE DEV", vous etes invité à en faire de meme, de fait j'ai accès à la documentation api du server, voir capture ici aprés.

l'offre actuelle (serrure+ gatway + chargeur+ telecommande) pour 199€ frais de port inclus

 

 

L’ API est en https / L’api est celle du serveur. Elle permet de gérer les partages, récupérer les clefs numériques, envoyer l’historique etc.

- La serrure est en BLE 

- La gateway fait le lien entre Internet et la serrure. une nouvelle API permettra à une box domotique de s’y connecter en https pour exécuter des ordres d’ouvertures/fermetures et récupérer les événements.

- L’API server fonctionne en POST / GET et renvoie du JSON "

 

l’API gateway n’existe pas , ils sont entrain de la spécifier et l’écrire avec tous les devs de box qui veulent se joindre à ce projet. Chez JeeDom ils bossent avec Lunarok et s’il y a des devs de Fibaro qui veulent participer aussi ce serait vraiment super ! ils ont contacté fibaro qui n’a pas répondu.

 

 

Réponse aux questions les plus fréquentes

 

 

https://docs.google.com/spreadsheets/d/1iCdEC7qd8aw9ITd6J8VRQPfsrxTnYIZyiWhQy8iOmIw/edit#gid=1308446537

 

 

message du fondateur :

"Pour la doc, je peux mettre les comptes que vous me demandez en ROLE DEVELOPPER"

 

edit:

vous pretez un interet  a ce type de produit

vous souhaitez qu'il dialogue , un jour,avec la box fibaro

alors manifestez vous afin que le developpement s'oriente dans cette direction afin de satisfaire les besoins des uns et des autres de la communauté fibaro.

 

 

 

Modifié le 23 juin 2020 par Lazer

[pepite]

bonjour @flamalex,

 

Je la trouve sympa cette serrure, elle a l'air prometteuse, et start-up serieuse, déjà plein de serrures professionnelles ;-)

 

API ouverte, top !!

 

Faudrait trouver toutes les caractéristiques, j'ai pas encore lu.

 

A priori, il faut une gateway ;-)

Modifié le 8 mars 2017 par pepite

[flamalex]

[flamalex]

Pour JeeDom, Lunarok est en train de faire le plugin. Il devrait y en avoir un avant la fin du kickstarter.

Est-ce que vous voulez organiser un achat groupé pour Fibaro ? y a-t-il un développeur lead avec qui on pourrait avancer un plugin ?

Modifié le 11 mars 2017 par flamalex

[Joacbe]

Salut Flamalex,

 

Ou as-tu eu ces infos sur l'API?

J'ai commandé et reçu cette serrure, je me pencherai bien sur son intégration avec la HC2 (même si je ne suis loin d'être développeur dans l’âme ...).

 

Un gros point noir est l'absence totale de documentation de la part du constructeur, aussi bien sur son API web que sur l'API embarquée dans la Gateway ... En gros, le seul moyen de trouver quelques infos est de faire du reverse engineering du code produit par lunarok pour le module Jeedom.

[flamalex]

Salut Joacbe,

tu es bien plus avancé que moi

je n’ai tjrs rien reçu et pas de news.

la derniere new que j’ai eu, le vendeur souhaitait optimiser les expeditions , serrure +gatway+ telecommande+ module inside pour portail,

donc j’attends tjrs.

pour les infos api, tu dois t’inscrire, il me semble, ici

https://issues.the-keys.fr/login

 

ca remonte, donc je ne sais plus trop,

sinon l’auteur se fera un plaisir de te fournir la doc ou le lien 

[Joacbe]

Merci pour l'info Flamalex.

Pour ce qui est de la com. chez The Keys c'est pas trop ça je trouve ... M'inquiétant de ne pas voir ma serrure arriver, j'ai tenté de les joindre via Kickstarter puis directement par mail comme ils l'ont indiqué et jamais je n'ai eu la moindre réponse. Plusieurs personnes ont fait la demande de doc concernant les API et pour le moment sans retour semble t'il.

 

Je viens de m'inscrire, on va voir s'ils valident mon compte rapidement.

 

Pour le moment, la serrure est vraiment pas mal. Mes seuls reproches sont:

- un jour important entre le châssis de la serrure et la porte (il va falloir que je créer une entretoise ce Week End pour combler ca car c'est vraiment moche)

- la gateway livrée à nu, aucun boitier, rien

- absence totale de doc de quelque sorte que ce soit

- impossible de savoir si la porte est en statut ouverte ou fermée, l'information n'est pas maintenue ou que ce soit

[flamalex]

ah ouhai kan mm !!! 

j’ai kkes kestions

pour l’expedition, tu as ete averti ?

tu avais commandé le tk inside pour serrure portail et le chargeur?

pour cette histoire de « jour important » j’ai vu que c’etait un gros sujet de conversation

mais je n’arrive pas a comprendre, visualiser et imaginer ce que ca donne

 

pour la gateway, oui j’avais cru comprendre kelle est a poil, mais sans doc ou tuto c’est chiant

 

pour le statut serrure, de l’interieur il n’y a pas une led?

apres avec jeedom et fibaro, ca peut s'arranger,

as tu reussi a interconnecter la serrure avec la getway?

Modifié le 21 septembre 2017 par flamalex

[Joacbe]

Pour l'expédition : rien, nada, keudalle. Aucune communication, juste un avis DHL dans ma boite aux lettres un soir...

Non, pas tk: juste la serrure et la gateway.

 

Pour le jour, je ne suis pas chez moi donc pas possible de prendre de photo, ce qui aurait été le plus parlant. Mais il y a un jour de 14mm entre l'arrière de la serrure et ma porte.

 

Mon compte sur issues a été validé et il y a un peu de doc pour la gateway, je regarderai ca ce WE en détail.

[flamalex]

ah en effet c'est moyen, je pensais que l'on recevait un mail de suivi.

pour le "jour" ah oui!, c'est pcq le canon est trop long finalement, cote interieur il aurait fallu que tu aies 10mm de - ?

ils sont nombreux les plaignants concernant ce "jour"

je pense que je vais etre deçu aussi.

Modifié le 21 septembre 2017 par flamalex

[Joacbe]

oui, au lieu de prendre un barillet 30/40 (comme celui que j'avais initialement, j'aurai du prendre un 30/30, ca aurait déjà limité les dégats ...

Mais bon, à défaut d'avoir une imprimante 3D, je vais jouer de la défonceuse sur une plaque de contre plaqué ce WE:)

 

Sinon, j'ai regardé un peu les doc sur leur site issues, pour la gateway, c'est intéressant mais par contre impossible de trouver la doc qui correspond à ton screen shot de mars sur l'API Internet. 

[flamalex]

pour mon screen

Arnaud, le fondateur, m’avait donné un accès admin, que je n’ai plus, c’etait pour ceux qui etaient intéressés pour develop, c pour ca que j’ai de suite posté et demandé de  l’aide!!!

 

lol pour la defonceuse, ca va etre un bon weekend 

 

pour la getway, si tu la connectes avec ip fix et mac apres avec jeedom ca devrait rouler

de mon cote j’ai preparé un vd sur hc2 qui dialoguera avec jeedom pour l’action open/close et le statut qui remontera sur hc2 ou descendra sur jeedom

dialogue dans les 2 sens, en fonction que tu actionnes ta serrure par la telecommande ou par la serrure elle mm ou encore par la hc2( si tu fais des scenarios ca sera pas mal)

 

dans la presentation ci dessous

lunarock fait reference a la getway et precise que le boitier devrait arriver

https://lunarok-domotique.com/2017/08/the-keys-nouvelles-photos/#comment-1916

 

Modifié le 21 septembre 2017 par flamalex

[Joacbe]

Je n'ai pas Jeedom et voudrais éviter de devoir l'installer juste pour ca. Si je peux ne garder que HC2, ca m'ira bien sur la complexité de mon environnement actuel.

 

J'avais effectivement lu le post de Lunarok sur le boitier.

[flamalex]

oui je souhaitais egalement ne pas utiliser jeedom et rester avec ma hc2, mais voyant personne interesse et ayant du tps pour develop un midule sur hc2 pour the key, je m’y suis colle en avril, je ne regrete pas

c’est du boulot, mais c pas msl

je l’utilise en design sur tablette collée au mur

le jeedom ne recoit et envoie que des requêtes http, comme ca si jeedom plante, aucune incidence sur le reste

hc2 reste le maitre

 

sinon niveau technique, questions, je viens de trouver ce lien ici apres,

en effet les colis ne sont pas suivi

et apparement il y a un probleme avec la getway qui ne fonction que 20h et apres fini , lol

mais le probleme est identifié

https://www.jeedom.com/forum/viewtopic.php?f=59&t=25693&start=120

 

pour l’api

Arnaud m’avait donne l’acces a ceci

https://api.the-keys.fr/api/doc/v1

il faut lui demander un nouvelle acces ROLE DEV.

 

edit:  normalement le probleme getway est resolu depuis hier soir.

pour les colis, ils ont tt stop, cause decharge trop rapide de la batterie, cela serait du a un fin de course qui ne faisait pas son job, probleme résolu, reprise des livraisons

Modifié le 23 septembre 2017 par flamalex

[Eliah]

Je relance le sujet.. quelqu'un y arrive avec un VD Fibaro (sans passer par Jeedom ?) ?

[flamalex]

Je n'ai tjrs pas reçu la serrure et gateway, je n'ai donc pas avancé.

il serait en effet intéressant d'avoir qqes retours!!! 

[Eliah]

voici les infos du Wiki de la Gateway, perso j'y comprends rien du tout et je vois pas quoi en faire... si quelqu'un peut aider, je peux faire le béta tester  :

 

Gateway

Fonctionnalités

Paramètre réseau

• Recuperation de l'adresse IP par DHCP.

On ne recupere que les paramètres réseau de base: IP, netmask et gateway.
La gateway ne recupère pas le serveur DNS, ni le proxy si il y en a un.
La gateway ne fonctionne pas si un proxy est utilisé.

• Recuperation de l'IP api.the-keys.fr.

On utilise le serveur DNS de google: 8.8.8.8

Taches récurrentes

• La gateway scan en continue les serrures. Si une serrure annonce qu'elle doit se synchroniser (pour envoyer les informations d'ouverture ou fermeture), la gateway synchronise la serrure

• Toutes les 5s, elle envoie au serveur les informations sur les serrures qu'elle voit. Le serveur en retour renvoie les informations sur les eventuelles synchronisation a faire

• Lors de la synchronisation, si un nouveau firmware est disponible, elle se met a jour

• Dans les informations de synchronisation de la serrure, il y a la mise a jour éventuelle du firmware des serrures

Serveur WS

Liste des serrures

curl http://<ip>/lockers

reponse: 

{"status": "ok", "devices": [{"identifier": 45961123, "rssi": -71, "battery":4065}]}

 

Synchroniser la gateway

curl http://<ip>/synchronize

Reponse:

{"status": "ok", "code": 0}

 

Erreurs:

• Si la gateway est occupé (autre action en cours): 

  {"status": "500", "message": "busy"}
  

Synchroniser une serrure

curl -d "identifier=<id locker>" http://<ip>/locker/synchronize

Réponse:

{"status": "0", "code": "ok"}

 

Erreurs:

• Si la gateway est occupé (autre action en cours): 

  {"status": "500", "message": "busy"}
  

• Serrure non detectée:
  status = 1
  Impossible de se connecter à la serrure

• Serrure non compatible:
  status = 2
  La serrure n'est pas compatible avec la gateway

• Données invalide
  Le serveur api.the-keys.fr a renvoyé des données de synchronisation invalide (c'est un cas possible sur un problème serveur)

Mise à jour de la gateway

La gateway sera mise à jour, meme si le firmware est déjà à jour.

curl http://<ip>/update

Erreurs:

• Si la gateway est occupé (autre action en cours): 

  {"status": "500", "message": "busy"}
  

• Firmware invalide
  status = 1
  Le cas standard est une erreur de téléchargement

• Erreur générique
  status = 2
  Si le serveur ne renvoie pas le firmware.

Mise à jour d'une serrure

curl -d "identifier=<id locker>" http://<ip>/locker/update

Ouvrir une serrure

• Creation du partage

Pour utiliser la gateway depuis une box domotique, il faut d'abord créer un partage entre la serrure et la gateway. 
Chaque gateway à un id unique Comment récupère-t-on cet id?

Il faut ensuite creer le partage en utilisant le WS "createWithAccessory":

    def createShare(self, name, locker, gateway):

        data = {}
        data["partage_accessoire[description]"] = "" 
        data["partage_accessoire[nom]"] = name

        headers={"Authorization": "Bearer %s"%self.token}

        r = requests.post("https://%s/fr/api/v2/partage/create/%s/accessoire/%s"%(self.host, locker, gateway), headers=headers, data=data)
        data = json.loads(r.text)
        code=data["data"]["code"]

 

Le WS renvoie en retour le code du partage.

• Generation du hmac

On utilise un timestamp pour generer le hmac. Le timestamp est unique par requete et on ne peut pas utiliser un timestamp plus ancien que le precedent. 
Exemple en python de la generation du hmac:

ts = str(int(time.time()))
hm = hmac.new(code, ts.encode("ascii"), "sha256")
hash = hm.digest()

 

• Ouverture

Pour l'ouverture, on envoie le timestamp et le hash:

curl -d "identifier=<id locker>&hash=<hash>&ts=<ts>" http://<ip>/open

Réponse:

{"status": "0", "code": "ok"}

 

Erreur:

• Parametre manquant: 
  status = 400
  Le code contient les informations sur le parametre manquant (timestamp, hash ou identifier)

• La serrure n'est pas partagée
  status = 32
  La gateway ne peut pas valider le hmac si il n'y a pas de partage avec elle.

• Hmac invalide
  status = 33

• La serrure n'est pas detectée
  status = 34

• La serrure n'est pas compatible
  status = 35

• Clé invalide
  status = 36
  La gateway a essayé d'ouvrir, mais la serrure a refusé la clé. 
  Verifier que le partage existe et que la serrure est synchronisé dans ce cas.

• Autre erreur
  status = 37
  Tous les cas d'erreurs non identifiés: 
  - La connection à la serrure a echoué
  - La connection s'est coupé
  - La serrure renvoie un timeout

Fermer une serrure

La fermeture se fait comme l'ouverture. il n'y a que l'url qui change:

curl -d "identifier=<id locker>&hash=<hash>&ts=<ts>" http://<ip>/close

Status de la gateway

A partir de la version 17

curl http://<ip>/status

reponse: 

{"version": "16", "current_status": "Scanning..."}

 

Status d'une serrure

La récupération du status se fait comme pour l'ouverture. il n'y a que l'url qui change:

curl -d "identifier=<id locker>&hash=<hash>&ts=<ts>" http://<ip>/locker_status

Il y a 3 codes possibles en réponse:

• Etat inconnue (code 0x30)
  Ce cas se produit quand la serrure vient de démarrer (après une mise a jour par exemple).

• Porte fermée (code 0x31)

• Porte ouverte (code 0x32)

Test rapide

Ci joint les 2 fichiers python qui permettent d'interagir avec la gateway

 ./test.py --help
usage: test.py [-h] [-d] [-i IDENTIFIER] [--host HOST] [-c CODE] action

positional arguments:
  action                open, close, search, synchronize, update,
                        synchronize_locker, update_locker

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug
  -i IDENTIFIER, --identifier IDENTIFIER
                        locker identifier
  --host HOST           host
  -c CODE, --code CODE  code

Par exemple, pour ouvrir:

./test.py --host 192.168.0.26 -i 45961123 -c 'Zmo1sps2OVyCFtl1' open

test.py  (1,2 ko) , 27/09/2017 16:29

gateway.py  (2,85 ko) , 27/09/2017 16:29

[Eliah]

J'ai réussi à faire le début, mais à partir de Ouvrir la serrure : création d'un partage, je vois plus.. je ne sais pas ou il faut taper ces commandes bref c'est la merde !

[pepite]

Bonjour,

 

Sympa la description de l'API, pas mal. elle en est où d'ailleurs cette clé au niveau commercialisation ? vous avez des infos ? Le tarif a changé ou toujours aux alentours des 200 euros ?

 

Voila ce que je comprends :

   - Faut créer un partage entre la Gateway et la Serrure pour récupérer ce qu'ils appellent le "code" : 

         --> https donc net.HTTPClient depuis une scène

        --> puis generation du hmac à partir du timestamp + code récupéré

 

Puis en HTTP avec le hash + timestamp action sur la serrure.

Modifié le 28 novembre 2017 par pepite

[Eliah]

Oui mais bon, contreventement on fait ça comment ?

 

Ils ont livré quasi tout le monde normalement.. je pense qu'elle sera en vente en 2018 au grand public. Pour le moment j'ai de très bon résultat avec cette serrure.. Si seulement je pouvais l'intégrer dans le HC2 ca serait le top :/

[pepite]

Bonjour,

 

Pardon, je n'avais pas compris que tu demandais de l'aide pour le code en LUA ;-) ..j'etais dans les nuages en lisant certainement ;-)

[flamalex]

bjr,

je viens de la recevoir, sans la gateway, je dois a attendre.

lors des tests, il y a gros truc qui me chagrine,

lorsque vous actionnez manuellement la serrure, le statut de celle ci ne remonte pas sur l’appli du telephone. donc a distance, aucun moyen de connaitre le dernier etat exact de la serrure.  

ça c’est gênant, sans ce retour ça va etre compliqué les scénarios

[pepite]

il y a 16 minutes, flamalex a dit :

ça c’est gênant

Genant ;-)

 

Heuu oui effectivement, le retour d'ouverture et fermeture me semble indispensable pour une serrure ;-) connectée.

[Eliah]

non ca n'est pas vraiment gênant puisqu'il y a une commande pour ouvrir et une commande pour fermer. donc il suffit de faire des scènes en conséquence :

- tu veux être sur que ta porte soit fermer à XX heure, tu lances le scénario fermeture de la porte.
- tu veux un retour d'état de ta serrure ? tu fais une scène qui l'ouvre ou qui la ferme en fonction et tu es sur de l'état

 

il n'y aurai qu'une commande pour ouvrir ET fermer, la oui ca serait très problématique ! mais ce n'est pas le cas

 

Malgré tout je pense qu'il manque une fonctionnalité, celle de la fermeture automatique de la serrure après XX secondes. C'était présent sur OkyDokeys et c'était vraiment bien pour être sur que ca se refermait.

Modifié le 29 novembre 2017 par Eliah

[mprinfo]

si j'ai bien compris tu n'as pas de retour d'état ? je trouve que cela est problématique car on suppose que la commande passe à chaque fois

Envoyé de mon SM-G901F en utilisant Tapatalk