Application Note. GenTrack 23e AOB GenTrack 35e AOB. Nouvelles fonctionnalités EaseTrack V1.30

Transcription

1 L esprit Modem Application Note GenTrack 23e AOB GenTrack 35e AOB Nouvelles fonctionnalités EaseTrack V1.30 Référence : EG_EaseTrack_V13x_AN086_000_FR.doc Révision : 000 Date : 21/12/2010 S.A. ERCO & GENER ZI de St. Lambert-des-Levées BP F SAUMUR Cedex Tél. : +33 (0) Fax : +33 (0) infos@ercogener.com SA CAPITAL R.C. SAUMUR B SIRET NAF 322A TVA Intra : FR

2 EG_EaseTrack_V13x_AN086_000_FR.doc Page 2 / 16 Evolution de ce document Révision Modifications Auteur Date 000 CREATION pour EaseTrack V1.30 BBO 21/12/2010 Les principales évolutions de cette documentation par rapport à la version précédente sont facilement identifiables lors de la lecture sur un écran par la couleur bleu du texte. Table des Matières 1. AVERTISSEMENTS: Présentation du document: Mise à jour de l'application EaseTrack V1.3x: MISE A JOUR DU MICROPROGRAMME RENESAS : Mise à jour du GenTrack 23e : Mise à jour du GenTrack 35e : MISE A JOUR DE L'APPLICATION EASETRACK AVEC L'OUTIL "GENTRACK CONFIG" EFFACEMENT DES PARAMETRES OBJETS : MISE A JOUR DU BOOT LOADER : RE-PARAMETRAGE DE LA BALISE : Nouvelles fonctionnalités proposées sur EaseTrack V1.30: TROIS DESTINATAIRES SUR L'APPEL DE CONFORT EN DATI : PARAMETRAGE A DISTANCE VIA SMS : Principe de traitement des SMS de configuration : Conditions de prise en compte des SMS de configuration : Paramétrage du mode de configuration à distance par SMS : Exemple de SMS de configuration envoyé: Liste des commandes AT interdites en mode configuration à distance : DEMANDE DE POSITION VIA SMS : EVOLUTION DU PARAMETRAGE A DISTANCE VIA TCP : Principe : SMS de demande de connexion au serveur TCP : Déroulement de la reconfiguration par TCP : Liste des commandes AT interdites en mode configuration à distance : MODE GSM PERMANENT "STAY ON": Cas du PDS en mode "Stay ON" : Cas du TRACKING en mode "Stay ON" : Cas du DATI en mode "Stay ON" : AUTO-ANSWER MODE : Cas particulier du mode DATI : ENVOI DE LA POSITION VIA SMS EN MODE TRACKING : Cas du mode PDS : Cas du GEOFENCING : ENVOI DES TRAMES ACTIVE ET DEACTIVE EN SMS : EVOLUTION DU PROTOCOLE GIFT DEVERYWARE : EVOLUTION DE GENTRACK CONFIG :... 16

3 EG_EaseTrack_V13x_AN086_000_FR.doc Page 3 / AVERTISSEMENTS: Erco&Gener recommande de lire avec attention l'ensemble des documents liés aux produits GenTrack (User Guide, Notes d'application, Command List). ERCO & GENER ne peut être tenu responsable pour : - Les problèmes survenant d'une utilisation inappropriée du GenTrackxxe. - Les problèmes survenant d'une mauvaise configuration - Les problèmes survenant d'une mauvaise utilisation d'une application logicielle embarquée développée et fournie par un tiers. - Les disfonctionnements survenant de l'absence ou de la mauvaise couverture des réseaux GSM, GPRS et GPS. - Les disfonctionnements si le produit est utilisé pour la surveillance de personnes physiques où la vie humaine est en jeu. ERCO & GENER se réserve le droit de modifier les fonctionnalités de ses produits "GenTrackxxe", "EaseTrack" et "GenTrack Config" sans avis préalable.

4 EG_EaseTrack_V13x_AN086_000_FR.doc Page 4 / Présentation du document: Ce document présente les nouvelles fonctionnalités proposées par l'application EaseTrack V1.30 depuis la version antérieure EaseTrack V1.22. Pour tous détails complémentaires sur ces nouvelles fonctions ainsi que sur les fonctions déjà existantes avec les versions antérieures, merci de vous référer aux documents suivants : Command List EaseTrack : EG_EaseTrack_01_CL_013_yy.pdf User Guide GenTrack 23e / 35e : EG_GenTrack23e_997_UG_005_yy.pdf EG_GenTrack35e_1034_UG_001_yy.pdf User guide GenTrack Config : EG_GenTrack_Config_UG_xxx_yy.pdf Voir les "Infos bulle" dans l'outil GenTrack Config V1.30 Application Note AN075 (descriptif des évolutions EaseTrack V1.2 Application Note Tracking : AN055 / AN071 Application Note DATI : AN Mise à jour de l'application EaseTrack V1.3x: Note très importante : Pour utiliser la nouvelle version EaseTrack V1.30 il est impératif de mettre aussi à jour le microprogramme interne RENESAS en version V225 Sans cette mise à jour, l'application EaseTrack V1.30 ne pourra pas fonctionner. Il est important de suivre dans l'ordre les étapes suivantes : 3.1. Mise à jour du microprogramme RENESAS : Mise à jour du GenTrack 23e : Cette étape est réalisable uniquement avec un socle chargeur GenTrack 23e spécifique (présence de boutons rouge/noir sur le socle) :

5 EG_EaseTrack_V13x_AN086_000_FR.doc Page 5 / 16 - Si vous disposez de ce socle chargeur, se référer alors au document de mise à jour du RENESAS : EG_GenTrack_997_UP-Rn_003_FR.pdf La nouvelle version RENESAS à charger est la GenTrackxxe_V225 - Si vous ne disposez pas de ce socle modifié, le matériel doit nous être retourné (nous contacter) Mise à jour du GenTrack 35e : Le matériel doit nous être retourné (nous contacter) 3.2. Mise à jour de l'application EaseTrack avec l'outil "GenTrack Config" Conditions de mise à jour : La balise doit être au minimum équipée d'une version EaseTrack V1.20 La version EaseTrack s'affiche dans le champ "Balise identification" de l'outil de paramétrage "GenTrack Config". Ouvrir l'actuelle version "GenTrack Config" version V1.20 Aller sur l'onglet Update et cliquer sur "Update GenTrack" Sélectionner le nouveau fichier exemple : EaseTrack_V130.bin Attendre le status : "Done, Gentrack Restarted" (status affiché en bas à gauche de l'écran général) 3.3. Effacement des paramètres objets : Après le chargement de l'application EaseTrack V1.30, il est impératif d'effacer les paramètres objets : Retourner sur l'onglet Update et cliquer sur "Erase Flash Objets" Attendre le status : "Done, Gentrack Restarted" (status affiché en bas à gauche de l'écran général) 3.4. Mise à jour du boot Loader : Attention : la balise doit être équipée de la version Boot loader : 2.36_GT2 Contrôle de la version boot loader en cours : Sous HyperTerminal paramétré à bps 8/N/1, taper la commande: AT+EGMRST=3 La balise se positionne alors dans le menu du boot-loader, la version du boot loader est indiquée en première ligne :

6 EG_EaseTrack_V13x_AN086_000_FR.doc Page 6 / 16 Exemple d'affichage : Bootloader V2.36 GT2 UA Gentrack v2 (HW10 rev F/G) Ren v2.25 hw 23 Power supply voltage = 4,11 V 1 - Update application 2 - Erase objects M - GSM direct access A - Advanced P - Power off E - Exit Dans le cas d'une version antérieure à 2.36 GT2 (ex : 2.31 / 2.27), suivre la procédure de mise à jour du boot loader décrite dans le document : EG_BootLoader_AOB_UP_000_FR.pdf 3.5. Re-paramétrage de la balise : L'effacement des paramètres objets nécessite de re-paramétrer la balise. Ouvrir "GenTrack Config" version V1.30 Cliquer sur "GET" et contrôler l'affichage de la version EaseTrack V1.30 dans la fenêtre "Balise identification" Saisir la configuration souhaitée en utilisant les nouvelles fenêtres proposées dans GenTrack Config. Attention : les fichiers de configuration écrits sous "GenTrack Config" version antérieure (V1.1x et V1.2x) ne peuvent pas être utilisés avec le nouveau "GenTrack Config" V1.30, il faut les recréer.

7 EG_EaseTrack_V13x_AN086_000_FR.doc Page 7 / Nouvelles fonctionnalités proposées sur EaseTrack V1.30: 4.1. Trois destinataires sur l'appel de confort en DATI : Evolution de la fonction existante de 1 vers 3 destinataires autorisés. Désormais 3 destinataires au lieu de 1 seul sont proposés en appel dit "de confort" lors de l'appui sur le bouton Tph en mode DATI. Le paramétrage et le mode de fonctionnement sont identiques pour les destinataires utilisés par le bouton rouge "SOS", L'appel vers les destinataires est géré en mode cascade. La "non réponse" sur timeout ou la détection de l'occupation du distant lancera l'appel du numéro suivant. L'outil de programmation GenTrack Config V1.30 propose désormais une fenêtre de saisie pour ces 3 numéros dit de confort "Comfort" : 4.2. Paramétrage à distance via SMS : Nouvelle fonction Cette fonction permet à partir d'un SMS de modifier ou de lire un ou plusieurs paramètres de la balise distante. L'accès est sécurisé soit par mot de passe, soit par une table de numéros d'émetteurs autorisés et préalablement enregistrés dans la balise Principe de traitement des SMS de configuration : 1 Sans N autorisé - le SMS doit contenir le mot de passe pour être traité - la première commande après le mot de passe doit être de type AT (obligatoire) 2 Avec N autorisé - Le SMS contient un mot de passe

8 EG_EaseTrack_V13x_AN086_000_FR.doc Page 8 / 16 - le mot de passe est correct, il exécute les commandes à suivre (1 ère de type ATxxx) - le mot de passe est incorrecte, rejet total du SMS - Le SMS ne contient pas de mot de passe, la première commande doit alors être obligatoirement de type AT pour être acceptée Conditions de prise en compte des SMS de configuration : N Tel. autorisé PassWord SMS traité Oui Présent et bon OK Oui Absent OK Oui Présent et mauvais KO Non Présent et bon OK Non Présent et mauvais KO Non absent KO Mot de passe : - Mot de passe unique : 4 digits alphanumériques; les majuscules et minuscules sont interprétées. Numéros autorisés : - Le contrôle des numéros émetteurs des SMS est réalisé sur les 8 derniers digits uniquement. Ce traitement ignore l'entête du numéro (codage "national" ou "international") Paramétrage du mode de configuration à distance par SMS : La balise doit être attachée sur le réseau GSM pour accepter le SMS de configuration. Il faut donc avoir programmé la balise en mode "Stay on" pour accepter les SMS entrants : Attention : Après activation de la balise, le mode "Stay ON" laisse le module GSM en permanence sous tension, augmentant de ce fait la consommation avec pour effet de réduire l'autonomie de la balise. Paramétrage de la fonction : Aller dans l'onglet "Remote Config" : Cocher la case "Configuration via SMS" Cocher "Send command responses" si vous souhaitez recevoir un SMS de réponse aux commandes envoyées.

9 EG_EaseTrack_V13x_AN086_000_FR.doc Page 9 / Exemple de SMS de configuration envoyé: Note : La première commande doit obligatoirement commercer par ATxxx Exemple de SMS envoyé avec un mot de passe "0000" [0000 AT+EGWUP=0,2 +EGWUP? #TCPSERV=1] Exemple de SMS reçu sur le mobile à l'origine du SMS émit : 1:OK +EGWUP:0,2 #TCPSERV: 1, " " Détail des réponses reçues : Si la réponse est du type "OK" ou "ERROR" : alors un N d'index est placé devant la réponse. Si la réponse est du type +EG ou #... alors dans ce cas on ne reçoit pas de N d'index devant la réponse Liste des commandes AT interdites en mode configuration à distance : Certaines commandes AT ne sont pas autorisées en configuration à distance. Les commandes non autorisés sont détaillées dans le document EG_EaseTrack_01_CL_013_UK.pdf au chapitre "AT+EGPWD Remote configuration "

10 EG_EaseTrack_V13x_AN086_000_FR.doc Page 10 / Demande de position via SMS : La fonction de paramétrage à distance par SMS autorise désormais la demande de position par SMS: Il faut autoriser la configuration par SMS Mettre le modem en "STAY ON" et "Leave GPS ON" Envoyer la commande à distance en SMS : 0000 AT+GPSPOS Exemple de réponse retournée par la balise nommée "Balise ID23" : Balise ID23: +GPSPOS:2, ,221110, N, W,73.7,1.62,0.618,163.85,07 Note : si "Leave GPS ON" n'a pas été coché, on risque de recevoir la dernière valeur GPS connue. Avec "Leave GPS ON" coché, la commande AT+GPSPOS retournera à chaque fois une valeur rafraichie Evolution du paramétrage à distance via TCP : Evolution de la fonction existante: - Accès sécurisé par mot de passe. - Possibilité d'envoyer un fichier de configuration Principe : Le lancement de la connexion vers le serveur TCP peut être ordonné directement par un SMS. Important : dans ce mode de déclenchement de connexion TCP à partir d'un SMS de configuration, les trames GPS bufférisées et non envoyées ne seront pas envoyées durant cette communication. Seule la configuration à distance sera autorisée. Pour autoriser ce fonctionnement, les fonctions de configuration par TCP et SMS doivent être validées : Dans l'onglet "TCP", il faut aussi activer l'envoi du <EOT> (0x04) afin d'identifier précisément côté serveur la fin de réception des trames GPS. C'est le <EOT> qui va indiquer au serveur que le paramétrage à distance peut commencer :

11 EG_EaseTrack_V13x_AN086_000_FR.doc Page 11 / 16 Côté serveur, seul le caractère <EOT> (0x04) sera reçu pour signifier que le serveur peut démarrer sa séquence de reconfiguration SMS de demande de connexion au serveur TCP : Exemple avec le mot de passe d'accès = AT+EGPWD=99,"0000" Déroulement de la reconfiguration par TCP : Côté serveur TCP : Fin de réception des trames TCP, le serveur reçoit <EOT> (0x04) Tempo d'écoute armée, la balise est en attente du fichier de configuration Le serveur envoie la configuration avec le mot de passe en première ligne de commande : Exemple de configuration : AT+EGPWD=99,"0000"<CR> (0x0d) // envoi du mot de passe "0000" AT+EGWUP=0,1<CR> (0x0d) // première commande de configuration AT+EGBUZ=2 <CR> (0x0d) // seconde commande de configuration <EOX> (0x04) // fin de la configuration par End Of Test <EOT> Important : c'est le caractère <EOT> (0x04) qui valide l'ensemble des commandes AT envoyées depuis le serveur. Sans ce caractère et hormis la première commande de mot de passe AT+EGPWD, aucune commande AT envoyée ne sera traitée par la balise distance. Une fois les commandes traitées par la balise, elle retournera les status des différentes commandes vers le serveur. Exemple des réponses retournées par la balise vers le serveur : PWD OK // ou PWD ERROR si le mot de passé est erroné) OK OK <EOT> // End Of Test (0x04)

12 EG_EaseTrack_V13x_AN086_000_FR.doc Page 12 / 16 Fin de la reconfiguration : Demande de déconnexion 0x03 envoyée depuis le serveur Ou déconnexion automatique déclenchée par la balise sur fin de la temporisation "Configuration timeout" Liste des commandes AT interdites en mode configuration à distance : Comme pour la configuration par SMS, certaines commandes AT ne sont pas autorisées en configuration à distance via TCP. Les commandes non autorisés sont détaillées dans le document EG_EaseTrack_01_CL_013_UK.pdf au chapitre "AT+EGPWD Remote configuration " 4.5. Mode GSM permanent "Stay ON": Extension du mode existant pour : - Autoriser des appels entrants dans tous les modes - Accepter les SMS de reconfiguration dans tous les modes Cas du PDS en mode "Stay ON" : La balise peut recevoir des appels entrants La balise peut recevoir des SMS de configuration Le bouton Tph reste affecté à l'envoi d'une position par SMS avec le login code "SERVICE" Cas du TRACKING en mode "Stay ON" : La balise peut recevoir des appels entrants La balise peut recevoir des SMS de configuration Le bouton Tph devient affecté à l'appel du N de confort, il ne permet plus le réveil de la balise pour une prise de position manuelle. Le bouton rouge SOS n'est pas activé Cas du DATI en mode "Stay ON" : La balise peut recevoir des appels entrants

13 EG_EaseTrack_V13x_AN086_000_FR.doc Page 13 / 16 La balise peut recevoir des SMS de reconfiguration Le bouton Tph reste affecté aux appels de confort, le bouton rouge SOS reste affecté à la fonction d'alerte vocal/sms/tcp Auto-answer mode : Nouvelle fonction Associée au mode "Stay ON", cette nouvelle fonction permet d'autoriser ou non les appels entrants dans les modes TRACKINK et PDS. Pour supprimer la réception d'appels entrants en mode Tracking ou PDS, il faut utiliser le paramétrage suivant : "Auto-answer" : non coché "Audio level" : positionné à Cas particulier du mode DATI : Si une alarme est déclenchée en mode DATI (perte de verticalité ou arrêt de mouvement) le mode réponse automatique en vocal est immédiatement réactivé et ce, quelque soit l'état de la fonction "Auto-answer".

14 EG_EaseTrack_V13x_AN086_000_FR.doc Page 14 / Envoi de la position via SMS en mode Tracking : Nouvelle fonction Désormais, l'envoi des positions est autorisé en SMS et peut être cumulé avec l'envoi en GPRS TCP/IP, on peut donc avoir l'envoi des trames en SMS et/ou TCP. Seule la dernière position de "fix GPS" trouvée est envoyée en mode SMS contrairement au mode TCP qui vide toutes les données qui se trouvent bufférisées et non envoyées. Pour envoyer aussi un SMS d'information (SMS de vie) en cas de perte du GPS, il faut pour cela activer la fonction dans l'onglet GenTrack Config "NO GPS SMS" à une valeur différente de 0. Exemple avec une valeur à 2 (voir tableau ci-dessus), la balise enverra un SMS avec l'identifiant et l'information "NO GPS" au bout de deux trames consécutives NO GPS Cas du mode PDS : Désormais, il faut activer l'envoi par SMS "Send SMS" pour autoriser l'envoi des SMS de type "SERVICE" en mode PDS Cas du GEOFENCING : Si "Send SMS " est coché : Et que Geo-fencing activé à "ALL" mais SMS mis en "Disabled" : : Les trames envoyées en TCP pourront comporter le code "GEO" en cas de mouvement de zone. Par contre, les SMS seront toujours uniquement envoyés avec le code "Tracking" Pour envoyer les SMS avec le code "GEO" il faudra impérativement cocher aussi l'envoi des SMS Geo-fencing

15 EG_EaseTrack_V13x_AN086_000_FR.doc Page 15 / 16 Dans ce cas, le SMS GEOFENCING sera prioritaire sur le SMS Tracking, un seul SMS sera envoyé avec soit l'info Tracking, soit l'info GEOFENCING en cas de mouvement de zone Envoi des trames Active et Deactive en SMS : Evolution Lorsque "Send Tracking SMS "est coché, les trames Active et Deactive sont envoyées dans les deux cas de la fenêtre "Get GPS position" et aussi "Get GPS position + send frame" car cette différence est réservée uniquement à l'envoi en TCP. Si "Do nothing" est sélectionné, aucun SMS ne sera envoyé Evolution du protocole GIFT Deveryware : Le protocole GIFT de DEVERYWARE est enrichi d'un nouveau groupe de données indiquant la condition de l'alerte envoyée. Ce groupe est appelé "Condition" et peut être ajouté à la trame en cochant le paramètre : Note : le détail du protocole GIFT est donné dans le document Command List EaseTrack

16 EG_EaseTrack_V13x_AN086_000_FR.doc Page 16 / Evolution de GenTrack Config : EaseTrack V1.30 doit être utilisé avec la nouvelle version de l'outil de configuration GenTrack Config V1.30 Les principales évolutions sont : Nouvelle fenêtre N de confort Ajout du bouton : Auto-answer Nouvel onglet pour la gestion de la configuration à distance. Fin du document