Erco&Gener Genloc 31e Manuel utilisateur

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

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 – infos@ercogener.com

SA CAPITAL 183244 € – R.C. SAUMUR B 332 174 820 – SIRET 332 174 820 00032 – NAF 322A – TVA Intra : FR 16 332 174 820

EG_WS0008_CL_020_FR Page 2 / 70

Historique du document

Révision Modifications Auteur Date

000 Création

001 Correction + Evolution

002 Correction + Evolution

003 Evolution

004 Correction + Evolution

005 Correction + Evolution

Cde LOCFRT=2, le paramètre Status passe avant le Fix

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

007 Correction + Evolution

Cde +LOCTRC, +LOCTRD

008 Correction + Evolution

Cde +LOCASV, +LOCTSV

010 Ajout exemples,

Commentaire commande A/, +LOCSND=4

011 Ajout commentaire sur commande LOCTSK

+LOCFRT

Ajout infos +LOCSTK

Ajout info transfert 115200 b/s

013 Correction commande demande position en SMS est bien

PBR 06/10/2004

PBR

PBR

24/11/2004

09/03/2005

PBR 01/09/2005

PBR 07/10/2005

PBR 25/10/2005

PBR 28/10/2005

PBR 28/11/2005

PBR 13/01/2006

PBR 25/01/2006

PBR 01/02/2006

PBR 10/02/2006

PBR 03/03/2006

SENDPOSI.

Ajout infos + Modification AT+LOCSTK

Modification AT+LOCFRT

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 « / ».

015 Ajout commande +LOCRDI.

Modification commande +LOCSPD.

Modification +LOCCNF display information.

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.

PBR 07/04/2006

PBR 05/07/06

PBR/MRE 21/09/06

Ajout InPuts states pour +LOCFRT=2.

Ajout commande +LOCNRP.

Ajoute GPI/O status dans +LOCCNF.

Ajoute commande +LOCTFD.

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)

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 3 / 70

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 4 / 70

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 5 / 70

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 6 / 70

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.

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

EG_WS0008_CL_020_FR Page 7 / 70

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 8 / 70

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 9 / 70

1.2.3 Méthodologie

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 10 / 70

• 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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

2 COMMANDES D’APPLICATION

Page 11 / 70

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

Syntaxe: 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).

AT+LOCPSW=<PaSsWord>[,<newPWD>]

Exemples:

Commande

AT+LOCPSW=?

Réponses Possibles

+LOCPSW: 8,8

OK

Notes

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”

AT+LOCPSW=”xxxx”,

”ERASE”

OK

OK

Changement de mot de passe.

Sauvegardé immédiatement en flash.

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

AT+LOCPSW?

OK

NON-AUTHORIZED ACCESS

OK

Arrêt accès

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 12 / 70

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

AT+LOCIDT=?

AT+ LOCIDT?

Réponses Possibles

+LOCIDT: (20)

OK

AT+LOCIDT="354475000000001"

OK

354475000000001

OK

Notes

Afficher la syntaxe.

Programmation de l’identifiant.

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”.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 13 / 70

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

AT+LOCPHN=?

Réponses Possibles

+LOCPHN: (1-255),20,(0-255)

Notes

OK

Afficher la syntaxe

AT+ LOCPH=x,,y

Modifier seulement les paramètres de

OK

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

Effacer le numéro de téléphone

OK

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)

• 2 (bit 1)

Numéro destinataire Envoi en mode SMS (trame NMEA RMC, GGA, PERSO).

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)

• 8 (bit 3)

• bits 6, 5 et 4

Demande ajout identifiant appareil à l’envoi.

Numéro destinataire Envoi en mode Data.

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).

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 14 / 70

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

AT+LOCGPS=?

Réponses Possibles

+LOCGPS: (0-1),(0-1)

OK

AT+LOCGPS?

+LOCGPS: 0,0

OK

Notes

Afficher la syntaxe

Afficher la configuration actuelle

AT+LOCGPS=1,1

Bascule les signaux DSR et DTR vers

OK

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 15 / 70

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

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 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.

EG_WS0008_CL_020_FR Page 17 / 70

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>

<a,b,...> format trame, 0, 1 or 2 (format défini par l’utilisateur). 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

054.7

Speed over ground, Knots

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

08

0.9

2 = DGPS fix

Number of satellites being tracked

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 18 / 70

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

FX

Valeur Fix indicateur -1 : Unable,

0 : Invalide,

1 : GPS Fix (2D/3D),

0

1

TM

Time UTC ( Universal Time )

2 : DGPS Fix

123456.00

3

LT

Latitude 4716.80415

LI

Latitude Indice

LG

N-S

0

5

LU

Longitude Indice

NS Nombre de satellite

HD HDOP Horizontal Dilution of Precision

(<2 valeur pouvant être prise en

E-W

1-12

1

0

0.01-99.99 2 compte)

AL Altitude

CS Course

0.1-9999.9

M

0.01-255.33

0.001-999.999

3

0

3

3

GS Geoid

DT Date

0.001-999.999

0.1-179.9

M

I

3

I

2

I

1 xxxxxxxxxx

JJMMAA

3

2

0

3

10

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 cidessus. 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

• (Vitesse)

• (Altitude)

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 19 / 70

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 20 / 70

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

AT+LOCINS=? +LOCINS: (0-2),(0-65535),("O","C"),

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

OK

AT+LOCINS?

+LOCINS: 0,00000,"O","S",000

+LOCINS: 1,00000,"O","S",000

Notes

Afficher la syntaxe

Afficher la configuration actuelle

+LOCINS: 2,00000,"O","S",000

OK

Valeurs définies:

<n>

<t>

Numéro de l’entrée, 0 à 2.

Temps de présence de l’entrée active avant action de 0 (inactive) à 65535 (base de temps 100 ms).

<x>

<y>

Etat de l’entrée au repos. "O" pour Open et "C" pour Closed.

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

2.5.2 AT+LOCINP – Activation des entrées

Description:

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

Page 21 / 70

Syntaxe:

AT+LOCINP=<n>,<mode>[,<n>,<mode>][,<n>,<mode>]

Exemples :

Commande

AT+LOCINP=?

Réponses Possibles

+LOCINP: (0-2),(0-1)

OK

AT+LOCINP?

+LOCINP: 0,1,1,0,2,1

OK

Notes

( INPut )

Afficher la syntaxe

Afficher la configuration actuelle.

Entrée 1 désactivée. Inputs 0 et 2 activées.

Arrêt acquisition GPS sur entrée 1

AT+LOCINP=1,0

Valeurs définies:

<n>

<mode>

OK

Numéro de l’entrée, 0 à 2.

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

AT+LOCOUT=?

Réponses Possibles

+LOCOUT: (0),(0-1),(0-255)

Notes

OK

Afficher la syntaxe

AT+LOCOUT=0,1,10 OK

AT+LOCOUT?

+LOCOUT: 0

OK

AT+LOCOUT=0,1

AT+LOCOUT?

OK

+LOCOUT: 1

OK

Sortie 0 fermée pour 1000ms

Afficher la configuration actuelle

Sortie 0 fermée

Afficher la configuration actuelle

Valeurs définies:

<n>

<x>

Numéro de sortie (0 est la sortie par défaut).

0 : ouverte.

1 : fermée.

<y>

Remarques: différent de 0 donne la durée de l’impulsion (base de temps 100 ms).

Il est possible de la piloter:

• sur réception d’un SMS

• durant une connexion en mode DATA

(développement ultérieur) .

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 22 / 70

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

AT+LOCSTK=?

Réponses Possibles

+LOCSTK: (0-1),"HHMMSS",(0-1),(0-99),(0-

Notes

Afficher la syntaxe

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

OK

AT+LOCSTK?

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

Afficher la configuration

OK

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 23 / 70

Remarques: commande 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

AT+LOCSPD=?

+LOCSPD: (0-255) km/h

OK

AT+LOCSPD=10

OK

Notes

Afficher la syntaxe

Vitesse min = 10 KMH

AT+LOCSPD?

+LOCSPD: 10 km/h (0.000000 knots)

Afficher la configuration

OK

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 24 / 70

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

Exemples :

(HisToriC)

Commande Réponses Possibles

AT+LOCHTC

6

Notes

Afficher les

$GPRMC,144516.00,A,4716.81455,N,00003.50568,W,0.130,349.30,210606,,,A*77

positions stockés

$GPRMC,144555.00,V,4716.81188,N,00003.49605,W,1.154,8.41,210606,,,A*61

du premier secteur

$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

de stockage (6) de

$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

la flash

$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

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

Syntaxe:

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.

AT+LOCRDI?

Syntaxe réponse:

(ReaD Index)

+LOCRDI: <read index>,<block number>,<write index>,<block number>

Exemples :

Commande

AT+LOCRDI?

Réponses Possibles

+LOCRDI: 264, 27, 220, 27

Notes

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 25 / 70

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

AT+LOCSND=?

Réponses Possibles

+LOCSND: (0-

Notes

Afficher la syntaxe

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

OK

AT+LOCSND=0,"I","

00:10"

OK

Programmer les paramètres

AT+LOCSND?

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

Afficher la configuration

OK

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) . 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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 26 / 70

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

AT+LOCUTC=?

+LOCUTC: "-11"/"+12"

OK

Notes

Afficher la syntaxe

AT+LOCUTC=0

OK

AT+LOCUTC?

+LOCUTC: +00

OK

Ajuster par 0 heures

Afficher la configuration actuelle

AT+LOCUTC

Voir les remarques en

OK

dessous

Valeurs définies:

<n>

Remarques:

Nombre d’heures d’ajustage (-11 à +12 heures).

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é.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 27 / 70

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. message 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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 28 / 70

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 29 / 70

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 30 / 70

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","."

Par TCP (fichier non compressé)

+LOCDWL="arm_genlocxxD_B_V200.dwl","."

(fichier à la racine du disque: ".")

(fichier à la racine du disque: ".")

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 31 / 70

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>]

Exemples :

Commande

AT+LOCRST=?

Réponses Possibles

(ReSeT)

+LOCRST: (0-3),"HH:MM"

Notes

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

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

Page 32 / 70

SIM Card presence ..................... Removed

SIM Code Status ....................... Unknown

GPS position capture .................. STOPPED

GPS power supply management ........... Always powered

GPS antenna parameters ................ Powered, Connected, 3217 mV

Interval 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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

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 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.

EG_WS0008_CL_020_FR Page 34 / 70

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 35 / 70

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”,

Syntaxe: o

“l’Access point UserName”, o

“l’Access point PassWord”.

(Access point SerVer name)

AT+LOCASV=<"ServerString">,<"UserName">,<"PassWord">

Exemples :

Commande

AT+LOCASV=?

Réponses Possibles

+LOCASV:

"ServerString","UserName","Password"

Notes

Afficher la syntaxe

OK

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

AT+LOCASV?

OK

+LOCASV: "internet","user","pass"

Programmer les paramètres

Afficher la configuration

OK

actuelle

AT+LOCASV=,0

AT+LOCASV?

OK

+LOCASV: "","",""

Effacer les paramètres

Afficher la configuration

OK

Valeurs définies:

<ServerString> Access point server name. Maximum 100 caractères.

<UserName> Access point user name. Maximum 50 caractères.

actuelle

<PassWord>

Remarques:

Access point password (case sensitive). Maximum 50 caractères.

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:

(Access point UserName)

AT+LOCAUN=<"UserName">

Exemples :

Commande

AT+LOCAUN=?

Réponses Possibles

+LOCAUN: "UserName"

OK

AT+LOCAUN="user"

OK

AT+LOCAUN?

+LOCAUN: "user"

OK

Notes

Afficher la syntaxe

Programmer le paramètre

Afficher la configuration actuelle

AT+LOCAUN=,0

Effacer le paramètre

OK

Valeurs définies:

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 36 / 70

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:

(Access point PassWord)

AT+LOCAPW=<"PassWord">

Exemples :

Commande

AT+LOCAPW=?

Réponses Possibles

+LOCAPW: "Password"

OK

Notes

Afficher la syntaxe

AT+LOCAPW="pass"

OK

AT+LOCAPW?

+LOCAPW: "pass"

OK

Programmer le paramètre

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

AT+LOCTSV=?

Réponses Possibles

+LOCTSV: "xxx.xxx.xxx.xxx",(0-(1-

65535))

OK

Notes

Afficher la syntaxe

AT+LOCTSV=

"123.98.76.54",1234

AT+LOCTSV?

OK

+LOCTSV: "123.98.76.54", 1234

Programmer le paramètre

Afficher la configuration

OK

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>

Remarques:

Numéro port (1 è 65535).

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 37 / 70

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

AT+LOCTPT=?

Réponses Possibles

+LOCTPT: (1-65535)

OK

AT+LOCTPT=1234

OK

Notes

Afficher la syntaxe

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>

Exemples :

Commande

AT+LOCTTD=?

(TCP Transmit Delay)

Réponses Possibles

+LOCTTD: (0-65535)

OK

AT+LOCTTD=100

OK

AT+LOCTTD?

+LOCTTD: 100

OK

Valeurs définies:

<delay>

Notes

Afficher la syntaxe

Programmer le paramètre

Afficher la configuration actuelle

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 38 / 70

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>

Exemples :

Commande

AT+LOCTTD=?

(TCP transmit inter Frame Delay)

Réponses Possibles

+LOCTTD: (0-65535)

Notes

OK

Afficher la syntaxe

AT+LOCTTD=100

Programmer le paramètre

OK

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">

Exemples :

Commande

AT+LOCTPH=?

(TcpPatH)

Réponses Possibles

+LOCTPH: "\PATH="

OK

AT+LOCTPH=”GET

/GPS=”

AT+LOCTPH?

OK

+LOCTPH: "GET /GPS"

OK

AT+LOCTPH=,0

OK

Notes

Afficher la syntaxe

Programmer le paramètre

Afficher la configuration actuelle

Effacer le paramètre

Valeurs définies:

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 39 / 70

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

AT+LOCTAK=?

Réponses Possibles

+LOCTAK: "Value for Ack",0-

1,(Delay:0-65535)

OK

Notes

Afficher la syntaxe

AT+LOCTAK=”OK”

la chaîne OK valide la trame reçue avec

OK

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

AT+LOCTAK=”OK”,,100

OK

Afficher la configuration actuelle 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

Valeurs définies:

<string>

<param>

<time>

OK

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

Effacer les paramètres

Chaîne d’acquit (“string”). Maximum 50 caractères.

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 40 / 70

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

AT+LOCTRD=?

Réponses Possibles

+LOCTRD: "Value for Server Read

Pos",0-1

Notes

Afficher la syntaxe

OK

AT+LOCTRD=”POS”

AT+LOCTRD?

OK

+LOCTRD: "POS",1

OK

Programmer le paramètre

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

AT+LOCTCP=?

Réponses Possibles

+LOCTCP: (0-1)

OK

Notes

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

AT+LOCTCP=0

No TCP connexion

OK

OK

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

Termine une session TCP

Valeurs définies:

<mode>

Remarques:

0 : Termine une session TCP.

1 : Initialise une session TCP.

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

2.13.12 AT+LOCFSV – FTP Server name

Description:

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

Syntaxe:

Page 41 / 70

AT+LOCFSV=<"addr">

Exemples :

Commande

AT+LOCFSV=?

Réponses Possibles

+LOCFSV: "xxx.xxx.xxx.xxx"

OK

AT+LOCFSV="123.98.76.54”

OK

AT+LOCFSV?

+LOCFSV: "123,98,76,54"

OK

Notes

Afficher la syntaxe

Programmer le paramètre

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

AT+LOCFUN=?

Réponses Possibles

+LOCFUN: "UserName"

OK

AT+LOCFUN="user"

OK

AT+LOCFUN?

+LOCFUN: "user"

OK

AT+LOCFUN=,0

Notes

Afficher la syntaxe

Programmer le paramètre

Afficher la configuration actuelle

Effacer le paramètre

OK

Valeurs définies:

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

2.13.14 AT+LOCFPW – FTP password

Description:

Cette commande permet de saisir le “FTP PassWord”.

Syntaxe:

Page 42 / 70

AT+LOCFPW=<"PassWord">

Exemples :

Commande

AT+LOCFPW=?

Réponses Possibles

+LOCFPW: "Password"

OK

AT+LOCFPW="pass"

OK

AT+LOCFPW?

+LOCFPW: "pass"

OK

Notes

Afficher la syntaxe

Programmer le paramètre

AT+LOCFPW=,0

OK

Afficher la configuration actuelle

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

AT+LOCFPT=?

Réponses Possibles

+LOCFPT: (1-65535)

OK

AT+LOCFPT=1234

OK

AT+LOCFPT?

+LOCFPT: 1234

OK

Notes

Afficher la syntaxe

Programmer le paramètre

Afficher la configuration actuelle

Valeurs définies:

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 43 / 70

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

AT+LOCFGP=?

Réponses Possibles

+LOCFGP: "./PATH"

OK

AT+LOCFGP=”./mypath”

OK

Notes

Afficher la syntaxe

Programmer le paramètre

AT+LOCFGP?

+LOCFGP: "./mypath"

Afficher la configuration

OK

actuelle

AT+LOCFGP=,0

Programmer le chemin par

OK

défaut (“.”)

Valeurs définies:

<path>

Remarques:

Chemin FTP (“path”). Maximum 100 caractères.

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

AT+LOCFGF=?

Réponses Possibles

+LOCFGF: "Get_Filename"

OK

AT+LOCFGF=”myfile.txt”

OK

Notes

Afficher la syntaxe

Programmer le paramètre

AT+LOCFGF?

+LOCFGF: "myfile.txt"

Afficher la configuration

OK

actuelle

AT+LOCFGF=,0

Effacer le paramètre

OK

Valeurs définies:

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 44 / 70

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

AT+LOCFPP=?

Réponses Possibles

+LOCFPP: "./PATH"

OK

AT+LOCFPP=”./mypath”

OK

Notes

Afficher la syntaxe

Programmer le paramètre

AT+LOCFPP?

+LOCFPP: "./mypath"

Afficher la configuration

OK

actuelle

AT+LOCFPP=,0

Programmer le chemin par

OK

défaut (“.”)

Valeurs définies:

<path>

Remarques:

Chemin FTP (“path”). Maximum 100 charactères.

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

AT+LOCFPF=?

Réponses Possibles

+LOCFPF: "Put_Filename"

OK

AT+LOCFPF=”myfile.txt”

OK

Notes

Afficher la syntaxe

Programmer le paramètre

AT+LOCFPF?

+LOCFPF: "myfile.txt"

Afficher la configuration

OK

actuelle

AT+LOCFPF=,0

Effacer le paramètre

OK

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

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

EG_WS0008_CL_020_FR Page 45 / 70

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

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 46 / 70

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

+CPIN: SIM PIN

+CPIN: SIM PUK

(le code PIN est bon)

(le code PIN est mauvais ou pas encore saisie)

(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):

(le chiffre 0 indique verrouillé)

AT+CLCK="SC",0,1234

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 47 / 70

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

Syntaxe: 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.

AT+LOCPIN=<"OLD">,<"NEW">

Valeurs définies:

<OLD>

<NEW> old ancien code PIN 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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 48 / 70

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

AT+LOCTRC=?

+LOCTRC: (0-255)

OK

AT+LOCTRC=17

Notes

Afficher la syntaxe

Valider les traces

OK

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 OFF

OK

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>

Remarques:

Niveau de trace (voir les remarques).

Les niveaux de trace suivants sont disponibles :

1

: , envoi du message “READY” lors du lancement.

2

: , envoi des informations concernant la carte SIM et l’attachement au réseau.

4

: , envoi des trames GPS en mode stockage actif.

8

: , envoi du suivi de l’attachement au réseau.

16

: , envoi du suivi de l’attachement au réseau et du transfert en TCP et FTP.

32

: , envoi du suivi de l’attachement au réseau et du transfert en connexion DATA

GSM.

64

: , 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 cidessous. 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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 49 / 70

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 50 / 70

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.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

ATI8

OAT V3.04.Q2406B-GENLOC31e version ARM-2.00 - Sep 18 2006 12:40:47

OK

Notes

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 51 / 70

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

AT+ WGPSNMEA

Réponses Possibles

AT+WGPSNMEA=(0-1),(0-5),...

OK

AT+WGPSNMEA=1,0,2,3

OK

Notes

Afficher la syntaxe

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

AT+ WGPSNMEA?

AT+ WGPSNMEA=0

+WGPSNMEA: 1,0,2,3

OK

OK

Afficher la configuration actuelle

(GGA, GSV, RMC)

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

Retourne en affichage non

AT+ WGPSNMEA=1

OK

sollicités (le choix précédent est utilisé)

Valeurs définies:

<mode>

<NMEAx>

0 : désactiver l’affichage non sollicités des trames NMEA (défaut).

1 : activer l’affichage non sollicités des trames NMEA. 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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 52 / 70

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

AT+WGPSRAW

Réponses Possibles

AT+WGPSRAW="raw UBX data string"

OK

Notes

Afficher la syntaxe

AT+WGPSRAW=”B5

6206010600F005000

10001043200010000

0331”

Valeurs définies:

<pdu>

OK

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

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 53 / 70

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

AT+WGPSPOS

Réponses Possibles

+WGPSPOS:2,100556.00,080606,4716.80053N,00

003.51560W,83.4,1.45,0.013,,07

Notes

Voir les valeurs définies

OK

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 = 19 th

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>

<hdop>

<speed>

<course> mmmm.m altitude en mètres mmm.mm horizontal dilution of position en mètres ssss.s vitesse en KPH

<nbsat> dddmm.mmmm cap en degrés, minutes limites des valeurs: ddd (degrés) 000 à 360 mm.mmmm (minutes) 00.0000 à 59.9999 nn nombre de satellites en vue

Remarques:

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 54 / 70

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

AT+WGPSM AT+WGPSM=(0-1)(3),(0-1)

OK

AT+WGPSM=0,1

OK

AT+WGPSM=0

+WGPSM: 0,1

OK

Notes

Afficher la syntaxe

Mise sous tension du module GPS

Le module GPS est actuellement sous tension

Reset du module GPS

AT+WGPSM=1,0

OK

AT+WGPSM=1,1

OK

AT+WGPSM=1

+WGPSM: 1,1

OK

Arrêt du reset du module GPS

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 +

Version logicielle et matérielle du module GPS

Extension: M4H1.1 Jan 09 2006 15:3

9:54

OK

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é.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

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

Afficher la syntaxe

OK

AT+WIOR=0

+WIOR: 0

OK

Page 55 / 70

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

AT+WIOR=3

+WIOR: 0

OK

+WIOR: 0

OK

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

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).

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

3.1.8 AT+WIOW – Write GPIO value

Description:

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

Syntaxe:

Page 56 / 70

AT+WIOW=<index>,<value>

Exemples :

Commande Réponses Possibles

AT+WIOW AT+WIOW=(0,1,7,8),(0-1)

OK

AT+WIOW=0,1

OK

AT+WIOW=1,0

OK

AT+WIOW=7,1

OK

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)

Notes

Afficher la syntaxe

Sortie collecteur ouvert est haute

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

UART1 RS232 interface est validé

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)

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

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

AT+WGPSANT

Réponses Possibles

+WGPSANT=type(,[mode][mon])

OK

AT+WGPSANT=0

OK

AT+WGPSANT=1,1

OK

Notes

Afficher la syntaxe

Page 57 / 70

L’antenne est actuellement alimentée

Activer le monitoring de l’antenne

Unsolicited message

+WGPSANT: 2,1,0,3282

Unsolicited message

+WGPSANT: 2,1,1,3116

AT+WGPSANT=2

+WGPSANT: 2,1,1,3116

OK

Circuit ouvert détecté. Antenne déconnectée.

Antenne reconnectée et présente

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>

<mon>

<status>

0 : 0v (antenne pas alimentée).

1 : 3v interne (défaut) (antenne alimentée).

0 : monitoring est désactivé (défaut).

1 : monitoring est activé.

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 58 / 70

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

Afficher la syntaxe

OK

AT+SHOWPOS=10

AT+SHOWPOS?

OK

+SHOWPOS: 10

Afficher les coordonnées toutes les 10 secondes

Afficher la configuration actuelle

OK

AT+SHOWPOS=0

Arrêter l’affichage automatique

OK

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

AT+ERRORSTAT

AT+ERRORSTAT=(0-1) (0=NMEA, 1=UBX)

OK

AT+ERRORSTAT=0 NMEA error status: checksum errors

= 0 / 17877 (frames received)

OK

Notes

Afficher la syntaxe

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 59 / 70

3.2 UBX

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

AT+UBXMONVER

Réponses Possibles

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

AT+UBXMONHW Noise Level measured by GPS Core : 159

AGC Monitor : 6123

Notes

Niveau de bruit.

Niveau AGC.

Antenna Supervisor Status : OK

Antenne supervision machine d’état statut.

Antenna PowerStatus : ON

Antenne power statut.

Real-Time Clock : Calibrated

OK

HTR Interne ajustée à l’heure

GPS reçu.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

3.2.4 AT+UBXCFGDAT – Datum GPS

Description:

Cette commande permet de programmer le Datum GPS.

Syntaxe:

Page 60 / 70

AT+UBXCFGDAT=<n>

Exemples :

Commande

AT+UBXCFGDAT

Réponses Possibles

AT+UBXCFGDAT=(0-215)

OK

AT+UBXCFGDAT=0

OK

AT+UBXCFGDAT?

Current Datum: 0 - WGS84

OK

Afficher la syntaxe

Programmer Datum à 0 (WGS84)

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

Syntaxe: conséquence une meilleure interprétation des mesures et par conséquent du rendement plus précis de position.

AT+UBXCFGPM=<n>

Exemples :

Commande

AT+UBXCFGDPM

Réponses Possibles

AT+UBXCFGDPM=(1-7)

OK

AT+UBXCFGDPM=3

OK

Afficher la syntaxe

Sélection l’Automotive Dynamic Platform

Model

AT+UBXCFGDPM?

+UBXCFGDPM: 3

OK

Valeurs définies:

<n>

Afficher la configuration actuelle. Dans ce cas,

3 (Automotive)

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 61 / 70

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

AT+UBXSHOW

Réponses Possibles

AT+UBXSHOW=(0-3) + (80 for ASCII)

OK

AT+ UBXSHOW=1

OK

AT+ UBXSHOW=2

OK

AT+ UBXSHOW=3

OK

AT+ UBXSHOW=83

OK

AT+ UBXSHOW?

+UBXSHOW=83

OK

AT+ UBXSHOW=0

OK

Afficher la syntaxe

Afficher les trames RX seulement

Afficher les trames TX seulement

Afficher les trames RX et TX

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

Afficher la configuration actuelle.

Dans ce cas trames RX, TX avec interprétation ascii

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

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 62 / 70

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.......=

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 63 / 70

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)

Afficher des informations sur la mémoire flash série

Size: 2097152 Bytes

Erase Blocks: 64KB 32KB 4KB

OK

détectée

AT+SFTYPE

No Serial Flash detected

OK

Pas de flash série présente

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 64 / 70

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

AT+SFSR +SFSR: 0x1C

OK

Notes

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

AT+SFWEL

Réponses Possibles

AT+SFWEL=x (0=Disabled, 1=Enabled)

OK

AT+SFWEL=0

AT+SFWEL=1

OK

OK

AT+SFWEL?

+SFWEL: 1

OK

Valeurs définies:

<n> 0 : Dé-validé.

1 : validé.

Notes

Afficher la syntaxe

Set WEL bit à 0

Set WEL bit à 1

Afficher la configuration actuelle, dans ce cas 1

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 65 / 70

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

AT+ SFBP

Réponses Possibles

AT+SFBP=x (0=Unprotected, 1=Protected)

OK

AT+SFBP=1

OK

AT+SFBP=0

OK

AT+SFBP? +SFBP: 0

OK

Notes

Afficher la syntaxe

Set all BP bits to 1

Set all BP bits to 0

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

Syntaxe: 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.

AT+SFWRTEXT=<n>,“ascii text”

Exemple:

Commande

AT+SFWRTEXT=50,”An ascii text string”

Réponses Possibles

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>

“ascii text”

Adresse de début, 0 à la taille maximum de la mémoire (valeur décimale).

Chaîne en ascii.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

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:

Page 66 / 70

AT+SFRD=<s>, <n>,<a>

Exemples :

Commande

AT+SFRD=8,100

Réponses Possibles

AT+SFRD=start,length(,a) (a=1: ascii dump)

OK

AT+SFRD=8,100

Note: Afficher la syntaxe

100 bytes read starting at address 0x00000008...

AT+SFRD=8,100,1

-- 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

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>

<n>

<a>

Adresse de début, 0 à la taille maximum de la mémoire (valeur décimale).

Longueur, 1 à 512 (valeur décimale).

Ascii dump, 0: non (défaut), 1: oui.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 67 / 70

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

AT+SFEB

Réponses Possibles

AT+SFEB=x(,s) (s default = 64 (KBytes))

OK

AT+SFEB=0

Erasing block 0 (0x10000 bytes). Please wait...

Block 0 erased

OK

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

Block 0 erased

OK

AT+SFEB=0

Flash - Write Latch Disabled

ERROR

Notes

Afficher la syntaxe

Bloc 0 de 64Koctets a

été effacé

été effacé

Bloc 0 de 4Koctets a

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>

<s>

Numéro bloc, 0 jusqu’au nombre maximum de bloc - 1, valeur décimale).

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

AT+SFECHIP

Erasing device memory. Please wait...

Memory erased

OK

AT+SFECHIP

Flash - Write Latch Disabled

ERROR

AT+SFECHIP

Flash - Blocks protected

ERROR

Notes

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

Le WEL bit n’est validé.

Impossible d’effacer la mémoire

Les bits BP ne sont pas reseté.

Impossible d’effacer la mémoire

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

EG_WS0008_CL_020_FR Page 68 / 70

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

AT+LOCFRT=2

format

Visualisation de la configuration GPRS:

AT+LOCCNG

Visualisation de la configuration générale:

AT+LOCCNF

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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR Page 69 / 70

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

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

Programmer l’intervalle de capture des positions GPS :

AT+LOCSTK=1,"000500",0,4,1,000,03

adresse IP et numéro port 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.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.

EG_WS0008_CL_020_FR

5 TELECHARGEMENT DE L’APPLICATION

Page 70 / 70

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

AT+WOPEN=3

(arrêt l’application courante)

(efface les paramètres en mémoire flash)

AT+WOPEN=4

AT+WGPSANT=1,0

AT&F

AT&W

AT+CFUN=1

(efface le programme)

(désactive la gestion de l’antenne)

(recharge les paramètres usine)

(sauvegarde la configuration courante)

(reset de l’appareil)

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

• Lancer le logiciel HyperTerminal sous Windows.

• Activer

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

.

Descriptions and non-contractual illustrations in this document are given as an indication only.

ERCO&GENER reserves the right to make any modifications.