Application Note. EaseLoc Mise à jour de l application Over The Air (DOTA)

Transcription

1 L esprit Modem Application Note EaseLoc Mise à jour de l application Over The Air (DOTA) Référence : EG_EaseLoc_DOTA_AN122_000_FR Révision : 000 Date : 20/08/2013 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 2630Z TVA Intra : FR

2 EG_EaseLoc_DOTA_AN122_000_FR Page 2 / 9 Evolution de ce document Rév. Modifications Rédaction Date Validation Date 000 Création BBO 20/08/2013 OCH 20/08/2013 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.

3 EG_EaseLoc_DOTA_AN122_000_FR Page 3 / 9 TABLE DES MATIERES 1 AVERTISSEMENTS PRESENTATION : MISE A JOUR SANS EFFACEMENT DE LA FLASH STOPPER LES FONCTIONS DE STOCKAGE ET D ENVOI: CONTROLE DE LA FERMETURE DE LA CONNEXION GPRS: SI LES PARAMETRES FTP N ONT PAS ETE ENREGISTRES DANS LE MODEM: MISE A JOUR AVEC EFFACEMENT DE LA FLASH EFFACEMENT DE L ENSEMBLE DE LA ZONE FLASH: ENVOI DES PARAMETRES GPRS ET FTP : LANCEMENT DE LA MISE A JOUR FTP ENVOI DE LA COMMANDE DE MISE A JOUR : RECEPTION DU SMS DE CONFIRMATION DE MISE A JOUR : Mise à jour réussie Echec de la mise à jour : RECHARGER UNE CONFIGURATION CLIENT EXEMPLE DE RECONFIGURATION A ENVOYER :... 9

4 EG_EaseLoc_DOTA_AN122_000_FR Page 4 / 9 1 Avertissements ERCO & GENER recommande de lire avec attention l'ensemble des documents liés aux produits GenLoc 41e et GenLoc 54e (User Guide, Notes d'application, AT Command List). ERCO & GENER ne peut être tenu responsable pour : - Les problèmes survenant d'une utilisation inappropriée du GenLoc xxe. - 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 "GenLoc xxe", et "EaseLoc" sans avis préalable.

5 EG_EaseLoc_DOTA_AN122_000_FR Page 5 / 9 2 Présentation : EaseLoc offre la possibilité de mettre à jour à distance la version d'easeloc sans avoir à intervenir manuellement sur le modem. La mise à jour est réalisée par DOTA «Download Over The Air» par liaison GPRS et depuis un site FTP hébergé par l utilisateur (ERCO&GENER ne fournit pas de site FTP hébergeant les versions EaseLoc). La mise à jour est pilotée par SMS depuis un téléphone mobile ou un modem GSM. L abonnement souscrit avec la carte SIM du modem GenLoc supportant EaseLoc, doit autoriser les services GPRS et SMS. la plupart des mises à jour EaseLoc nécessitent l effacement complet de la zone Flash contenant l application, le paramétrage et le buffer des trames enregistrées. Si la mise à jour nécessite d effacer cette zone, un avertissement est donné en début de la Release Note de la version correspondante. Après la mise à jour, il faudra renvoyer la configuration complète au modem par SMS (voir descriptif au chapitre 5) Notes : pour une meilleure lisibilité de la syntaxe des SMS à utiliser, le symbole noté _ représente le caractère espace (0x20). Le mot de passe utilisé dans les exemples suivants est : 0000 Le contenu du SMS envoyé ne doit pas dépasser 160 caractères (mot de passe et espaces inclus) Présentation des échanges par SMS : Désigne le texte du SMS à envoyer vers le modem SMS de réponse retourné par le modem

6 EG_EaseLoc_DOTA_AN122_000_FR Page 6 / 9 3 Mise à jour sans effacement de la Flash 3.1 Stopper les fonctions de stockage et d envoi: Afin de sécuriser la phase de téléchargement et de mise à jour, il est fortement conseillé de stopper le stockage cyclique ainsi que la connexion GPRS active : 0000_AT+LOCSTK=0_+LOCSND= xxxxxxx +LOCSTK:OK +LOCSND:OK A la réception du SMS de réponse, attendre 1 minute le temps que la connexion GPRS active se ferme. 3.2 Contrôle de la fermeture de la connexion GPRS: Cette étape facultative permet de contrôler si la connexion GPRS est active ou stoppée: 0000_AT+LOCSND?_+CGPADDR=1 Exemples de réponses : xxxxxxx +LOCSND: 0,"I","00:00",0,0 +CGPADDR: 1, " " " " : l adresse IP est toujours valide, la connexion GPRS n est pas fermée xxxxxxx +LOCSND: 0,"I","00:00",0,0 +CGPADDR: 1, " " " " l adresse IP n est plus valide, la connexion GPRS est fermée 3.3 Si les paramètres FTP n ont pas été enregistrés dans le modem: Envoyer dans un seul SMS les paramètres de l accès au serveur FTP contenant la nouvelle application EaseLoc à télécharger. 0000_"AT+LOCFSV="myFTPserver"_+LOCFUN="myUseName"_+LOCFPW="myPass word"_+locfpt=myportnumber xxxxxxx +LOCFSV:OK +LOCFUN:OK +LOCFPW:OK +LOCFPT:OK Passer au chapitre 5

7 EG_EaseLoc_DOTA_AN122_000_FR Page 7 / 9 4 Mise à jour avec effacement de la Flash 4.1 Effacement de l ensemble de la zone Flash: Cette commande a pour effet d effacer l ensemble des paramètres et des trames sauvegardées puis de relancer l application avec ses paramètres usine : 0000_AT+EGMFLH=3 Pas de SMS de réponse 4.2 Envoi des paramètres GPRS et FTP : Envoyer dans un seul SMS les paramètres de l APN GPRS et l accès au serveur FTP où sera hébergée l application EaseLoc à télécharger. 0000_AT+LOCASV=="myAPN_"AT+LOCFSV="myFTPserver"_+LOCFUN="myUseNa me"_+locfpw="mypassword"_+locfpt=myportnumber xxxxxxx +LOCASV:OK +LOCFSV:OK +LOCFUN:OK +LOCFPW:OK +LOCFPT:OK Passer au chapitre 5 5 Lancement de la mise à jour FTP 5.1 Envoi de la commande de mise à jour : Cette commande déclenche le processus de récupération en GPRS FTP du fichier de la nouvelle application qui sera automatiquement suivi de la phase d installation. 0000_AT+LOCDWL="newfile_boot.bin","./mydirectory" xxxxxxx +locdwl:ok Exemple pour le fichier EaseLoc_V3.10_lzo.bin situé sur le serveur dans le répertoire DWL Note : le fichier à charger peut être renommé sur le serveur sans aucune extension (ex : V310 ). L application contrôlera le fichier avant de l utiliser. La syntaxe du nom de fichier doit être exactement identique à celle renseignée dans la commande AT+LOCDWL 0000_AT+LOCDWL="EaseLoc_V3.10_lzo.bin","./DWL" xxxxxxx +locdwl:ok

8 EG_EaseLoc_DOTA_AN122_000_FR Page 8 / 9 Notes : La taille du fichier contenant la nouvelle application est d environ 430ko Le temps de la mise à jour généralement constaté (rapatriement FTP et chargement en Flash) se situe autour de 5mn. Cette durée est variable et est «réseau dépendant» 5.2 Réception du SMS de confirmation de mise à jour : Mise à jour réussie xxxxxxx DOWNLOAD SUCCESS Echec de la mise à jour : En cas d échec de la mise à jour, voici les différents messages d erreur pouvant être retournés par SMS : xxxxxxx DOWNLOAD ERROR xxxxxxx DOTA ERROR: The file has length xxxxxxx DOTA ERROR: Install failed xxxxxxx DOTA ERROR: Wait for SIM failed xxxxxxx DOTA ERROR: Wait for ATT failed xxxxxxx DOTA ERROR: Wait for CNX failed xxxxxxx DOTA ERROR: The server does not exist xxxxxxx DOTA ERROR: Username/Password failed xxxxxxx DOTA ERROR: Out of buffer space or disk space xxxxxxx DOTA ERROR: The file does not exist xxxxxxx DOTA ERROR: Unable to allocate memory for internal buffers xxxxxxx DOTA ERROR: Transfer too long xxxxxxx DOTA ERROR: Unexpected result code n En cas d échec de la mise à jour, réitérer le processus après avoir contrôlé l ensemble des paramètres : de l APN GPRS, du serveur FTP, du nom du fichier à télécharger. Si l échec persiste, le produit doit être repris manuellement pour une mise à jour locale via le port série ou retourné en usine après demande d un numéro de retour RMA (nous consulter).

9 EG_EaseLoc_DOTA_AN122_000_FR Page 9 / 9 6 Recharger une configuration client Dans le cas où la mémoire Flash é été effacée, il est nécessaire de renvoyer au modem l ensemble de sa configuration. En mode texte, un SMS est limité à 160 caractères. En fonction du nombre de commandes à envoyer, il peut être nécessaire de construire plusieurs SMS. Dans ce cas, les commandes AT ne doivent pas être découpées et le mot de passe renseigné en entête de chaque nouveau message envoyé. Il est aussi conseillé : De prioriser et d isoler l envoi la commande AT+LOCFRT=xx qui nécessite un temps de traitement plus long. De mettre en fin de paramétrage et dans l ordre suivant les commandes AT+LOCSTK=xx puis AT+LOCSND=xx 6.1 Exemple de reconfiguration à envoyer : AT+LOCFRT=2, "IP","LC","DT","IP","AN","AA","OW" AT+LOCTSV=" ",8844 AT+LOCTAK="OK",0,120 AT+LOCUTC="+02" AT+LOCSTK=2,"000100" AT+LOCSND=2,"I","0000" 1 er SMS : 0000_ AT+LOCFRT=2,"IP","LC","DT","AN","AA","OW" xxxxxxx +locfrt:ok 2 nd SMS : 0000_AT+LOCTSV=" ",8844_+LOCTAK="OK",0,120_+LOCUTC= "+02"_+LOCSTK=2,"000100"_+LOCSND=2,"I","0000" xxxxxxx +LOCTSV:OK +LOCTAK:OK +LOCUTC:OK +LOCSTK:OK +LOCSND:OK Fin du document