LTE Standard

GNSS Application Note

LTE Standard Module Series

Rev. LTE_Standard_GNSS_Application_Note_V1.2

Date: 2019-10-23

Status: Released

www.quectel.com
 LTE Standard Module Series
LTE Standard GNSS Application Note

Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:

Quectel Wireless Solutions Co., Ltd.

Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai,
China 200233
Tel: +86 21 5108 6236
Email: info@quectel.com

Or our local office. For more information, please visit:

http://www.quectel.com/support/sales.htm

For technical support, or to report documentation errors, please visit:

http://www.quectel.com/support/technical.htm
Or email to: support@quectel.com

GENERAL NOTES
QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT
TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT
MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT
ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR
RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.

COPYRIGHT
THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF
QUECTEL WIRELESS SOLUTIONS CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION
AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE
FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF
DAMAGES. ALL RIGHTS ARE RESERVED IN THE EVENT OF A PATENT GRANT OR
REGISTRATION OF A UTILITY MODEL OR DESIGN.

Copyright © Quectel Wireless Solutions Co., Ltd. 2019. All rights reserved.

LTE_Standard_GNSS_Application_Note 1 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

About the Document

History

Revision Date Author Description

1.0 2016-09-02 Sundy WANG Initial

1. Added the introduction, AT commands and an
operation procedure example of gpsOneXTRA
Assistance function (Chapter 1.3, 2.7, 2.8, 2.9
and 3.3)
1.1 2017-02-13 Sundy WANG 2. Modified the parameter description of
AT+QGPSCFG=“outport”[,<outport>] (Chapter
2.1.1)
3. Modified the parameter description of
AT+QGPSDEL (Chapter 2.2)
1. Added applicable modules of this document
(Chapter 1).
2. Added following commands (Chapter 2.1)
AT+QGPSCFG="odpcontrol"
AT+QGPSCFG="dpoenable"
AT+QGPSCFG="plane"
1.2 2019-10-23 Tery SHI AT+QGPSCFG="autogps"
AT+QGPSCFG="suplver"
AT+QGPSCFG="agpsposmode"
AT+QGPSCFG="agnssprotocol"
AT+QGPSCFG="fixfreq"
3. Added command AT+QGPSSUPLURL(Chapter
2.6) and AT+QGPSSUPLCA (Chapter 2.7)

LTE_Standard_GNSS_Application_Note 2 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Contents

About the Document .................................................................................................................................. 2

Contents ...................................................................................................................................................... 3
Table Index .................................................................................................................................................. 5

1 Introduction ......................................................................................................................................... 6
1.1. GNSS Turning on/off Procedures .............................................................................................. 6
1.2. NMEA Sentence Types .............................................................................................................. 7
1.3. Introduction of gpsOneXTRA Assistance ................................................................................... 7

2 Description of GNSS AT Commands ................................................................................................ 9

2.1. AT+QGPSCFG Configure GNSS ............................................................................................ 9
2.1.1. AT+QGPSCFG="outport" Configure NMEA Sentences Output Port ......................... 10
2.1.2. AT+QGPSCFG="nmeasrc" Enable/Disable Acquisition of NMEA Sentences via
AT+QGPSGNMEA ....................................................................................................................... 10
2.1.3. AT+QGPSCFG="gpsnmeatype" Configure Output Type of GPS NMEA Sentences .. 11
2.1.4. AT+QGPSCFG="glonassnmeatype" Configure Output Type of GLONASS NMEA
Sentences .................................................................................................................................... 12
2.1.5. AT+QGPSCFG="galileonmeatype" Configure Output Type of Galileo NMEA
Sentences .................................................................................................................................... 13
2.1.6. AT+QGPSCFG="beidounmeatype" Configure Output Type of BeiDou NMEA
Sentences .................................................................................................................................... 14
2.1.7. AT+QGPSCFG="gnssconfig" Configure Supported GNSS Constellations ............... 15
2.1.8. AT+QGPSCFG="odpcontrol" Configure ODP Mode .................................................. 16
2.1.9. AT+QGPSCFG="dpoenable" Enable/Disable DPO Mode ......................................... 16
2.1.10. AT+QGPSCFG="gsvextnmeatype" Enable/Disable GNSS Extended GGSV ........... 17
2.1.11. AT+QGPSCFG="plane" Configure Plane Mode Used by MO AGPS Session .......... 18
2.1.12. AT+QGPSCFG="autogps" Enable/Disable GNSS to Run Automatically .................. 19
2.1.13. AT+QGPSCFG="suplver" Configure SUPL Protocol Version .................................... 19
2.1.14. AT+QGPSCFG="agpsposmode" Configure AGPS Positioning Mode ....................... 20
2.1.15. AT+QGPSCFG="agnssprotocol" Configure A-GNSS Positioning Protocols ............. 21
2.1.16. AT+QGPSCFG="fixfreq" Configure NMEA Output Frequency .................................. 22
2.2. AT+QGPSDEL Delete Assistance Data ................................................................................ 23
2.3. AT+QGPS Turn on GNSS ..................................................................................................... 24
2.4. AT+QGPSEND Turn off GNSS ............................................................................................. 25
2.5. AT+QGPSLOC Acquire Positioning Information ................................................................... 26
2.6. AT+QGPSSUPLURL Configure SUPL Server URL .............................................................. 28
2.7. AT+QGPSSUPLCA Inject SUPL Certificate .......................................................................... 29
2.8. AT+QGPSGNMEA Acquire NMEA Sentences ...................................................................... 29
2.9. AT+QGPSXTRA Enable/Disable gpsOneXTRA Assistance Function .................................. 31
2.10. AT+QGPSXTRATIME Inject gpsOneXTRA Time .................................................................. 32
2.11. AT+QGPSXTRADATA Inject gpsOneXTRA Data File........................................................... 33

3 Examples ........................................................................................................................................... 35

LTE_Standard_GNSS_Application_Note 3 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

3.1. Turn on/off the GNSS ............................................................................................................... 35

3.2. Application of GNSS <nmeasrc> ............................................................................................. 35
3.3. Operation Procedures of gpsOneXTRA Assistance Function ................................................. 36

4 Summary of Error Codes ................................................................................................................. 37

5 Appendix A References.................................................................................................................... 38

LTE_Standard_GNSS_Application_Note 4 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Table Index

TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 37

TABLE 2: RELATED DOCUMENTS .................................................................................................................. 38
TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 38

LTE_Standard_GNSS_Application_Note 5 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

1 Introduction
Quectel LTE standard modules integrate a GNSS engine which supports GPS, BeiDou, Galileo and
GLONASS systems and also gpsOneXTRA Assistance technology. The high-performance GNSS engine
is suitable for various applications where the lowest-cost and accurate positioning is needed, and it
supports position tracking without any network assistance. The GNSS makes LTE standard modules
popular in application fields such as turn-by-turn navigation, asset tracking, personnel tracking,
location-aware games, as well as home and fleet management.

This document is applied to the following LTE Standard modules:

 EC2x: EC21, EC25, EC20 R2.0 and EC20 R2.1

 EG2x-G: EG25-G and EG21-G
 EG9x: EG91 and EG95
 EM05

1.1. GNSS Turning on/off Procedures

The GNSS of LTE standard modules supports location calculation without any assistance from the
network. GNSS turning on/off procedures are shown below:

Step 1: Configure GNSS parameters via AT+QGPSCFG.

Step 2: Turn on GNSS via AT+QGPS.
Step 3: After GNSS is turned on and position is fixed successfully, the positioning information can be
obtained in either of the following three ways:
1) NMEA sentences are outputted to "usbnmea" port by default. NMEA sentences can be obtained
by reading the port.
2) AT+QGPSLOC can be used to obtain positioning information directly, such as latitude, longitude,
height, GNSS positioning mode, time, number of satellites, and so on.
3) After enabling <nmeasrc> via AT+QGPSCFG="nmeasrc",1, the specified NMEA sentence can
be acquired via AT+QGPSGNMEA. If <nmeasrc> is disabled, this command cannot be used.
Step 4: Turn off GNSS via AT+QGPSEND.

LTE_Standard_GNSS_Application_Note 6 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

1.2. NMEA Sentence Types

The NMEA sentences are compatible with NMEA-0183 protocol, and four kinds of prefixes are available
to differentiate NMEA sentences of different satellite systems, as illustrated below.

For GPS NMEA sentences, the prefix is “GP”, as below:

 GPGGA - Global positioning system fix data, such as time, position, etc.
 GPRMC - Recommended minimum specific GNSS data
 GPGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.
 GPGSA - GNSS DOP and active satellites
 GPVTG - Course over ground and ground speed

For GLONASS NMEA sentences, the prefixes are "GL" and "GN", as below:

 GLGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.
 GNGSA - GNSS DOP and active satellites
 GNGNS - GNSS fix data

For Galileo NMEA sentences, the prefixes are "GA", as below:

 GAGGA - Global positioning system fix data, such as time, position, etc.
 GARMC - Recommended minimum specific GNSS data
 GAGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.
 GAGSA - GNSS DOP and active satellites
 GAVTG - Course over ground and ground speed

For BeiDou NMEA sentences, the prefixes are "PQ", as below:

 PQGSV - GNSS satellites in view, such as number of satellites in view, satellite ID numbers, etc.
 PQGSA - GNSS DOP and active satellites

1.3. Introduction of gpsOneXTRA Assistance

gpsOneXTRA Assistance technology enhances the performance of GNSS and provides simplified GNSS
assistance delivery, including ephemeris, almanac, ionosphere, UTC, health and coarse time assistance
for GNSS engine. After activating gpsOneXTRA Assistance, the TTFF (Time to First Fix) can be reduced
by 18s~30s (or more in harsh environments with weak signals). The assistance data which is obtained
from one of the gpsOneXTRA Assistance web servers needs to be updated once a day (or every couple
of days).

Before using this function, please make sure the valid gpsOneXTRA assistance data is available first. It is
necessary to download a new gpsOneXTRA binary file which contains the data from one of the
gpsOneXTRA Assistance web servers via URLs listed below.

LTE_Standard_GNSS_Application_Note 7 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

 The files named with suffix "xtra2.bin" are for GPS+GLONASS.

http://xtrapath1.izatcloud.net/xtra2.bin
http://xtrapath2.izatcloud.net/xtra2.bin
http://xtrapath3.izatcloud.net/xtra2.bin

 The files named with suffix "xtra3grc.bin" are for GPS+GLONASS+BeiDou.

http://xtrapath1.izatcloud.net/xtra3grc.bin
http://xtrapath2.izatcloud.net/xtra3grc.bin
http://xtrapath3.izatcloud.net/xtra3grc.bin

 The files named with suffix "xtra3grcej.bin" are for GPS+GLONASS+BeiDou+Galileo.

http://xtrapath1.izatcloud.net/xtra3grcej.bin
http://xtrapath2.izatcloud.net/xtra3grcej.bin
http://xtrapath3.izatcloud.net/xtra3grcej.bin

gpsOneXTRA assistance data needs to be updated regularly. The status of gpsOneXTRA data files can
be queried via AT+QGPSXTRADATA? before updating.

The operation procedures of gpsOneXTRA Assistance function are shown as follows:

Step 1: gpsOneXTRA Assistance function is disabled by default, and can be enabled via
AT+QGPSXTRA=1.
Step 2: Query and confirm the current validity of gpsOneXTRA data file via AT+QGPSXTRADATA?. If
the data is invalid, perform Step 3~6 then; if the data is valid, turn on GNSS engine according to
the procedures described in Chapter 1.1 directly.
Step 3: Download files with suffix “xtra2.bin” or “xtra3grc.bin” to the module via URLs listed above.
Step 4: Inject the correct gpsOneXTRA time to GNSS engine via AT+QGPSXTRATIME.
Step 5: Inject the valid gpsOneXTRA data file to GNSS engine via AT+QGPSXTRADATA.
Step 6: Turn on GNSS engine according to the procedures described in Chapter 1.1.

NOTE

Before Step 1, it is necessary to ensure that the GNSS engine has been turned off.

For more detailed information of the AT commands mentioned above, please refer to Chapter 2.9, 2.10
and 2.11.

LTE_Standard_GNSS_Application_Note 8 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2 Description of GNSS AT Commands

2.1. AT+QGPSCFG Configure GNSS

The command is used to query and configure various GNSS settings, including NMEA sentences output
port, output type, etc.

AT+QGPSCFG Configure GNSS

Test Command Response
AT+QGPSCFG=? +QGPSCFG: "outport",("none","usbnmea","uartdebug")
+QGPSCFG: "nmeasrc",(0,1)
+QGPSCFG: "gpsnmeatype",(0-31)
+QGPSCFG: "glonassnmeatype",(0-7)
+QGPSCFG: "galileonmeatype",(0-1)
+QGPSCFG: "beidounmeatype",(0-3)
+QGPSCFG: "gnssconfig",(0-6)
+QGPSCFG: "odpcontrol",(0-2)
+QGPSCFG: "dpoenable",(0,1)
+QGPSCFG: "gsvextnmeatype",(0,1)
+QGPSCFG: "plane",(0-2)
+QGPSCFG: "autogps",(0,1)
+QGPSCFG: "suplver",(1,2)
+QGPSCFG: "agpsposmode",(0-4294967295)
+QGPSCFG: "agnssprotocol",(0-255),(0-65535)
+QGPSCDF: "fixfreq",(1,2,5,10)

OK

Reference

LTE_Standard_GNSS_Application_Note 9 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.1.1. AT+QGPSCFG="outport" Configure NMEA Sentences Output Port

This command is used to configure the NMEA sentences output port. It will take effect immediately.

AT+QGPSCFG="outport" Configure NMEA Sentences Output Port

Write Command Response
AT+QGPSCFG="outport"[,<out_port> When two parameters are specified, configure the output port
] of NMEA sentences:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "outport",<out_port>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<out_port> String type. Configure the output port of NMEA sentences, and the parameter
configuration will be automatically saved to NVRAM.
"none" Close NMEA sentence output
"usbnmea" Output via USB NMEA port
"uartdebug" Output via debug UART port
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.2. AT+QGPSCFG="nmeasrc" Enable/Disable Acquisition of NMEA Sentences

via AT+QGPSGNMEA

This command is used to enable/disable acquisition of NMEA sentences via AT+QGPSGNMEA. It will
take effect immediately.

AT+QGPSCFG="nmeasrc" Enable/Disable Acquisition of NMEA Sentences via

AT+QGPSGNMEA
Write Command Response
AT+QGPSCFG="nmeasrc"[,<NMEA_s When two parameters are specified, configure whether to
rc>] enable acquisition of NMEA sentences via

LTE_Standard_GNSS_Application_Note 10 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

AT+QGPSGNMEA:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "nmeasrc",<NMEA_src>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<NMEA_src> Integer type. If enabled, original NMEA sentences can be acquired via
AT+QGPSGNMEA, and the parameter configuration will be automatically saved
to NVRAM. Meanwhile, sentences are outputted via the same NMEA ports as
before.
0 Disable
1 Enable
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.3. AT+QGPSCFG="gpsnmeatype" Configure Output Type of GPS NMEA

Sentences

This command is used to configure the type of GPS NMEA sentences that will be outputted. It will take
effect after the module is rebooted.

AT+QGPSCFG="gpsnmeatype" Configure Output Type of GPS NMEA Sentences

Write Command Response
AT+QGPSCFG="gpsnmeatype"[,<GP When two parameters are specified, configure the output type
S_NMEA_type>] of GPS NMEA sentences:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "gpsnmeatype",<GPS_NMEA_type>

LTE_Standard_GNSS_Application_Note 11 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<GPS_NMEA_type> Integer type. Output type of GPS NMEA sentences, and the parameter
configuration will be automatically saved to NVRAM. The default value is 31
which means that all the five types of sentences will be outputted.
0 Disable
1 GPGGA
2 GPRMC
4 GPGSV
8 GPGSA
16 GPVTG
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.4. AT+QGPSCFG="glonassnmeatype" Configure Output Type of GLONASS

NMEA Sentences

This command is used to configure the type of the GLONASS NMEA sentence that will be outputted. It
will take effect after the module is rebooted.

AT+QGPSCFG="glonassnmeatype" Configure Output Type of GLONASS NMEA

Sentences
Write Command Response
AT+QGPSCFG="glonassnmeatype"[, When two parameters are specified, configure the output type
<GLONASS_NMEA_type>] of GLONASS NMEA sentences:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG:
"glonassnmeatype",<GLONASS_NMEA_type>

OK

LTE_Standard_GNSS_Application_Note 12 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<GLONASS_NMEA_type> Integer type. Configure output type of GLONASS NMEA sentences, and
the parameter configuration will be automatically saved to NVRAM. The
default value is 0.
0 Disable
1 GLGSV
2 GNGSA
4 GNGNS
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for
details.

2.1.5. AT+QGPSCFG="galileonmeatype" Configure Output Type of Galileo NMEA

Sentences

This command is used to configure the type of Galileo NMEA sentence that will be outputted. It will take
effect after the module is rebooted.

AT+QGPSCFG="galileonmeatype" Configure Output Type of Galileo NMEA

Sentences
Write Command Response
AT+QGPSCFG="galileonmeatype"[,< When two parameters are specified, configure the output type
Galileo_NMEA_type>] of Galileo NMEA sentences:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "galileonmeatype",<Galileo_NMEA_type>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

LTE_Standard_GNSS_Application_Note 13 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Parameter

<Galileo_NMEA_type> Integer type. Configure output type of Galileo NMEA sentences, and the
parameter configuration will be automatically saved to NVRAM. The default
value is 0.
0 Disable
1 GAGSV
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for
details.

2.1.6. AT+QGPSCFG="beidounmeatype" Configure Output Type of BeiDou NMEA

Sentences

This command is used to configure the type of BeiDou NMEA sentence that will be outputted. It will take
effect after the module is rebooted.

AT+QGPSCFG="beidounmeatype" Configure Output Type of BeiDou NMEA

Sentences
Write Command Response
AT+QGPSCFG="beidounmeatype"[,< When two parameters are specified, configure the output type
BeiDou_NMEA_type>] of BeiDou NMEA sentences:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "beidounmeatype",<BeiDou_NMEA_type>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<BeiDou_NMEA_type> Integer type. Configure output type of BeiDou NMEA sentences, and the
parameter configuration will be automatically saved to NVRAM. The default
value is 0.
0 Disable
1 PQGSA

LTE_Standard_GNSS_Application_Note 14 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2 PQGSV
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for
details

2.1.7. AT+QGPSCFG="gnssconfig" Configure Supported GNSS Constellations

This command is used to configure the supported GNSS constellations of the module. It will take effect
after the module is rebooted.

AT+QGPSCFG="gnssconfig" Configure Supported GNSS Constellations

Write Command Response
AT+QGPSCFG="gnssconfig"[,<GNSS When two parameters are specified, configure the supported
_config>] GNSS constellations:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "gnssconfig",<GNSS_config>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<GNSS_config> Integer type. Supported GNSS constellations

GPS is always ON
0 GLONASS OFF/BeiDou OFF/Galileo OFF
1 GLONASS ON/BeiDou ON/Galileo ON
2 GLONASS ON/BeiDou ON/Galileo OFF
3 GLONASS ON/BeiDou OFF/Galileo ON
4 GLONASS ON/BeiDou OFF/Galileo OFF
5 GLONASS OFF/BeiDou ON/Galileo ON
6 GLONASS OFF/BeiDou OFF/Galileo ON
7 GLONASS OFF/BeiDou ON/Galileo OFF
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

LTE_Standard_GNSS_Application_Note 15 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.1.8. AT+QGPSCFG="odpcontrol" Configure ODP Mode

This command is used to configure the OPD mode. This command will take effect after the module is
rebooted.

AT+QGPSCFG="odpcontrol" Configure ODP Mode

Write Command Response
AT+QGPSCFG="odpcontrol"[,<ODP_ When two parameters are specified, ODP mode can be
control>] configured:
OK
Or
ERROR

When the second parameter is not specified, the current

setting can be queried:
+QGPSCFG: "odpcontrol",<ODP_control>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<ODP_control> Integer type. Set ODP mode. The setting will be automatically saved to NVRAM.
0 Disable ODP
1 Low power mode
2 Ready mode
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.9. AT+QGPSCFG="dpoenable" Enable/Disable DPO Mode

This command is used to enable/disable the DPO mode for GNSS. It will take effect after the module is
rebooted.

AT+QGPSCFG="dpoenable" Enable/Disable DPO Mode

Write Command Response
AT+QGPSCFG="dpoenable"[,<DPO_e When two parameters are specified, enable/disable the DPO
nable>] mode:
OK
Or

LTE_Standard_GNSS_Application_Note 16 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "dpoenable",<DPO_enable>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<DPO_enable> Integer type. Enable/Disable DPO. The setting will be automatically saved to
NVRAM.
0 Disable DPO
1 Enable the DPO with dynamic duty cycle
2 Enable the DPO only if the phone is not connected to an external
power supply (not running on battery)
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.10. AT+QGPSCFG="gsvextnmeatype" Enable/Disable GNSS Extended GGSV

This command is used to enable/disable GNSS extended GGSV. It will take effect after the module is
rebooted.

AT+QGPSCFG="gsvextnmeatype" Enable/Disable GNSS Extended GGSV

Write Command Response
AT+QGPSCFG="gsvextnmeatype"[,< When two parameters are specified, configure the GNSS
gsvext_NMEA_type>] extended GGSV:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "gsvextnmeatype",<gsvext_NMEA_type>

OK

If there is any error related to ME functionality:

LTE_Standard_GNSS_Application_Note 17 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

+CME ERROR: <errcode>

Reference

Parameter

<gsvext_NMEA_type> Enable/disable extended GGSV

0 Disable extended GGSV
1 Enable extended GGSV
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for
details.

2.1.11. AT+QGPSCFG="plane" Configure Plane Mode Used by MO AGPS Session

This command is used to configure the plane mode (control plane or user plane) to be used by the
Mobile-Originated (MO) AGPS session. This command will take effect after the module is rebooted.

AT+QGPSCFG="plane" Configure AGPS Plane Mode

Write Command Response
AT+QGPSCFG="plane"[,<plane>] When two parameters are specified, configure the plane
mode used by MO GPS session:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "plane",<plane>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<plane> Integer type. The plane mode used by MO AGPS session.

0 User plane without SSL
1 User plane with SSL
2 Control plane
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

LTE_Standard_GNSS_Application_Note 18 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.1.12. AT+QGPSCFG="autogps" Enable/Disable GNSS to Run Automatically

This command is used to configure whether to enable GNSS when the module restarts. It will take effect
after the module is rebooted.

AT+QGPSCFG="autogps" Enable/Disable GNSS to Run Automatically

Write Command Response
AT+QGPSCFG="autogps"[,<autoGPS When two parameters are specified, configure whether to
>] enable GNSS to run automatically:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "autogps",<autoGPS>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<autoGPS> Integer type. Enable/disable GNSS to run automatically after the module is
powered on, and the parameter configuration will be automatically saved to
NVRAM.
0 Disable GNSS to run automatically
1 Enable GNSS to run automatically
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.13. AT+QGPSCFG="suplver" Configure SUPL Protocol Version

This command is used to configure the SUPL version in an SI session, and the most likely used SUPL
major version in a NI session. This command will take effect after the module is rebooted.

AT+QGPSCFG="suplver" Configure SUPL Protocol Version

Write Command Response
AT+QGPSCFG="suplver"[,<SUPL_ver When two parameters are specified, configure the SUPL
sion>] protocol version:
OK

LTE_Standard_GNSS_Application_Note 19 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "suplver",<SUPL_version>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<SUPL_version> Integer type. SUPL protocol version.

1 SUPL version 1.0
2 SUPL version 2.0
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.14. AT+QGPSCFG="agpsposmode" Configure AGPS Positioning Mode

This command is used to configure the AGPS positioning mode. It will take effect after the module is
rebooted.

AT+QGPSCFG="agpsposmode" Configure the AGPS mode

Write Command Response
AT+QGPSCFG="agpsposmode"[,<AG When two parameters are specified, configure the AGPS
PS_posmode>] mode:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "agpsposmode",<AGPS_posmode>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

LTE_Standard_GNSS_Application_Note 20 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Parameter

<AGPS_posmode> Integer type. AGPS positioning mode configuration. The range is 0-4294967295.
The default value of each LTE Standard modules are different.
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.1.15. AT+QGPSCFG="agnssprotocol" Configure A-GNSS Positioning Protocols

This command is used to configure A-GPS LPP positioning protocol and A-GLONASS positioning
protocol. This command will take effect after rebooting the module.

AT+QGPSCFG="agnssprotocol" Configure A-GNSS Positioning Protocols

Write Command Response
AT+QGPSCFG="agnssprotocol"[,<A When two parameters are specified, configure the LPP
GPS_lp>,<AGLONASS_lp>] protocol:
OK
Or
ERROR

When the second and third parameters are not specified,

query the current setting:
+QGPSCFG:
"agnssprotocol",<AGPS_lp>,<AGLONASS_lp>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<AGPS_lp> Integer type. A-GPS LPP positioning protocol.

1 User plane LPP
2 Control plane LPP
<AGLONASS_lp> Integer type. A-GLONASS positioning protocol.
1 Control plane RRLP
2 Control plane RRC
4 Control plane LPP
256 User plane RRLP
1024 User plane LPP
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

LTE_Standard_GNSS_Application_Note 21 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.1.16. AT+QGPSCFG="fixfreq" Configure NMEA Output Frequency

This command is used to configure the NMEA sentence output frequency. It can only be executed when
the GNSS engine is turned off and takes effect immediately. When the output frequency of NMEA is set
higher than 1Hz, the output of GGA, RMC, VTG and GSA sentences will be outputted at the set frequency,
and the output of GSV sentence will always be 1Hz.

AT+QGPSCFG="fixfreq" Configure NMEA Output Frequency

Write Command Response
AT+QGPSCFG="fixfreq",<freq> When two parameters are specified, configure the NMEA
output frequency:
OK
Or
ERROR

When the second parameter is not specified, query the

current setting:
+QGPSCFG: "fixfreq",<freq>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<freq> Integer type. NMEA output frequency. The default value is 1Hz.
1 1Hz
2 2Hz
5 5Hz
10 10Hz
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

NOTE

Not all modules and software baselines support this function. Please consult Quectel Technical Support
Team for specific supported model and software baselines.

LTE_Standard_GNSS_Application_Note 22 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.2. AT+QGPSDEL Delete Assistance Data

The command is used to delete assistance data so as to operate cold start, hot start and warm start of
GNSS. The command can only be executed when GNSS is turned off. After deleting the assistance data
via this command, the cold start of GNSS can be enforced via AT+QGPS. Hot/warm start can also be
performed if the corresponding conditions are satisfied. This command takes effect immediately.

AT+QGPSDEL Delete Assistance Data

Test Command Response
AT+QGPSDEL=? +QGPSDEL: (0-3)

OK
Write Command Response
AT+QGPSDEL=<delete_type> OK
Or
ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<delete_type> Integer type. The type of GNSS assistance data to be deleted.

0 Delete all assistance data. Enforce cold start after starting GNSS.
1 Do not delete any data. Perform hot start if the conditions are permitted after
starting GNSS.
2 Delete some related data. Perform warm start if the conditions are permitted
after starting GNSS.
3 Delete the gpsOneXTRA assistance data injected into GNSS engine.
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

LTE_Standard_GNSS_Application_Note 23 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.3. AT+QGPS Turn on GNSS

This command is used to turn on GNSS function. When <fix_count> is 0, GNSS can be turned off via
AT+QGPSEND. When <fix_count> is non-zero and reaches the value specified by customers, GNSS will
be turned off automatically. This command takes effect immediately.

AT+QGPS Turn on GNSS

Test Command Response
AT+QGPS=? +QGPS: (1-4),(1-255),(0-1000),(0-1000),(1-65535)

OK
Read Command Response
Read current GNSS state +QGPS: <GNSS_state>
AT+QGPS?
OK
Write Command Response
AT+QGPS=<GNSS_mode>[,<fix_maxt OK
ime>[,<fix_maxdist>[,<fix_count>[,<fi Or
x_rate>]]]] ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<GNSS_state> Integer type. GNSS state

0 GNSS OFF
1 GNSS ON
<GNSS_mode> Integer type. GNSS working mode
1 Stand-alone
2 MS-based
3 MS-assisted
4 Speed-optimal
<fix_maxtime> Integer type. The maximum positioning time (unit: s), which indicates the
response time of GNSS receiver while measuring the GNSS pseudo range and
the upper time limit of GNSS satellite searching. It also includes the time for
demodulating the ephemeris data and calculating the position.
1-30-255 Maximum positioning time
<fix_maxdist> Integer type. Accuracy threshold of positioning. Unit: m.
0-50-1000
<fix_count> Integer type. Positioning times.

LTE_Standard_GNSS_Application_Note 24 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

0-1000
0 Continuous positioning.
Other values Actual positioning times.
<fix_rate> Integer type. The interval between the first and the second positioning. Unit: s.
1–65535
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.4. AT+QGPSEND Turn off GNSS

When GNSS is turned on and <fix_count> is 0, GNSS fixes position continuously and can be turned off
via AT+QGPSEND. When <fix_count> is non-zero and reaches the value specified by customers, GNSS
will be turned off automatically. This command takes effect immediately.

AT+QGPSEND Turn off GNSS

Test Command Response
AT+QGPSEND=?
OK
Or
ERROR
Read command Response
AT+QGPSEND?
OK
Or
ERROR
Execution Command Response
Turn off GNSS OK
AT+QGPSEND Or
ERROR

If error is related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

LTE_Standard_GNSS_Application_Note 25 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.5. AT+QGPSLOC Acquire Positioning Information

This command is used to acquire positioning information. Before executing the command, GNSS must be
turned on via AT+QGPS. If GNSS fails in position fix, +CME ERROR: <errcode> will be returned to
indicate the corresponding situation. This command takes effect immediately.

AT+QGPSLOC Acquire Positioning Information

Test Command Response
AT+QGPSLOC=? +QGPSLOC: <UTC>,<latitude>,<longitude>,<HDOP>,<alt
itude>,<fix>,<COG>,<spkm>,<spkn>,<date>,<nsat>

OK
Write Command Response
AT+QGPSLOC=<mode> +QGPSLOC: <UTC>,<latitude>,<longitude>,<HDOP>,<alt
itude>,<fix>,<COG>,<spkm>,<spkn>,<date>,<nsat>

OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<mode> Integer type. Latitude and longitude display format.

0 <latitude>,<longitude> format: ddmm.mmmm N/S,dddmm.mmmm E/W
1 <latitude>,<longitude> format: ddmm.mmmmmm N/S,dddmm.mmmmmm E/W
2 <latitude>,<longitude> format: (-)dd.ddddd,(-)ddd.ddddd
<UTC> UTC time.
Format: hhmmss.sss (Quoted from GPGGA sentence).
<latitude> Latitude.

If <mode> is 0:
Format: ddmm.mmmm N/S (Quoted from GPGGA sentence)
dd 00-89 (degree)
mm.mmm 00.0000-59.9999 (minute)
N/S North latitude/South latitude

If <mode> is 1:
Format: ddmm.mmmmmm N/S (Quoted from GPGGA sentence)
dd 00-89 (degree)
mm.mmmmmm 00.000000-59.999999 (minute)

LTE_Standard_GNSS_Application_Note 26 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

N/S North latitude/South latitude

If <mode> is 2:
Format: (-)dd.ddddd (Quoted from GPGGA sentence)
dd.ddddd -89.99999-89.99999 (degree)
- South latitude
<longitude> Longitude

If <mode> is 0:
Format: dddmm.mmmm E/W (Quoted from GPGGA sentence)
Ddd 000-179 (degree)
mm.mmmm 00.0000-59.9999 (minute)
E/W East longitude/West longitude

If <mode> is 1:
Format: dddmm.mmmmmm E/W (Quoted from GPGGA sentence)
Ddd 000-179 (degree)
mm.mmmmmm 00.000000-59.999999 (minute)
E/W East longitude/West longitude

If <mode> is 2:
Format: (-)dd.ddddd (Quoted from GPGGA sentence)
dd.ddddd -179.99999-179.99999 (degree)
- West longitude
<HDOP> Horizontal precision: 0.5-99.9 (Quoted from GPGGA sentence).
<altitude> The altitude of the antenna away from the sea level (unit: m), and is accurate to one
decimal place (Quoted from GPGGA sentence).
<fix> GNSS positioning mode (Quoted from GAGSA/GPGSA sentence).
2 2D positioning
3 3D positioning
<COG> Course Over Ground based on true north.
Format: ddd.mm (Quoted from GPVTG sentence).
ddd 000-359 (degree)
mm 00-59 (minute)
<spkm> Speed over ground.
Format: xxxx.x. Unit: km/h. Accurate to one decimal place (Quoted from GPVTG
sentence).
<spkn> Speed over ground.
Format: xxxx.x. Unit: knots. Accurate to one decimal place (Quoted from GPVTG
sentence).
<date> UTC time when fixing position.
Format: ddmmyy (Quoted from GPRMC sentence).
<nsat> Number of satellites, from 00 (the first 0 should be retained) to 12 (Quoted from
GPGGA sentence).

LTE_Standard_GNSS_Application_Note 27 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.6. AT+QGPSSUPLURL Configure SUPL Server URL

This command is used to configure the SUPL server URL. The parameter configuration will be saved to
NVRAM automatically. This command takes effect immediately.

AT+QGPSSUPLURL Configure SUPL Server URL

Test command Response
AT+QGPSSUPLSURL=? +QGPSSUPLURL: <SUPL_URL>

OK
Read Command Response
AT+QGPSSUPLURL? +QGPSSUPLURL: <SUPL_URL>

OK
Write Command Response
Configure SUPL server URL OK
AT+QGPSSUPLURL=<SUPL_URL> Or
ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<SUPL_URL> String type. SUPL server address. The address format is “URL:port_number” where
the “port_number” can be omitted, for example "supl.server.com", "123.123.123.123",
and "supl.server.com:7275". When the “port number” is omitted, the default value
(7275) will be used.
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

LTE_Standard_GNSS_Application_Note 28 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

2.7. AT+QGPSSUPLCA Inject SUPL Certificate

This command is used to inject SUPL certificate. The certificate file should be inputted into the file system
via AT+QFUPL, details of which are provided in Quectel_LTE_Standard_FILE_Application_Note. The
certificate should be obtained from the operator or the server provider. This command takes effect
immediately.

AT+QGPSSUPLCA Inject SUPL Certificate

Test command Response
AT+QGPSSUPLCA=? +QGPSSUPLCA: <CA_file_name>

OK
Read Command Response
AT+QGPSSUPLCA?
OK
Or
ERROR
Write Command Response
AT+QGPSSUPLCA=<CA_file_name> OK
Or
ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<CA_file_name> String type. SUPL certificate name.

<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.8. AT+QGPSGNMEA Acquire NMEA Sentences

This command is used to acquire NMEA sentences. Before using this command, GNSS must be turned
on via AT+QGPS, and set <NMEA_src> into 1 to enable acquisition of NMEA sentences via
AT+QGPSGNMEA.

The sentence output can be disabled via AT+QGPSCFG="gpsnmeatype",

AT+QGPSCFG="glonassnmeatype", AT+QGPSCFG="galileonmeatype" or
AT+QGPSCFG="beidounmeatype",0. If sentence output is disabled, AT+QGPSGNMEA can still be

LTE_Standard_GNSS_Application_Note 29 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

used to acquire NMEA sentences on condition that the GNSS has already acquired sentences via this
command after its activation. And the sentences acquired via the command will be the last ones that have
ever been acquired. This command takes effect immediately.

AT+QGPSGNMEA Acquire NMEA Sentences

Test Command Response
AT+QGPSGNMEA=? +QGPSGNMEA: ("GGA","RMC","GSV","GSA","VTG","G
NS")

OK
Write Command Response
Query GGA sentence +QGPSGNMEA: GGA sentence
AT+QGPSGNMEA="GGA"
OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Write Command Response
Query RMC sentence +QGPSGNMEA: RMC sentence
AT+QGPSGNMEA="RMC"
OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Write Command Response
Query GSV information +QGPSGNMEA: GSV sentence
AT+QGPSGNMEA="GSV"
OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Write Command Response
Query GSA sentence +QGPSGNMEA: GSA sentence
AT+QGPSGNMEA="GSA"
OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Write Command Response
Query VTG sentence +QGPSGNMEA: VTG sentence
AT+QGPSGNMEA="VTG"
OK

If there is any error related to ME functionality:

LTE_Standard_GNSS_Application_Note 30 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

+CME ERROR: <errcode>

Write Command Response

Query GNS sentence +QGPSGNMEA: GNS sentence
AT+QGPSGNMEA="GNS"
OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.9. AT+QGPSXTRA Enable/Disable gpsOneXTRA Assistance Function

This command is used to enable/disable gpsOneXTRA Assistance function, and it will take effect
immediately.

AT+QGPSXTRA Enable/Disable gpsOneXTRA Assistance Function

Test Command Response
AT+QGPSXTRA=? +QGPSXTRA: (0,1)

OK
Read Command Response
AT+QGPSXTRA? +QGPSXTRA: <xtraenable>

OK
Write Command Response
AT+QGPSXTRA=<xtraenable> OK
Or
ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

LTE_Standard_GNSS_Application_Note 31 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Parameter

<xtraenable> Integer type. Enable/disable gpsOneXTRA Assistance function, and the parameter
configuration will be automatically saved to NVRAM.
0 Disable gpsOneXTRA Assistance
1 Enable gpsOneXTRA Assistance
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.10. AT+QGPSXTRATIME Inject gpsOneXTRA Time

This command can be used to inject gpsOneXTRA time to GNSS engine. Before using it, gpsOneXTRA
Assistance function must be enabled via AT+QGPSXTRA=1 command. After activating the function, the
GNSS engine will ask for gpsOneXTRA time and assistance data file. Before injecting gpsOneXTRA data
file, gpsOneXTRA time must be injected first via this command. This command takes effect immediately.

AT+QGPSXTRATIME Inject gpsOneXTRA Time

Test Command Response
AT+QGPSXTRATIME=? +QGPSXTRATIME: 0,<xtratime>,(0,1),(0,1),<uncrtn>

OK
Write Command Response
Inject gpsOneXTRA time OK
AT+QGPSXTRATIME=<type>,<xtratim Or
e>,<utc>,<force>,<uncrtn> ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

Parameter

<type> Type of injecting time.

0 Inject XTRA time manually
1 Inject time through SNTP once. This type is disabled currently.
<xtratime> Current UTC time.
Format: YYYY/MM/DD,hh:mm:ss. e.g. 2019/01/05,08:30:30.
<utc> UTC or GPS time that gpsOneXTRA time refers to.
0 GPS time
1 UTC time. This value is recommended.
<force> Whether to force GNSS to accept the data.
0 Not force GNSS to accept the data

LTE_Standard_GNSS_Application_Note 32 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

1 Force acceptance of data. This value is recommended.

<uncrtn> Uncertainty of time. Unit: ms. Default value: 3500ms. It indicates the time difference
between sending a request to the SNTP server and receiving a response from the SNTP
server.
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for details.

2.11. AT+QGPSXTRADATA Inject gpsOneXTRA Data File

This command is used to inject a gpsOneXTRA assistance data file to the GNSS engine. Before operating
this command, gpsOneXTRA must be enabled, valid gpsOneXTRA data file must be stored into RAM or
UFS (UFS is recommended) of the module and gpsOneXTRA time be injected to GNSS engine. After
operating this command successfully, gpsOneXTRA data file can be deleted from RAM or UFS, and
whether the gpsOneXTRA data is injected successfully can be queried via AT+QGPSXTRADATA?.

AT+QGPSXTRADATA Inject gpsOneXTRA Data File

Test Command Response
AT+QGPSXTRADATA=? +QGPSXTRADATA: <xtradatafilename>

OK
Read Command Response
Query the status of gpsOneXTRA data +QGPSXTRADATA: <xtradatadurtime>,<injecteddatatim
files e>
AT+QGPSXTRADATA?
OK

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Write Command Response
Inject gpsOneXTRA data files OK
AT+QGPSXTRADATA=<xtradatafilena Or
me> ERROR

If there is any error related to ME functionality:

+CME ERROR: <errcode>
Reference

LTE_Standard_GNSS_Application_Note 33 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

Parameter

<xtradatafilename> String type. Filename of the gpsOneXTRA data file, e.g. xtra2.bin or
xtra3grc.bin.
<xtradatadurtime> Integer type. Valid time of injected gpsOneXTRA data file. Unit: min.
0 No gpsOneXTRA file or the file is overdue
1-10080 Valid time of gpsOneXTRA file
<injecteddatatime> String type. Start time of the valid time of gpsOneXTRA data file.
Format: YYYY/MM/DD,hh:mm:ss, e.g. 2016/01/03,15:34:50.
<errcode> Integer type. The error code of operation. Please refer to Chapter 4 for
details.

LTE_Standard_GNSS_Application_Note 34 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

3 Examples

3.1. Turn on/off the GNSS

Default parameters are used in this example to turn on GNSS. After turning on GNSS, NMEA sentences
will be outputted from "usbnmea" port by default; and GNSS can be turned off via AT+QGPSEND.

AT+QGPS=1 //Turn on GNSS.

OK
//After turning on GNSS, NMEA sentences will be outputted from "usbnmea" port by default.
AT+QGPSLOC? //Obtain positioning information.
+QGPSLOC: 061951.0,3150.7223N,11711.9293E,0.7,62.2,2,0.0,0.0,0.0,110513,09

OK
AT+QGPSEND //Turn off GNSS.
OK

3.2. Application of GNSS <nmeasrc>

When GNSS is turned on and <nmeasrc> is set to 1, NMEA sentences can be acquired directly via
AT+QGPSGNMEA.

AT+QGPSCFG="nmeasrc",1 //Set <nmeasrc> to 1 to enable acquisition of NMEA

sentences via AT+QGPSGNMEA.
OK
AT+QGPSGNMEA="GGA" //Obtain GGA sentence.
+QGPSGNMEA: $GPGGA,103647.0,3150.721154,N,11711.925873,E,1,02,4.7,59.8,M,-2.0,M,,*77

OK
AT+QGPSCFG="nmeasrc",0 //Set <nmeasrc> to 0 to disable acquisition of NMEA
sentences via AT+QGPSGNMEA.
OK
AT+QGPSGNMEA="GGA"
+CME ERROR: 507 //Acquisition of NMEA sentences via AT+QGPSGNMEA
was disabled, and thus GGA sentences cannot be obtained.

LTE_Standard_GNSS_Application_Note 35 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

3.3. Operation Procedures of gpsOneXTRA Assistance Function

This example shows the operation procedures of gpsOneXTRA Assistance function.

AT+QGPSXTRA=1 //If gpsOneXTRA Assistance is disabled,

enable it first and then perform the following
procedures.
OK
//The gpsOneXTRA Assistance function is activated immediately.
//If gpsOneXTRA data file is valid (query via AT+QGPSXTRADATA?), turn on GNSS engine directly.
//If gpsOneXTRA data file is invalid (query via AT+QGPSXTRADATA?), then perform the following
procedures.
//gpsOneXTRA data file can be downloaded to PC (or MCU) from URL
http://xtrapath1.izatcloud.net/xtra2.bin or other URLs listed in Chapter 1.3.
AT+QFUPL="RAM:xtra2.bin",59748,60 //Select a gpsOneXTRA file and upload it to
module via QCOM. For more details about this
command and QCOM tool usage and
configuration,please refer to document [1].
OK
AT+QGPSXTRATIME=0,"2019/01/05,08:30:30",1,1,3500 //Inject gpsOneXTRA time to GNSS engine.
OK
AT+QGPSXTRADATA="RAM:xtra2.bin"
OK //The gpsOneXTRA data file is injected to
GNSS engine successfully.
AT+QFDEL="RAM:xtra2.bin" //Delete gpsOneXTRA data file from UFS.
OK
AT+QGPS=1 //Turn on GNSS engine.
OK

LTE_Standard_GNSS_Application_Note 36 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

4 Summary of Error Codes

The <errcode> indicates an error related to GNSS operation. The details about <errcode> are described
in the following table.

Table 1: Summary of Error Codes

<errcode> Meaning

501 Invalid parameter(s)

502 Operation not supported

503 GNSS subsystem busy

504 Session is ongoing

505 Session not active

506 Operation timeout

507 Function not enabled

508 Time information error

512 Validity time is out of range

513 Internal resource error

514 GNSS locked

515 End by E911

516 Not fixed now

517 CMUX port is not opened

549 Unknown error

LTE_Standard_GNSS_Application_Note 37 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

5 Appendix A References

Table 2: Related Documents

SN Document Name Remark

Quectel_LTE_Standard_FILE_AT_Commands_ File AT Commands Manual for LTE Standard

[1]
Manual Modules

Table 3: Terms and Abbreviations

Abbreviation Description

AGPS Assisted Global Positioning System

APN Access Point Name

BeiDou BeiDou Navigation Satellite System

DOP Dilution of Precision

DPO Dynamic Power Optimization

Galileo Galileo Satellite Navigation System

GGA Global Positioning System Fix Data

GLONASS Global Navigation Satellite System

GNS Global Network Service

GNSS Global Navigation Satellite System

GPS Global Positioning System

gpsOneXTRA An Auxiliary Positioning Technology Provided by Qualcomm

GSA GPS DOP and Active Satellites

GSV Satellites in View

LTE_Standard_GNSS_Application_Note 38 / 39
 LTE Standard Module Series
LTE Standard GNSS Application Note

LPP LTE Positioning Protocol

MCU Micro Control Unit

ME Mobile Equipment

MS Mobile Station

NI Network Initiated

NMEA National Marine Electronics Association

NVRAM Non-Volatile Random Access Memory

ODP On-Demand Positioning

PC Private Computer

RAM Random Access Memory

RMC Recommended Minimum Navigation Information

SI SET Initiated

SNR Signal Noise Ratio

SNTP Simple Network Time Protocol

SSL Secure Sockets Layer

SUPL Secure User Plane Location

TTFF Time to First Fix

UART Universal Asynchronous Receiver & Transmitter

UFS User File System

URL Uniform Resource Locator

USB Universal Serial Bus

UTC Universal Time Code

VTG Course Over Ground and Ground Speed

LTE_Standard_GNSS_Application_Note 39 / 39