Quectel EC25&EC21 GNSS AT Commands Manual V1.1

Quectel_EC25%26EC21_GNSS_AT_Commands_Manual_V1.1

Quectel_EC25%26EC21_GNSS_AT_Commands_Manual_V1.1

Quectel_EC25%26EC21_GNSS_AT_Commands_Manual_V1.1

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 30

DownloadQuectel EC25&EC21 GNSS AT Commands Manual V1.1
Open PDF In BrowserView PDF
EC25&EC21 GNSS
AT Commands Manual
LTE Module Series
Rev. EC25&EC21_GNSS_AT_Commands_Manual_V1.1
Date: 2017-02-13

www.quectel.com

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233
Tel: +86 21 5108 6236
Email: info@quectel.com

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

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

http://www.quectel.com/support/salesupport.aspx

For technical support, or to report documentation errors, please visit:
http://www.quectel.com/support/techsupport.aspx
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 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. 2017. All rights reserved.

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

1 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

About the Document
History
Revision
1.0

Date

Author

Description

2016-09-02

Sundy WANG

Initial

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
1.

1.1

2017-02-13

Sundy WANG

2.

3.

EC25&EC21_GNSS_AT_Commands_Manual

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)
Modified the parameter description of
AT+QGPSCFG=“outport”[,]
(Chapter 2.1.1)
Modified the parameter description of
AT+QGPSDEL (Chapter 2.2)

Confidential / Released

2 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Contents
About the Document ................................................................................................................................ 2
Contents .................................................................................................................................................... 3
Table Index ............................................................................................................................................... 4
1

Introduction ....................................................................................................................................... 5
1.1. GNSS Turning on/off Procedures ............................................................................................. 5
1.2. NMEA Sentences Type ............................................................................................................. 6
1.3. Introduction of gpsOneXTRA Assistance .................................................................................. 6

2

Description of GNSS AT Commands ............................................................................................... 8
2.1. AT+QGPSCFG GNSS Configurations ................................................................................... 8
2.1.1. AT+QGPSCFG=“outport”[,] Configure NMEA Sentences Output Port....... 8
2.1.2. AT+QGPSCFG=“nmeasrc”[,]
Enable/Disable Acquisition of NMEA
Sentences via AT+QGPSGNMEA ................................................................................................ 9
2.1.3. AT+QGPSCFG=“gpsnmeatype”[,] Configure Output Type of GPS
NMEA Sentences ....................................................................................................................... 10
2.1.4. AT+QGPSCFG=“glonassnmeatype”[,] Configure Output Type of
GLONASS NMEA Sentences......................................................................................................11
2.1.5. AT+QGPSCFG=“galileonmeatype”[,] Configure Output Type of
Galileo NMEA Sentences ............................................................................................................11
2.1.6. AT+QGPSCFG=“beidounmeatype”[,] Configure Output Type of
BeiDou NMEA Sentences .......................................................................................................... 12
2.1.7. AT+QGPSCFG=“gsvextnmeatype”[,]
Enable/Disable Output of
GSVEXT NMEA Sentences ....................................................................................................... 13
2.1.8. AT+QGPSCFG=“gnssconfig”[,]
Configure
Supported
GNSS
Constellation .............................................................................................................................. 14
2.1.9. AT+QGPSCFG=“autogps”[,] Enable/Disable GNSS to Run Automatically 15
2.2. AT+QGPSDEL Delete Assistance Data ............................................................................... 15
2.3. AT+QGPS Turn on GNSS .................................................................................................... 16
2.4. AT+QGPSEND Turn off GNSS ............................................................................................ 18
2.5. AT+QGPSLOC Acquire Positioning Information .................................................................. 18
2.6. AT+QGPSGNMEA Acquire NMEA Sentences ..................................................................... 20
2.7. AT+QGPSXTRA Enable gpsOneXTRA Assistance Function ............................................... 21
2.8. AT+QGPSXTRATIME Inject gpsOneXTRA Time ................................................................. 22
2.9. AT+QGPSXTRADATA Inject gpsOneXTRA Data File .......................................................... 23

3

Examples ......................................................................................................................................... 25
3.1. Turn on and off the GNSS ...................................................................................................... 25
3.2. Application of GNSS  ............................................................................................ 25
3.3. Operation Procedures of gpsOneXTRA Assistance Function ................................................. 26

4
5

Appendix A References .................................................................................................................. 27
Appendix B Summary of Error Codes ........................................................................................... 29

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

3 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Table Index
TABLE 1: RELATED DOCUMENTS .................................................................................................................. 27
TABLE 2: TERMS AND ABBREVIATIONS ........................................................................................................ 27
TABLE 3: SUMMARY OF ERROR CODES ...................................................................................................... 29

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

4 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

1

Introduction

Quectel EC25/EC21 module integrates a GNSS engine which supports GPS, BeiDou, Galileo and
GLONASS systems, and also it supports gpsOneXTRA Assistance technology. The high performance
GNSS engine is suitable for various applications where lowest-cost and accurate positioning is needed,
and it supports position tracking without network assistance. EC25/EC21 GNSS can be applied in the
following applications: turn-by-turn navigation, asset tracking, buddy tracking, location-aware games, as
well as home and fleet management.

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

1.1. GNSS Turning on/off Procedures

EC25/EC21 GNSS 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 three ways:
1) NMEA sentences are output to "usbnmea" port by default; customers can read the port to obtain
NMEA sentences.
2)

Customers can use AT+QGPSLOC to obtain positioning information directly, such as latitude,
longitude, height, GNSS positioning mode, time, number of satellites, and so on.

3)

After enabling  via AT+QGPSCFG=“nmeasrc”,1, customers can acquire the
specified NMEA sentence via AT+QGPSGNMEA. If  is disabled, this command
cannot be used.

Step 4: GNSS can be turned off in two ways:
1) If the parameter  of AT+QGPS is set to 0 in Step 2, GNSS will get position
continuously, and it can be turned off via AT+QGPSEND.
2) If  reaches the specified value, the GNSS will stop automatically.

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

5 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

1.2. NMEA Sentences Type
The NMEA sentences are compatible with NMEA-0183 Protocol, and all of the standard NMEA sentences
have four kinds of prefix.
For GPS sentences, the prefix is “GP”, as below:
 GPGGA - Global positioning system fix data, such as time, position, etc.
 GPRMC - Recommended minimum data
 GPGSV - Detailed satellite data
 GPGSA - Overall satellite data
 GPVTG - Vector track and speed over the ground

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

For GLONASS sentences, the prefixes are "GL" and "GN", as below:
 GLGSV - Detailed satellite data
 GNGSA - Overall satellite data
 GNGNS - Positioning system
For Galileo sentences, the prefixes are "GA" and "GN", as below:
 GAGSV - Detailed satellite data
 GNGSA - Overall satellite data
 GNGNS - Positioning system
For BeiDou sentences, the prefix is "PQ", as below:
 PQGSV - Detailed satellite data
 PQGSA - Overall satellite data

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 18~30s (or more in harsh environments with weak signals). The assistance data which is obtained
from one of the gpsOneXTRA Assistance web servers on the network needs to be updated once a day (or
every couple of days).
Before using this function, customers need to ensure that the valid gpsOneXTRA assistance data is
available first. They need to download a new gpsOneXTRA binary file which contains the data from one of
the gpsOneXTRA Assistance web servers via URLs listed below. The files named as xtra.bin are for GPS
only and the files named as xtra2.bin are for GPS+GLONASS. The exact file size should be less than
50kB.

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

6 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

http://xtrapath1.izatcloud.net/xtra.bin
http://xtrapath2.izatcloud.net/xtra.bin
http://xtrapath3.izatcloud.net/xtra.bin
http://xtrapath1.izatcloud.net/xtra2.bin
http://xtrapath2.izatcloud.net/xtra2.bin
http://xtrapath3.izatcloud.net/xtra2.bin
gpsOneXTRA assistance data needs to be updated regularly. Customers can query the status of
gpsOneXTRA data file via AT+QGPSXTRADATA? and then update the data properly.
The operation procedures of gpsOneXTRA Assistance function are shown as follows:

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

Step 1: If gpsOneXTRA Assistance is disabled, enable it first via AT+QGPSXTRA and restart the module
to activate the function.

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 as the
procedures described in Chapter 1.1 directly.
Step 3: Download file xtra.bin or xtra2.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 as the procedures described in Chapter 1.1.
For more detailed information of the AT commands, please refer to Chapter 2.7, 2.8 and 2.9.

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

7 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

2

Description of GNSS AT Commands

2.1. AT+QGPSCFG

GNSS Configurations

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

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

AT+QGPSCFG
Test Command

GNSS Configurations

AT+QGPSCFG=?

Response

+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: “gsvextnmeatype”,(0,1)
+QGPSCFG: “gnssconfig”,(0-6)
+QGPSCFG: “autogps”,(0,1)
OK

Reference

2.1.1. AT+QGPSCFG=“outport”[,]
Port

AT+QGPSCFG=“outport”[,]
Write Command

AT+QGPSCFG=“outport”[,]

Configure NMEA Sentences Output

Configure NMEA Sentences Output Port

Response
When there are two parameters:
OK

When the second parameter is omitted, query the current
setting:
+QGPSCFG: “outport”,

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

8 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

OK
If error is related to ME functionality:
+CME ERROR: 
Reference

Parameter




Configure the output port of NMEA sentences, and the configuration parameter
will be automatically saved to NVRAM.
“none”
Close NMEA sentence output
“usbnmea”
Output via USB NMEA port
“uartdebug”
Output via UART debug port

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
Integer type, indicates the error code of the operation. If it is not 0, it is the type
of error (Please refer to Chapter 5 for details).

2.1.2. AT+QGPSCFG=“nmeasrc”[,]

Enable/Disable Acquisition of NMEA

Sentences via AT+QGPSGNMEA

The command enables/disables acquisition of NMEA sentences via AT+QGPSGNMEA.

AT+QGPSCFG=“nmeasrc”[,]
Sentences via AT+QGPSGNMEA
Write Command

AT+QGPSCFG=“nmeasrc”[,]

Enable/Disable Acquisition of NMEA

Response
When there are two parameters:
OK

When the second parameter is omitted, query the current
setting:
+QGPSCFG: “nmeasrc”,
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter


After being enabled, original NMEA sentences can be acquired via
AT+QGPSGNMEA, and the configuration parameter will be automatically

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

9 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

saved to NVRAM. Meanwhile, sentences are output via the same NMEA ports
as before.
0
Disable
1
Enable


Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

2.1.3. AT+QGPSCFG=“gpsnmeatype”[,]

Configure Output Type of

GPS NMEA Sentences

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

AT+QGPSCFG=“gpsnmeatype”[,]
NMEA Sentences
Write Command

AT+QGPSCFG=“gpsnmeatype”[,]

Configure Output Type of GPS

Response
When there are two parameters:
OK

When the second parameter is omitted, query the current
setting:
+QGPSCFG: “gpsnmeatype”,
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter





Output type of GPS NMEA sentences by ORed, and the configuration
parameter will be automatically saved to NVRAM. The default value is 31
which means that all the five types of sentences will be output.
0
Disable
1
GGA
2
RMC
4
GSV
8
GSA
16
VTG

Integer type, indicates the error code of the operation. If it is not 0, it is the type
of error (Please refer to Chapter 5 for details).

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

10 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

2.1.4. AT+QGPSCFG=“glonassnmeatype”[,]

Configure Output

Type of GLONASS NMEA Sentences
AT+QGPSCFG=“glonassnmeatype”[,]
of GLONASS NMEA Sentences
Write Command
AT+QGPSCFG=“glonassnmeatype”[,
]

Configure Output Type

Response
When there are two parameters:
OK
When the second parameter is omitted, query the current
setting:

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
+QGPSCFG: “glonassnmeatype”,
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter



Configure output type of GLONASS NMEA sentences by ORed, and the
configuration parameter will be automatically saved to NVRAM. The default
value is 0.
0
Disable
1
GSV
2
GSA
4
GNS



Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

2.1.5. AT+QGPSCFG=“galileonmeatype”[,]

Configure Output

Type of Galileo NMEA Sentences

AT+QGPSCFG=“galileonmeatype”[,]
Galileo NMEA Sentences
Write Command
AT+QGPSCFG=“galileonmeatype”[,<
galileonmeatype>]

Configure Output Type of

Response
When there are two parameters:
OK

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

11 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

When the second parameter is omitted, query the current
setting:
+QGPSCFG: “galileonmeatype”,
OK
If error is related to ME functionality:
+CME ERROR: 
Reference

Parameter

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C



Configure output type of Galileo NMEA sentences by ORed, and the
configuration parameter will be automatically saved to NVRAM. The default
value is 0.
0
Disable
1
GSV



Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

2.1.6. AT+QGPSCFG=“beidounmeatype”[,]

Configure Output

Type of BeiDou NMEA Sentences

AT+QGPSCFG=“beidounmeatype”[,]
BeiDou NMEA Sentences
Write Command

AT+QGPSCFG=“beidounmeatype”[,<
beidounmeatype>]

Configure Output Type of

Response
When there are two parameters:
OK

When the second parameter is omitted, query the current
setting:
+QGPSCFG: “beidounmeatype”,
OK

If error is related to ME functionality:
+CME ERROR: 
Reference

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

12 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Parameter


Configure output type of BeiDou NMEA sentences via ORed, and the
configuration parameter will be automatically saved to NVRAM. The default
value is 0.
0
Disable
1
GSA
2
GSV



Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

2.1.7. AT+QGPSCFG=“gsvextnmeatype”[,]

Enable/Disable

Output of GSVEXT NMEA Sentences

AT+QGPSCFG=“gsvextnmeatype”[,]
GSVEXT NMEA Sentences
Write Command

AT+QGPSCFG=“gsvextnmeatype”[,<
gsvextnmeatype>]

Enable/Disable Output of

Response
When there are two parameters:
OK

When the second parameter is omitted, query the current
setting:
+QGPSCFG: “gsvextnmeatype”,
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter



Enable/disable output of extended GSV information. Elevation/Azimuth/SNR
(C/No) will be displayed as decimals when extended information is enabled,
otherwise they will be displayed as integers. The configuration parameter will
be automatically saved to NVRAM. The default value is 0.
0
Disable
1
Enable



Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

13 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

2.1.8. AT+QGPSCFG=“gnssconfig”[,]

Configure Supported GNSS

Constellation
AT+QGPSCFG=“gnssconfig”[,]
Constellation
Write Command
AT+QGPSCFG=“gnssconfig”[,]

Configure Supported GNSS

Response
When there are two parameters:
OK
When the second parameter is omitted, query the current
setting:

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
+QGPSCFG: “gnssconfig”,
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter




Supported GNSS constellation.
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

Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

14 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

2.1.9. AT+QGPSCFG=“autogps”[,]

Enable/Disable GNSS to Run

Automatically
AT+QGPSCFG=“autogps”[,]
Write Command
AT+QGPSCFG=”autogps”[,]

Enable/Disable GNSS to Run Automatically

Response
When there are two parameters:
OK
When the second parameter is omitted, query the current
setting:

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
+QGPSCFG: “autogps”,
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter




NOTE

Enable/disable GNSS to run automatically after the module is powered on.
Configuration parameter will be automatically saved to NVRAM. The default
value is 0.
0
Disable GNSS to run automatically
1
Enable GNSS to run automatically

Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

The command is only valid in Stand-alone Solution.

2.2. AT+QGPSDEL Delete Assistance Data
Delete assistance data 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, cold start of
GNSS can be enforced via AT+QGPS. Hot/warm start can also be performed if the corresponding
conditions are satisfied.

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

15 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

AT+QGPSDEL Delete Assistance Data
Test Command

Response

AT+QGPSDEL=?

+QGPSDEL: (0-3)
OK

Write Command

Response

AT+QGPSDEL=

OK
If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter


l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
Delete data types of GNSS
0 Delete all assistance data except gpsOneXTRA 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.



Integer type, indicates the error code of the operation. If it is not 0, it is the type of error
(Please refer to Chapter 5 for details).

2.3. AT+QGPS

Turn on GNSS

The command is used to turn on GNSS function. Currently  only supports turning on GNSS
in Stand-alone Solution. When  is 0, GNSS will fix position continuously, and it can be turned
off via AT+QGPSEND. When  is non-zero and reaches the specified value, GNSS will be
turned off automatically.

AT+QGPS

Turn on GNSS

Test Command

Response

AT+QGPS=?

+QGPS: (1-4),(1-255),(1-1000),(0-1000),(1-65535)
OK

Read Command
Read current GNSS state

Response
+QGPS: 

AT+QGPS?

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

16 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

OK
Write Command

Response

AT+QGPS=[,[,[,[,]]]]

OK
If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter












l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
GNSS state
0
GNSS OFF
1
GNSS ON

GNSS working mode
1
Stand-alone
2
MS-based
3
MS-assisted
4
Speed-optimal

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
Accuracy threshold of positioning. Unit: m.
1-50-1000

Number of attempts for positioning
0–1000
0 indicates continuous positioning. Non-zero values indicate the
actual number of attempts for positioning.
The interval time between the first and second time positioning. Unit: s.
1–65535

Integer type, indicates the error code of the operation. If it is not 0, it is the type of
error (Please refer to Chapter 5 for details).

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

17 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

2.4. AT+QGPSEND

Turn off GNSS

When GNSS is turned on and  is 0, GNSS fixes position continuously. In this case, GNSS can
be turned off compulsorily via AT+QGPSEND. When  is non-zero, GNSS will be turned off
automatically when the parameter reaches the specified value, and thus the command can be ignored.

AT+QGPSEND

Turn off GNSS

Test Command

Response

AT+QGPSEND=?
OK

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

Execution Command

Response

AT+QGPSEND

OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter


Integer type, indicates the error code of the operation. If it is not 0, it is the type of
error (Please refer to Chapter 5 for details).

2.5. AT+QGPSLOC

Acquire Positioning Information

Before executing the command, GNSS must be turned on via AT+QGPS. If it fails in position fix, +CME
ERROR:  will be returned to indicate the corresponding situation.

AT+QGPSLOC
Test Command

Acquire Positioning Information

AT+QGPSLOC=?

Response

+QGPSLOC:
,,,,,,,,,,
OK

Write Command

Response

AT+QGPSLOC=

+QGPSLOC:
,,,,,,,,,,

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

18 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

OK
If error is related to ME functionality:
+CME ERROR: 
Reference

Parameter















Latitude and longitude display format
0: , format: ddmm.mmmm N/S,dddmm.mmmm E/W
1: , format: ddmm.mmmmmm N/S,dddmm.mmmmmm E/W
2: , format: (-)dd.ddddd,(-)ddd.ddddd

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
UTC time
Format: hhmmss.sss (Quoted from GPGGA sentence).

Latitude
Format: ddmm.mmmm N/S (Quoted from GPGGA sentence).
dd
00-89 (degree)
mm.mmmm
00.0000-59.9999 (minute)
N/S
North latitude/South latitude

Longitude
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

Horizontal precision: 0.5-99.9 (Quoted from GPGGA sentence).
The altitude of the antenna away from the sea level (unit: m), accurate to one decimal
place (Quoted from GPGGA sentence)
GNSS positioning mode (Quoted from GNGSA/GPGSA sentence).
2
2D positioning
3
3D positioning

Course Over Ground based on true north.
Format: ddd.mm (Quoted from GPVTG sentence).
ddd
000-359 (degree)
mm
00-59 (minute)

Speed over ground.
Format: xxxx.x; unit: Km/h; accurate to one decimal place (Quoted from GPVTG
sentence).



Speed over ground.
Format: xxxx.x; unit: knots; accurate to one decimal place (Quoted from GPVTG
sentence).



UTC time when fixing position.
Format: ddmmyy (Quoted from GPRMC sentence).



Number of satellites, from 00 (The first 0 should be retained) to 12 (Quoted from

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

19 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

GPGGA sentence).


Integer type, indicates the error code of the operation. If it is not 0, it is the type of
error (Please refer to Chapter 5 for details).

2.6. AT+QGPSGNMEA Acquire NMEA Sentences
Before using this command, GNSS must be turned on via AT+QGPS, and  has to enabled via
AT+QGPSCFG=“nmeasrc”,1.

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

If parameters , ,  and  are
all 0, the command can be used to acquire NMEA sentences. If the GNSS has already acquired
sentences via this command after its activation, customers can disable sentences output via
AT+QGPSCFG=“gpsnmeatype”/“glonassnmeatype”/“galileonmeatype”/“beidounmeatype”,0.
Then the sentences obtained via AT+QGPSGNMEA are the last sentences.

AT+QGPSGNMEA Acquire NMEA Sentences
Test Command

AT+QGPSGNMEA=?

Response

+QGPSGNMEA:
(“GGA”,“RMC”,“GSV”,“GSA”,“VTG”,“GNS”)
OK

Inquiry Command
Query GGA information

Response

+QGPSGNMEA: GGA sentence

AT+QGPSGNMEA=“GGA”

OK

If error is related to ME functionality:
+CME ERROR: 

Inquiry Command
Query RMC information

Response

+QGPSGNMEA: RMC sentence

AT+QGPSGNMEA=“RMC”

OK

If error is related to ME functionality:
+CME ERROR: 

Inquiry Command
Query GSV information

Response
+QGPSGNMEA: GSV sentence

AT+QGPSGNMEA=“GSV”
OK
If error is related to ME functionality:
+CME ERROR: 

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

20 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Inquiry Command
Query GSA information

Response
+QGPSGNMEA: GSA sentence

AT+QGPSGNMEA=“GSA”
OK
If error is related to ME functionality:
+CME ERROR: 
Inquiry Command
Query VTG information

Response
+QGPSGNMEA: VTG sentence

AT+QGPSGNMEA=“VTG”
OK

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
If error is related to ME functionality:
+CME ERROR: 

Inquiry Command
Query GNS information

Response

+QGPSGNMEA: GNS sentence

AT+QGPSGNMEA=“GNS”

OK

If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter


Integer type, indicates the error code of the operation. If it is not 0, it is the type of error
(Please refer to Chapter 5 for details).

2.7. AT+QGPSXTRA Enable gpsOneXTRA Assistance Function

This command can be used to enable gpsOneXTRA Assistance function, and the function can be
activated after restarting the module.

AT+QGPSXTRA Enable gpsOneXTRA Assistance Function
Test Command

Response

AT+QGPSXTRA=?

+QGPSXTRA: (0,1)
OK

Read Command

Response

AT+QGPSXTRA?

+QGPSXTRA: 

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

21 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

OK
Write Command

Response

AT+QGPSXTRA=

OK
If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter




l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
Enable gpsOneXTRA Assistance function, and the configuration parameter will be
automatically saved to NVRAM.
0
Disable gpsOneXTRA Assistance
1
Enable gpsOneXTRA Assistance

Integer type, indicates the error code of the operation. If it is not 0, it is the type of error
(Please refer to Chapter 5 for details).

2.8. AT+QGPSXTRATIME

Inject gpsOneXTRA Time

This command can be used to inject gpsOneXTRA time to GNSS engine. Before using it, customers must

enable gpsOneXTRA Assistance function 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.

AT+QGPSXTRATIME
Test Command

Inject gpsOneXTRA Time

AT+QGPSXTRATIME=?

Response

+QGPSXTRATIME: 0,,(0,1),(0,1),
OK

Write Command
Inject gpsOneXTRA time

AT+QGPSXTRATIME=,[,[,,]]

Response
OK

If error is related to ME functionality:
+CME ERROR: 

Reference

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

22 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Parameter


Operation type
0
Inject gpsOneXTRA time



Current UTC/GPS time
Format: YYYY/MM/DD,hh:mm:ss. e.g. 2016/01/03,15:34:50.



The type of time
0
GPS time
1
UTC time



Allow or force GPS subsystem to accept the time injected
0
Allow acceptance
1
Force acceptance





l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
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. If the set time is less than 3.5s, it will be counted
as 3.5s.

Integer type, indicates the error code of the operation. If it is not 0, it is the type of
error (Please refer to Chapter 5 for details).

2.9. AT+QGPSXTRADATA Inject gpsOneXTRA Data File

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

AT+QGPSXTRADATA Inject gpsOneXTRA Data File
Test Command

AT+QGPSXTRADATA=?

Response

+QGPSXTRADATA: 
OK

Read Command
Query the status of gpsOneXTRA data
file

Response

+QGPSXTRADATA:
,

AT+QGPSXTRADATA?
OK
If error is related to ME functionality:
+CME ERROR: 

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

23 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

Write Command
Inject gpsOneXTRA data file
AT+QGPSXTRADATA=

Response
OK
If error is related to ME functionality:
+CME ERROR: 

Reference

Parameter



Filename of the gpsOneXTRA data file, e.g. xtra.bin or xtra2.bin.
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



Starting time of the valid time of gpsOneXTRA data file
Format: YYYY/MM/DD,hh:mm:ss, e.g. 2016/01/03,15:34:50.



Integer type, indicates the error code of the operation. If it is not 0, it is the
type of error (Please refer to Chapter 5 for details).

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

24 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

3

Examples

3.1. Turn on and off the GNSS

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

Default arguments are used in this example to turn on GNSS. After turning on GNSS, NMEA sentences
will be output from “usbnmea” port by default; and GNSS can be turned off via AT+QGPSEND.
AT+QGPS=1
OK

//Turn on GNSS.

//After turning on GNSS, NMEA sentences will be output 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
OK

//Turn off GNSS.

3.2. Application of GNSS 

When GNSS is turned on and  is enabled, NMEA sentences can be acquired directly via
AT+QGPSGNMEA.
AT+QGPSCFG=“nmeasrc”,1
//Enable  functionality.
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
OK
AT+QGPSGNMEA=“GGA”

//Disable  functionality.
//Disable  functionality, and thus GGA sentence
cannot be obtained.

+CME ERROR: 507

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

25 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

3.3. Operation Procedures of gpsOneXTRA Assistance Function
This example shows the operation procedures of gpsOneXTRA Assistance function.
//If gpsOneXTRA Assistance is disabled, enable it via AT+QGPSXTRA=1 and restart the mdoule, then
perform the following procedures.
AT+QGPSXTRA=1
OK

//Enable gpsOneXTRA Assistance.

//The gpsOneXTRA Assistance function is activated after restarting the module.

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

//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.
//Customers can download the gpsOneXTRA data file to PC (or
http://xtrapath1.izatcloud.net/xtra2.bin or other URLs listed in Chapter 1.3.
AT+QFUPL="RAM:xtra2.bin",59748,60

OK
AT+QGPSXTRATIME=0,“2015/01/03,15:30:30”,1,1,5
OK
AT+QGPSXTRADATA=“RAM:xtra2.bin,59748,60”
OK
AT+QFDEL=“RAM:xtra2.bin”
OK
AT+QGPS=1
OK

EC25&EC21_GNSS_AT_Commands_Manual

MCU)

from

URL

//Select the gpsOneXTRA file and upload it to
module via QCOM. For more details about
this command, please refer to document
[2]. And for more details about QCOM tool
usage and configuration, please refer to
document [3].

//Inject gpsOneXTRA time to GNSS engine.

//Inject gpsOneXTRA data file to GNSS engine
successfully.
//Delete gpsOneXTRA data file from RAM file

//Turn on GNSS engine

Confidential / Released

26 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

4

Appendix A References

Table 1: Related Documents
SN

Document name

Remark

[1]

Quectel_EC25&EC21_AT_Commands_Manual

EC25&EC21 AT commands manual

[2]

Quectel_EC25&EC21_FILE_Application_Note

EC25&EC21 FILE application note

[3]

Quectel_QCOM_User_Guide

QCOM user guide

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

Table 2: Terms and Abbreviations
Abbreviation
BeiDou
Galileo
GGA
GLONASS
GNS
GNSS
GPS
gpsOneXTRA
GSA
GSV

Description

BeiDou Navigation Satellite System
Galileo Satellite Navigation System

Global Positioning System Fix Data
Global Navigation Satellite System
Global Network Service

Global Navigation Satellite System
Global Positioning System

An Auxiliary Positioning Technology Provided by Qualcomm
GPS DOP and Active Satellites
Satellites in View

MCU

Micro Control Unit

ME

Mobile Equipment

MS

Mobile Station

NMEA

National Marine Electronics Association

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

27 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

NVRAM

Non-Volatile Random Access Memory

PC

Private Computer

RAM

Random Access Memory

RMC

Recommended Minimum Navigation Information

SNR

Signal Noise Ratio

SNTP

Simple Network Time Protocol

TTFF

Time to First Fix

UART
URL
USB
UTC
VTG

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
Universal Asynchronous Receiver & Transmitter
Uniform Resource Locator
Universal Serial Bus

Universal Time Code

Track Made Good and Ground Speed

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

28 / 29

LTE Module Series
EC25&EC21 GNSS AT Commands Manual

5

Appendix B Summary of Error Codes

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

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

Table 3: Summary of Error Codes

501
502
503
504
505
506
507
508
512
513
514
515
516
549

Meaning

Invalid parameter(s)

Operation not supported
GNSS subsystem busy
Session is ongoing
Session not active
Operation timeout

Function not enabled

Time information error

Validity time is out of range
Internal resource error
GNSS locked
End by E911

Not fixed now

Unknown error

EC25&EC21_GNSS_AT_Commands_Manual

Confidential / Released

29 / 29
Source Exif Data: 
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.6
Linearized                      : No
Encryption                      : Standard V4.4 (128-bit)
User Access                     : Print, Copy, Extract, Print high-res
Author                          : Windows 用户
Create Date                     : 2017:02:13 10:04:47+08:00
Modify Date                     : 2017:02:13 10:33:10+08:00
Has XFA                         : No
Language                        : zh-CN
XMP Toolkit                     : Adobe XMP Core 4.2.1-c041 52.342996, 2008/05/07-20:48:00
Format                          : application/pdf
Creator                         : Windows 用户
Creator Tool                    : Microsoft® Word 2010
Metadata Date                   : 2017:02:13 10:33:10+08:00
Producer                        : Microsoft® Word 2010
Document ID                     : uuid:827935d2-9b73-44cd-9a39-d8cdcebd5ad4
Instance ID                     : uuid:3d02a228-5b8b-4f0c-a3d4-38b01eea0199
Page Mode                       : UseOutlines
Page Count                      : 30
EXIF Metadata provided by EXIF.tools

Navigation menu