WS0008 Application embarquée permettant la gestion...

70
S.A. ERCO & GENER – ZI de St. Lambert-des-Levées – BP 30163 – F-49412 SAUMUR Cedex Tél. : +33 (0)2 41 83 13 00 – Fax : +33 (0)2 41 67 19 20 – www.ercogener.com – [email protected] SA CAPITAL 183244 € – R.C. SAUMUR B 332 174 820 – SIRET 332 174 820 00032 – NAF 322A – TVA Intra : FR 16 332 174 820 L’esprit Modem Command List WS0008 Application embarquée permettant la gestion autonome des fonctionnalités GPS GenLoc 31e Référence : EG_WS0008_CL_020_FR Révision : 020 Date : 21/09/2006

Transcript of WS0008 Application embarquée permettant la gestion...

Page 1: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

S.A. ERCO & GENER – ZI de St. Lambert-des-Levées – BP 30163 – F-49412 SAUMUR Cedex

Tél. : +33 (0)2 41 83 13 00 – Fax : +33 (0)2 41 67 19 20 – www.ercogener.com – [email protected] SA CAPITAL 183244 € – R.C. SAUMUR B 332 174 820 – SIRET 332 174 820 00032 – NAF 322A – TVA Intra : FR 16 332 174 820

L’esprit Modem

Command List

WS0008

Application embarquée permettant la gestion autonome des fonctionnalités GPS

GenLoc 31e

Référence : EG_WS0008_CL_020_FR Révision : 020 Date : 21/09/2006

Page 2: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 2 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

Historique du document Révision Modifications Auteur Date

000 Création PBR 06/10/2004 001 Correction + Evolution PBR 24/11/2004 002 Correction + Evolution PBR 09/03/2005 003 Evolution PBR 01/09/2005 004 Correction + Evolution PBR 07/10/2005 005 Correction + Evolution

Cde LOCFRT=2, le paramètre Status passe avant le Fix PBR 25/10/2005

006 Correction + Evolution Cde +LOCSTK, ajout paramètre de filtrage des information GPS par le nombre de satellites utilisés (4), valeur mini hdop passe à 10. Ajout cde +LOCPOS Ajout cde +LOCTCP

PBR 28/10/2005

007 Correction + Evolution Cde +LOCTRC, +LOCTRD

PBR 28/11/2005

008 Correction + Evolution Cde +LOCASV, +LOCTSV

PBR 13/01/2006

010 Ajout exemples, Commentaire commande A/, +LOCSND=4

PBR 25/01/2006

011 Ajout commentaire sur commande LOCTSK PBR 01/02/2006 012 Correction +LOCFRT

Ajout infos +LOCSTK Ajout info transfert 115200 b/s

PBR 10/02/2006

013 Correction commande demande position en SMS est bien SENDPOSI. Ajout infos + Modification AT+LOCSTK Modification AT+LOCFRT

PBR 03/03/2006

014 Correction Ajout info 2D/3D format 2 (existait en V1.2 mais a été enlevé de la V1.3) Ajout infos commandes à distance Ajout infos mise à jour à distance +LOCDWL. Correction commande +LOCTPH, erreur sur « / ».

PBR 07/04/2006

015 Ajout commande +LOCRDI. Modification commande +LOCSPD. Modification +LOCCNF display information.

PBR 05/07/06

020 Supprimé commande +LOCIOS. Modifié commandes +LOCINS, +LOCINP and +LOCOUT. Ajout la low-level command list avec Wavecom +WGPSxxx, +Wxxx commands, ainsi que les commandes serial flash etc. Ajout InPuts states pour +LOCFRT=2. Ajout commande +LOCNRP. Ajoute GPI/O status dans +LOCCNF. Ajoute commande +LOCTFD.

PBR/MRE 21/09/06

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 DOCUMENTS DE REFERENCE:

[R1] – AT Command Interface Guide For X52a Software (ref: WM_ASW_OAT_UGD_016 revision 8)

[R2] – Open AT ADL User Guide for Open AT 3.04 (ref: WM_ASW_OAT_UGD_00052 revision 2)

[R3] – Specific AT Commands for GPS Management (ref: WM_RNASW_Q2501_UGD_001 revision 6)

Page 3: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 3 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

CONTENTS

1 DESCRIPTION ......................................................................................................................................... 7 1.1 Introduction ...................................................................................................................................... 7 1.2 Fonctionnalités................................................................................................................................. 8

1.2.1 Protection..................................................................................................................................... 8 1.2.2 Localisation .................................................................................................................................. 8 1.2.3 Méthodologie d’enregistrement ................................................................................................... 9 1.2.4 Transmission................................................................................................................................ 9 1.2.5 Consommation et temps d’acquisition....................................................................................... 10 1.2.6 Divers ......................................................................................................................................... 10

2 COMMANDES D’APPLICATION........................................................................................................... 11 2.1 Principes généraux........................................................................................................................ 11

2.1.1 AT+LOCPSW – Mot de passe................................................................................................... 11 2.1.2 AT+LOCIDT – Identifiant de l’appareil....................................................................................... 12 2.1.3 AT+LOCPHN – Numéros de téléphone autorisés..................................................................... 13

2.2 AT+LOCGPS – Communication avec le GPS............................................................................... 14 2.3 Envoi de la position GPS............................................................................................................... 15

2.3.1 Par SMS..................................................................................................................................... 15 2.3.2 Par EMAIL en GPRS (développement ultérieur). ...................................................................... 15 2.3.3 Par DATA en GSM..................................................................................................................... 15 2.3.4 Par TCP en GPRS..................................................................................................................... 15 2.3.5 Par FTP en GPRS ..................................................................................................................... 16 2.3.6 Par UDP en GPRS (développement ultérieur). ......................................................................... 16

2.4 AT+LOCFRT – Format de la trame de la position GPS................................................................ 17 2.5 Gestion des Entrées/Sortie............................................................................................................ 20

2.5.1 AT+LOCINS – Configuration des entrées ................................................................................. 20 2.5.2 AT+LOCINP – Activation des entrées ....................................................................................... 21 2.5.3 AT+LOCOUT – Activation de la sortie....................................................................................... 21

2.6 Gestion des positions GPS............................................................................................................ 22 2.6.1 AT+LOCSTK – Stockage des positions GPS............................................................................ 22 2.6.2 AT+LOCSPD – Vitesse minimum de déplacement autorisant l’enregistrement ....................... 23 2.6.3 AT+LOCHTC – Récupération des positions enregistrées......................................................... 24 2.6.4 AT+LOCRDI – Gestion des indices en mémoire des données GPS ........................................ 24

2.7 AT+LOCSND – Envoi des positions GPS ..................................................................................... 25 2.8 AT+LOCUTC – Ajustement à l’heure locale.................................................................................. 26 2.9 Gestion et Configuration à distance .............................................................................................. 27

2.9.1 Messages de commande “Standard” ........................................................................................ 27 2.9.2 Messages de commande “spéciale”.......................................................................................... 27 2.9.3 Gestion et Configuration par SMS............................................................................................. 27 2.9.3.1 Commande par correspondant identifié ................................................................................ 27 2.9.3.2 Commande par correspondant inconnu................................................................................ 27 2.9.3.3 +LOCNRP – Demande de non réponse par SMS ................................................................ 28 2.9.3.4 Exemple de SMS de configuration ........................................................................................ 29

2.9.4 Gestion et Configuration par le lien GPRS en TCP................................................................... 29 2.9.4.1 Exemple de commande via lien TCP .................................................................................... 29

2.10 AT+LOCDWL – Chargement d’une nouvelle application à distance ............................................ 30 2.11 AT+LOCRST – Reset journalier .................................................................................................... 31 2.12 Configurations & informations courantes ...................................................................................... 32

2.12.1 AT+LOCCNF – Configuration générale ................................................................................ 32 2.12.2 AT+LOCCNG – Configuration GPRS.................................................................................... 33 2.12.3 AT+LOCPOS – Information GPS .......................................................................................... 34

2.13 Programmation & configuration GPRS.......................................................................................... 35

Page 4: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 4 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.1 AT+LOCASV – Access Point Server Name.......................................................................... 35 2.13.2 AT+LOCAUN – Access Point User Name............................................................................. 35 2.13.3 AT+LOCAPW – Access Point Password .............................................................................. 36 2.13.4 AT+LOCTSV – Adresse et numéro de Port TCP IP.............................................................. 36 2.13.5 AT+LOCTPT – Numéro de port TCP .................................................................................... 37 2.13.6 AT+LOCTTD – Délai de transmission en TCP...................................................................... 37 2.13.7 AT+LOCTFD – Délai de transmission inter-trame en TCP................................................... 38 2.13.8 AT+LOCTPH – Chemin d’accès en TCP .............................................................................. 38 2.13.9 AT+LOCTAK – Acquit et délai d’attente en retour en TCP ................................................... 39 2.13.10 AT+LOCTRD – Trame de lecture de la position en TCP...................................................... 40 2.13.11 AT+LOCTCP – Test de la liaison TCP.................................................................................. 40 2.13.12 AT+LOCFSV – FTP Server name......................................................................................... 41 2.13.13 AT+LOCFUN – FTP User Name........................................................................................... 41 2.13.14 AT+LOCFPW – FTP password ............................................................................................. 42 2.13.15 AT+LOCFPT – Numéro de port FTP..................................................................................... 42 2.13.16 AT+LOCFGP – Chemin d’accès en lecture FTP (GET) (développement ultérieur) ............. 43 2.13.17 AT+LOCFGF – Nom de fichier en lecture FTP (GET) (développement ultérieur) ................ 43 2.13.18 AT+LOCFPP – Chemin d’accès en écriture FTP (PUT) ....................................................... 44 2.13.19 AT+LOCFPF – Nom de fichier en écriture FTP (PUT).......................................................... 44

2.14 Fonctionnement en GPRS............................................................................................................. 45 2.14.1 Mode TCP.............................................................................................................................. 45 2.14.2 Mode FTP.............................................................................................................................. 45

2.15 Gestion du code PIN ..................................................................................................................... 46 2.15.1 AT+CPIN – Rentrer un code PIN .......................................................................................... 46 2.15.2 AT+CLCK – Verrouiller le code PIN ...................................................................................... 46 2.15.3 AT+LOCPIN – Gestion protégée du code PIN...................................................................... 47 2.15.4 AT+CPWD – Changer le code PIN ....................................................................................... 47

2.16 Gestion suivi fonctionnement – Mode TRACE.............................................................................. 48 2.16.1 AT+LOCTRC – Activer la trace ............................................................................................. 48

2.17 Divers............................................................................................................................................. 49 2.17.1 Heure ..................................................................................................................................... 49 2.17.2 Réinitialisation ....................................................................................................................... 49 2.17.2.1 AT+WOPEN........................................................................................................................... 49

3 COMMANDES BAS NIVEAU................................................................................................................. 50 3.1 Commandes générales ................................................................................................................. 50

3.1.1 AT+HELP – Afficher la liste des commandes générales........................................................... 50 3.1.2 ATI8 – Afficher la version de l’application et l’information de compilation................................. 50 3.1.3 AT+WGPSNMEA – GPS NMEA non sollicités .......................................................................... 51 3.1.4 AT+WGPSRAW – Envoyer des données brutes au module GPS ............................................ 52 3.1.5 AT+WGPSPOS – Position GPS ................................................................................................ 53 3.1.6 AT+WGPSM – Gestion module GPS ........................................................................................ 54 3.1.7 AT+WIOR – Read GPIO value .................................................................................................. 55 3.1.8 AT+WIOW – Write GPIO value.................................................................................................. 56 3.1.9 AT+WGPSANT – Configuration antenne GPS.......................................................................... 57 3.1.10 AT+SHOWPOS – Affichage automatique des coordonnées GPS ....................................... 58 3.1.11 AT+ERRORSTAT – Afficher le statut des trames NMEA et UBX......................................... 58 3.1.12 AT+WGPSCONF – GPS configuration ................................................................................. 58

3.2 UBX commands............................................................................................................................. 59 3.2.1 AT+HELPUBX – Afficher la liste des commandes UBX............................................................ 59 3.2.2 AT+UBXMONVER – Afficher la version HW / SW du module GPS.......................................... 59 3.2.3 AT+UBXMONHW – Afficher statut matériel du module GPS.................................................... 59 3.2.4 AT+UBXCFGDAT – Datum GPS............................................................................................... 60 3.2.5 AT+UBXCFGDPM – Module GPS Dynamic Platform Model .................................................... 60 3.2.6 AT+UBXSHOW – Afficher trames UBX..................................................................................... 61

Page 5: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 5 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.3 Serial Flash commands ................................................................................................................. 63 3.3.1 AT+SFHELP – Afficher liste des commandes mémoire flash série .......................................... 63 3.3.2 AT+SFTYPE – Type mémoire ................................................................................................... 63 3.3.3 AT+SFSR – Registre de statut .................................................................................................. 64 3.3.4 AT+SFWEL – Afficher / modifier Write Enable Latch bit ........................................................... 64 3.3.5 AT+SFBP – Afficher / modifier Block Protection bits ................................................................. 65 3.3.6 AT+SFWRTEXT – Ecrire une chaîne en ascii........................................................................... 65 3.3.7 AT+SFRD – Afficher le contenu de la mémoire ........................................................................ 66 3.3.8 AT+SFEB – Effacer block .......................................................................................................... 67 3.3.9 AT+SFECHIP – Effacer chip...................................................................................................... 67

4 CONFIGURATION RAPIDE................................................................................................................... 68 4.1 Générale ........................................................................................................................................ 68 4.2 Mode SMS ..................................................................................................................................... 68 4.3 Mode Appel Data ........................................................................................................................... 68 4.4 Mode Réponse Data...................................................................................................................... 69 4.5 Mode GPRS FTP........................................................................................................................... 69 4.6 Mode GPRS TCP .......................................................................................................................... 69

5 TELECHARGEMENT DE L’APPLICATION .......................................................................................... 70 5.1 Préparation du téléchargement ..................................................................................................... 70 5.2 AT+WDWL – Téléchargement de l’application ............................................................................. 70 5.3 Transfert à 115200 b/s .................................................................................................................. 70

Page 6: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 6 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

DISCLAIMER OF WARRANTY This Software is provided free of charge on an 'as is' basis. No warranty is given by ERCO&GENER in relation to the Software concerning the uses to which it may be put by you, the user, or its merchantability, fitness or suitability for any particular purpose or conditions; and/or that the use of the Software and all documentation relating thereto by the Licensee will not infringe any third party copyright or other intellectual property rights. LIMIT OF LIABILITY In no event shall ERCO&GENER be liable for any loss or damages whatsoever or howsoever caused arising directly or indirectly in connection with this license, the Software, its use or otherwise except to the extent that such liability may not be lawfully excluded. Notwithstanding the generality of the foregoing, ERCO&GENER expressly excludes liability for indirect, special, incidental or consequential loss or damage which may arise in respect of the Software or its use, or in respect of other equipment or property, or for loss of profit, business, revenue, goodwill or anticipated savings. In its continuing research into improving its products, ERCO&GENER reserves the right to modify its products and documentation at any time. TRADEMARKS WAVECOM®, WISMO®, MUSE Platform® are filed or registered trademarks of Wavecom S.A. in France or in other countries. All other company and/or product names mentioned may be filed or registered trademarks of their respective owners.

This document is the sole and exclusive property of ERCO&GENER. Not to be distributed or divulged without prior written agreement. Ce document est la propriété exclusive de ERCO&GENER. Il ne peut être

communiqué ou divulgué à des tiers sans son autorisation préalable.

Page 7: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 7 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

1 DESCRIPTION

1.1 Introduction Le GenLoc31e est un appareil conçu à partir d’un module Wismo de Wavecom incorporant les fonctionnalités de communication en GSM ou GPRS et celle de localisation via le réseau GPS. Ceci permet de réaliser un système complet dans des dimensions réduites. De base, le système dispose des fonctionnalités GSM et GPS mais celles-ci ne sont pas interconnectées. L’application développée avec les outils mis à disposition par Wavecom permet de venir charger une application directement dans l’appareil. Ceci permet de concevoir un produit autonome au niveau des fonctionnalités sans obligation d’avoir de l’intelligence à l’extérieur. NOTE: L’application embarquée a été développé avec la suite logicielle Open AT® mise à disposition par Wavecom en ADL (Advanced Developper Layer) afin de simplifier les traitements, ceci à pour conséquence l’envoi systématique à la mise de sous tension de l’appareil de différents messages “WIND“, que l’application ne peut filtrer, celle-ci étant activée ultérieurement

Page 8: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 8 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

1.2 Fonctionnalités 1.2.1 Protection L’accès aux commandes et données stockées dans l’appareil ne peut se faire que suite à la saisie d’un mot de passe. Par défaut, le mot de passe vaut « 0000 ». Dès qu’il est programmé avec une valeur différente, toutes les données sont protégées. Il n’est plus possible de voir ou modifier la configuration et les données enregistrées. Les informations saisies sont immédiatement sauvegardées en mémoire non volatile. Lorsque plusieurs paramètres composent une commande et que les premiers sont corrects, ils peuvent être enregistrés en mémoire non volatile alors que la fin de la commande n’est pas prise en compte. 1.2.2 Localisation La particularité du GenLoc31e réside dans le fait que la fonction de capture des positions GPS est indépendante de celle de transmission. Ainsi le système est capable d’enregistrer des positions avec différents critères de filtrage et de n’envoyer qu’un bloc de donnée lors d’une session de communication. Ceci est important dans les cas de transmission en mode données ou SMS. Les critères de filtrage sont à ce jour limités à :

• Une qualité du signal reçu des satellites correcte, • Un HDOP (Horizontal Dilution Of Precision) (par défaut inférieur ou égal à 10), • Un nombre minimum de satellites en vue (par défaut supérieur ou égal à 4), • Une vitesse de déplacement ( par défaut supérieur ou égal à 0),

Tous ces paramètres sont programmables. L’activation d’une entrée TOR peut aussi occasionner l’enregistrement. Afin de faciliter l’utilisation des informations reçues en retour, il est possible de demander au système l’envoi de trames avec une conversion de l’heure UTC en heure locale. Le format d’enregistrement des données est soit de type :

• RMC (Recommended Minimum specific GPS/Transit data). • GGA (Global Positioning System Fix Data) • Personnel. Dans ce cas l’utilisateur choisi les informations dont il veut disposer. L’état des

informations, l’heure, la latitude et la longitude font obligatoirement parties des informations stockées.

Les positions sont enregistrées en mémoire non volatile dans 31 blocs de 4096 octets. La gestion de ces blocs fonctionne sur le principe d’un buffer circulaire ce qui permet de pouvoir récupérer les informations les plus vieilles. L’effacement du bloc le plus vieux n’a lieu que lorsque le système a besoin de la place. La place prise en mémoire est fonction du type de trame utilisé. Une optimisation logicielle existe et permet de gagner de la place en mémoire. Ainsi on peut considérer avoir une capacité de stockage d’environ 6000 trames NMEA de type RMC. Associé à un filtrage sur une vitesse supérieure à 3 km/h et une capture toutes les 30 secondes, il est possible de mémoriser 10 heures de déplacement par jour sur 5 jours.

Page 9: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 9 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

1.2.3 Méthodologie d’enregistrement En règle générale, l’enregistrement en continu des trames n’a lieu que si les données sont conformes aux filtres mis en place. La première trame reçue avec des données erronées est enregistrée, ceci afin d’avoir une trace du fonctionnement correct de l’appareil. Si les trames suivantes sont elles aussi erronées, elles ne seront pas enregistrées. Afin d’indiquer au site distant que le matériel est toujours actif, un enregistrement forcé a lieu toutes les heures. Ceci peut donner une trame avec uniquement la date et l’heure de conforme, mais le site distant sait que le matériel est toujours raccordé au réseau. Exemples : Dans le cas ci-dessous, l’intervalle de capture est de 10 secondes. Une bonne position a été reçue à 07:49:30, un enregistrement a eu lieu à 07:49:40 pour signaler que le GPS est perdu, ensuite une nouvelle position correcte a été vue à 07:55:59. $GPLOC,123456786,A,1,074930.00,4716.81238,N,00003.51117,W,5,3.33,180.57,1.225,230106*2E $GPLOC,123456786,V,0,074940.00,,,,,,,,,230106*05 $GPLOC,123456786,A,1,075559.00,4716.82613,N,00003.50695,W,4,3.09,161.21,0.056,230106*2F Dans le cas ci-dessous l’intervalle de capture est de 30 secondes. La dernière bonne position a été reçue à 11:54:24, un enregistrement a eu lieu à 11:54:55 pour signaler que le GPS est perdu, ensuite chaque heure un enregistrement a lieu afin de signaler que le système est toujours opérationnel, mais hors de portée des satellites GPS. $GPRMC,115424.00,A,4713.19609,N,00007.71711,W,40.841,250.08,210106,,,A*49 $GPRMC,115455.00,V,,,,,,,210106,,,N*78 $GPRMC,125353.00,V,,,,,,,210106,,,N*7A 1.2.4 Transmission La transmission des informations n’a naturellement lieu qu’en cas de besoin. Elle s’effectue à heure fixe ou avec un délai entre chaque transfert. Elle se fait en GSM en mode SMS ou en mode DATA, en GPRS en FTP ou en TCP. Il est possible d’ajouter en tête de message un identifiant spécifique à chaque appareil. Par défaut celui-ci correspond au numéro d’IMEI du produit qui est unique. Seulement, lorsque la transmission s’est correctement déroulée, l’appareil incrémente son pointeur d’envoi. En cas d’échec, un nouvel essai est réalisé cycliquement. Le numéro de téléphone est stocké en mémoire flash. Il ne peut y avoir qu’un seul destinataire des données de position Par SMS, plusieurs fonctionnalités sont accessibles :

• Lancer le stockage, • Arrêter le stockage, • Demander à distance un SMS en retour contenant la position courante ou la dernière position valide

connue, • Effectuer un reset, • Modifier la configuration courante.

Le SMS de commande doit avoir le numéro de téléphone de l’expéditeur d’enregistré dans l’appareil, ou bien le message doit commencer par le mot de passe précédemment saisie. Dans ce dernier cas, si un numéro de téléphone de “pilotage“ est enregistré en mémoire, un SMS sera envoyé en retour avec en copie le contenu de la commande et le numéro de téléphone du “commanditaire“ (Fonction espion) . En GPRS Dans ce cas, l’utilisateur choisi le type de transmission souhaitée. Soit en mode TCP, en FTP, en UDP (développement ultérieur), ou en MAIL (développement ultérieur).

• En mode TCP, le système envoie ses trames selon l’intervalle de lecture défini au fil de l’eau vers le distant. Lors de la première connexion ou re connexion, il envoie aussi son identifiant dans le cas d’un format de trame RMC ou GGA. Pour le type perso l’identifiant peut être inclus directement dans la trame.

• En mode FTP, le système se connecte ponctuellement et envoie un fichier, dont le nom comporte son identifiant ainsi que la date et l’heure de la première trame du fichier, contenant les données collectées depuis le dernier envoi.

Page 10: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 10 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

• En mode UDP, le système envoie ses trames au fil de l’eau et gère les acquits reçus en retour (développement ultérieur).

• En mode MAIL, idem ci-dessus avec envoie des données collectées depuis le dernier envoi dans un mail (développement ultérieur).

1.2.5 Consommation et temps d’acquisition Afin de limiter la consommation, il est possible aussi de couper l’alimentation de l’antenne GPS. Dans ce cas la durée d’acquisition est fonction des conditions de détection, à ciel ouvert la durée peut varier de 30 à 80 secondes dans 80% des cas. Essai effectué avec une antenne disposée sur un plan métallique à ciel ouvert. A terme, la partie GSM pourra elle aussi être mise hors tension afin de diminuer encore la consommation. Un niveau très faible de consommation pourra être atteint mais dans ce cas le système ne pourra acquérir des positions GPS que lors du déclenchement d’une alarme horaire. 1.2.6 Divers

• Le GenLoc31e dispose de 3 entrées opto-couplées et 1 sortie collecteur ouvert. • Par défaut une fonction de reset automatique permet à l’appareil d’éviter les cas de blocage. • Des commandes permettent de visualiser d’un seul coup les différents paramètres programmés. • Automatiquement, le système surveille la présence du réseau GSM et en cas de perte relance un

attachement.

Page 11: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 11 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2 COMMANDES D’APPLICATION 2.1 Principes généraux Actuellement, il est possible à partir des commandes Hayes de bases incluses dans le modem GenLoc31e d’effectuer toutes les fonctionnalités de gestion du GPS, mais ceci oblige à avoir une application externe. D’autres commandes « Hayes » ont été créées permettant de réaliser des « fonctions » complètes, comme :

• Emission de SMS avec coordonnées GPS, • Emission de fichiers en FTP, • Etc.

Ceci avec en plus des paramètres permettant de choisir des délais d’envoi, les destinataires, etc.

• Des commandes Hayes spécifiques ont été ajoutées afin d’être utilisées dans les différents cas de fonctionnement.

• Si un mot de passe différent de « 0000 » est programmé, la gestion ne pourra s’effectuer que suite à la saisie du mot de passe.

• La commande « A/ » n’est pas fonctionnelle avec cette application et ne doit en aucun cas être utilisée.

• La concaténation des commandes spécifiques ne doit en aucun cas être utilisée. 2.1.1 AT+LOCPSW – Mot de passe Description:

Cette commande permet de gérer un mot de passe qui autorisera l’accès aux différentes fonctions de gestion locale et à distance, pour cette dernière dans le cas où le numéro de téléphone associé à la commande est différent de celui enregistré (appel entrant en mode DATA ou réception de SMS).

Syntaxe:

AT+LOCPSW=<PaSsWord>[,<newPWD>] Exemples: Commande Réponses Possibles Notes AT+LOCPSW=? +LOCPSW: 8,8

OK Afficher la syntaxe. Longueur maximum du mot de passe

AT+LOCPSW=”xxxx” AUTHORIZED ACCESS OK

Avec xxxx prenant la valeur du mot de passe en cours. Permet d’accéder à toutes les commandes de paramétrage

AT+LOCPSW? AUTHORIZED ACCESS OK

Afficher la configuration actuelle, l’accès est autorisé

AT+LOCPSW=”OLD”,”NEW”

OK Changement de mot de passe. Sauvegardé immédiatement en flash.

AT+LOCPSW=”xxxx”,”ERASE”

OK Effacement flash complet. Puis reset par AT+CFUN=1 pour reprendre les paramètres par défaut. Avec xxxx prenant la valeur du mot de passe en cours.

AT+LOCPSW OK Arrêt accès AT+LOCPSW? NON-AUTHORIZED ACCESS

OK Accès non-autorisé

Valeurs définies:

<PaSsWord> Mot de passe actuel entré comme une chaîne ascii, exemple : “0000”. <newPWD> Nouveau mot de passe ou “ERASE” permettant l’effacement complet de la

mémoire flash. Remarques:

Longueur maximum du mot de passe est 8 caractères. Attention à la casse (majuscules, minuscules, chiffres, etc.). Mot de passe par défaut : 0000.

Page 12: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 12 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.1.2 AT+LOCIDT – Identifiant de l’appareil Description:

Cette commande permet de programmer un identifiant qui facilite la reconnaissance de l’appareil lors de l’envoi des informations.

Syntaxe: AT+LOCIDT=<IdenTifier>

Exemples: Commande Réponses Possibles Notes AT+LOCIDT=? +LOCIDT: (20)

OK Afficher la syntaxe.

AT+LOCIDT="354475000000001" OK

Programmation de l’identifiant.

AT+ LOCIDT? 354475000000001 OK

Afficher l’identifiant sauvegardé

Valeurs définies:

<IdenTifier> Valeur de l’identifiant entré comme une chaîne ascii, exemple : “012345678912345”.

Remarques:

Le longueur maximum de l’identifiant est 20 caractères. Identifiant par défaut : Numéro d’IMEI et si absent “GENLOCXX”.

Page 13: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 13 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.1.3 AT+LOCPHN – Numéros de téléphone autorisés Description:

Cette commande permet de programmer les numéros de téléphone des correspondants utilisés par les communications de l’appareil. Nous disposons ainsi d’un répertoire téléphonique indépendant de celui de la carte SIM.

Syntaxe:

AT+LOCPHN=<x>[,<nnn>,<y>] (PHoNe) Exemples: Commande Réponses Possibles Notes AT+LOCPHN=? +LOCPHN: (1-255),20,(0-255)

OK Afficher la syntaxe

AT+ LOCPH=x,,y OK

Modifier seulement les paramètres de fonction, pour un numéro de téléphone existant

AT+ LOCPH=1, "0612345678",5

OK

Programme un numéro de destinataire de SMS de position contenant l’identifiant de l’appareil

AT+ LOCPH=1, "0687654321",128

OK

Programme le numéro de téléphone autorisé à envoyer des SMS de commande sans avoir besoin de saisir le mot de passe

AT+ LOCPHN? +LOCPHN: 1,"0612345678",5 OK

Lire les numéros de téléphone sauvegardé.

AT+ LOCPH=1 OK

Effacer le numéro de téléphone stocké à l’indice 1.

Valeurs définies:

<x> Indice (1 à 255). <nnn> Numéro de téléphone (20 digits max.). Le format du numéro de téléphone doit être

"+yyxxxxxxx". Ce champ ne sert pas lors d’une connexion GPRS mais doit quand même être renseigné avec au moins un chiffre.

<y> Map de bit permettant de choisir la fonction utilisant ce numéro de téléphone: • 1 (bit 0) Numéro destinataire Envoi en mode SMS (trame NMEA RMC, GGA, PERSO). • 2 (bit 1) Numéro destinataire Envoi en mode SMS (trame texte. La date n’apparaît que

si le format choisi est RMC ou PERSO et pour ce dernier cas si ce paramètre a été validé).

• 4 (bit 2) Demande ajout identifiant appareil à l’envoi. • 8 (bit 3) Numéro destinataire Envoi en mode Data. • bits 6, 5 et 4 Envoi en mode GPRS:

0 (0 0 0) Inactif. 16 (0 0 1) Numéro destinataire Envoi en mode GPRS UDP (développement

ultérieur). 32 (0 1 0) Numéro destinataire Envoi en mode GPRS FTP. 48 (0 1 1) Numéro destinataire Envoi en mode GPRS MAIL (développement

ultérieur). 64 (1 0 0) Numéro destinataire Envoi en mode GPRS TCP.

• 128 (bit 7) Numéro autorisé pour commander (appel entrant).

Page 14: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 14 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.2 AT+LOCGPS – Communication avec le GPS Description:

Cette commande permet de communiquer directement avec le module GPS en basculant les signaux DSR vers RxD GPS et/ou DTR vers TxD GPS,

Syntaxe: AT+LOCGPS=<DSR>,<DTR>

Exemples : Commande Réponses Possibles Notes AT+LOCGPS=? +LOCGPS: (0-1),(0-1)

OK Afficher la syntaxe

AT+LOCGPS? +LOCGPS: 0,0 OK

Afficher la configuration actuelle

AT+LOCGPS=1,1 OK

Bascule les signaux DSR et DTR vers Rxd GPS et TxD GPS.

Valeurs définies:

<DSR> 0 : usage normal (défaut). 1 : réception des trames GPS sur le signal DSR. <DTR> 0 : usage normal (défaut). 1 : émission des trames de correction DGPS pour le GPS via le signal DTR.

Remarque :

Suite à cette commande les fonctionnalités internes de gestion des positions GPS ne sont plus actives.

Page 15: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 15 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.3 Envoi de la position GPS 2.3.1 Par SMS Le paramètre complémentaire (valeur 1 ou 2) à la commande +LOCPHN valide cette fonctionnalité. Pour le déclenchement, voir le paragraphe Gestion et Configuration par SMS. Vérifier la présence des données relatives au centre serveur SMS correspondantes à l’opérateur. Commande AT+CSCA ? Pour plus d’information, voir document général des commandes AT. Voir aussi le paragraphe Gestion et Configuration par SMS. 2.3.2 Par EMAIL en GPRS (développement ultérieur). Le paramètre complémentaire à la commande +LOCPHN valide cette fonctionnalité. 2.3.3 Par DATA en GSM Le paramètre complémentaire à la commande +LOCPHN valide cette fonctionnalité. Dans ce mode, suite à la connexion, les positions précédemment enregistrées sont envoyées vers le distant, lorsque toutes les positions ont été envoyées, l’appareil coupe la connexion. Il n’y a pas d’acquit sur l’envoi des données. En REPONSE AUTOMATIQUE Il est aussi possible d’utiliser ce type de connexion dans le mode d’interrogation à distance (réponse automatique). Dans ce cas, le système peut être configuré pour ne jamais lancer d’appel automatique. Lorsque le GenLoc31e reçoit un appel, il vérifie si le numéro de téléphone de l’appelant est dans le répertoire de l’application (commande AT+LOCPHN) et s’il a bien le paramètre DATA de positionné. Si tout est conforme, une phase de réponse automatique est initialisée et suite à la connexion, les trames GPS sont envoyées au fil de l’eau vers le distant. Il est possible d’avoir plusieurs numéros de téléphone avec le paramètres DATA, ceci afin de pouvoir appeler à partir de différents sites. 2.3.4 Par TCP en GPRS Le paramètre complémentaire à la commande +LOCPHN valide cette fonctionnalité, on peut aussi directement saisir la commande AT+LOCSND=2 ou AT+LOCSND=4. Avec la valeur 2, le lien TCP sert uniquement à l’envoi de données entre le GenLoc31e et le serveur. Avec la valeur 4, le lien TCP peut aussi être utilisé pour envoyer des données vers un périphérique connecté sur le port série. Le GenLoc31e lorsqu’il est connecté transfert les données reçues du port série vers le site distant et fait de même dans l’autre sens. Lorsque le GenLoc31e doit envoyer une trame, il vient insérer celle-ci dans le flux de données et s’il doit attendre un acquit en retour, il analyse les données reçues afin de trouver celui-ci. Ajout de l’identifiant de l’appareil avec les trames standards de type RMC ou NMEA. La commande AT+LOCPHN=1, ″1″,68 permet d’ajouter l’identifiant de l’appareil en mode TCP avant chaque trame. Le champ ″ numéro de téléphone ″ est obligatoire mais n’a aucune influence sur la connexion. L’envoi peut se faire en automatique par le GenLoc31e ou bien sur réception d’une demande du serveur. Voir commande AT+LOCTRD. Afin de répondre à des besoins particuliers, il existe des modes de fonctionnement pré-programmé permettant à l’utilisateur de mettre rapidement en œuvre l’appareil. Ainsi la commande AT+LOCFM=1,"FORMAT1","PWD" active le principe de fonctionnement suivant en TCP :

• Connexion à un site, • Si position à envoyer, ouverture d’une connexion TCP, • Envoi de la position, attente d’un acquit durant 10 secondes, • Si réception de l’acquit, fermeture de la connexion, • Si non réception, fermeture de la connexion TCP et réitération, • Si fermeture de la connexion par le distant, attente et réitération.

Page 16: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 16 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.3.5 Par FTP en GPRS Voir commande AT+LOCSND=3 et paragraphe spécifique Mode FTP 2.3.6 Par UDP en GPRS (développement ultérieur). Le paramètre complémentaire à la commande +LOCPHN valide cette fonctionnalité.

Page 17: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 17 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.4 AT+LOCFRT – Format de la trame de la position GPS Description:

Cette commande permet de choisir son format de données. • Trame NMEA complète avec choix des infos. Deux formats de trames standards sont proposés,

RMC et GGA. • Trame personnalisée, par positionnement d’indicateur, il est possible de sélectionner les champs En cas de demande de changement de format, toutes les données préalablement enregistrées seront automatiquement effacées. Ceci est dû à l’optimisation du stockage qui ne permet pas le passage d’un format à l’autre sans perte d’information.

Syntaxe:

AT+LOCFRT=<format>[,a,b,..] Valeurs définies:

<format> format trame, 0, 1 or 2 (format défini par l’utilisateur). <a,b,...> format défini par l’utilisateur (voir tableau en dessous).

Avec format = 0, envoi de la trame directement au format NMEA avec le type de trame RMC - Recommended minimum specific GPS/Transit data. Exemple :

$GPRMC,225446,A,4916.45,N,12311.12,W,000.5,054.7,191194,020.3,E*68 225446 Time of fix 22:54:46 UTC A Navigation receiver warning A = OK, V = warning 4916.45,N Latitude 49 deg. 16.45 min North 12311.12,W Longitude 123 deg. 11.12 min West 000.5 Speed over ground, Knots 054.7 Course Made Good, True 191194 Date of fix 19 November 1994 020.3,E Magnetic variation 20.3 deg East *68 Mandatory checksum

Avec format = 1, envoi de la trame directement au format NMEA avec le type de trame GGA - Global Positioning System Fix Data Exemple :

$GPGGA,123519,4807.038,N,01131.324,E,1,08,0.9,545.4,M,46.9,M, , *42

123519 Fix taken at 12:35:19 UTC 4807.038,N Latitude 48 deg 07.038' N 01131.324,E Longitude 11 deg 31.324' E 1 Fix quality: 0 = invalid 1 = GPS fix 2 = DGPS fix 08 Number of satellites being tracked 0.9 Horizontal dilution of position 545.4,M Altitude, Metres, above mean sea level 46.9,M Height of Geoid (mean sea level) above WGS84 ellipsoid (empty field) Time in seconds since last DGPS update (empty field) DGPS station ID number *42 Mandatory checksum

Page 18: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 18 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

Avec format = 2, les paramètres suivants (1 à 14 maximum) déterminent les champs sélectionnés. Les valeurs en gras seront toujours présentes. Les valeurs sont :

Nom Description Valeurs Taille maximum réservée en flash par capture

ID Identifiant (voir commande +LOCIDT) ST Status ( Navigation Receiver warning.) A : valeur correcte

V : avertissement 0

FX Valeur Fix indicateur -1 : Unable, 0 : Invalide, 1 : GPS Fix (2D/3D), 2 : DGPS Fix

1

TM Time UTC ( Universal Time ) 123456.00 3 LT Latitude 4716.80415 5 LI Latitude Indice N-S 0 LG Longitude 00003.51805 5 LU Longitude Indice E-W 1 NS Nombre de satellite 1-12 0 HD HDOP Horizontal Dilution of Precision

(<2 valeur pouvant être prise en compte)

0.01-99.99 2

AL Altitude 0.1-9999.9 3 AI Altitude Indice M 0 CS Course 0.01-255.33 3 SN* Vitesse Nœud 0.001-999.999 3 SK* Vitesse KMH 0.001-999.999 3 GS Geoid 0.1-179.9 2 GU Geoid Unit M 0 IP InPuts states I3I2I1 3

CU** Capture UART xxxxxxxxxx 10 DT Date JJMMAA 3

Remarques :

*Concernant la vitesse une seule des deux possibilités est sélectionnable. **Le paramètre CU permet d’affecter des données venant du port série avec une position GPS. La taille des données est limitée à 10 caractères. Taille maximum sauvegardée par défaut : 15 Un procédé d’optimisation permet un gain complémentaire de l’ordre de 5 octets par trame capturée. Elles peuvent être saisie dans n’importe quel ordre, mais seront toujours données dans l’ordre ci-dessus. Par cette commande, seules 14 des 18 possibilités sont sélectionnables ou bien voir remarque ci-dessous. Il est possible de sélectionner tous les paramètres en omettant lors de la saisie de la commande les paramètres par défaut (ST, FX, TM, LT,LI, LG, LU) ceux-ci seront automatiquement ajouté. Le format devra être proche d’une trame NMEA afin de limiter les traitements. La trame constituée sera donné avec l’ordre suivant pour les éléments la constituant :

• Identifiant de l’appareil • Fix • Latitude • Longitude

• Date • Heure GMT • (Vitesse) • (Altitude)

Page 19: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 19 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

L’ajout de l’état des entrées par le paramètre ″IP″ a les conséquences suivantes : • Les entrées sont automatiquement configurées avec les valeurs suivantes :

+LOCINS : 0-00005,"O","D",000 +LOCINS : 1-00005,"O","D",000 +LOCINS : 2-00005,"O","D",000

Soit 500 ms de temps d’intégration et double état transmis. • Lorsqu’une entrée change d’état, une trame GPS est automatiquement enregistrée et

l’intervalle de capture est reporté d’autant. Ci-dessous disposition des valeurs dans la trame avec commande AT+LOCFRT=2,"IP" uniquement $GPLOC,V,0,152530.00,,,,,000*2F Entrée 2┘│└Entrée 0 Entrée 1 Il faut arrêter l’acquisition avant de changer ou modifier le format des données (AT+LOCSTK=0).

La commande AT+LOCFRT=x,1 permet un effacement complet de la zone de stockage des positions GPS.

Page 20: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 20 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.5 Gestion des Entrées/Sortie L’appareil dispose de trois entrées opto-couplées et d’une sortie collecteur-ouvert. Se reporter à la documentation générale du GenLoc31e pour plus d’information. Une commande Hayes permet d’activer l’enregistrement de la position lors du changement d’état de l’entrée (AT+LOCSTK). 2.5.1 AT+LOCINS – Configuration des entrées Description:

Cette commande permet de configurer l’utilisation des entrées opto-couplées. Syntaxe:

AT+LOCINS=<n>,<t>,<x>,<y>,<z> (INput Set-up) Exemples : Commande Réponses Possibles Notes AT+LOCINS=? +LOCINS: (0-2),(0-65535),("O","C"),

("B","D","S"),(0-255) OK

Afficher la syntaxe

AT+LOCINS? +LOCINS: 0,00000,"O","S",000 +LOCINS: 1,00000,"O","S",000 +LOCINS: 2,00000,"O","S",000 OK

Afficher la configuration actuelle

Valeurs définies:

<n> Numéro de l’entrée, 0 à 2. <t> Temps de présence de l’entrée active avant action de 0 (inactive) à 65535 (base de

temps 100 ms). <x> Etat de l’entrée au repos. "O" pour Open et "C" pour Closed. <y> Type de gestion au changement d’état:

"S" pour Single, le passage de repos à travail occasionne l’action. "D" pour Double, le passage de repos à travail et de travail à repos occasionne

l’action. "B" pour Break, le passage de repos à travail occasionne l’action et celui de

travail à repos l’interrompt si elle n’est pas terminée (développement ultérieur).

<z> Réservé.

Remarques:

Configuration par défaut: +LOCINS : 0,00000,"O","S",000 +LOCINS : 1,00000,"O","S",000 +LOCINS : 2,00000,"O","S",000

Page 21: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 21 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.5.2 AT+LOCINP – Activation des entrées Description:

Cette commande permet d’activer l’utilisation des entrées opto-couplées. Syntaxe:

AT+LOCINP=<n>,<mode>[,<n>,<mode>][,<n>,<mode>] ( INPut ) Exemples : Commande Réponses Possibles Notes AT+LOCINP=? +LOCINP: (0-2),(0-1)

OK Afficher la syntaxe

AT+LOCINP? +LOCINP: 0,1,1,0,2,1 OK

Afficher la configuration actuelle. Entrée 1 désactivée. Inputs 0 et 2 activées.

AT+LOCINP=1,0 OK Arrêt acquisition GPS sur entrée 1 Valeurs définies:

<n> Numéro de l’entrée, 0 à 2. <mode> 0 : désactive.

1 : active. 2.5.3 AT+LOCOUT – Activation de la sortie Description:

Cette commande permet d’activer la sortie collecteur-ouvert. Syntaxe:

AT+LOCOUT=<n>,<x>,<y> (OUTput) Exemples : Command Réponses Possibles Notes AT+LOCOUT=? +LOCOUT: (0),(0-1),(0-255)

OK Afficher la syntaxe

AT+LOCOUT=0,1,10 OK Sortie 0 fermée pour 1000ms AT+LOCOUT? +LOCOUT: 0

OK Afficher la configuration actuelle

AT+LOCOUT=0,1 OK Sortie 0 fermée AT+LOCOUT? +LOCOUT: 1

OK Afficher la configuration actuelle

Valeurs définies:

<n> Numéro de sortie (0 est la sortie par défaut). <x> 0 : ouverte.

1 : fermée. <y> différent de 0 donne la durée de l’impulsion (base de temps 100 ms).

Remarques:

Il est possible de la piloter: • sur réception d’un SMS • durant une connexion en mode DATA (développement ultérieur).

Page 22: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 22 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.6 Gestion des positions GPS 2.6.1 AT+LOCSTK – Stockage des positions GPS Description:

Cette commande permet d’activer le stockage des positions GPS et de choisir la qualité de celle-ci. Syntaxe:

AT+LOCSTK=[<s>,<x>,<y>,<h>,<f>,<v>,<n>,<d>] (STocKage) Exemples : Commande Réponses Possibles Notes AT+LOCSTK=? +LOCSTK: (0-1),"HHMMSS",(0-1),(0-99),(0-

2),(0-255),(0-16),(0-255) OK

Afficher la syntaxe

AT+LOCSTK? +LOCSTK: 0,"00:00:10",0,10,1,000,04,120 OK

Afficher la configuration actuelle (ici défaut)

Valeurs définies:

<s> Gestion du stockage: 0 : pas de stockage, 1 : stockage permanent, plus à chaque changement d’état des entrées si paramètre ″IP″

demandé avec le format trame personnalisée (AT+LOCFRT=2,…). 2 : stockage uniquement à chaque changement d’état des entrées.

<x> Intervalle d’acquisition de la position. Format "HHMMSS" (intervalle max = 240000 i.e. 24

heures). <y> Gestion alimentation GPS. Afin de diminuer la consommation du système, la partie GPS

interne et l’antenne peuvent être passé en mode faible consommation. Attention, ceci retarde l’acquisition au réveil ( 40 secs à 2 min ). 0 : pas de gestion de l’alimentation. 1 : gestion active. Dans ce cas la capture est fonction du temps de réaction de l’antenne.

Suite à la saisie de cette commande, il faut réinitialiser l’appareil afin que ce paramètre soit correctement pris en compte par la commande AT+CFUN=1.

<h> Correspond à la valeur maximale autorisée, pour la prise en compte des informations, de la

partie entière du HDOP ( Horizontal Dilution of Precision ) issue du GPS. Cette information permet de connaître le niveau d’exactitude des informations GPS. La valeur théorique va de 0 à 99.99, la valeur par défaut est de 10. Il est déconseillé de modifier ce paramètre.

<f> Correspond à la valeur minimale autorisée, pour la prise en compte des informations, du

paramètre de qualité de réception FIX issue du GPS. ( 0 : Invalide , 1 : GPS, 2 : DGPS ). La valeur par défaut est de 1. Il est déconseillé de modifier ce paramètre.

<v> Correspond à la valeur minimale autorisée, pour la prise en compte des informations, du

paramètre de vitesse de déplacement issue du GPS. La valeur par défaut est de 0, ce qui autorise tous les enregistrements même si le système ne se déplace pas. Ce paramètre est aussi modifiable par la commande AT+LOCSPD.

<n> Correspond à la valeur minimale autorisée, pour la prise en compte des informations, du

nombre de satellites utilisée. La valeur par défaut est de 4.

<d> Lorsque la gestion de l’alimentation de la tête est activé, ce paramètre correspond au délai maximum de mise sous tension de la partie GPS dans le but d’acquérir une position. Si aucune position valide n’est trouvée, le système enregistre quand même les derniers paramètres reçus et coupe l’alimentation.

Page 23: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 23 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

Remarques: • La commande AT+LOCSTK permet de connaître la position immédiate selon le format sélectionné.

Si les informations semblent valides, la position est retournée même si les valeurs de filtrage sont incorrectes. (Ex : HDOP mini à 10, et HDOP lu vaut 20).

• Suite à la saisie de cette commande, pour une prise en compte correcte, il faut soit effectuer un reset par la commande AT+CFUN=1, soit une coupure de l’alimentation.

• Il n’est pas utile de mettre un intervalle d’acquisition court entre chaque capture car ceci peut anéantir les possibilités de stockage du système par un écrasement des données préalablement enregistrées en cas de problème de transmission. Voici les distances parcourues en 10 secondes:

à 130 km/h, 360 mètres. à 90 km/h, 250 mètres. à 50 km/h, 139 mètres.

• En TCP il faut tenir compte des délais de transmission, voir la paragraphe Fonctionnement en GPRS.

2.6.2 AT+LOCSPD – Vitesse minimum de déplacement autorisant l’enregistrement Description:

Cette commande permet de spécifier la vitesse minimum pour l’enregistrement des positions GPS. Syntaxe:

AT+LOCSPD=<n> (SPeeD) Exemples : Commande Réponses Possibles Notes AT+LOCSPD=? +LOCSPD: (0-255) km/h

OK Afficher la syntaxe

AT+LOCSPD=10 OK

Vitesse min = 10 KMH

AT+LOCSPD? +LOCSPD: 10 km/h (0.000000 knots) OK

Afficher la configuration actuelle (ici défaut)

Valeurs définies:

<n> 0 : (défaut) toutes les positions valident sont enregistrées. 1 : seules les positions ayant une vitesse de déplacement supérieures à 1 Km/h sont

enregistrées. Remarques:

Ce paramètre est aussi modifiable par la commande AT+LOCSTK.

Page 24: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 24 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.6.3 AT+LOCHTC – Récupération des positions enregistrées Description:

Cette commande retourne toutes les positions enregistrées dans l’appareil au format sélectionné. Un chiffre indique le secteur d’enregistrement en flash. L’envoi est fait dans l’ordre chronologique, de la plus veille à la plus récente.

Syntaxe:

AT+LOCHTC (HisToriC) Exemples : Commande Réponses Possibles Notes AT+LOCHTC 6

$GPRMC,144516.00,A,4716.81455,N,00003.50568,W,0.130,349.30,210606,,,A*77 $GPRMC,144555.00,V,4716.81188,N,00003.49605,W,1.154,8.41,210606,,,A*61 $GPRMC,144645.00,A,4716.80598,N,00003.50676,W,0.611,261.59,210606,,,A*7F $GPRMC,144655.00,A,4716.80674,N,00003.50843,W,1.020,261.77,210606,,,A*7E $GPRMC,144705.00,A,4716.80727,N,00003.50790,W,0.043,267.24,210606,,,A*78 $GPRMC,144715.00,A,4716.80709,N,00003.50650,W,0.004,0.00,210606,,,A*7E $GPRMC,144725.00,A,4716.80630,N,00003.50706,W,0.026,244.53,210606,,,A*70 $GPRMC,144735.00,A,4716.80586,N,00003.50764,W,0.035,241.56,210606,,,A*79 $GPRMC,144745.00,A,4716.80554,N,00003.50821,W,0.050,225.43,210606,,,A*7A $GPRMC,144755.00,A,4716.80585,N,00003.50928,W,0.109,243.82,210606,,,A*7F $GPRMC,144805.00,A,4716.80469,N,00003.50961,W,0.596,239.15,210606,,,A*7A $GPRMC,144815.00,A,4716.80105,N,00003.50947,W,0.898,202.07,210606,,,A*78 OK

Afficher les positions stockés du premier secteur de stockage (6) de la flash

2.6.4 AT+LOCRDI – Gestion des indices en mémoire des données GPS Description:

Cette commande permet de connaître la valeur des indices de lecture et d’écriture des positions GPS en flash. En premier est retourné la valeur de l’indice de lecture, suivi du numéro du bloc, puis la valeur de l’indice d’écriture et le numéro de bloc.

Syntaxe: AT+LOCRDI? (ReaD Index)

Syntaxe réponse:

+LOCRDI: <read index>,<block number>,<write index>,<block number> Exemples : Commande Réponses Possibles Notes AT+LOCRDI? +LOCRDI: 264, 27, 220, 27

OK Afficher les valeurs actuelles

AT+LOCRDI OK

Positionne l’indice de lecture à la valeur de celui d’écriture. Ceci permet d’éviter un vidage de toute la mémoire de stockage si cela est inutile.

Remarques:

Le premier numéro de bloc est 6 et le dernier 37. Les indices peuvent varier de 0 à 4095.

Page 25: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 25 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.7 AT+LOCSND – Envoi des positions GPS Description:

Cette commande permet d’activer l’envoi des positions GPS. Il a lieu à intervalle régulier. Syntaxe:

AT+LOCSND=<x>,<y>,<z> (SeND) Exemples: Commande Réponses Possibles Notes AT+LOCSND=? +LOCSND: (0-

4),(0,"I","H","N","D"),("HH:MM",00000) OK

Afficher la syntaxe

AT+LOCSND=0,"I","00:10"

OK

Programmer les paramètres

AT+LOCSND? +LOCSND: 0,"I","00:10" OK

Afficher la configuration actuelle

Valeurs définies:

<x> 0 : pas d’envoi, fonctionnalité uniquement d’enregistrement si stockage actif. 1 : envoi en mode data ou SMS. 2 : envoi en mode GPRS en TCP, dans ce cas les champs suivant sont inutiles. 3 : envoi en mode GPRS en FTP. 4 : envoi en mode GPRS en TCP avec utilisation du lien série pour envoi d’autres information,

dans ce cas les champs suivant sont inutiles.

<y> "I" : envoi à intervalle régulier. "H" : envoi à heure fixe (développement ultérieur). "N" : envoi sur nombre de captures (développement ultérieur). "D" : envoi sur distance parcourue (développement ultérieur).

<z> "hh:mm" avec

hh = heure, mm = minutes, intervalle d’envoi, ou l’heure d’envoi, ou nombre de capture 1 à nnn (0 = envoi sur mémoire pleine), (développement

ultérieur). ou distance en mètres entre deux mesures (développement ultérieur).

Remarques:

L’envoi à l’heure précise est fonction de l’heure UTC avec remise à l’heure automatique et gestion interne en cas de perte des informations GPS. Il est possible de demander un envoi forcé sur réception d’un SMS Lorsque la commande AT+LOCSND=4 à été envoyée, pour reprendre la main sur l’appareil, il faut simplement éjecter la carte SIM.

Page 26: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 26 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.8 AT+LOCUTC – Ajustement à l’heure locale Description:

Cette commande permet de transformer l’indication horaire reçue par l’antenne GPS (Coordinated Universal Time = UTC) en heure locale.

Syntaxe:

AT+LOCUTC=<n> Exemples: Commande Réponses Possibles Notes AT+LOCUTC=? +LOCUTC: "-11"/"+12"

OK Afficher la syntaxe

AT+LOCUTC=0 OK Ajuster par 0 heures AT+LOCUTC? +LOCUTC: +00

OK Afficher la configuration actuelle

AT+LOCUTC OK

Voir les remarques en dessous

Valeurs définies:

<n> Nombre d’heures d’ajustage (-11 à +12 heures). Remarques:

La commande AT+LOCUTC permet de lire l’heure locale et de mettre à l’heure l’horloge interne du module GSM avec l’ajustement en heure locale. Cette fonction n’est opérationnelle que si l’appareil reçoit des coordonnées GPS valides. Il n’y a pas de gestion automatique des horaires hiver/été.

Page 27: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 27 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.9 Gestion et Configuration à distance Il est possible d’envoyer des informations de configuration par les canaux de communication soit par le canal SMS, soit par le canal TCP. Ceci peut permettre d’identifier des problèmes de fonctionnement indépendant de l’appareil, ainsi une demande par SMS du niveau de réception du signal GSM ( les SMS « passent » avec des niveaux très faibles alors qu’une connexion GSM DATA ou GPRS ne fonctionnera pas) permet de déterminer que l’appareil est dans une zone « blanche » et justifie la non réception côté serveur des informations attendues. 2.9.1 Messages de commande “Standard” Le système accepte par ces canaux les mêmes commandes de paramétrage que via le lien série, à l’exception en SMS de celles qui pourraient bloquer l’appareil :

• AT+WOPEN=0 • AT+CPOF • AT+CFUN=0

Remarques:

• Dans le cas où la commande est spécifique à l’application embarquée (+LOCxxx), celle-ci ne doit pas comporter le préfixe AT. A ce jour le système accepte uniquement les commandes de paramétrages (+LOCxxx=yyy).

• S’il s’agit d’une commande de base du modem Wavecom la commande doit comporter le préfixe AT. Elle peut aussi comporter plusieurs paramètres en utilisant le séparateur “ ; ”.

• Les commandes peuvent être envoyées en minuscule ou en majuscule, sauf le mot de passe qui doit respecter la casse d’origine.

• Le message ne doit pas comporter de caractère de retour de ligne (ENTER). 2.9.2 Messages de commande “spéciale” Il existe des commandes complémentaires uniquement acceptées par le canal SMS. La syntaxe simple permet une mémorisation rapide.

“ STARTPOSP ” pour démarrage capture Permanente. “ STARTPOSI ” pour démarrage capture fonction de l’état d’une entrée (Input). “ STOPPOS ” pour arrêt de la capture. “ SENDPOSI ” pour demande de position IMMEDIATE correcte ou pas avec identifiant de

l’appareil. “ SENDPOSG ” pour demande de la dernière position bonne (GOOD) avec identifiant de l’appareil. “ RESET ” pour reset complet du matériel.

Le message de commande peut être saisie en minuscule ou majuscule 2.9.3 Gestion et Configuration par SMS Avec cette méthode, on peut installer directement l’appareil sans aucune saisie préalable. Il suffit de connaître le numéro de téléphone de la carte SIM insérée et d’envoyer un ou plusieurs SMS avec toutes les informations suffisantes pour que le système devienne opérationnel. Il est possible de mettre plusieurs commandes différentes dans le même SMS en laissant un espace entre chaque commande et en respectant les préconisations ci-dessus. Suite à la réception du SMS de commande, le système retourne un SMS (ou non, voir la commande AT+LOCNRP) avec l’identifiant de l’appareil et les réponses dans le cas d’une commande AT ou bien le début de la commande plus une indication OK ou ERROR. Si changement d’identifiant, ce sera l’ancien qui sera retourné. Si la réponse comporte plus de 160 caractères, le système tronque à la taille maximum, le reste est perdu. 2.9.3.1 Commande par correspondant identifié Dans le cas où le numéro de téléphone de l’émetteur du SMS est enregistré dans la SIM, les SMS doivent commencer par le libellé de la fonction désirée. 2.9.3.2 Commande par correspondant inconnu Dans le cas où le numéro de téléphone de l’émetteur du SMS n’est pas enregistré dans la SIM, les SMS doivent commencer par le mot de passe enregistré via la commande AT+LOCPSW, suivi de celle de la fonction désirée, le reste des paramètres étant identique à ci-dessus.

Page 28: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 28 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.9.3.3 +LOCNRP – Demande de non réponse par SMS Description:

Cette commande permet de demander au système de ne pas envoyer de réponse en retour lors de la réception d’un SMS de commande.

Syntaxe:

+LOCNRP

Page 29: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 29 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.9.3.4 Exemple de SMS de configuration SMS de configuration en respectant la syntaxe des commandes 160 caractères max par SMS. SMS de configuration en FTP

«0000 +locasv="internet-entreprise","orange","orange" +locfsv="titi.tata.fr","USERNAME","password" +locfsv="./titi"»

SMS reçu en retour : « 358730000000042 +locasv:OK +locfsv:OK +locfsv:OK »

SMS de configuration stockage et envoi en FTP

« 0000 +locfrt=2,"ID","NS","HD","CS","SK","DT" +locstk=1,"000010" +locidt="123456786" +locsnd=3,,"00:10" » SMS reçu en retour : « 358730000000042 +locfrt :OK +locstk :OK +locidt :OK +locsnd :OK »

Activation d’une entrée

« 0000 +locinp=0,1 » SMS reçu en retour : « 123456786 +locinp:OK »

Il est possible de lancer une mise à jour de l’application embarquée via la fonctionnalité DOTA. Voir paragraphe AT+LOCDWL – Chargement d’une nouvelle application à distance. Texte d’un SMS de demande de position avec appelant identifié dans l’appareil

SENDPOSI Texte d’un SMS de demande de position avec appelant non identifié dans l’appareil et mot de passe par défaut

0000 SENDPOSI

En retour, le SMS reçu contient la trame au format retenu avec l’identifiant, ici cas avec trame correcte : 354475000000394 GPRMC,071037.00,A,4716.80453,N,00003.51482,W,0.041,5.43,181005,,,A*73

ici cas avec position non accessible : 354475000000394 GPRMC,091151.00,V,,,,,,,181005,,,N*7D

Remarque : Dans le cas de l’envoi avec mot de passe correct, le système recherche un numéro enregistré dans l’appareil comme étant « Numéro autorisé pour commander » et envoi vers celui-ci un SMS avec le numéro de téléphone et la commande reçu du correspondant inconnu mais connaissant le mot de passe. 2.9.4 Gestion et Configuration par le lien GPRS en TCP Avec cette méthode, on peut configurer à minima l’appareil et gérer son fonctionnement à distance en modifiant tous les paramètres de capture GPS et/ou autres. Le système lorsqu’il reçoit des données du lien TCP analyse celles-ci et vérifie s’il identifie la chaîne "+LOC" ou "AT". Si oui il traite la commande et retourne une information sur le résultat du traitement, si non, il transmet l’information vers le port série dans le cas d’une configuration avec la commande AT+LOCSND=4 sinon celle-ci est perdue. 2.9.4.1 Exemple de commande via lien TCP Exemple commande de pilotage d’une entrée

+LOCINP=0,1 Réponse : +LOCINP:OK

Page 30: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 30 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.10 AT+LOCDWL – Chargement d’une nouvelle application à distance Description:

Cette commande permet de demander au système la mise à jour du logiciel embarqué. Ceci suite à l’ajout d’une nouvelle fonctionnalité ou à la découverte d’un dysfonctionnement. Cette fonctionnalité s’appelle aussi le « DOTA » pour Download Over The Air.

Le transfert ne peut se faire qu’en GPRS avec une connexion de type FTP. Il faut donc que les paramètres FTP soient renseignés dans l’appareil. Pour ce faire, utiliser les commandes AT+LOCFSV, et/ou AT+LOCFUN, AT+LOCFPW.

Syntaxe:

AT+LOCDWL=<"filename">,<"path"> Valeurs définies:

<filename> nom fichier à télécharger. <path> nom chemin pour le fichier.

ORIGINE DE LA COMMANDE :

La commande peut arriver soit via le lien série, un SMS ou la liaison TCP. Lors de la réception de la commande, le système en fonction de la tâche en cours, l’interrompt ou attends sa fin, se détache du réseau et se rattache en utilisant les paramètres FTP. Le transfert se réalise, puis à la fin, l’installation de l’application, un redémarrage avec la nouvelle application si toutes les informations sont correctes ou bien avec l’ancienne en cas de problème Dans le cas d’une commande par SMS un SMS est envoyé en retour avec l’information “ID - File Download, installation OK ” ou “ID – File Download, installation ERROR” en cas d’erreur. De même si le fichier est absent ou si le transfert échoue.

Exemple de commandes : Par le lien série (fichier compressé)

at+locdwl="arm_genlocxxD_B_V200.wpb.dwl","./DWL" (nom de fichier, chemin: "./DWL") Par un SMS (fichier non compressé)

0000 +locdwl="arm_genlocxxD_B_V200.dwl","." (fichier à la racine du disque: ".") Par TCP (fichier non compressé)

+LOCDWL="arm_genlocxxD_B_V200.dwl","." (fichier à la racine du disque: ".")

Page 31: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 31 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.11 AT+LOCRST – Reset journalier Description:

Cette commande permet de reseter automatiquement une fois par jour l’appareil. Ceci peu éviter les cas de blocage dus à un rejet intempestif de l’appareil du réseau GSM. Cette fonctionnalité s’appuie sur l’heure interne au GSM qui est elle même initialisée soit automatiquement par l’heure GPS dès qu’une heure correcte est détectée, ou bien via la commande Hayes AT+CCLK.

Syntaxe:

AT+LOCRST=<mode>[,<time>] (ReSeT) Exemples : Commande Réponses Possibles Notes AT+LOCRST=? +LOCRST: (0-3),"HH:MM"

OK Afficher la syntaxe

AT+LOCRST=1,”03:00” OK

Programmer l’heure du reset à 03h00

AT+LOCRST? +LOCRST: 1,"03:00" OK

Afficher la configuration actuelle

AT+LOCRST=0 OK

Désactiver le reset journalier

Valeurs définies:

<mode> 0 : reset inactif. 1 : reset actif.

2 : reset actif avec ré-initialisation à 0 de l’indice de lecture du bloc en cours. 3 : ré initialisation à la valeur par défaut de l’indice de lecture du bloc en cours ainsi

que le numéro de bloc.

<time> “HH:MM”, HH = heures, MM = minutes.

Page 32: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 32 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.12 Configurations & informations courantes 2.12.1 AT+LOCCNF – Configuration générale Description:

Cette commande permet de visualiser la configuration du matériel. Syntaxe:

AT+LOCCNF (CoNFig) Exemples : Commande Réponses Possibles AT+LOCCNF CONFIGURATION

Local identify ........................ 358730000000265 GSM Registered parameters ............. Not Registered SIM Card presence ..................... Removed SIM Code Status ....................... Unknown GPS position capture .................. STOPPED GPS power supply management ........... Always powered GPS antenna parameters ................ Powered, Connected, 3217 mVInterval between capture .............. 00:00:10 HDOP max value ........................ 10 FIX min value ......................... 1 SPEED min value ....................... 0 km/h (0.000000 knots) NB SAT min value ...................... 04 Frame output format ................... NMEA RMC Transmit position ..................... STOPPED Transmit method ....................... Interval Interval delay ........................ 00:10 Number of remote phone numbers ........ 00 Hour correction parameter ............. +00 GPI status ............................ I0:1 I1:1 I2:1 GPO status ............................ O0:Opened OAT V3.03.Q2406B-GENLOC31e version V1.42 - Jul 25 2006 13:15:03 OK

Page 33: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 33 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.12.2 AT+LOCCNG – Configuration GPRS Description:

Cette commande permet de visualiser la configuration GPRS du matériel. Syntaxe:

AT+LOCCNG (CoNfig Gprs) Exemples : Commande Réponses Possibles AT+LOCCNG GPRS CONFIGURATION

Acces Point Name Server ......(+LOCASV) "" Acces Point Name User Name ...(+LOCAUN) "" Acces Point Name Password ....(+LOCAPW) "" TCP Server ...................(+LOCTSV) "0.0.0.0" TCP Port .....................(+LOCTPT) 00 TCP Transmit delay ...........(+LOCTTD) 00000 TCP Transmit Inter Frame delay(+LOCTFD) 00000 TCP Server Path ..............(+LOCTPH) "" TCP Server Acknowledge Frame .(+LOCTAK) "" TCP Acknowledge Delay.........(+LOCTAK) 200 TCP Server Read Pos. Frame ...(+LOCTRD) "" FTP Server ...................(+LOCFSV) "" FTP User Name ................(+LOCFUN) "" FTP Password .................(+LOCFPW) "" FTP Port .....................(+LOCFPT) 21 FTP Type .............................. "I" FTP Mode .............................. 00 FTP Get Path .................(+LOCFGP) "." FTP Get Filename .............(+LOCFGF) "" FTP Put Path .................(+LOCFPP) "." FTP Put Filename .............(+LOCFPF) "%I_%D_%H.txt" OK

Page 34: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 34 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.12.3 AT+LOCPOS – Information GPS Description:

Cette commande permet de visualiser la dernière position GPS correcte trouvée ou dont la relève a été forcée.

Description:

AT+LOCPOS (POSition) Exemples : Commande Réponses Possibles AT+LOCPOS Position parameters

Current UTC Time ................ 080634.00 Position read UTC Time .......... 080634.00 Position read Date .............. 290606 Latitude ........................ 4716.80267, N Longitude ....................... 00003.51536, W Fix Quality ..................... 1 Fix value request for stock ..... 1 Number satellites view .......... 08 Number satellites used .......... 08 Nb Sat value request for stock .. 4 Horizontal Dilution Of Precision 1.01 HDOP value request for stock .... 10 Altitude ........................ 28.9 M Height of Geoid ................. 47.9 M Magnetic Variation .............. Course Made Good ................ 328.55 Ground speed, knots ............. 0.004 Ground speed, kilometers per hour 0.007 Speed value request for stock ... 010 OK

Notes:

La première ligne donne l’heure courante du GPS. Ceci permet de vérifier “l’ancienneté” des informations suivantes. Car seules les dernières données correctes sont affichées.

Page 35: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 35 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13 Programmation & configuration GPRS Voir chapitre Fonctionnement en GPRS. 2.13.1 AT+LOCASV – Access Point Server Name Description:

Cette commande permet de saisir en une seule fois tous les paramètres donnés par l’opérateur GSM pour l’accès GPRS : o “l’Access point SerVer name”, o “l’Access point UserName”, o et “l’Access point PassWord”.

Syntaxe:

AT+LOCASV=<"ServerString">,<"UserName">,<"PassWord"> (Access point SerVer name) Exemples : Commande Réponses Possibles Notes AT+LOCASV=? +LOCASV:

"ServerString","UserName","Password" OK

Afficher la syntaxe

AT+LOCASV="internet","user","pass"

OK

Programmer les paramètres

AT+LOCASV? +LOCASV: "internet","user","pass" OK

Afficher la configuration actuelle

AT+LOCASV=,0 OK Effacer les paramètres AT+LOCASV? +LOCASV: "","",""

OK Afficher la configuration actuelle

Valeurs définies:

<ServerString> Access point server name. Maximum 100 caractères. <UserName> Access point user name. Maximum 50 caractères. <PassWord> Access point password (case sensitive). Maximum 50 caractères.

Remarques:

Si un paramètre est erroné, les informations ne seront pas automatiquement sauvegardées en mémoire flash.

2.13.2 AT+LOCAUN – Access Point User Name Description:

Cette commande permet de saisir l’Access Point Name UserName, donné par l’opérateur GSM pour l’accès GPRS.

Syntaxe:

AT+LOCAUN=<"UserName"> (Access point UserName) Exemples : Commande Réponses Possibles Notes AT+LOCAUN=? +LOCAUN: "UserName"

OK Afficher la syntaxe

AT+LOCAUN="user" OK

Programmer le paramètre

AT+LOCAUN? +LOCAUN: "user" OK

Afficher la configuration actuelle

AT+LOCAUN=,0 OK

Effacer le paramètre

Valeurs définies:

<UserName> Nom du point d’accès. Maximum 50 caractères.

Page 36: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 36 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.3 AT+LOCAPW – Access Point Password Description:

Cette commande permet de saisir l’Access Point Name PassWord, donné par l’opérateur GSM pour l’accès GPRS.

Syntaxe:

AT+LOCAPW=<"PassWord"> (Access point PassWord) Exemples : Commande Réponses Possibles Notes AT+LOCAPW=? +LOCAPW: "Password"

OK Afficher la syntaxe

AT+LOCAPW="pass" OK

Programmer le paramètre

AT+LOCAPW? +LOCAPW: "pass" OK

Afficher la configuration actuelle

AT+LOCAPW=,0 OK

Effacer le paramètre

Valeurs définies:

<PassWord> Mot de passe du point d’accès. Maximum 50 caractères. Attention à la casse (majuscules, minuscules, chiffres, etc.).

2.13.4 AT+LOCTSV – Adresse et numéro de Port TCP IP Description:

Cette commande permet de saisir l’adresse IP du “TCP SerVer” distant et la valeur du “TCP PorT”. Syntaxe:

AT+LOCTSV=<"addr">[,<port>] Exemples : Commande Réponses Possibles Notes AT+LOCTSV=? +LOCTSV: "xxx.xxx.xxx.xxx",(0-(1-

65535)) OK

Afficher la syntaxe

AT+LOCTSV= "123.98.76.54",1234

OK

Programmer le paramètre

AT+LOCTSV? +LOCTSV: "123.98.76.54", 1234 OK

Afficher la configuration actuelle

AT+LOCTSV=,0 OK

Effacer le paramètre

Valeurs définies:

<addr> Adresse IP du serveur TCP distant (“xxx.xxx.xxx.xxx” ou www.tcpserver.com”). Maximum 100 caractères.

<port> Numéro port (1 è 65535).

Remarques:

Si un paramètre est erroné, les informations ne seront pas automatiquement sauvegardées en mémoire flash.

Page 37: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 37 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.5 AT+LOCTPT – Numéro de port TCP Description:

Cette commande permet de saisir la valeur du “TCP PorT”. Syntaxe:

AT+LOCTPT=<port> Exemples : Command Réponses Possibles Notes AT+LOCTPT=? +LOCTPT: (1-65535)

OK Afficher la syntaxe

AT+LOCTPT=1234 OK

Programmer le paramètre

AT+LOCTPT? +LOCTPT: 1234 OK

Afficher la configuration actuelle

Valeurs définies:

<port> Numéro port TCP/IP (1 à 65535). 2.13.6 AT+LOCTTD – Délai de transmission en TCP Description:

Cette commande permet de saisir la valeur du délai avant envoi des données vers le distant. Syntaxe:

AT+LOCTTD=<delay> (TCP Transmit Delay) Exemples : Commande Réponses Possibles Notes AT+LOCTTD=? +LOCTTD: (0-65535)

OK Afficher la syntaxe

AT+LOCTTD=100 OK

Programmer le paramètre

AT+LOCTTD? +LOCTTD: 100 OK

Afficher la configuration actuelle

Valeurs définies:

<delay> Délais de transmission TCP (0 à 65535). Valeur par défaut = 0.

Page 38: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 38 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.7 AT+LOCTFD – Délai de transmission inter-trame en TCP Description:

Cette commande permet de saisir la valeur du délai entre chaque envoi de données vers le distant, pour les cas où le distant ferme la session entre chaque envoi.

Syntaxe:

AT+LOCTFD=<delay> (TCP transmit inter Frame Delay) Exemples : Commande Réponses Possibles Notes AT+LOCTTD=? +LOCTTD: (0-65535)

OK Afficher la syntaxe

AT+LOCTTD=100 OK

Programmer le paramètre

AT+LOCTTD? +LOCTTD: 100 OK

Afficher la configuration actuelle

Valeurs définies:

<delay> Délais entre chaque envoi (0 à 65535). Valeur par défaut = 0.

2.13.8 AT+LOCTPH – Chemin d’accès en TCP Description:

Cette commande permet de saisir le chemin d’accès sur le site distant ou la commande de dépôt, "TCP PatH". Ainsi vers un site en HTTP on peut mettre "GET /GPS=".

Syntaxe:

AT+LOCTPH=<"path"> (TcpPatH) Exemples : Commande Réponses Possibles Notes AT+LOCTPH=? +LOCTPH: "\PATH="

OK Afficher la syntaxe

AT+LOCTPH=”GET /GPS=”

OK

Programmer le paramètre

AT+LOCTPH? +LOCTPH: "GET /GPS" OK

Afficher la configuration actuelle

AT+LOCTPH=,0 OK

Effacer le paramètre

Valeurs définies:

<path> Chemin d’accès sur le site distant (“path”). Maximum 100 caractères.

Page 39: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 39 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.9 AT+LOCTAK – Acquit et délai d’attente en retour en TCP Description:

Cette commande permet de saisir la valeur de la chaîne d’acquit reçue en retour lors de l’envoi d’une trame de données vers le distant, et de programmer la durée d’attente de cet acquit.

Syntaxe:

AT+LOCTAK=<"string">[,<param>,<time>] (TcpAck) Exemples : Commande Réponses Possibles Notes AT+LOCTAK=? +LOCTAK: "Value for Ack",0-

1,(Delay:0-65535) OK

Afficher la syntaxe

AT+LOCTAK=”OK” OK

la chaîne OK valide la trame reçue avec délai par défaut, sinon l’appareil réitère l’envoi 5 fois puis ferme la liaison TCP

AT+LOCTAK? +LOCTAK: "OK",1,200 OK

Afficher la configuration actuelle

AT+LOCTAK=”OK”,,100 OK

la chaîne OK valide la trame reçue avec délai d’attente de 10 secondes, sinon l’appareil réitère l’envoi 5 fois puis ferme la liaison TCP

AT+LOCTAK? +LOCTAK: "OK",1,100 OK

Afficher la configuration actuelle

AT+LOCTAK=,0 OK Effacer les paramètres Valeurs définies:

<string> Chaîne d’acquit (“string”). Maximum 50 caractères. <param> Paramètre servant à gérer la chaîne <string> ; 0 : pour effacer, dans ce cas string doit être vide. Autres valeurs non gérées <time> Délai d’attente en multiples de 100ms, défaut = 200 (20 secondes).

Remarques:

La chaîne valide la trame reçue dans le délai. Après ce délai l’appareil réitère l’envoi 5 fois puis ferme la liaison TCP.

Page 40: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 40 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.10 AT+LOCTRD – Trame de lecture de la position en TCP Description:

Cette commande permet de saisir la valeur de la chaîne de demande de la position reçue du serveur. Ceci permet au serveur d’être à l’initiative des demandes de position.

Syntaxe:

AT+LOCTRD=<"string"> Exemples : Commande Réponses Possibles Notes AT+LOCTRD=? +LOCTRD: "Value for Server Read

Pos",0-1 OK

Afficher la syntaxe

AT+LOCTRD=”POS” OK Programmer le paramètre AT+LOCTRD? +LOCTRD: "POS",1

OK Afficher la configuration actuelle

AT+LOCTRD=,0 OK

Effacer le paramètre

Valeurs définies:

<string> Chaîne de demande de position (“string”). Lorsque l’appareil reçoit la chaîne, il envoie en retour la position GPS courante valide.

Par défaut la chaîne est vide. Maximum 50 caractères.

2.13.11 AT+LOCTCP – Test de la liaison TCP Description:

Cette commande permet de tester la liaison TCP. Lorsque les paramètres de configuration ont été saisis, voir ci-dessous, cette commande autorise l’ouverture d’un lien TCP, l’envoie et la réception “manuelle” des données. Ainsi la vérification du bon fonctionnement du lien GPRS indépendamment de l’application GPS est facilitée.

Syntaxe:

AT+LOCTCP=<mode> Exemples : Commande Réponses Possibles Notes AT+LOCTCP=? +LOCTCP: (0-1)

OK Afficher la syntaxe

AT+LOCTCP=1 WAIT network and SIM ready OK

Initialise une session TCP

AT+LOCTRD? TRACE : OK

Afficher la configuration actuelle

AT+LOCTRD No TCP connexion OK

Pas de liaison TCP établi. Voir les remarques en dessous.

AT+LOCTCP=0 OK

Termine une session TCP

Valeurs définies:

<mode> 0 : Termine une session TCP. 1 : Initialise une session TCP.

Remarques: Lorsque la session est ouverte, cette commande permet d’envoyer une trame de test. Si aucune information de position n’existe, la version logicielle de l’appareil est envoyée, sinon c’est la dernière position GPS valide. Le serveur peut aussi envoyer des informations qui seront servies sur le port série.

Page 41: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 41 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.12 AT+LOCFSV – FTP Server name Description:

Cette commande permet de saisir l’adresse IP du “FTP SerVer” distant. Syntaxe:

AT+LOCFSV=<"addr"> Exemples : Commande Réponses Possibles Notes AT+LOCFSV=? +LOCFSV: "xxx.xxx.xxx.xxx"

OK Afficher la syntaxe

AT+LOCFSV="123.98.76.54” OK

Programmer le paramètre

AT+LOCFSV? +LOCFSV: "123,98,76,54" OK

Afficher la configuration actuelle

AT+LOCFSV=,0 OK

Effacer le paramètre

AT+LOCFSV? +LOCFSV: "" OK

Afficher la configuration actuelle

Valeurs définies:

<addr> Adresse IP du serveur FTP (“xxx.xxx.xxx.xxx” ou “www.ftpserver.com”). Maximum 100 caractères.

2.13.13 AT+LOCFUN – FTP User Name Description:

Cette commande permet de saisir le “UserName” du site FTP. Syntaxe:

AT+LOCFUN=<"UserName"> Exemples : Commande Réponses Possibles Notes AT+LOCFUN=? +LOCFUN: "UserName"

OK Afficher la syntaxe

AT+LOCFUN="user" OK

Programmer le paramètre

AT+LOCFUN? +LOCFUN: "user" OK

Afficher la configuration actuelle

AT+LOCFUN=,0 OK

Effacer le paramètre

Valeurs définies:

<UserName> Nom d’utilisateur du site FTP. Maximum 50 caractères.

Page 42: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 42 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.14 AT+LOCFPW – FTP password Description:

Cette commande permet de saisir le “FTP PassWord”. Syntaxe:

AT+LOCFPW=<"PassWord"> Exemples : Commande Réponses Possibles Notes AT+LOCFPW=? +LOCFPW: "Password"

OK Afficher la syntaxe

AT+LOCFPW="pass" OK

Programmer le paramètre

AT+LOCFPW? +LOCFPW: "pass" OK

Afficher la configuration actuelle

AT+LOCFPW=,0 OK

Effacer le paramètre

Valeurs définies:

<PassWord> Mot de passe FTP. Maximum 50 caractères. Attention à la casse (majuscules, minuscules, chiffres, etc.).

2.13.15 AT+LOCFPT – Numéro de port FTP Description:

Cette commande permet de saisir la valeur du “FTP PorT“. Syntaxe:

AT+LOCFPT=<port> Exemples : Commande Réponses Possibles Notes AT+LOCFPT=? +LOCFPT: (1-65535)

OK Afficher la syntaxe

AT+LOCFPT=1234 OK

Programmer le paramètre

AT+LOCFPT? +LOCFPT: 1234 OK

Afficher la configuration actuelle

Valeurs définies:

<port> Numéro port FTP (1 à 65535). Défaut = 21.

Page 43: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 43 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.16 AT+LOCFGP – Chemin d’accès en lecture FTP (GET) (développement ultérieur) Description:

Cette commande permet de saisir la valeur du “FTP GetPath”. Syntaxe:

AT+LOCFGP=<"path"> Exemples : Commande Réponses Possibles Notes AT+LOCFGP=? +LOCFGP: "./PATH"

OK Afficher la syntaxe

AT+LOCFGP=”./mypath” OK

Programmer le paramètre

AT+LOCFGP? +LOCFGP: "./mypath" OK

Afficher la configuration actuelle

AT+LOCFGP=,0 OK

Programmer le chemin par défaut (“.”)

Valeurs définies:

<path> Chemin FTP (“path”). Maximum 100 caractères. Remarques:

Le caractère “.” indique la racine du disque (défaut). Le caractère “/ ” doit précéder le chemin. La commande AT+LOCFGP="." programme le chemin à la racine du disque.

2.13.17 AT+LOCFGF – Nom de fichier en lecture FTP (GET) (développement ultérieur) Description:

Cette commande permet de saisir la valeur du “FTP Get Filename”. Syntaxe:

AT+LOCFGF=<"Get_Filename"> Exemples : Commande Réponses Possibles Notes AT+LOCFGF=? +LOCFGF: "Get_Filename"

OK Afficher la syntaxe

AT+LOCFGF=”myfile.txt” OK

Programmer le paramètre

AT+LOCFGF? +LOCFGF: "myfile.txt" OK

Afficher la configuration actuelle

AT+LOCFGF=,0 OK

Effacer le paramètre

Valeurs définies:

<Get_Filename> Nom fichier FTP à récupérer (“filename”). Maximum 100 caractères.

Page 44: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 44 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.13.18 AT+LOCFPP – Chemin d’accès en écriture FTP (PUT) Description:

Cette commande permet de saisir la valeur du “FTP PutPath”. Syntaxe:

AT+LOCFPP=<"path"> Exemples : Commande Réponses Possibles Notes AT+LOCFPP=? +LOCFPP: "./PATH"

OK Afficher la syntaxe

AT+LOCFPP=”./mypath” OK

Programmer le paramètre

AT+LOCFPP? +LOCFPP: "./mypath" OK

Afficher la configuration actuelle

AT+LOCFPP=,0 OK

Programmer le chemin par défaut (“.”)

Valeurs définies:

<path> Chemin FTP (“path”). Maximum 100 charactères. Remarques:

Le caractère “.” indique la racine du disque (défaut). Le caractère “/ ” doit précéder le chemin. La commande AT+LOCFPP="." programme le chemin à la racine du disque.

2.13.19 AT+LOCFPF – Nom de fichier en écriture FTP (PUT) Description:

Cette commande permet de saisir la valeur du “FTP Put Filename”. Syntaxe:

AT+LOCFPF=<"Put_Filename"> Exemples : Commande Réponses Possibles Notes AT+LOCFPF=? +LOCFPF: "Put_Filename"

OK Afficher la syntaxe

AT+LOCFPF=”myfile.txt” OK

Programmer le paramètre

AT+LOCFPF? +LOCFPF: "myfile.txt" OK

Afficher la configuration actuelle

AT+LOCFPF=,0 OK

Effacer le paramètre

Valeurs définies:

<Put_Filename> FTP put file name (“filename”). Maximum 100 caractères. Remarques:

La valeur “ %I ” ajoutera l’identifiant de l’appareil dans le nom de fichier. La valeur “ %D ” ajoutera la première date valide des données transmises dans le nom de fichier. La valeur “ %H ” ajoutera la première heure valide des données transmises dans le nom de fichier. Exemple, le nom “%I_%D_%H.txt” génère pour la trame GPS suivante :

$GPLOC,A,1,072126.00,4716.81269,N,00003.51100,W,151105*27

le nom fichier : 354475000000394_151105_072126.txt

Page 45: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 45 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.14 Fonctionnement en GPRS 2.14.1 Mode TCP Dans ce mode, le système lorsqu’il est correctement paramétré, ouvre une connexion GPRS. Ensuite lorsqu’il détecte qu’il a des données à envoyer ou bien que l’interrogation est à l’initiative du serveur (AT+LOCTRD) agit selon les modes suivants : 1 - Pas d’attente d’acquit en retour :

• Dans ce cas, une liaison TCP est ouverte, et le système émet ses trames au fil de l’eau. En cas de détection d’erreurs de liaison, la connexion est fermée, et réouverte.

2 - Avec attente d’un acquit en retour :

• La liaison TCP est toujours ouverte. Une temporisation d’attente d’acquit est initialisée (20 secs par défaut).

• Si l’acquit arrive, le système se prépare à envoyer une nouvelle trame. • Si un non acquit est reçu, un compteur est incrémenté et l’envoi et réitéré 10 fois, puis la liaison

TCP est fermée et le système renouvelle la connexion. • Si le délai d’attente arrive à expiration, l’envoi et réitéré 5 fois, puis la liaison TCP est fermée et

le système renouvelle la connexion. Dans ce mode, avec le paramètre de configuration 4, (+LOCSND=4) un lien est aussi établi avec le port série de l’appareil. Ainsi lorsqu’une liaison TCP est ouverte, si des données arrivent du port série ou via le lien TCP et ne sont pas reconnues par l’appareil elles sont acheminées à travers l’appareil vers le lien destinataire. Du port série vers la liaison TCP, de la liaison TCP vers le port série. Ceci permet de disposer un appareil indépendant sur le port série et de bénéficier du lien TCP. La trame d’acquit doit être envoyée indépendamment des autres données, ceci pour permettre au système de bien l’identifier.

2.14.2 Mode FTP Dans ce mode, le système lorsqu’il est correctement paramétré, ouvre une connexion GPRS. Ensuite lorsqu’il détecte qu’il a des données à envoyer agit selon le mode suivant :

• En fonction de l’intervalle de transmission demandé, l’appareil ouvre une liaison FTP, crée un fichier sur le site distant selon les paramètres demandés et envoie les trames GPS au format choisi.

• Suite à l’envoi, la liaison GPRS reste ouverte, mais le lien FTP lui est fermé. En cas d’échec, les

données non envoyées le seront lors du transfert suivant.

Page 46: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 46 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.15 Gestion du code PIN 2.15.1 AT+CPIN – Rentrer un code PIN Le code PIN est indispensable pour effectuer un appel ou accepter une réponse émanant du réseau GSM. Ce code est contenu sur la carte SIM, et il peut être changé par l’utilisateur. Attention ! L’utilisateur n’a droit qu’à 3 tentatives de saisie du code PIN. Passé ces 3 tentatives, seul

un deuxième code, le code PUK, fourni par l’opérateur, permettra de choisir un nouveau code PIN. (Voir chapitre AT+CPWD – Changer le code PIN.)

Exemple (code PIN = 1234) :

• Rentrer le code PIN : AT+CPIN=1234

• Contrôler le code PIN :

AT+CPIN? Le modem retourne : +CPIN: READY (le code PIN est bon) +CPIN: SIM PIN (le code PIN est mauvais ou pas encore saisie) +CPIN: SIM PUK (le code PUK est réclamé)

2.15.2 AT+CLCK – Verrouiller le code PIN Afin d’éviter de rentrer systématiquement le code PIN de la carte SIM à chaque nouvelle mise sous tension, une commande permet de verrouiller la demande. Attention ! La carte sera déverrouillée et pourra alors être utilisée sur n’importe quel autre terminal

GSM. Pour protéger l’utilisation voir la commande AT+CPIN – Rentrer un code PIN. Exemple (code PIN = 1234) :

• Rentrer le code PIN: AT+CPIN=1234

• Contrôler le code PIN :

AT+CPIN? Le modem retourne : +CPIN: READY (le code PIN est bon)

• Verrouiller le code PIN (‘SC’ doit être tapé en Majuscule): AT+CLCK="SC",0,1234 (le chiffre 0 indique verrouillé) Le modem retourne : OK (le code PIN est correctement Verrouillé) ou ERROR (attendre 2 minutes et envoyer à nouveau la commande (il

faut un certain temps pour que le carte SIM soit initialisée) A la prochaine mise sous tension, le modem acceptera tout appel sortant ou entrant. Pour activer à nouveau la requête de code PIN à chaque mise sous tension, il suffit de saisir:

AT+CLCK="SC",1,1234

Page 47: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 47 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.15.3 AT+LOCPIN – Gestion protégée du code PIN Description:

Pour interdire l’utilisation de la carte SIM dans un autre appareil, il est possible de faire “saisir” le code PIN par l’application embarquée. Voir commande AT+CLCK="SC",1,xxxx pour activer cette fonction. La première fois, il faut saisir le code PIN qui sera sauvegardée en flash et envoyé lors de chaque mise sous tension.

Syntaxe:

AT+LOCPIN=<"OLD">,<"NEW"> Valeurs définies:

<OLD> old ancien code PIN <NEW> nouveau code PIN

Exemples (code PIN = 1234) :

AT+CLCK="SC",1,1234 AT+LOCPIN="1234"

• Pour changer le code pin :

AT+LOCPIN="1234","0000" (le nouveau code PIN est “0000”)

• Pour désactiver l’envoi automatique du code PIN: AT+LOCPIN="0000","10000"

2.15.4 AT+CPWD – Changer le code PIN Description:

Le code PIN peut être changé par l’utilisateur, à condition bien sûr de connaître le code PIN en cours.

Syntaxe:

AT+CPWD=<"SC">,<old>,<new> Exemple (PIN code actuel = 1234, nouveau code PIN = 4321) :

AT+CPWD="SC",1234,4321 Remarques:

Il faut que la requête de code PIN soit active. Voir la commande AT+CLCK="SC",1,1234

Page 48: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 48 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.16 Gestion suivi fonctionnement – Mode TRACE 2.16.1 AT+LOCTRC – Activer la trace Description:

Il est possible d’activer le mode trace qui permet de suivre sur le port série le déroulement du fonctionnement. Par défaut toutes les traces sont actives.

Syntaxe:

AT+LOCTRC=<level> Exemples : Commande Réponses Possibles Notes AT+LOCTRC=? +LOCTRC: (0-255)

OK Afficher la syntaxe

AT+LOCTRC=17 OK

Valider les traces DISPLAY_GPRS (level 16) et DISPLAY_GENERAL (level 1)

AT+LOCTRC? TRACE : GENERAL ON, WIND OFF, GPS OFF, GSM OFF, GPRS ON, DATA OFF, DOWNLOAD OFFOK

Afficher la configuration actuelle

AT+LOCTRC All Traces State inversed OK

Inverser tous les niveaux de trace

AT+LOCTRC? TRACE : GENERAL OFF, WIND ON, GPS ON, GSM ON, GPRS OFF, DATA ON, DOWNLOAD ON OK

Afficher la configuration actuelle

Valeurs définies:

<level> Niveau de trace (voir les remarques). Remarques:

Les niveaux de trace suivants sont disponibles : 1 : DISPLAY_GENERAL, envoi du message “READY” lors du lancement. 2 : DISPLAY_WIND, envoi des informations concernant la carte SIM et l’attachement au réseau. 4 : DISPLAY_GPS, envoi des trames GPS en mode stockage actif. 8 : DISPLAY_GSM, envoi du suivi de l’attachement au réseau. 16 : DISPLAY_GPRS, envoi du suivi de l’attachement au réseau et du transfert en TCP et FTP. 32 : DISPLAY_DATA, envoi du suivi de l’attachement au réseau et du transfert en connexion DATA

GSM. 64 : DISPLAY_DOWNLOAD, envoi des informations relatives à la mise à jour de l’application en

mode DOTA (Download Over The Air).

La commande est immédiatement sauvegardée en mémoire flash. La commande AT+LOCTRC sans paramètres permet de basculer toutes les traces dans l’état inverse. Le compte-rendu suivant est retourné “All Traces State inversed”. Voir les exemples ci-dessous. L’action de cette commande n’est pas sauvegardée en mémoire flash. La valeur par défaut sera rechargée lors de la prochaine mise sous tension.

Page 49: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 49 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

2.17 Divers 2.17.1 Heure Automatiquement, lorsque le système reçoit une trame GPS conforme, il en extrait les informations horaires et transfèrent celles-ci dans son horloge interne. 2.17.2 Réinitialisation Si suite à diverses manipulations, le matériel ne se comporte pas conformément aux attentes, il est possible de réinitialiser complètement l’espace mémoire afin de repartir avec les paramètres usines (voir la commande AT+WOPEN). 2.17.2.1 AT+WOPEN Procéder, comme suit.

Envoyer la commande “AT+WOPEN=0”, pour arrêter l’application. Envoyer la commande “AT+WOPEN=3”, pour effacer les paramètres de l’application. Envoyer la commande “AT+WOPEN=1”, pour relancer l’application.

Page 50: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 50 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3 COMMANDES BAS NIVEAU Ces commandes fournissent un accès de bas niveau direct au matériel du module. Celles-ci incluent des commandes pour accéder au serial flash, commandes trames UBX et certaines commandes Wavecom.

3.1 Commandes générales 3.1.1 AT+HELP – Afficher la liste des commandes générales Description:

Cette commande affichera une liste des commandes générales disponibles. La liste inclut certaines commandes de Wavecom qui ont été recréées par l'application afin d'être compatibles avec le matériel du GenLoc31e et les commandes originales de Wavecom (exemple: AT+WGPSPOS).

Syntaxe:

AT+HELP Example : Commande Réponses Possibles AT+HELP ATI8......................Display product software version and build information

AT+WGPSNMEA=(0-1),(0-5),..Activate display of unsolicited GPS NMEA frames AT+WGPSPOS................Display current GPS coordinate information AT+SHOWPOS=(0-240)........Display GPS information every n seconds. (0=disable) AT+ERRORSTAT=(0-1)........Display frame errors and total frames received (0=NMEA, 1=UBX) AT+WIOR=(0-3).............Display logic level at input 0-2 or motion detector (3) AT+WIOW=0,(0-1)...........Set logic level on open-collector output. 0=low, 1=high AT+WIOW=1,(0-1)...........RS232 interface: 0=enabled, 1=disabled AT+WIOW=n,(0-1)...........UART2 mode: n=7/8. 0=normal(DSR/DTR), 1=RxD/TxD diverted to DSR/DTR AT+WGPSM=0,(0-1)..........GPS module power: 0=off, 1=on AT+WGPSM=1,(0-1)..........GPS module reset: 0=reset, 1=normal AT+WGPSM=3................GPS module Software and Hardware versions AT+WGPSRAW................Send a raw UBX data stream to the GPS module AT+WGPSANT=(0-2)(,[mode][mon])..GPS antenna configuration AT+HELPUBX................Display list of UBX commands OK Note: Afficher liste des commandes

3.1.2 ATI8 – Afficher la version de l’application et l’information de compilation Description:

Cette commande affichera la version et l’information de compilation de l'application. Syntaxe:

ATI8 Example: Commande Réponses Possibles Notes ATI8 OAT V3.04.Q2406B-GENLOC31e version ARM-2.00 - Sep 18 2006 12:40:47

OK Afficher la version et l’information de compilation de l'application

Page 51: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 51 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.3 AT+WGPSNMEA – GPS NMEA non sollicités Description:

Cette commande permet à l'hôte d'activer les trames GPS NMEA fournies en tant que messages non sollicités sur le lien série principal de l’appareil comme suit :

$GPGGA,092003.00,4716.80272,N,00003.51569,W,1,08,1.01,28.7,M,47.9,M,,*7F $GPGSA,A,3,20,11,23,17,24,01,04,13,,,,,2.05,1.01,1.79*0E $GPGSV,3,1,09,20,75,044,48,11,39,138,47,23,61,168,49,17,47,261,50*7C $GPGSV,3,2,09,24,54,302,45,01,25,045,47,33,34,201,44,04,22,303,43*75 $GPGSV,3,3,09,13,31,196,51*4A $GPGLL,4716.80272,N,00003.51569,W,092003.00,A,A*75 $GPRMC,092004.00,A,4716.80273,N,00003.51572,W,0.004,,080606,,,A*6C $GPVTG,,T,,M,0.004,N,0.008,K,A*2F

Syntaxe:

AT+WGPSNMEA=<mode>[,<NMEA1>,<NMEA2>…] Exemples : Commande Réponses Possibles Notes AT+ WGPSNMEA AT+WGPSNMEA=(0-1),(0-5),...

OK Afficher la syntaxe

AT+WGPSNMEA=1,0,2,3

OK Ces trois trames seront affichées en tant que messages non sollicités

AT+ WGPSNMEA? +WGPSNMEA: 1,0,2,3 OK

Afficher la configuration actuelle (GGA, GSV, RMC)

AT+ WGPSNMEA=0 OK

Arrêter l’affichage non sollicités des trames

AT+ WGPSNMEA=1 OK Retourne en affichage non sollicités (le choix précédent est utilisé)

Valeurs définies:

<mode> 0 : désactiver l’affichage non sollicités des trames NMEA (défaut). 1 : activer l’affichage non sollicités des trames NMEA.

<NMEAx> sélectionner les trames NMEA dans la liste :

0 : GGA - GPS fix data. 1 : GSA - GPS DOP and Active satellites. 2 : GSV - GPS satellites in view. 3 : RMC - Recommended minimum data. 4 : VTG - Course over ground and ground speed. 5 : GLL - Latitude and longitude, with time of position fix and status.

Remarques:

Si les paramètres <NMEAx> sont omis, la dernière configuration est utilisée. Les paramètres sont stockés en flash.

Page 52: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 52 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.4 AT+WGPSRAW – Envoyer des données brutes au module GPS Description:

Cette commande permet d’envoyer une chaîne de données brutes au module GPS. Les données ne sont pas interprétées à l'intérieur du module GSM.

Syntaxe:

AT+WGPSRAW=<pdu>

Exemples : Commande Réponses Possibles Notes AT+WGPSRAW AT+WGPSRAW="raw UBX data string"

OK Afficher la syntaxe

AT+WGPSRAW=”B56206010600F005000100010432000100000331”

OK

Transmission réussie des données au module GPS (cet exemple permet au module GPS d’envoyer des trames VTG)

Valeurs définies:

<pdu> Des données sont saisies comme une chaîne binaire (dans le format hexadécimal) enclos par des guillemets. Seulement les caractères hexadécimaux suivants : ‘0’ à ‘9’, et ‘A’ à ‘F’ sont permis. Chaque paire de caractères est convertie en byte. Par exemple, « 41 » est convertis en valeur hexadécimale 0x41.

Remarques:

Le contenu de <pdu> est de la responsabilité de l’utilisateur. La longueur de <pdu> est limitée à 512 caractères correspondant à une trame de 256 bytes hexadécimaux.

Page 53: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 53 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.5 AT+WGPSPOS – Position GPS Description:

Cette commande obtiendra en réponse la dernière information de position GPS reçue. Syntaxe:

AT+WGPSPOS Réponse Syntaxe: +WGPSPOS:<fix>,<time>,<date>,<latitude>,<longitude>,<altitude>,<hdop>,<speed>,<course>,<nbsat> Exemples : Commande Réponses Possibles Notes AT+WGPSPOS +WGPSPOS:2,100556.00,080606,4716.80053N,00

003.51560W,83.4,1.45,0.013,,07 OK

Voir les valeurs définies

Valeurs définies:

<fix> 0 : Invalide fix 1 : 2D fix 2 : 3D fix -1 : pas possible de définir une position

<time> hhmmss l’heure du fix limites des valeurs: hh (heure) 00 à 23 mm (minute) 00 à 59 ss (seconde) 00 à 59

Exemple: 130556 = 13:05:56 UTC <date> ddmmyy date du fix

limites des valeurs: dd (jour) 01 à 31 mm (mois) 01 à 12 yy (année) 2000 à 2099

Exemple: 191105 = 19th Novembre 2005 <latitude> ddmm.mmmmm(N/S)

limites des valeurs: dd (degrés) 00 à 90 mm.mmmmm (minutes) 00,00000 à 59.99999 (N/S) Nord ou Sud

Exemple: latitude 4716.80053N = 47° 16.80053’ Nord <longitude> dddmm.mmmm(E/W)

limites des valeurs: dd (degrés) 00 à 180 mm.mmmm (minutes) 00,0000 à 59.9999 (E/W) Est ou Ouest

Exemple: longitude 12303.51560W = 123° 3.51560’ West <altitude> mmmm.m altitude en mètres <hdop> mmm.mm horizontal dilution of position en mètres <speed> ssss.s vitesse en KPH <course> dddmm.mmmm cap en degrés, minutes

limites des valeurs: ddd (degrés) 000 à 360 mm.mmmm (minutes) 00.0000 à 59.9999

<nbsat> nn nombre de satellites en vue

Remarques: Quelques champs peuvent être vides selon la disponibilité des informations.

Page 54: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 54 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.6 AT+WGPSM – Gestion module GPS Description:

Cette commande contrôle la mise sous tension, le reset du module GPS, et fournis la version logicielle et matérielle courante du module GPS.

Syntaxe:

AT+WGPSM=<type>[,<mode>][,<reset>]

Exemples : Commande Réponses Possibles Notes AT+WGPSM AT+WGPSM=(0-1)(3),(0-1)

OK Afficher la syntaxe

AT+WGPSM=0,1 OK

Mise sous tension du module GPS

AT+WGPSM=0 +WGPSM: 0,1 OK

Le module GPS est actuellement sous tension

AT+WGPSM=1,0 OK

Reset du module GPS

AT+WGPSM=1,1 OK

Arrêt du reset du module GPS

AT+WGPSM=1 +WGPSM: 1,1 OK

Lecture de l’état, le module GPS n’est pas en reset

AT+WGPSM=3 +WGPSM: SW VERSION 5.00 Jan 09 2006 12:00:00 - HW VERSION 00040001 + Extension: M4H1.1 Jan 09 2006 15:3 9:54 OK

Version logicielle et matérielle du module GPS

Valeurs définies:

<type> 0 : module GPS gestion de l’alimentation (voir <mode>). 1 : module GPS gestion du reset (voir <reset>). 2 : Non géré 3 : retourne la version logicielle et matérielle du module GPS.

<mode> 0 : module GPS n’est pas alimenté.

1 : module GPS est alimenté (défaut). Si <mode> est omis, l’état actuel est retourné.

<reset> 0 : module GPS est en reset.

1 : module GPS n’est pas en reset (défaut). Si <reset> est omis, l’état actuel est retourné.

Page 55: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 55 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.7 AT+WIOR – Read GPIO value Description:

Cette commande retourne l’état des entrées GPIO sur le bus SPI. Syntaxe:

AT+WIOR=<index>

Exemples : Commande Réponses Possibles Notes AT+WIOR AT+WIOR=(0-3)

OK Afficher la syntaxe

AT+WIOR=0 +WIOR: 0 OK

L’état de l’entrée 0 est bas

AT+WIOR=1 +WIOR: 1 OK

L’état de l’entrée 1 est haut

AT+WIOR=2 +WIOR: 0 OK

L’état de l’entrée 2 est bas

AT+WIOR=3 +WIOR: 0 OK

Le détecteur de mouvement est bas (option)

Valeurs définies:

<index> 0 : entrée opto-couplée 0. 1 : entrée opto-couplée 1. 2 : entrée opto-couplée 2. 3 : détecteur de mouvement (optionnel).

Page 56: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 56 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.8 AT+WIOW – Write GPIO value Description:

Cette commande écrit une valeur sur une sortie via le bus SPI. Syntaxe:

AT+WIOW=<index>,<value>

Exemples : Commande Réponses Possibles Notes AT+WIOW AT+WIOW=(0,1,7,8),(0-1)

OK Afficher la syntaxe

AT+WIOW=0,1 OK

Sortie collecteur ouvert est haute

AT+WIOW=1,0 OK

UART1 RS232 interface est validé

AT+WIOW=7,1 OK

UART2 RxD/TxD sont détournés vers UART1 DSR/DTR

Valeurs définies:

<index> 0 : sortie collecteur ouvert (voir <value>) 1 : UART1 RS232 interface (voir <state>) 7 : UART2 re-direction (voir <mode>) 8 : UART2 re-direction (voir <mode>)

<value>

0 : Output pin est bas 1 : Output pin est haut

<state>

0 : UART1 RS232 interface est validé (défaut) 1 : UART1 RS232 interface est dé-validé (le RxD reste toujours actif permettant la

réception des commandes) <mode>

0 : Normal (défaut) 1 : UART 2 RxD et TxD sont détournés vers UART1 DSR et DTR (pas besoin de

reset et mode externe)

Page 57: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 57 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.9 AT+WGPSANT – Configuration antenne GPS Description:

Gestion de la configuration de l’antenne GPS. Syntaxe:

AT+WGPSANT=<type>[,<mode>][,<mon>] Réponse syntaxe:

+WGPSANT: <type>,<mode> : <type>,<mon> : <type>,<status>,<presence>,<voltage>

Syntaxe de la réponse non sollicitée :

+WGPSANT: <type>,<status>,<presence>,<voltage> Exemples : Commande Réponses Possibles Notes AT+WGPSANT +WGPSANT=type(,[mode][mon])

OK Afficher la syntaxe

AT+WGPSANT=0 OK

L’antenne est actuellement alimentée

AT+WGPSANT=1,1 OK

Activer le monitoring de l’antenne

Unsolicited message +WGPSANT: 2,1,0,3282 Circuit ouvert détecté. Antenne déconnectée.

Unsolicited message +WGPSANT: 2,1,1,3116 Antenne reconnectée et présente AT+WGPSANT=2 +WGPSANT: 2,1,1,3116

OK Pas de circuit ouvert détecté et l’antenne est connectée avec 3.116V

Valeurs définies:

<type> 0 : configuration antenne (voir <mode>). 1 : gestion antenne monitoring (voir <mon>). 2 : status antenne (voir <status>).

<mode> 0 : 0v (antenne pas alimentée).

1 : 3v interne (défaut) (antenne alimentée). <mon> 0 : monitoring est désactivé (défaut). 1 : monitoring est activé. <status> 0 : antenne pas alimentée.

1 : antenne alimentée. Remarque : Dans le cas d'un court-circuit, le système de protection interne déconnecte l'antenne, ouvrant le circuit. Après un délai de 10 secondes l'antenne est ré-alimentée.

<presence>

0 : pas d’antenne connectée. 1 : antenne connectée 2 : le système de détection de la présence de l’antenne n’est pas activé.

<voltage> voltage de l’antenne en mV.

Remarques:

Il n'est pas nécessaire d'effectuer une reset pour que cette commande soit prise en compte. La commande AT+WGPSANT ne gère pas les modes EXT ou Single Coax Options pour la configuration d'antenne GPS.

Page 58: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 58 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.1.10 AT+SHOWPOS – Affichage automatique des coordonnées GPS Description:

Cette commande affichera automatiquement les coordonnées GPS. L’affichage se fera comme si la commande AT+WGPSPOS été entrée toutes les n secondes, i.e. :

+WGPSPOS:2,074657.00,170506,4716.80554N,00003.51461W,78.0,0.92,0.007,,08 +WGPSPOS:2,074707.00,170506,4716.80550N,00003.51490W,77.8,0.92,0.006,,08 +WGPSPOS:2,074717.00,170506,4716.80535N,00003.51490W,77.9,0.92,0.005,,08 etc.

Syntaxe:

AT+SHOWPOS=<n> Exemples : Commande Réponses Possibles Notes AT+SHOWPOS AT+SHOWPOS=(0-240)

OK Afficher la syntaxe

AT+SHOWPOS=10 OK

Afficher les coordonnées toutes les 10 secondes

AT+SHOWPOS? +SHOWPOS: 10 OK

Afficher la configuration actuelle

AT+SHOWPOS=0 OK

Arrêter l’affichage automatique

Valeurs définies:

<n> 0 : arrêter l’affichage automatique. 1 to 240 (secondes) : afficher les coordonnées GPS toutes les n secondes.

Remarques: Ce paramètre est immédiatement sauvegardé dans la mémoire flash interne.

3.1.11 AT+ERRORSTAT – Afficher le statut des trames NMEA et UBX Description:

Cette commande affichera le nombre trames NMEA et d'UBX reçues et le nombre d'erreurs reçues par UART2 du module GPS.

Syntaxe:

AT+ERRORSTAT=<n> Exemples : Commande Réponses Possibles Notes AT+ERRORSTAT AT+ERRORSTAT=(0-1) (0=NMEA, 1=UBX)

OK Afficher la syntaxe

AT+ERRORSTAT=0 NMEA error status: checksum errors = 0 / 17877 (frames received) OK

Afficher le statut pour les trames NMEA. Dans ce cas, 0 erreurs pour 17877 trames reçu.

AT+ERRORSTAT=1 UBX error status: checksum errors = 0 / 10 (frames received) OK

Afficher le statut pour les trames UBX. Dans ce cas, 0 erreurs pour 10 trames reçu.

Valeurs définies:

<n> 0 : trames NMEA. 1 : trames UBX.

3.1.12 AT+WGPSCONF – GPS configuration

La commande AT+WGPSCONF ne peut pas être utilisée pour modifier la configuration GPS.

Page 59: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 59 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.2 UBX commands 3.2.1 AT+HELPUBX – Afficher la liste des commandes UBX Description:

Cette commande affichera la liste des commandes UBX qu’il est possible d’utiliser entre le Wismo et le module GPS.

Syntaxe:

AT+HELPUBX Exemple : Commande Réponses Possibles AT+HELPUBX AT+UBXMONVER..............Display hardware and software version of the GPS module

AT+UBXMONHW...............Display status of the hardware of the GPS module AT+UBXCFGDAT..............Display (?) or set datum (=0-215) AT+UBXCFGDPM..............Display (?) or set Dynamic Platform Model (=1-7) OK Note: Afficher la liste des commandes UBX

3.2.2 AT+UBXMONVER – Afficher la version HW / SW du module GPS Description:

Cette commande affichera la version logicielle et matérielle du module GPS. Syntaxe:

AT+UBXMONVER Exemple : Commande Réponses Possibles AT+UBXMONVER GPS module - SW version: "5.00 Jan 09 2006 12:00:00"

GPS module - HW version: "00040001" GPS module - Extension : "M4H1.1 Jan 09 2006 15:39:54" OK Note: Afficher la version logicielle et matérielle du module GPS

3.2.3 AT+UBXMONHW – Afficher statut matériel du module GPS Description:

Cette commande affichera le statut des différents aspects du matériel du module GPS, tel que l'antenne, le niveau de bruit, la commande de gain automatique (AGC) et l’Horloge Temps Réel.

Syntaxe:

AT+UBXMONHW Exemple : Commande Réponses Possibles Notes AT+UBXMONHW Noise Level measured by GPS Core : 159

AGC Monitor : 6123 Antenna Supervisor Status : OK Antenna PowerStatus : ON Real-Time Clock : Calibrated OK

Niveau de bruit. Niveau AGC. Antenne supervision machine d’état statut. Antenne power statut. HTR Interne ajustée à l’heure GPS reçu.

Page 60: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 60 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.2.4 AT+UBXCFGDAT – Datum GPS Description:

Cette commande permet de programmer le Datum GPS. Syntaxe:

AT+UBXCFGDAT=<n> Exemples : Commande Réponses Possibles AT+UBXCFGDAT AT+UBXCFGDAT=(0-215)

OK Afficher la syntaxe

AT+UBXCFGDAT=0 OK

Programmer Datum à 0 (WGS84)

AT+UBXCFGDAT? Current Datum: 0 - WGS84 OK

Afficher la configuration actuelle. Dans ce cas, 0 (WGS84)

Valeurs définies:

<n> 0 à 215 : datum identifier (Défaut 0, correspondant à WGS84).

3.2.5 AT+UBXCFGDPM – Module GPS Dynamic Platform Model Description:

Cette commande permet de modifier le Dynamic Platform Model employé par le module GPS ajustant de ce fait le moteur de navigation sur l'environnement prévu. Ceci peut avoir comme conséquence une meilleure interprétation des mesures et par conséquent du rendement plus précis de position.

Syntaxe:

AT+UBXCFGPM=<n> Exemples : Commande Réponses Possibles AT+UBXCFGDPM AT+UBXCFGDPM=(1-7)

OK Afficher la syntaxe

AT+UBXCFGDPM=3 OK

Sélection l’Automotive Dynamic Platform Model

AT+UBXCFGDPM? +UBXCFGDPM: 3 OK

Afficher la configuration actuelle. Dans ce cas, 3 (Automotive)

Valeurs définies:

<n> 1 : Stationary – Vélocité est limité à 0 m/s. 2 : Pedestrian – Faible accélération verticale, les dispositifs portatifs se sont

déplacés par la puissance de l’homme. 3 : Automotive – Faible accélération verticale, dynamiques d’automobiles. 4 : Sea – Zéro accélération verticale, applications marine.

5 : Airborne <1g – Plage dynamique supérieur qu’une voiture et plus d’accélération verticale.

6 : Airborne <2g – Environnement d’avion typique 7 : Airborne <4g – Environnement dynamique extrême.

Page 61: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 61 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.2.6 AT+UBXSHOW – Afficher trames UBX Description:

Cette commande permet l’affichage des trames UBX échangées entre l’UART2 et le module GPS. Syntaxe:

AT+UBXSHOW=<n> Exemples : Commande Réponses Possibles AT+UBXSHOW AT+UBXSHOW=(0-3) + (80 for ASCII)

OK Afficher la syntaxe

AT+ UBXSHOW=1 OK

Afficher les trames RX seulement

AT+ UBXSHOW=2 OK

Afficher les trames TX seulement

AT+ UBXSHOW=3 OK

Afficher les trames RX et TX

AT+ UBXSHOW=83 OK

Afficher les trames RX et TX avec l’interprétation ascii

AT+ UBXSHOW? +UBXSHOW=83 OK

Afficher la configuration actuelle. Dans ce cas trames RX, TX avec interprétation ascii

AT+ UBXSHOW=0 OK

Arrêter l’affichage de trames UBX

Valeurs définies:

<n> 0 : arrêter l’affichage des trames UBX. 1 : afficher les trames RX seulement. 2 : afficher les trames TX seulement.

3 : afficher les trames RX et TX. n+80 : afficher les trames interprétation ascii.

Exemple a) - Afficher les trames RX seulement :

AT+UBXSHOW=1 OK AT+UBXCFGDAT? - <UBX RX> CFG_DAT: B5 62 06 06 34 00 00 00 57 47 53 38 34 00 00 00 00 40 A6 54 58 41 88 6D 74 96 1D A4 72 40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 E2 A5 Current Datum: 0 - WGS84 OK - <UBX RX> ACK_ACK: B5 62 05 01 02 00 06 06 14 3D

Exemple b) - Afficher les trames RX et TX interprétation ascii:

AT+UBXSHOW=83 OK

Page 62: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 62 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

AT+UBXCFGDAT? - <UBX TX> CFG_DAT: B5 62 06 06 00 00 0C 2A µb.....* - <UBX RX> CFG_DAT: B5 62 06 06 34 00 00 00 57 47 53 38 34 00 00 00 µb..4...WGS84... 00 40 A6 54 58 41 88 6D 74 96 1D A4 72 40 00 00 .@¦TXAˆmt–.¤r@.. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 00 00 00 00 00 00 00 00 00 00 E2 A5 ..........⥠Current Datum: 0 - WGS84 OK - <UBX RX> ACK_ACK: B5 62 05 01 02 00 06 06 14 3D µb.......=

Page 63: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 63 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.3 Serial Flash commands Ces commandes permettent d'accéder à la mémoire flash série optionnel. Voir la data sheet pour plus d’information sur le type de flash utilisé. 3.3.1 AT+SFHELP – Afficher liste des commandes mémoire flash série Description:

Cette commande affichera les commandes disponibles pour accéder et gérer la mémoire flash série. Syntaxe:

AT+SFHELP Exemple: Commande Réponses Possibles AT+SFHELP

------------------------- SERIAL FLASH ------------------------- AT+SFHELP.................Display list of commands AT+SFTYPE.................Display manufacturer, memory size and erase block size(s) AT+SFSR...................Display Status Register AT+SFWRTEXT=addr,"text"...Write an ascii text to the address addr AT+SFRD=start,length(,a)..Read length bytes from start address, (a=1: ascii dump) AT+SFWEL=x................Display or modify Write Enable Latch bit: 0=Disabled, 1=Enabled AT+SFBP=x.................Display or modify Block Protection bits: 1=Protected, 0=Unprotected AT+SFEB=x(,s).............Erase block, size (default 64Kbytes) AT+SFECHIP................Erase entire memory OK Note: Commandes mémoire flash série

3.3.2 AT+SFTYPE – Type mémoire Description:

Cette commande affichera le fabricant, type, taille mémoire et taille des blocs en octets de la mémoire flash série (si présente).

Syntaxe:

AT+SFTYPE Exemples: Commande Réponses Possibles AT+SFTYPE

------------- SERIAL FLASH ------------- Manufacturer: SST (0xBF), Type: SST25VF016B (0x2541) Size: 2097152 Bytes Erase Blocks: 64KB 32KB 4KB OK

Afficher des informations sur la mémoire flash série détectée

AT+SFTYPE

No Serial Flash detected OK

Pas de flash série présente

Page 64: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 64 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.3.3 AT+SFSR – Registre de statut Description:

Cette commande permet d’afficher le contenu du registre de statut dans la mémoire flash série en format hexadécimal.

Syntaxe:

AT+SFSR Exemple : Commande Réponses Possibles Notes AT+SFSR +SFSR: 0x1C

OK Registrer de status = 0x1C

3.3.4 AT+SFWEL – Afficher / modifier Write Enable Latch bit Description:

Cette commande permet d’afficher ou modifier le bit Write Latch Enable (WEL) dans le registre de statut. A noter que le WEL bit doit être validé (1) et que les bits BP appropriés doivent être effacés (0) pour pouvoir modifier la mémoire. Le WEL bit est reseté à 0 (dé-validé) après une écriture dans le registre de statut, les bits de protection ou dans la mémoire.

Syntaxe:

AT+SFWEL=<n> Exemples: Commande Réponses Possibles Notes AT+SFWEL AT+SFWEL=x (0=Disabled, 1=Enabled)

OK Afficher la syntaxe

AT+SFWEL=0 OK

Set WEL bit à 0

AT+SFWEL=1 OK

Set WEL bit à 1

AT+SFWEL? +SFWEL: 1 OK

Afficher la configuration actuelle, dans ce cas 1

Valeurs définies:

<n> 0 : Dé-validé. 1 : validé.

Page 65: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 65 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.3.5 AT+SFBP – Afficher / modifier Block Protection bits Description:

Cette commande permet d’afficher ou de modifier les bits de protection blocs (BP) dans le registre de statut. A noter le WEL bit doit être validé (1) pour pouvoir modifier les bits BP. Le WEL bit doit être aussi validé (1) et les bits BP appropriés doivent être effacés (0) pour pouvoir modifier la mémoire.

Syntaxe:

AT+SFBP=<n> Exemples: Commande Réponses Possibles Notes AT+ SFBP AT+SFBP=x (0=Unprotected, 1=Protected)

OK Afficher la syntaxe

AT+SFBP=1 OK

Set all BP bits to 1

AT+SFBP=0 OK

Set all BP bits to 0

AT+SFBP? +SFBP: 0 OK

Afficher la configuration actuelle des BP bits, dans ce cas 0

Valeurs définies:

<n> 0 : non-protégé. 1 : protégé.

3.3.6 AT+SFWRTEXT – Ecrire une chaîne en ascii Description:

Cette commande permet d’écrite une chaîne de caractères en ascii dans la mémoire flash série. A noter que le WEL bit doit être validé (1) et que les bits BP appropriés doivent être effacés (0) pour pouvoir modifier la mémoire.

Syntaxe:

AT+SFWRTEXT=<n>,“ascii text” Exemple: Commande Réponses Possibles AT+SFWRTEXT=50,”An ascii text string” 20 bytes written to address 0x00000032

OK Note: la chaîne de caractères est écrite dans la mémoire à partir de l’adresse 50 (0x00000032)

Valeurs définies:

<n> Adresse de début, 0 à la taille maximum de la mémoire (valeur décimale). “ascii text” Chaîne en ascii.

Page 66: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 66 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.3.7 AT+SFRD – Afficher le contenu de la mémoire Description:

Cette commande permet de lire et afficher le contenu de la mémoire. Syntaxe:

AT+SFRD=<s>, <n>,<a> Exemples : Commande Réponses Possibles AT+SFRD=8,100 AT+SFRD=start,length(,a) (a=1: ascii dump)

OK Note: Afficher la syntaxe

AT+SFRD=8,100 100 bytes read starting at address 0x00000008... -- ADDR -- 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0x00000000 FF FF FF FF FF FF FF FF 0x00000010 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 0x00000020 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 0x00000030 FF FF 41 6E 20 61 73 63 69 69 20 74 65 78 74 20 0x00000040 73 74 72 69 6E 67 FF FF FF FF FF FF FF FF FF FF 0x00000050 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 0x00000060 FF FF FF FF FF FF FF FF FF FF FF FF OK

Note: Afficher la contenu de la plage d’adresses 8 (0x08) à 100 (0x64) sans ascii dump

AT+SFRD=8,100,1 100 bytes read starting at address 0x00000008... -- ADDR -- 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F ---- ASCII ----- 0x00000000 FF FF FF FF FF FF FF FF ÿÿÿÿÿÿÿÿ 0x00000010 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ 0x00000020 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ 0x00000030 FF FF 41 6E 20 61 73 63 69 69 20 74 65 78 74 20 ÿÿAn ascii text 0x00000040 73 74 72 69 6E 67 FF FF FF FF FF FF FF FF FF FF stringÿÿÿÿÿÿÿÿÿÿ 0x00000050 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ 0x00000060 FF FF FF FF FF FF FF FF FF FF FF FF ÿÿÿÿÿÿÿÿÿÿÿÿ OK

Note: Afficher la contenu de la plage d’adresses 8 (0x08) à 100 (0x64) avec ascii dump

AT+SFRD=10000000,100 Flash - Address is out of Range ERROR Note: L’adresse de début dépasse la taille de la mémoire

Valeurs définies:

<s> Adresse de début, 0 à la taille maximum de la mémoire (valeur décimale). <n> Longueur, 1 à 512 (valeur décimale). <a> Ascii dump, 0: non (défaut), 1: oui.

Page 67: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 67 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

3.3.8 AT+SFEB – Effacer block Description:

Cette commande permet d’effacer un bloc d’adresses dans la mémoire. A noter que le WEL bit doit être validé (1) et que les bits BP appropriés doivent être effacés (0) pour pouvoir modifier la mémoire.

Syntaxe:

AT+SFEB=<n>,<s> Exemples : Commande Réponses Possibles Notes AT+SFEB AT+SFEB=x(,s) (s default = 64 (KBytes))

OK Afficher la syntaxe

AT+SFEB=0 Erasing block 0 (0x10000 bytes). Please wait...Block 0 erased OK

Bloc 0 de 64Koctets a été effacé

AT+SFEB=0,4 Erasing block 0 (0x1000 bytes). Please wait... Block 0 erased OK

Bloc 0 de 4Koctets a été effacé

AT+SFEB=0 Flash - Write Latch Disabled ERROR

Le WEL bit n’est validé. Impossible d’effacer le bloc.

AT+SFEB=0 Flash - Blocks protected ERROR

Les bits BP ne sont pas resetés. Impossible d’effacer le bloc.

AT+SFEB=0,16 ERROR La taille du bloc spécifié n’est pas compatible avec le flash

AT+SFEB=185 Flash - Block Number is out of Range ERROR

Le numéro bloc spécifiédépasse la taille de la mémoire

Valeurs définies:

<n> Numéro bloc, 0 jusqu’au nombre maximum de bloc - 1, valeur décimale). <s> Taille bloc (défaut 64K), sélectionner 1,2,4,8,16,32,64 ou 128K octets, (valeur

décimale). 3.3.9 AT+SFECHIP – Effacer chip Description:

Cette commande permet d’effacer toute la mémoire. A noter que le WEL bit doit être validé (1) et que les bits BP appropriés doivent être effacés (0) pour pouvoir modifier la mémoire.

Syntaxe:

AT+SFECHIP Exemples : Commande Réponses Possibles Notes AT+SFECHIP Erasing device memory. Please wait...

Memory erased OK

Toute la mémoire a été bien effacée

AT+SFECHIP Flash - Write Latch Disabled ERROR

Le WEL bit n’est validé. Impossible d’effacer la mémoire

AT+SFECHIP Flash - Blocks protected ERROR

Les bits BP ne sont pas reseté. Impossible d’effacer la mémoire

Page 68: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 68 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

4 CONFIGURATION RAPIDE

4.1 Générale Dès que les antennes GPS et GSM sont raccordées et que les voyants clignotent, ceci indique que l’appareil reçoit correctement des informations GPS et qu’il est attaché au réseau GSM/GPRS. Les exemples ci-dessous ne fonctionnent que si les conditions précitées sont réunies.

Choisir le format de trame: AT+LOCFRT=0 format RMC (défaut), AT+LOCFRT=1 format GGA, AT+LOCFRT=2 format CUSTOM. Visualisation de la configuration GPRS: AT+LOCCNG Visualisation de la configuration générale: AT+LOCCNF

4.2 Mode SMS Si l’on veut, il n’y a rien à programmer. L’envoi d’un SMS, avec les contenus suivants, suffit pour recevoir en retour la position courante.

Texte du SMS de demande : “0000 SENDPOSI” Exemple de SMS reçu en retour par défaut :

354475000000000 $GPRMC,100237.00,A,4716.81212,N,00003.50181,W,0.175,3.23,230106,,,A*7E

4.3 Mode Appel Data Il suffit de programmer le numéro de téléphone du destinataire, l’intervalle de capture des positions GPS et celui d’envoi des positions capturées. Le numéro de téléphone peut être celui d’une ligne du réseau téléphonique commuté sur laquelle un modem V32 avec correction d’erreur est raccordé.

Programmer le numéro du destinataire : AT+LOCPHN=1, "0xxxxxx",8 pour envoi en mode DATA, Programmer l’intervalle de capture des positions GPS : AT+LOCSTK= 1, "000500",0,4,1,000,03 toutes les 5 minutes vitesse mini 0 KMH /

HDOP <= 4 et 3 satellites, AT+LOCSTK= 1, "000030",0,10,1,000 ,04 toutes les 30 secondes, vitesse mini 0 KMH

/ HDOP <= 10 et 4 satellites, Programmer l’intervalle d’envoi : AT+LOCSND=1,"I","00:10" appel toutes les 10 minutes en mode DATA.

Page 69: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 69 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

4.4 Mode Réponse Data Il suffit simplement de programmer le numéro de téléphone de l’appelant afin qu’il soit identifié et que l’appel entrant soit accepté. L’appel doit se faire avec soit un modem GSM, soit un modem V32 avec correction d’erreur.

Programmer le numéro du destinataire : AT+LOCPHN=1, "0xxxxxx",8 pour envoi en DATA mode.

Suite à la connexion, par défaut, une trame au format RMC est envoyée chaque seconde.

4.5 Mode GPRS FTP Il faut entrer les informations concernant votre fournisseur d’accès et celles du site destinataire comme montré dans les exemples ci-dessous :

AT+LOCASV="internet","myuser","mypass" Access SerVer AT+LOCFSV="siteftp.mysite.fr" FTP SerVer AT+LOCFUN="siteusername" UserName AT+LOCFPW="sitepassword" PassWord

Par défaut, le nom du fichier créé comportera l’identifiant de l’appareil, la date et l’heure de la première trame écrite dans le fichier Ceci n’est vrai que pour le format de trame RMC ou dans le cas d’une trame PERSO lorsque le champ date a été sélectionné. Sinon celui-ci est remplacé par “000000” et seul la date de création du fichier permettra de remettre dans l’ordre les données reçues. Le fichier sera créé à la racine du répertoire.

Programmer l’intervalle de capture des positions GPS: AT+LOCSTK=1,"000500",0,4,1,000,03 toutes les 5 minutes vitesse mini 0 KMH /

HDOP <= 4 et 3 satellites. AT+LOCSTK=1,"000030",0,10,1,000,04 toutes les 30 secondes, vitesse mini 0 KMH

/ HDOP <= 10 et 4 satellites. Programmer l’intervalle d’envoi : AT+LOCSND=3,"I","00:10" transfert toutes les 10 minutes en mode

FTP.

4.6 Mode GPRS TCP Il faut entrer les informations concernant votre fournisseur d’accès et celles du site destinataire comme montré dans les exemples ci-dessous :

AT+LOCASV="internet","myuser","mypass" Access SerVer AT+LOCTSV="00.00.00.00",port adresse IP et numéro port Programmer l’intervalle de capture des positions GPS : AT+LOCSTK=1,"000500",0,4,1,000,03 toutes les 5 minutes vitesse mini 0 KMH /

HDOP <= 4 et 3 satellites. AT+LOCSTK=1,"000030",0,10,1,000,04 toutes les 30 secondes, vitesse mini 0 KMH

/ HDOP <= 10 et 4 satellites. Programmer l’envoi : AT+LOCSND=2 envoi au fil de l’eau des trames.

Page 70: WS0008 Application embarquée permettant la gestion ...sen.eme.free.fr/fz/Doctech/genloc/Commandes.pdf · Historique du document Révision Modifications Auteur Date 000 Création

EG_WS0008_CL_020_FR Page 70 / 70

Descriptions and non-contractual illustrations in this document are given as an indication only. ERCO&GENER reserves the right to make any modifications.

5 TELECHARGEMENT DE L’APPLICATION

5.1 Préparation du téléchargement TRES IMPORTANT Pour s'assurer que le téléchargement se passe correctement (sans s'arrêter ou blocage), avant de télécharger une nouvelle version de l'application, s'assure que les commandes suivantes sont exécutées d'abord :

AT+WOPEN=0 (arrêt l’application courante) AT+WOPEN=3 (efface les paramètres en mémoire flash) AT+WOPEN=4 (efface le programme) AT+WGPSANT=1,0 (désactive la gestion de l’antenne) AT&F (recharge les paramètres usine) AT&W (sauvegarde la configuration courante) AT+CFUN=1 (reset de l’appareil)

5.2 AT+WDWL – Téléchargement de l’application

• Lancer le logiciel HyperTerminal sous Windows. • Activer Matérial Contrôl de flux. • Exécuter la séquence de commandes d’initialisation comme décrit dans Préparation du

téléchargement pour initialiser le modem. • Entrer la commande AT+WDWL pour mettre le modem en mode de téléchargement. • A ce moment le modem retourne +WDWL : 0 puis des caractères de contrôle non interprété (‘§’ ou

similaire) avant 2 secondes. Si ce n’est pas le cas, entrer la commande AT+CFUN=1 pour reseter le modem puis recommencer à partir de la saisie de la séquence de commandes d’initialisation.

• Dans la barre d’outil sélectionner “Transfert” puis “Envoyer le fichier”. • Sélectionner le fichier à envoyer ayant l’extension “.DWL” • Sélectionner le protocole “Xmodem”. • Valider la sélection. • Le transfert commencera. • Quand celui-ci est fini, entrer la commande AT+CFUN=1 pour reseter le modem, sinon celui-ci

continu d’envoyer des caractères de contrôle. • Le modem retourne “OK”. • Entrer la commande AT+WOPEN=1 pour activer la fonctionnalité MUSE et la nouvelle application

chargée. • La vérification se fait par la commande AT+WOPEN?. Le modem répond +WOPEN :1 si actif, sinon

+WOPEN :0. Pour désactiver la fonctionnalité MUSE et l’application chargée entrer la commande AT+WOPEN=0.

5.3 Transfert à 115200 b/s

• Exécuter la séquence de commandes d’initialisation comme décrit dans Préparation du téléchargement pour initialiser le modem.

• A 9600 b/s entrer la commande AT+IPR=115200. • Modifier la vitesse de l’Hyperterminal à 115200 b/s. • Réaliser les actions du chapitre AT+WDWL – Téléchargement de l’application jusqu’à la

commande AT+CFUN=1 qui fait revenir l’appareil à 9600 b/s • Modifier la vitesse de l’Hyperterminal à 9600 b/s. • Entrer la commande AT+WOPEN=1 pour activer la fonctionnalité MUSE et la nouvelle application

chargée. • La vérification se fait par la commande AT+WOPEN?. Le modem répond +WOPEN :1 si actif, sinon

+WOPEN :0.