background image

                                                                                                                                                                           

LTE  Module  Series 

                                                                                        EP06&EG06&EM06  GNSS  AT  Commands  Manual

 

EP06&EG06&EM06_GNSS_AT_Commands_Manual                       

          

                              21 / 29 

 
 
 

Parameter 

 

2.7. AT+QGPSXTRA    Enable gpsOneXTRA Assistance Function 

 

This  command  can  be  used  to  enable  gpsOneXTRA  Assistance  function,  and  it  will  take  effect 

immediately. 

Write Command   

Query GSA sentence 

AT+QGPSGNMEA="GSA"

 

Response 

+QGPSGNMEA: GSA sentence 

 

OK 

 

If there is any error related to ME functionality: 

+CME ERROR: <errcode>

 

Write Command   

Query VTG sentence 

AT+QGPSGNMEA="VTG"

 

Response 

+QGPSGNMEA: VTG sentence 

 

OK 

 

If there is any error related to ME functionality: 

+CME ERROR: <errcode>

 

Write Command   

Query GNS sentence 

AT+QGPSGNMEA="GNS" 

Response 

+QGPSGNMEA: GNS sentence 

 

OK 

 

If there is any error related to ME functionality: 

+CME ERROR: <errcode>

 

Reference 

 

<errcode>         

  Integer type. The error code of the operation. If it is not 0, it is the type of error. Please 

refer to 

Chapter 4

 for details. 

AT+QGPSXTRA    Enable gpsOneXTRA Assistance Function 

Test Command 

AT+QGPSXTRA=? 

Response 

+QGPSXTRA: (0,1) 

 

OK 

Read Command 

AT+QGPSXTRA? 

Response 

+QGPSXTRA: <xtraenable> 

Summary of Contents for LTE EG06

Page 1: ...EP06 EG06 EM06 GNSS AT Commands Manual LTE Module Series Rev EP06 EG06 EM06_GNSS_AT_Commands_Manual_V1 0 Date 2018 04 11 Status Released www quectel com ...

Page 2: ...E 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 CHANG...

Page 3: ...LTE Module Series EP06 EG06 EM06 GNSS AT Commands Manual EP06 EG06 EM06_GNSS_AT_Commands_Manual 2 29 About the Document History Revision Date Author Description 1 0 2018 04 11 Amos ZHANG Initial ...

Page 4: ...onfigure 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 Constellations 14 2 1 9 AT QGPSCFG autogps Enable Disable GNSS to Run Automatically 14 2 2 AT QGPSDEL Delete Assistance Data 15 2 3 A...

Page 5: ...Module Series EP06 EG06 EM06 GNSS AT Commands Manual EP06 EG06 EM06_GNSS_AT_Commands_Manual 4 29 Table Index TABLE 1 SUMMARY OF ERROR CODES 27 TABLE 2 RELATED DOCUMENTS 28 TABLE 3 TERMS AND ABBREVIATIONS 28 ...

Page 6: ...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 outputted to usbnmea port by default Customers can read the port to obtain NMEA sentences 2 AT QGPSLOC can be u...

Page 7: ... 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 Fi...

Page 8: ...n are shown as follows Step 1 If gpsOneXTRA Assistance is disabled enable it first via AT QGPSXTRA and it will take effect immediately 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 file xtra2 ...

Page 9: ...ces Output Port AT QGPSCFG GNSS Configurations Test Command 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 AT QGPSCFG outport Configure NMEA Sentences Output Port Write Command ...

Page 10: ...tput via USB NMEA port uartdebug Output via debug UART port errcode Integer type The error code of the operation If it is not 0 it is the type of error Please refer to Chapter 4 for details AT QGPSCFG nmeasrc Enable Disable Acquisition of NMEA Sentences via AT QGPSGNMEA Write Command AT QGPSCFG nmeasrc nmeasrc Response When there are two parameters OK When the second parameter is omitted query the...

Page 11: ...QGPSCFG gpsnmeatype gps nmeatype Response When there are two parameters OK When the second parameter is omitted query the current setting QGPSCFG gpsnmeatype gpsnmeatype OK If there is any error related to ME functionality CME ERROR errcode Reference gpsnmeatype Output type of GPS NMEA sentences by ORed and the configuration parameter will be automatically saved to NVRAM The default value is 31 wh...

Page 12: ... parameter is omitted query the current setting QGPSCFG glonassnmeatype glonassnmeatype OK If there is any error related to ME functionality CME ERROR errcode Reference glonassnmeatype 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 errcode Integer type The error code of ...

Page 13: ...alileo NMEA sentences by ORed and the configuration parameter will be automatically saved to NVRAM The default value is 0 0 Disable 1 GSV errcode Integer type The error code of the operation If it is not 0 it is the type of error Please refer to Chapter 4 for details AT QGPSCFG beidounmeatype Configure Output Type of BeiDou NMEA Sentences Write Command AT QGPSCFG beidounmeatype beidounmeatype Resp...

Page 14: ...ble Output of GSVEXT NMEA Sentences Write Command AT QGPSCFG gsvextnmeatype gsvextnmeatype Response When there are two parameters OK When the second parameter is omitted query the current setting QGPSCFG gsvextnmeatype gsvextnmeatype OK If there is any error related to ME functionality CME ERROR errcode Reference gsvextnmeatype Enable disable output of extended GSV information Elevation Azimuth SN...

Page 15: ...any error related to ME functionality CME ERROR errcode Reference gnssconfig 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 errcode Integer type The err...

Page 16: ...he corresponding conditions are satisfied QGPSCFG autogps autogps OK If there is any error related to ME functionality CME ERROR errcode Reference autogps Enable disable GNSS to run automatically after the module is powered on and the 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 errcode In...

Page 17: ...OneXTRA 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 the operation If it is not 0 it is the type of err...

Page 18: ...eceiver 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 fixmaxdist Accuracy threshold of positioning Unit m 1 50 1000 fixcount Number of attempts for positioning 0 1000 0 indicates continuous positioning Non zero values indicate the...

Page 19: ...and AT QGPSLOC Response QGPSLOC UTC latitude longitude hdop altit ude fix cog spkm spkn date nsat OK Write Command AT QGPSLOC mode Response QGPSLOC UTC latitude longitude hdop altit ude fix cog spkm spkn date nsat OK If there is any error related to ME functionality CME ERROR errcode Reference mode Latitude and longitude display format 0 latitude longitude format ddmm mmmm N S dddmm mmmm E W 1 lat...

Page 20: ...de 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 accurate to one decimal place Quoted from GPGGA sentence fix GNSS positioning mode Quoted from GNGSA GPGSA sentence 2 2D positioning 3 3D positioning cog Course Over Gr...

Page 21: ...he sentences acquired via the command will be the last ones that have ever been acquired errcode Integer type The error code of the operation If it is not 0 it is the type of error Please refer to Chapter 4 for details AT QGPSGNMEA Acquire NMEA Sentences Test Command AT QGPSGNMEA Response QGPSGNMEA GGA RMC GSV GSA VTG G NS OK Write Command Query GGA sentence AT QGPSGNMEA GGA Response QGPSGNMEA GGA...

Page 22: ...ROR errcode Write Command Query VTG sentence AT QGPSGNMEA VTG Response QGPSGNMEA VTG sentence OK If there is any error related to ME functionality CME ERROR errcode Write Command Query GNS sentence AT QGPSGNMEA GNS Response QGPSGNMEA GNS sentence OK If there is any error related to ME functionality CME ERROR errcode Reference errcode Integer type The error code of the operation If it is not 0 it i...

Page 23: ...ommand AT QGPSXTRA xtraenable Response OK If there is any error related to ME functionality CME ERROR errcode Reference xtraenable Enable gpsOneXTRA Assistance function and the configuration parameter will be automatically saved to NVRAM 0 Disable gpsOneXTRA Assistance 1 Enable gpsOneXTRA Assistance errcode Integer type The error code of the operation If it is not 0 it is the type of error Please ...

Page 24: ...C GPS time Format YYYY MM DD hh mm ss e g 2016 01 03 15 34 50 utc The type of time 0 GPS time 1 UTC time force Allow or force GPS subsystem to accept the time injected 0 Allow acceptance 1 Force acceptance 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 If the set tim...

Page 25: ...datafilename Filename of the gpsOneXTRA data file e g xtra2 bin or xtra3grc bin xtradatadurtime 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 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 errcode Integer type The error code of the op...

Page 26: ...tain 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 sente...

Page 27: ...S 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 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 please refer...

Page 28: ... 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 ...

Page 29: ..._User_Guide QCOM user guide Abbreviation Description BeiDou BeiDou Navigation Satellite System 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 an...

Page 30: ...atile 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 Universal Asynchronous Receiver Transmitter URL Uniform Resource Locator USB Universal Serial Bus UTC Universal Time Code VTG Track Made Good and Ground Speed ...

Reviews: