2.1 General commands ................................................................................................................................ 6
2.1.1 ATI8 – Display application version and build information............................................................ 6
2.1.2 AT+HELP – Display list of available general commands............................................................. 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_GenLoc31e_988_CL_002_UK Page 4 / 22
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.
EG_GenLoc31e_988_CL_002_UK Page 5 / 22
1 INTRODUCTION
This document describes AT commands specific to the GenLoc31e. For a complete list of available
Wavecom commands and their descriptions, please refer to [R1].
For a complete technical description of the GenLoc31e, please refer to [R3].
1.1 References
[R1] – AT Command Interface Guide For X51 Software (ref: WM_ASW_OAT_UGD_00016 revision 6)
[R2] – Open AT ADL User Guide for Open AT 3.03 (ref: WM_ASW_OAT_UGD_00053 revision 1)
[R3] – GenLoc31e Technical Document (EG_GenLoc31e_988_UG_xxx_UK revision 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_GenLoc31e_988_CL_002_UK Page 6 / 22
2 COMMANDS
2.1 General commands
2.1.1 ATI8 – Display application version and build information
This command will display the version and build information of the application.
Syntax: ATI8
Example :
Command Possible Responses Notes
ATI8
2.1.2 AT+HELP – Display list of available general commands
This command will display a list of the available general commands. The list includes certain Wavecom
commands which have been recreated by the application in order to be compatible with the GenLoc31e
hardware and the original Wavecom commands (example: AT+WGPSPOS).
Syntax: AT+HELP
Example :
Command Possible Responses
AT+HELP
GenLoc31e V0.73 Jun 19 2006 14:32:38
Display application version
and build information
OK
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-collecter output. 0=low, 1=high
<NMEAx>: selected NMEA frame list chosen from the following list :
0 GGA GPS fix data (default)
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.
Note:
If the <NMEAx> parameters are omitted, the last configuration remains active. This configuration is
stored in EEPROM.
Examples :
Command Possible Responses Notes
AT+ WGPSNMEA
AT+WGPSNMEA=1,0,2,3
AT+ WGPSNMEA?
AT+ WGPSNMEA=0
AT+ WGPSNMEA=1
AT+WGPSNMEA=(0-1),(0-5),...
OK
OK
+WGPSNMEA: 1,0,2,3
OK
OK
OK
Display syntax
These three frames will be
provided as unsolicited
messages
Display current frame
selection (GGA, GSV, RMC)
Turn off the unsolicited
mode
Turn on the unsolicited
mode (previous selection is
used)
2.1.4 AT+WGPSRAW – Send raw data to the GPS module
This command will write a raw data stream to the GPS module. The data is not interpreted inside the GSM
module.
Syntax: AT+WGPSRAW=<pdu>
Examples :
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
Successful transmission of
data to the GPS controller (this
example enables VTG frames
to be output from the GPS
module)
<pdu> data is entered as a binary string (in hexadecimal format) enclosed by quotes. Only the
following hexadecimal characters are allowed: ‘0’ to ’9’, and ’A’ to ’F’. Each pair of characters is
converted to a byte. For example, 41 is converted to hexadecimal value.
Notes:
The contents of <pdu> is the responsibility of the host user.
The length of <pdu> is limited to 512 characters corresponding to a frame of 256 hexadecimal bytes.
2.1.5 AT+WGPSPOS – Get position information
This command will to get the last position information received.
ranges of values: hh (hour) 00 to 23
mm (minute) 00 to 59
ss (second) 00 to 59
Example: 130556 means 13:05:56 UTC
<date> : ddmmyy date of fix
ranges of values: dd (day) 01 to 31
mm (month) 01 to 12
yy (year) 2000 to 2099
Example: 191105 means 19
<latitude> : ddmm.mmmmm(N/S)
ranges of values: dd (degrees) 00 to 90
mm.mmmmm (minutes) 00,00000 to 59.99999
(N/S) North or South
Example: latitude of the fix 4716.80053N means 47° 16.80053’ North
<longitude> : dddmm.mmmm(E/W)
+WGPSPOS:2,100556.00,080606,4716.80053N,000
03.51560W,83.4,1.45,0.013,,07
OK
th
November 2005
See defined
values below
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
EG_GenLoc31e_988_CL_002_UK Page 9 / 22
ranges of values: dd (degrees) 00 to 180
mm.mmmm (minutes) 00,0000 to 59.9999
(E/W) East or West
Example: longitude of the fix 12303.51560W means 123° 3.51560’ West
<altitude> : mmmm.m altitude of fix in meters
<hdop> : mmm.mm horizontal dilution of position in meters
<speed> : ssss.s speed over ground, in kilometres per hour
<course> : dddmm.mmmm course in degrees, minutes
ranges of values: ddd (degrees) 000 to 360
mm.mmmm (minutes) 00.0000 to 59.9999
<nbsat> : nn number of satellites in view
Note:
Some fields may be empty depending on the availability of the information.
2.1.6 AT+WGPSM – GPS module management
This command will :
power-up or down the GPS module,
perform specific GPS module reset,
provide the current GPS module software and hardware version.
Syntax: AT+WGPSM=<type>[,<mo de>][,<reset>]
<type>
0 GPS module power management (see <mode> below)
1 GPS module reset (see <reset> below)
3 Get GPS module software and hardware version
<mode>
0 GPS module is powered down
1 GPS module is powered up (default)
If <mode> is omitted, the current status is returned
<reset>
0 GPS module is held in reset
1 GPS module is not held in reset (default)
If <reset> is omitted, the current status is returned
Examples :
Command Possible Responses Notes
AT+WGPSM
AT+WGPSM=(0-1)(3),(0-1)
OK
AT+WGPSM=0,1
OK
AT+WGPSM=0
+WGPSM: 0,1
OK
AT+WGPSM=1,0
OK
AT+WGPSM=1,1
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
Display syntax
Power up GPS module
GPS module is currently
powered up
GPS module is held in
reset
GPS module not reset
OK
AT+WGPSM=1
AT+WGPSM=3
+WGPSM: 1,1
OK
+WGPSM: SW VERSION 5.00 Jan 09
2006 12:00:00 - HW VERSION 00040001 +
Extension: M4H1.1 Jan 09 2006 15:3
9:54
OK
EG_GenLoc31e_988_CL_002_UK Page 10 / 22
GPS module is currently
not reset
Get GPS module
software and hardware
version
Note : The AT command AT+WGPSM will not provide a GPS reset with boot mode.
2.1.7 AT+WIOR – Read GPIO value
This command will read the requested SPI GPIO pin value.
0 Monitoring is deactivated (default)
1 Monitoring is activated
<status>
0 Antenna is not powered
1 Antenna is powered
Note : In the case of a short circuit, the hardware protection disconnects the antenna,
causing an open circuit. After a 10-second delay the antenna is re-powered.
<presence>
0 No antenna connected
1 Antenna connected
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
EG_GenLoc31e_988_CL_002_UK Page 12 / 22
2 Antenna loading detection not activated
<voltage>
The antenna voltage in mV.
Examples :
Command Possible Responses Notes
AT+WGPSANT
+WGPSANT=type(,[mode][mon])
Display syntax
OK
AT+WGPSANT=0
Antenna is currently
powered
OK
AT+WGPSANT=1,1
Activate antenna
monitoring
OK
Unsolicited message
+WGPSANT: 2,1,0,3282
An open circuit has been
detected. Antenna
deconnected
Unsolicited message
+WGPSANT: 2,1,1,3116
Antenna reconnected and
present
AT+WGPSANT=2
+WGPSANT: 2,1,1,3116
OK
No open circuit detected
and antenna is connected
with voltage 3.116V
Notes : It is not necessary to perform a reset for this command to be taken into account.
The AT command AT+WGPSANT will not manage the modes EXT or Single Coax Options for the
GPS antenna configuration.
2.1.10 AT+SHOWPOS – Automatic display of GPS coordinates
This command will automatically display the GPS coordinates. The output will be as if the command
AT+WGPSPOS had been entered every n seconds, i.e.:
Display status for NMEA
frames. In this case zero
errors for 17877 frames
received
Display status for UBX
frames. In this case zero
errors for 10 frames
received
2.1.12 AT+WGPSCONF – GPS configuration
The AT command AT+WGPSCONF cannot be used to modify GPS settings.
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
.
EG_GenLoc31e_988_CL_002_UK Page 14 / 22
2.2 UBX commands
2.2.1 AT+HELPUBX – Display list of UBX commands
This command will display a list of the available UBX commands that use the UBX protocol between the
Wismo and the GPS module.
Syntax: AT+HELPUBX
Example :
Command Possible Responses
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............
Model (=1-7)
OK
Note: Display UBX command list
.Display (?) or set Dynamic Platform
2.2.2 AT+UBXMONVER – Display HW / SW version of the GPS module
This command will display the current hardware and firmware version of the GPS module including any
extensions.
Note: Display current hardware and firmware version of the GPS module
2.2.3 AT+UBXMONHW – Display GPS module hardware status
This command will display the status of different aspects of the hardware the GPS module, such as Antenna,
Noise Level, Automatic Gain Control (AGC) and Real-Time-Clock.
Syntax: AT+UBXMONHW
Example :
Command Possible Responses Notes
AT+UBXMONHW
Noise Level measured by GPS Core : 159
AGC Monitor : 6123
Antenna Supervisor Status : OK
Antenna PowerStatus : ON
Real-Time Clock : Calibrated
OK
Noise level.
AGC monitor level.
Antenna supervisor
state machine status.
Antenna power status.
Internal RTC set to
received GPS time.
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
2.2.4 AT+UBXCFGDAT – Display / Set GPS DATUM
This command will display or set the GPS Datum.
Syntax: AT+UBXCFGDAT=<n>
EG_GenLoc31e_988_CL_002_UK Page 15 / 22
<n>
0 to 215 Datum identifier (Default value is 0, corresponding to WGS84)
Examples :
Command Possible Responses
AT+UBXCFGDAT
AT+UBXCFGDAT=0
AT+UBXCFGDAT?
AT+UBXCFGDAT=(0-215)
OK
OK
Current Datum: 0 - WGS84
OK
Display syntax
Set Datum to 0 (WGS84)
Display current Datum
setting. In this case 0
(WGS84)
2.2.5 AT+UBXCFGDPM – Display / Set GPS module Dynamic Platform Model
This command will display or set the Dynamic Platform Model used by the GPS module thus adjusting the
navigation engine to the expected environment. This can result in a better interpretation of the
measurements and hence more accurate position output.
Syntax: AT+UBXCFGPM=<n>
<n>
1 Stationary – Velocity is constrained to 0 m/s
2 Pedestrian – Assuming low accelerations, portable devices moved by manpower
3 Automotive – Assuming low vertical acceleration, passenger car dynamics
4 Sea – Zero vertical velocity, applications at sea
5 Airborne <1g – Dynamic range greater than car and greater vertical acceleration
6 Airborne <2g – Typical airplane environment
7 Airborne <4g – Extreme dynamic environment
Examples :
Command Possible Responses
AT+UBXCFGDPM
AT+UBXCFGDPM=3
AT+UBXCFGDPM?
AT+UBXCFGDPM=(1-7)
OK
OK
+UBXCFGDPM: 3
OK
Display syntax
Select Automotive Dynamic
Platform Model
Display current Dynamic
Platform Model setting. In
this case 3 (Automotive)
2.2.6 AT+UBXSHOW – Display UBX frames
This command will display the UBX frames exchanged between the UART2 and the GPS module.
Syntax: AT+UBXSHOW=<n>
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
EG_GenLoc31e_988_CL_002_UK Page 16 / 22
<n>
0 Turns off display of UBX frames
1 Display RX frames only
2 (Display TX frames only
3 Display RX and TX frames
n+80 Display with ascii interpretation
Examples :
Command Possible Responses
AT+UBXSHOW
AT+UBXSHOW=(0-3) + (80 for ASCII)
Display syntax
OK
AT+ UBXSHOW=1
Enable display of RX frames
only
OK
AT+ UBXSHOW=2
Enable display of TX frames
only
OK
AT+ UBXSHOW=3
Enable display of both RX
and TX frames
OK
AT+ UBXSHOW=83
AT+ UBXSHOW?
OK
+UBXSHOW=83
OK
Enable display of both RX
and TX frames and ascii
interpretation
Display current setting for
UBXSHOW. In this case RX,
TX frames and ascii
interpretation
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
EG_GenLoc31e_988_CL_002_UK Page 18 / 22
2.3 Serial Flash commands
These commands provide a means of accessing the optional serial flash memory. Refer to the data sheet
for the type of flash used for detailed information.
2.3.1 AT+SFHELP – Display serial flash commands
This command will display a list of the available commands to access and manage the serial flash.
Syntax: AT+SFHELP
Example :
Command Possible Responses
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:
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
2.3.3 AT+SFSR – Display status register contents
This command will display the contents of the status register in the serial flash. Displayed value is in
hexadecimal format.
Syntax: AT+SFSR
Example :
Command Possible Responses Notes
AT+SFSR
2.3.4 AT+SFWEL – Display / modify Write Enable Latch bit
This command will display or modify the Write Latch Enable (WEL) bit in the status register. Note that the
WEL bit must be set (enabled) and the appropriate BP bit(s) must be cleared (unprote cted) before attempting
to modify the memory.
The WEL bit will be cleared to 0 (disabled) after a write to the status register, the block protection bits or the
memory.
Syntax: AT+SFWEL=<n>
+SFSR: 0x1C
OK
EG_GenLoc31e_988_CL_002_UK Page 19 / 22
Status register contains
0x1C
<n>
0 Disabled
1 Enabled
Examples :
Command Possible Responses Notes
AT+SFWEL
AT+SFWEL=0
AT+SFWEL=1
AT+SFWEL?
AT+SFWEL=x (0=Disabled, 1=Enabled)
OK
OK
OK
+SFWEL: 1
OK
Display syntax
Set WEL bit to 0
Set WEL bit to 1
Display current value of
WEL bit. In this case 1
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
This command will display or modify the block protection bits in the status register. Note that the WEL bit
must be set (enabled) before attempting to modify the BP bit(s). Also, the WEL bit must be set (enabled) and
the appropriate BP bit(s) must be cleared (unprotected) before attempting to modify the memory.
Syntax: AT+SFBP=<n>
EG_GenLoc31e_988_CL_002_UK Page 20 / 22
<n>
0 Unprotected
1 Protected
Examples :
Command Possible Responses Notes
AT+ SFBP
AT+SFBP=1
AT+SFBP=0
AT+SFBP?
AT+SFBP=x (0=Unprotected, 1=Protected)
OK
OK
OK
+SFBP: 0
OK
Display syntax
Set all BP bits to 1
Set all BP bits to 0
Display current value of BP
bits. In this case 0
2.3.6 AT+SFWRTEXT – Write ascii text string to memory
This command will write an ascii text string to the serial flash memory. Note that the WEL bit must be set
(enabled) and the appropriate BP bit(s) must be cleared (unprotected) before attempting to modify the
memory.
Syntax: AT+SFWRTEXT=<n>,“ascii text”
<n> Start address (0 to maximum memory size (decimal value)
“ascii text” ascii text string
Example :
Command Possible Responses
AT+SFWRTEXT=50,”An ascii text string”
20 bytes written to address 0x00000032
OK
Note: The ascii text string is written to the flash starting
at address 50 (0x00000032)
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
EG_GenLoc31e_988_CL_002_UK Page 21 / 22
2.3.7 AT+SFRD – Display the contents of the memory
This command will read the contents of specified address range of the serial flash memory and dump it to
the terminal.
Syntax: AT+SFRD=<s>, <n>, <a>
<s> Start address (0 to maximum memory size, decimal value)
<n> length (1 to 512, decimal value)
<a> ascii dump (default 0: none, 1: ascii dump)
Note: Dump the contents of address range 8 (0x08) to 100 (0x64) with ascii
dump
AT+SFRD=10000000
,100
Flash - Address is out of Range
ERROR
Note: The specified start address is greater than that supported by the
flash
Descriptions and non-contractual illustrations in this document are given as an indication only.
ERCO&GENER reserves the right to make any modifications.
2.3.8 AT+SFEB – Erase block
This command will erase the specified block. Note that the WEL bit must be set (enabled) and the
appropriate BP bit(s) must be cleared (unprotected) before attempting to modify the memory.
Syntax: AT+SFEB=<n>,<s>
EG_GenLoc31e_988_CL_002_UK Page 22 / 22
<n> Block number (0 to maximum number of blocks - 1, decimal value)
<s> Block size (default 64K. Select either 1,2,4,8,16,32,64,128 kilobyte block size, decimal value)
Block 0 of size 64Kbytes has
been successfully erased
Block 0 of size 4Kbytes has
been successfully erased
The WEL bit has not been
set. Unable to erase block
The appropriate BP bit has
not been cleared. Unable to
erase block
The specified block size is
not supported by the flash
The specified block number
is greater than that
supported by the flash
2.3.9 AT+SFECHIP – Erase chip
This command will erase the entire contents of the serial flash memory. Note that the WEL bit must be set
(enabled) and all the BP bits must be cleared (unprotected) before attempting to modify the memory.