Tuesday, October 7, 2014

Aide pour eedomus locator

eedomus locator est une application pour envoyer la position du téléphone à un périphérique de type traceur GPS sur la box eedomus. Elle peut-être téléchargée sur Google Play: eedomus locator
Le principal problème rencontré est de configurer correctement les paramètres de connexion. Ce post montre comment configurer et tester les paramètres de connexion.

1) Obtenir les identifiants API eedomus
Dans les Paramètres Expert du traceur GPS cliquer sur l'icône clée:
Sur cet écran se trouve le code API (6 chiffres) du traceur GPS.

Fournir le mot de passe de votre eedomus pour accéder les identifiants API qui permette d'afficher cet écran:

2) Valider que le traceur GPS fonctionne avec vos identifiants:
Cliquer sur cette URL:
https://api.eedomus.com/set?action=periph.value&periph_id=XXXXXX&value=51,3.0&api_user=XXXXXX&api_secret=XXXXXXXXXXXXXXXX
Remplacer les XXX... en faisant des copier coller pour eviter toute erreur.
Dans l'ordre on a:

  • Code API (6 chiffres)
  • api_user (6 chiffres et lettres)
  • api_secret (16 chiffres et lettres)


La valeur 51,3.0 correspond à la position GPS (latitude=53, longitude=3.0). Cette valeur peut être modifiée pour envoyer une autre position. L'application eedomus locator se contente de faire exactement le même appel HTTP avec les coordonnées (lat/lng) actuelles données par le téléphone.

Si l'appel HTTP a retourné success, la position envoyé devrait apparaître sur le traceur GPS:


Sur le détail on peut voir le détail des valeur envoyées:

Pour voir plusieurs valeurs test identiques il faut sélectionner Tout afficher.

3) Valider sur le téléphone l'accès à l'API eedomus
Pour cela je m'envoi un mail avec l'URL testée dans le navigateur sur le PC

Je copie également les données de configuration: API code, api_user et api_secret sur des lignes distinctes: C'est pour faire facilement des copier-coller pour l'étape suivante.

Sur le téléphone, afficher le mail et cliquer sur le lien. Le résultat doit être identique au test de l'étape 2). Si ce n'est pas le cas le téléphone n'arrive pas à accéder l'API eedomus. Il s'agit très probablement d'un problème réseau: Téléphone pas connecté au WIFI de la maison ou pas d'accès données sur le téléphone.

4) Configurer exactement les mêmes valeurs sur eedomus locator
Lors du premier démarrage de eedomus locator l'écran de configuration est automatiquement affiché. Sinon sélectionner menu -> Setting dans l'application eedomus locator pour arriver à cet écran:


Pour éviter tout risque d'erreur reprendre les données envoyées par mail à l'étape précédente et faire des copier-coller entre le mail et l'écran de configuration eedomus locator.

Une fois les données saisies, appuyer sur le bouton Connect. Les paramètres sont enregistrés dans l'application. Dans la version actuelle aucun test n'est effectué sur les paramètres saisis.

L'écran principal de eedomus locator devrait être affiché:
Le bouton test permet de forcer l'envoi des coordonnées de test (lat=51/lng=3). Si le test à l'étape 3) a fonctionné, l'envoi cette requête test doit fonctionner également.

N'hésitez pas à me contacter ou laisser des commentaires sur cette page en cas de difficultés.

Note importante:
J'ai corrigé un bug important (07/10/2014 22:00) qui empêchait l'envoi de la requête sur certaines versions. Je n'ai pas encore mis à jour l'application sur Google Play mais l'APK corrigé peut-être téléchargé à cette adresse: https://s3-eu-west-1.amazonaws.com/godestalbin-web/apk/app-release.apk