Professional Documents
Culture Documents
Option nv, Gaston Geenslaan 14, 3001 Leuven - Belgium - Tel +32 16 317 411 - Fax +32 16 207 164
Version History
Date
Version
Author
8 July 2010
27 July 2010
20 Sept 2010
5 Oct 2010
8 Nov 2010
14 Dec 2010
15 March 2011
29 April 2011
26 July 2011
27 Oct 2011
02 Nov 2011
14 Dec 2011
30 Jan 2012
2 Oct 2012
30 Apr 2013
V001ext
V002ext
V003ext
V004ext
V005ext
V006ext
V007ext
V008
v014ext
V010draft
V011draft
V012ext
V013ext
V014ext
V015ext
D. Callaert
D. Callaert
D. Callaert
F. Bilsen
P. Vandeneede
P. Vandeneede
P. Vandeneede
P. Vandeneede
F. Bilsen
F. Bilsen
M. Rogmans
D. Hermans
P. Vandeneede
B.Goossens
D.Hermans
v015ext
Revision
S. Han
P. Vandeneede
Remarks
Initial Version
Revision
Revision
Revision
Revision
Revision
Revision
Revision
Revision
Revision
Revision
Revision
Cosmetic changes
Revision
Revision
Page 2 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Table of contents
1
INTRODUCTION ................................................................................................... 4
v015ext
Page 3 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
1 INTRODUCTION
All the GTM6xx modules do support GPS functionality. Next are the supported modes:
Standalone GPS
Assisted GPS
On the GTM66x and GTM67x the GPS antenna is shared with the diversity antenna,
on the GTM60x a separated GPS antenna input is available.
In order to configure the GPS functionality, Option proprietary AT commands have
been developed. This document describes the commands that can be used to set
various modes of GPS behaviour.
The table below shows all possible variants of these devices which are covered in this
document.
Commercial
Name
Product
Number
GTM661W1
GTM661E
GTM669W2
GTM669U
GTM671W3
GTM671E
GTM679W4
GTM679U
MO6612
MO6611
MO6692
MO6693
MO6712
MO6711
MO6792
MO6793
GTM601W
MO6012
GTM601E
MO6011
GTM609W
MO6092
I,II,V,VI,VIII
BC0,1
GTM609U
MO6093
II,V,VI
BC0,1
Wi-Fi
GSM,GPRS and
EDGE Bands
WCDMA
Bands
I,II,V,VI,VIII
I,VIII
I,II,V,VI,VIII
II,V,VI
I,II,V,VI,VIII
I,VIII
I,II,V,VI,VIII
II,V,VI
850Mhz
900Mhz
1800Mhz
1900Mhz
CDMA
Bands
BC0,1
BC0,1
BC0,1
BC0,1
I,II,V,VI,VIII
I,VIII
GTM661WF and GTM661WFS are part of the GTM661W family and can be treated identical in this document.
GTM669WF and GTM669WFS are part of the GTM669W family and can be treated identical in this document.
GTM671WF and GTM671WFS are part of the GTM671W family and can be treated identical in this document.
GTM679WF and GTM679WFS are part of the GTM679W family and can be treated identical in this document.
v015ext
Page 4 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
+CME ERROR: <cme_error>
_OGPS: <mode>
_OGPS: (0-3),(2-3600)
Description
This command starts or stops a GPS position determination.
Interrogation of this AT command will return the current state of the GPS engine.
Defined values
<Mode>
Value Description
0
GPS Off
Single Position Determination.
1
The GPS engine will switch off upon error or Position fix.
Can only be used when GPS is off.
Continuous Position Determination.
This setting will automatically restart a position determination when it ends.
2
Once the first fix has been made this will usually generate a fix once every
second.
Can only be used when GPS is off.
Continuous Position Determination with timing interval (seconds).
NMEA data will only be generated with <interval> seconds between fixes.
3
When the GPS cant make fixes, NMEA data will be generated every
second.
Can only be used when GPS is off.
<Interval>
Value
2-3600
Description
Target number of seconds between fixes, subject to environment.
Remarks
CME_ERROR : CME errors are listed in section 3 of this document.
Example
AT_OGPS=1
AT_OGPS=2
AT_OGPS=3,5
v015ext
Page 5 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
ERROR
_OGPSMODE: <Operating Mode>, <AGPS
Roaming>
_OGPSMODE: (1-3),(0-1)
Description
Set the GPS Mode to be used.
Defined values
<Operating Mode >
Value
1
2
3
Description
PDSM_SESSION_OPERATION_STANDALONE_ONLY
PDSM_SESSION_OPERATION_MSBASED
PDSM_SESSION_OPERATION_MSASSISTED
<AGPS Roaming>
Value Description
Disable AGPS data download when roaming
0
v015ext
Page 6 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
+CME ERROR: <cme_error>
_OGPSFIX: <enable>
_OGPSFIX: (0-1)
Description
This command will enable/disable unsolicited response in case a GPS fix is received or
lost.
Defined values
<enable>:
Value Description
0
Disable unsolicited response
1
Enable unsolicited response
*Default is 0. This will enable _OGPSUNSOLFIX unsolicited response.
Unsolicited Values
4 possible values:
Value Description
GPS engine started
0
v015ext
Page 7 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
_OGPSCLEAR?
_OGPSCLEAR=?
Possible Response(s)
OK
ERROR
CME ERROR
ERROR
_OGPSCLEAR
Description
This AT command allows you to clear all or part of the GPS assistance data stored on
the device. This command can only be used to clear data.
Interrogation of the AT commands (AT_OGPSCLEAR?) will return an error.
You can only clear assistance data while the GPS engine is switched off. Please keep
in mind GPS will stay on for a while after the last fix. OGPSEVT can be used to see
when issuing this command will be possible.
Defined values
<data>
Value
ALL
COLD
WARM
TIME
REFLC
SVDIR
SVSTR
SADAT
EPH
IONO
UTC
ALM
RTI
CELDB
Description
Clears all assistance data.
Clears all assistance data except Almanac.
Clears ephemeris data.
Clears time.
Clears Reference Location
Clears SV dir
Clears SV Steer
Clears SV Data
Clears ephemeris data.
Clears ionosphere corrections.
Clears time.
Clears almanac data.
Clears real time info.
Clears Cell Database.
Example
Clear all stored assistance data: AT_OGPSCLEAR="ALL",1
v015ext
Page 8 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
ERROR
_OGPSALLOW: <value>
ERROR
_OGPSALLOW: (0-3)
Description
This AT command allows you to specify if GPS should be permitted for Mobileoriginated (MO) or Mobile-terminated (MT). During an emergency call, a MT session
will always be permitted irrespective of the setting.
If the item has never been written, then reading will give an error.
This command is also used for gps privacy.
The command is persistent; it will read/write a specific NV item.
It only has effect in CDMA mode.
Defined values
<value>
Value
0
1
2
3
v015ext
Description
Allow all GPS sessions (default)
Allow MT GPS sessions only
Allow MO GPS sessions only (except for E91)
Disallow all GPS sessions (except for E911)
Page 9 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
ERROR
_OGPSLNA: <Enabled>, <GPS RF
Loss>
_OGPSLNA: (0-1),(0-254)
Description
Enable or Disable the external LNA for GPS. Optionally also setting the RF loss of the
currently chosen RF path (with or without external LNA). The LNA/no LNA RF loss
values are written to NV items, and are restored from the right NV item (depending on
LNA enabled or disabled) at boot time.
The changes are only effective after a reboot of the device.
Defined values
<Enable >
Value Description
0
Disable the external LNA
1
Enable the external LNA
< GPS RF Loss >
Value Description
RF loss of the GPS path in 0.1 dB. So a value of 56 means the RF loss is
0-254 5.6dB. A value for both with and without external LNA are kept into NV
memory.
Examples
Enable external LNA, set RF loss to 3.1dB: AT_OGPSLNA=1,31
Disable external LNA, set RF loss to a previously set value: AT_OGPSLNA=0
v015ext
Page 10 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
ERROR
_OGPSLS: <URL:Port ID>, <Security>
_OGPSLS: <URL:Port ID>,(0-1)
Description
This AT Command is used to set server connection parameters for use with
SUPL A-GPS.
Defined values
<URL>
URL (Uniform Resource Locator) format: String, max 128 bytes in length.
<Port ID>
Port Number
<Security>
Value Description
non-secure SUPL server
(no certificates needed)
0
Default value
secure SUPL server
1
(SUPL certificates needed)
Examples
AT_OGPSLS=http://www.yourSUPLsite.com:7275, 0
v015ext
Page 11 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
ERROR
_OGPSCONT: <Context ID>,<PDP
type>,<APN>,<IP Address>,<D_comp>
,<H_comp>
_OGPSCONT: 1,"IP",,,(0-2),(0-4)
_OGPSCONT: 1,"PPP",,,(0-2),(0-4)
Description
Sets the Context information which GPS will use to contact the SUPL server.
Defined values
<Cid> Only context id 1 is allowed because the GPS engine will always use that one.
<PDP type>
Value Description
PPP Point to Point Protocol
IP
Internet Protocol
<APN>
<IP Address>
<D_comp>
Value
0
1
2
Description
Off
On (manufacturer preferred compression)
V.42bis
<H_comp>
Remark
v015ext
Page 12 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Only context id 1 is allowed because the GPS engine will always use that one.
Example
AT_OGPSCONT=1,IP,"yourAPNhere"
v015ext
Page 13 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Possible Response(s)
OK
ERROR
_OGPSPDPP:
1,<authtype>,<password>,<username>
AT_OGPSPDPP=?
_OGPSPDPP: (1),(0-2),,
Description
This command is used to define the authentication parameters associated with GPS
PDP context 1 (cid=1). <cid> corresponds to the id used in the _OGPSCONT
command.
Only the first context will be used.
Defined values
<cid>:
<auth-type>:
Value
0
1
2
Description
None
PAP
CHAP
<password>: password
<username>: username
Remark
Only context id 1 is allowed because the GPS engine will always use that one.
v015ext
Page 14 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
_OGPSEVT?
_OGPSEVT=?
Possible Response(s)
OK
ERROR
+CME ERROR: <err>
<enable>
_OGPSEVT: (0-1)
Description
With this command you can enable or disable the unsolicited events that will display
the status of the GPS engine (for A-GPS SUPL sessions on UMTS, IS-95 sessions on
CMDA and GpsOneXTRA sessions for both UMTS and CDMA).
*This command is not applicable for S-GPS sessions.
Defined values
<enable>:
Value Description
0
Disable
1
Enable
*Default is 0. This will enable _OGPSEVT unsolicited response.
Unsolicited Values
5 possible values:
Value Description
GPS Comm Begin.
0
Valid For
AGPS on UMTS,
CDMA
GPS Comm
Connected.
AGPS on UMTS,
CDMA
AGPS on UMTS,
CDMA
AGPS on UMTS,
CDMA
v015ext
Page 15 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
GPS Done.
GpsOneXTRA Time
Download Start.
GpsOneXTRA Time
Download
Connected to server.
GpsOneXTRA Time
Download Done.
GpsOneXTRA Time
Download Failed.
GpsOneXTRA Data
Download Start.
GpsOneXTRA Data
Download
Connected to server.
GpsOneXTRA Data
Download Done.
GpsOneXTRA Data
Download Failed.
GpsOneXTRA on
UMTS
GpsOneXTRA on
UMTS
10
11
12
13
14
15
16
17
GpsOneXTRA on
UMTS
GpsOneXTRA on
UMTS
GpsOneXTRA on
UMTS, CDMA
GpsOneXTRA on
UMTS, CDMA
GpsOneXTRA on
UMTS, CDMA
GpsOneXTRA on
UMTS, CDMA
Example
When the unsolicited events are enabled and a A-GPS SUPL session is going to be
setup, the following response will be seen:
v015ext
Page 16 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
Example
6th of May 2010, 22:10:00 hours (UTC) equals to "10/05/06,22:10:00".
AT_OGCLK="10/05/06,22:10:00"
v015ext
Page 17 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
4 GPSONEXTRA COMMANDS
4.1 Option GPS XTRA Parameters AT_OGPSXP
Command
Possible Response(s)
_OGPSXP=<enabled>,<url1>,<url2>,<url3> +CME ERROR: <err>
_OGPSXP?
_OGPSXP: <enabled>, <url1>,
< url2>, <url3>
+CME ERROR: <err>
_OGPSXP=?
_OGPSXP: (0-1),,,
Description
Can be used to enable or disable the XTRA download and set the XTRA download
servers.
Defined values
<enabled>:
- 0: disable
- 1: enable
<url1>: Contains the url of the xtra.bin file on the primary XTRA data server.
Default value: http://xtra1.gpsonextra.net/xtra.bin
<url2>: Contains the url of the xtra.bin file on the secondary XTRA data server.
Default value: http://xtra1.gpsonextra.net/xtra.bin
<url3>: Contains the url of the xtra.bin file on the tertiary XTRA data server.
Default value: http://xtra1.gpsonextra.net/xtra.bin
v015ext
Page 18 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
v015ext
Page 19 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
CME ERRORS
The following numbers and messages of CME ERRORS are specific to GPS.
550 Invalid PDSM Client ID
551 Bad PDSM Service
Parameter
553 PDSM Privacy Error
554 PDSM Download Error
555 PDSM Network Access Error
556 PDSM Operating Error
This is an
internal error.
Unused
Unused
Unused
Unused
Bad Operation
Parameter
Internal Error
Unused
Unused
Unused
Unused
This is an
internal error.
e.g when phone
is in E911.
v015ext
AT_OGPSMODE
accepted an illegal value
for a parameter.
This should not occur.
Please report this error.
An action that requires the
GPS session to be active
was executed while the
session was off. Either
start the GPS session first
or execute the command
only when no GPS
session is active.
This is an
internal error.
Unused
Page 20 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
v015ext
Unused
Unused
Unused
e.g. for Secure
SUPL
Other errors.
Page 21 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.
References
Reference documents
v015ext
Owner
Page 22 of 22
This document is Option Confidential - it may not be duplicated, neither distributed externally
without prior and written permission of Option NV.