Wednesday, December 28, 2016

Documentation eedomus locator pour beta testers

Une version beta d'eedomus locator est disponible sur le Google Play store. Pour devenir beta tester vous devez utilisez le lien suivant pour acter votre participation.

En cas de problème contacter moi par mail. Vous pouvez trouver mon address sur le Google Play Store: eedomus locator

Principes

Besoin principal: Ouvrir automatiquement la porte de mon garage lorsque je rentre le soir à vélo de mon travail.
  1. Envoyer la position à la box eedomus (au traceur GPS) pour gérer des actions.
  2. Minimaliser l'usage réseau de données téléphonie mobile (je fonctionne avec un forfait Free à 2€ 50Mo/mois).
  3. Minimaliser la consommation d'énergie
Pour réaliser le point 2, je devais renseigner la position GPS de ma box/maison.  De plus régulièrement les actions n'était pas enclenchées alors que les positions GPS étaient bien reçues par le traceur GPS. Du coup, il me semblait plus simple de ne pas utiliser le traceur GPS et d'enclencher directement des actions. Cependant envoyer des positions GPS au traceur GPS reste possible.

Le schéma suivant résume le fonctionnement prévu de l'application:

Lorsque la position est à une distance supérieure à Far distance, la position (approximative) par le réseau téléphonie mobile est relevée toutes les 10 minutes.
Lorsque la position est à une distance supérieure Close distance et inférieure à Far distance, la position GPS est relevée toutes les 60 secondes et la position est envoyé au traceur GPS (si paramètre API renseigné).
Lorsque la position est à une distance supérieure à Target distance et inférieure à Close distance, la position GPS est relevée toutes les 15 secondes et la position est envoyé au traceur GPS (si paramètre API renseigné).
Lorsque la position est à une distance inférieure à Target distance, l'action API est éxécutée et le service est arrêté.

Comme dernièrement je ne fonctionnais qu'avec la dernière option, il est possible que les autres actions ne soient pas correctment éxécutées (notamment la mise à jour du traceur GPS). Informez moi des problèmes rencontrés et je ferais les corrections nécessaires.

Ecran principal

L'application fonctionne comme un service.
L'écran principal permet d'afficher le log du service.
Start: Démarre le service
Stop: Arrête le service
Open garage: Non opérationnel. Je l'utilise pour ouvrir mon garage manuellement lorsque le l'ouverture automatique n'a pas fonctionné.
Settings: Ecran des paramères.
Options: Boutton à supprimer, tous les paramètres ont été regroupés dans un seul écran.

Ecran des paramètres



  • API user/API secret sont les codes pour faire des appels API à l'eedomus. Pour les détails consulter la documentation de l'application actuelle.
  • Geolocation API code: code API du périphérique traceur GPS
  • Home latitude/longitude: coordonnées GPS de la box maison ou box eedomus.
  • Optional macro API code/Optional macro API code (virtual state): Ici je dois revoir ce que j'ai fait. En fait on ne devrait avoir qu'un code API avec une valeur à envoyer.
  • Target/Close/Far distance: Les distances utilisés selon le mode de fonctionnement explicité dans le schéma.
  • Auto start at: Timer pour démarrer l'application automatiquement à une heure donnée.
  • Save: sauvegarder les paramètres modifiés
  • Test: envoyer une position aléatoire au GPS: Requiert de renseigner les 5 premiers paramètres. Permet de valider que l'application communique bien avec la box.