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.
