Page 1
EC20 GNSS AT Commands Manual LTE Module Series Rev. EC20_GNSS_AT_Commands_Manual_V1.1 Date: 2015-06-09 www.quectel.com...
Page 2
QUECTEL OFFERS THIS 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.
LTE Module Series EC20 GNSS AT Commands Manual About the Document History Revision Date Author Description 2015-02-28 Tommy ZHANG Initial Added <uartdebug> <plane> 2015-06-09 Tommy ZHANG parameters in AT+QGPSCFG command. Deleted AT+QGPSXTRAUPL command. EC20_GNSS_AT_Commands_Manual Confidential / Released 2 / 26...
LTE Module Series EC20 GNSS AT Commands Manual Contents About the Document ........................... 2 Contents ............................... 3 Table Index ..............................4 Introduction ............................5 1.1. How to Use GNSS ........................5 1.2. NMEA Sentences Type ....................... 6 1.3. Introduction of gpsOneXTRA ...................... 6 1.4.
Page 5
LTE Module Series EC20 GNSS AT Commands Manual Table Index TABLE 1: RELATED DOCUMENTS ........................25 TABLE 2: TERMS AND ABBREVIATIONS ......................25 TABLE 3: SUMMARY OF ERROR CODES ...................... 26 EC20_GNSS_AT_Commands_Manual Confidential / Released 4 / 26...
1.1. How to Use GNSS EC20 GNSS engine allows calculating location without any assistance from the network. The procedure of turning on GNSS is shown as below: Step 1: Configure corresponding demands by AT+QGPSCFG.
LTE Module Series EC20 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 two kinds of prefix. For GPS sentences, the prefix is “GP”, as below: ...
Step 6: Others steps see Chapter 1.1. 1.4. GNSS Power Saving Management EC20 GNSS engine provides power saving solutions by DPO and ODP, thus extending battery life, maximizing talk and standby time, and enhancing accuracy and TTFF. 1.4.1. DPO (Dynamic Power Optimization) DPO (Dynamic Power Optimization) is a power-saving solution which attempts to turn off GNSS RF and other unneeded components.
Page 9
LTE Module Series EC20 GNSS AT Commands Manual ODP system requirements: (1) ODP requires valid gpsOneXTRA assistance data. (2) ODP requires that EC20 is in service. If these two requirements are not fulfilled ODP will be turned off automatically. And ODP will be suspended if a regular GNSS fix is running.
LTE Module Series EC20 GNSS AT Commands Manual Description of AT Command 2.1. AT+QGPSCFG Configure GNSS This command can be used to configure the using of GLONASS, switchover of NMEA sentences output port and setting of power saving and so on.
Page 11
LTE Module Series EC20 GNSS AT Commands Manual +CME ERROR: <errcode> When the second parameter is omitted, query the current setting: +QGPSCFG: “nmeasrc”,<nmeasrc> Configure output type of GPS NMEA Response sentences When there are two parameters: AT+QGPSCFG=“gpsnmeatype”[,<gpsn meatype>] If error is related to ME functionality: +CME ERROR: <errcode>...
Page 12
LTE Module Series EC20 GNSS AT Commands Manual Configure ODP mode Response AT+QGPSCFG=“odpcontrol”[,<odpcon When there are two parameters: trol>] If error is related to ME functionality: +CME ERROR: <errcode> When the second parameter is omitted, query the current setting: +QGPSCFG: “odpcontrol”,<odpcontrol>...
Page 13
LTE Module Series EC20 GNSS AT Commands Manual “usbnmea” Output through USB NMEA port “uartdebug” Output through UART DEBUG port <nmeasrc> After enabled, original NMEA sentences acquired AT+QGPSGNMEA, and the setting will be auto saved to NVRAM. Meanwhile, sentences are output through NMEA port as before...
LTE Module Series EC20 GNSS AT Commands Manual 2.2. AT+QGPSDEL Delete Assistance Data Delete assistance data to operate cold start, hot start and warm start. This command can only be executed when GPS engine is turned off. After deleting the assistance data by this command, cold start will be enforced by AT+QGPS, or perform hot/warm start when the hot/warm start condition is permitted.
Page 15
LTE Module Series EC20 GNSS AT Commands Manual AT+QGPS Operate GPS Session Test Command Response AT+QGPS=? +QGPS: (1-4),(1-255),(0-1000),(0-1000),(1-65535) Read current GNSS session state Response AT+QGPS? +QGPS: <gnssstate> Write Command Response AT+QGPS=<gnssmode>[,<fixmaxtim e>[,<fixmaxdist>[,<fixcount>[,<fixrate >]]]] If error is related to ME functionality: +CME ERROR: <errcode>...
LTE Module Series EC20 GNSS AT Commands Manual 2.4. AT+QGPSEND Terminate GNSS Session Turn on GNSS engine by AT+QGPS, when <fixcount> is 0, GNSS engine will fix continuously, you can force to terminate it by AT+QGPSEND. When <fixcount> is not 0, and the actual fix times reach to the specified value, it will terminate automatically.
Page 17
LTE Module Series EC20 GNSS AT Commands Manual Read Command Response AT+QGPSLOC=<mode> +QGPSLOC: <UTC>,<latitude>,<longitude>,<hdop>,<altitude>,<fix>,<c og>,<spkm>,<spkn>,<date>,<nsat> If error is related to ME functionality: +CME ERROR: <errcode> Reference Parameter <mode> Control the latitude and longitude display format 0: <latitude>,<longitude> format: ddmm.mmmmN/S,dddmm.mmmmE/W 1: <latitude>,<longitude> format: ddmm.mmmmmm,N/S,dddmm.mmmmmm,E/W 2: <latitude>,<longitude>...
LTE Module Series EC20 GNSS AT Commands Manual <errcode> Integer type, indicate the error code of the operation. If it is not 0, it is the type of error (Please refer to the Chapter 5). 2.6. AT+QGPSGNMEA Obtain NMEA Sentences Before using this command, GNSS engine must be turned on by AT+QGPS, and enable <nmeasrc>...
LTE Module Series EC20 GNSS AT Commands Manual +CME ERROR: <errcode> Query GSA information Response AT+QGPSGNMEA=“GSA” +QGPSGNMEA: GSA sentence If error is related to ME functionality: +CME ERROR: <errcode> Query VTG information Response AT+QGPSGNMEA=“VTG” +QGPSGNMEA: VTG sentence If error is related to ME functionality: +CME ERROR: <errcode>...
LTE Module Series EC20 GNSS AT Commands Manual Write Command Response AT+QGPSXTRA=<xtraenable>[,<retri es>,<retryInt>,<dloadInt>] If error is related to ME functionality: +CME ERROR: <errcode> Reference Parameter <xtraenable> Enable gpsOneXTRA functionality, the setting will be auto saved to NVRAM. Disable gpsOneXTRA Enable gpsOneXTRA and inject data by manual Enable gpsOneXTRA and automatically inject data <retries>...
LTE Module Series EC20 GNSS AT Commands Manual Inject XTRA time manually Response AT+QGPSXTRATIME=<op>,<xtratime >[,<utc>[,<force>,<uncrtn>]] If error is related to ME functionality: +CME ERROR: <errcode> Reference Parameter <op> Operation type Inject gpsOneXTRA time <xtratime> Current UTC/GPS time, the format of time: YYYY/MM/DD, hh:mm:ss, e.g.2015/01/03,15:34:50.
Integer type, indicate the error code of the operation. If it is not 0, it is the type of error (Please refer to the Chapter 5). 2.10. Introduction of URC EC20 GNSS engine will inform some information via URC. Expired XTRA Data 2.10.1.
Page 23
LTE Module Series EC20 GNSS AT Commands Manual Parameter <xtradatadurtime> Valid time of injected XTRA data, unit: minute. No XTRA file or XTRA file is expired <injecteddatatime> Starting time valid time XTRA data, format: “YYYY/MM/DD,hh:mm:ss”, e.g.“2015/01/03,15:34:50” EC20_GNSS_AT_Commands_Manual Confidential / Released...
LTE Module Series EC20 GNSS AT Commands Manual Example 3.1. Turn On and Off the GNSS Engine The example uses default arguments to start GNSS engine, after turning on GNSS engine, NMEA sentences will be outputted from “usbnmea” port by default.
LTE Module Series EC20 GNSS AT Commands Manual 3.3. Example of Injecting gpsOneXTRA You must enable gpsOneXTRA before injecting gpsOneXTRA time and data to GNSS engine. In this example we manually download the XTRA file, then upload to UFS via AT+QGPSXTRAUPL.
LTE Module Series EC20 GNSS AT Commands Manual Appendix A Reference Table 1: Related Documents Document name Remark Quectel_EC20_AT_Commands_Manual EC20 AT commands sets Table 2: Terms and Abbreviations Abbreviation Description GNSS Global Navigation Satellite Systems Global Positioning System provides by USA...
LTE Module Series EC20 GNSS AT Commands Manual Appendix B Summary of Error Codes The error code <errcode> indicates an error related to GNSS operations. The detail about <errcode> is described in the following table. Table 3: Summary of Error Codes <errcode>...
Need help?
Do you have a question about the EC20 GNSS and is the answer not in the manual?
Questions and answers