background image

                                                                                                                                                                     

LPWA  Module  Series 

                                                                                                      BG96  GNSS  Application  Note

 

BG96_GNSS_Application_Note                                                                                                                10 / 42 
 
 
 

2

 

Description  of  GNSS  AT  Commands 

 

This chapter mainly introduces the AT commands relating to GNSS function of BG96 module.   

 

2.1. AT Command Syntax 

2.1.1.  Definitions 

 

<CR>

     

Carriage return character. 

 

<LF>

     

Line feed character. 

 

<...>

   

 

Parameter name. Angle brackets do not appear on command line. 

 

[...]

   

 

Optional  parameter  of  a  command  or  an  optional  part  of  TA  information  response.         

 

 

 

Square brackets do not appear on command line. When an optional parameter is not   

 

 

 

given, the new value equals to its previous value or its default setting, unless otherwise 

 

 

 

specified. 

 

Underline

    Default setting of a parameter. 

 

2.1.2.  AT Command Syntax 

The 

AT

 or 

at

 prefix must be added at the beginning of each command line. Entering 

<CR>

 will terminate 

command 

line. 

Commands 

are 

usually 

followed 

by 

response 

that 

includes 

<CR><LF><response><CR><LF>

.  Throughout  this  document,  only  the  response 

<response>

  will  be 

presented, 

<CR><LF>

 are omitted intentionally. 

 

Table 1: Type of AT Commands and Responses 

 

Test Command 

AT+<cmd>=? 

This  command  returns  the  list  of  parameters  and  value 

ranges  set  by  the  corresponding  Write  Command  or 

internal processes. 

Read Command 

AT+<cmd>? 

This  command  returns  the  currently  set  value  of  the 

parameter or parameters. 

Write Command 

AT+<cmd>=<p1>

[,<p2>[,<p3>[...]]]

 

This command sets the user-definable parameter values. 

Execution Command 

AT+<cmd> 

This  command  reads  non-variable  parameters  affected 

by internal processes in the module. 

Summary of Contents for BG96

Page 1: ...BG96 GNSS Application Note LPWA Module Series Rev BG96_GNSS_Application_Note_V1 2 Date 2020 06 23 Status Released www quectel com...

Page 2: ...RS 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 INF...

Page 3: ...0 06 23 Matt YE Mac ZHU Alfred LI 1 Added the URLs for gpsOneXTRA file downloading through MCUs browsers in Chapter 1 3 2 Updated AT QGPSCFG outport in Chapter 2 2 1 1 3 Added AT QGPSCFG speed_thresho...

Page 4: ...1 3 AT QGPSCFG gpsnmeatype Configure Output Type of GPS NMEA Sentences 13 2 2 1 4 AT QGPSCFG glonassnmeatype Configure Output Type of GLONASS NMEA Sentences 14 2 2 1 5 AT QGPSCFG galileonmeatype Confi...

Page 5: ...o fence 32 2 2 10 2 AT QCFGEXT deletegeo Delete a Geo fence 34 2 2 10 3 AT QCFGEXT querygeo Query the Position with Respect to Geo fence 35 3 Examples 36 3 1 Turn on and off the GNSS 36 3 2 Applicatio...

Page 6: ...es BG96 GNSS Application Note BG96_GNSS_Application_Note 5 42 Table Index Table 1 Type of AT Commands and Responses 10 Table 2 Summary of Error Codes 40 Table 3 Related Documents 41 Table 4 Terms and...

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

Page 8: ...s the prefixes are GA and GN as below GAGSV GNSS satellites in view such as number of satellites in view and satellite ID numbers GNGSA GNSS DOP and active satellites GNGNS GNSS fix data For BeiDou se...

Page 9: ...xtra2 bin http xtrapath2 izatcloud net xtra2 bin http xtrapath3 izatcloud net xtra2 bin http xtrapath1 izatcloud net xtra3grc bin http xtrapath2 izatcloud net xtra3grc bin http xtrapath3 izatcloud ne...

Page 10: ...to the procedures described in Chapter 1 1 directly Step 3 Download file xtra2 bin or xtra3grc bin to the module via URLs listed above Step 4 Inject the correct gpsOneXTRA time to GNSS engine via AT...

Page 11: ...ault setting of a parameter 2 1 2 AT Command Syntax The AT or at prefix must be added at the beginning of each command line Entering CR will terminate a command line Commands are usually followed by a...

Page 12: ...rted outport s list of supported baud_rate s QGPSCFG nmeasrc list of supported NMEA_src s QGPSCFG gpsnmeatype range of supported GPS_NMEA_type s QGPSCFG glonassnmeatype range of supported GLONASS_NMEA...

Page 13: ...e port baud rate when outport is uartnmea or auxnmea OK If there is any error related to ME functionality CME ERROR errcode Maximum Response Time 300 ms Characteristics The command takes effect immedi...

Page 14: ...t setting QGPSCFG nmeasrc NMEA_src OK If the optional parameter is specified set whether to enable the acquisition of NMEA sentences via AT QGPSGNMEA OK If there is any error related to ME functionali...

Page 15: ...R errcode Maximum Response Time 300 ms Characteristics The command takes effect immediately The configuration is saved automatically Reference GPS_NMEA_type Integer type Output type of GPS NMEA senten...

Page 16: ...ately The configuration is saved automatically Reference GLONASS_NMEA_type Integer type Output type of GLONASS NMEA sentences by ORed 0 Disable 1 GSV 2 GSA 4 GNS errcode Integer type Error code of ope...

Page 17: ...of operation See Chapter 4 for details AT QGPSCFG beidounmeatype Configure Output Type of BeiDou NMEA Sentences Write Command AT QGPSCFG beidounmeatype Beidou_NMEA_type Response If the optional parame...

Page 18: ...NMEA_type Response If the optional parameter is omitted query the current setting QGPSCFG gsvextnmeatype GSVEXT_NMEA_type OK If the optional parameter is specified set whether to enable the output of...

Page 19: ...omitted query the current setting QGPSCFG gnssconfig GNSS_config OK If the optional parameter is specified set the supported GNSS constellations OK If there is any error related to ME functionality CM...

Page 20: ...omatic running of GNSS OK If there is any error related to ME functionality CME ERROR errcode Maximum Response Time 300 ms Characteristics The command takes effect after rebooting The configuration is...

Page 21: ...takes effect immediately The configuration is saved automatically Reference speed_threshold Float type Speed threshold If the speed is less than the threshold the speed in the NMEA sentence is 0 Defau...

Page 22: ...Float type Horizontal estimated velocity error Unit m s head_unc Float type Estimated heading error Unit degree errcode Integer type Error code of operation See Chapter 4 for details AT QGPSCFG nmea_e...

Page 23: ...ring type Data valid indication A Data valid V Data invalid HDOP Float type Horizontal dilution of precision hori_unc Float type Horizontal estimated position error Unit meter vert_unc Float type Vert...

Page 24: ...s 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...

Page 25: ...ching It also includes the time for demodulating the ephemeris data and calculating the position The default value will be used if the parameter is omitted Range 1 255 Default value 30 Unit second fix...

Page 26: ...rted time s OK Read Command AT QGPSLOC Response Return the positioning information in latitude longitud e format of ddmm mmmmN S dddmm mmmmE W QGPSLOC UTC latitude longitude HDOP alt itude fix COG spk...

Page 27: ...South latitude longitude Float type Longitude If mode is 0 Format dddmm mmmmE W Quoted from GPGGA sentence ddd 000 179 Unit degree mm mmmm 00 0000 59 9999 Unit minute E W East longitude West longitude...

Page 28: ...Speed over ground Format xxxx x unit Km h accurate to one decimal place Quoted from GPVTG sentence spkn Float type Speed over ground Format xxxx x Unit knots Accurate to one decimal place Quoted from...

Page 29: ...VTG Response QGPSGNMEA VTG_sentence OK If there is any error related to ME functionality CME ERROR errcode Write Command Acquire GNS sentences AT QGPSGNMEA GNS Response QGPSGNMEA GNS_sentence OK If th...

Page 30: ...le Before injecting gpsOneXTRA data file gpsOneXTRA time GSA VTG GNS errcode Integer type Error code of operation See Chapter 4 for details AT QGPSXTRA Enable Disable gpsOneXTRA Assistance Function Te...

Page 31: ...mmand Inject gpsOneXTRA time AT QGPSXTRATIME op XTRA_ti me UTC force uncrtn Response OK If there is any error related to ME functionality CME ERROR errcode Maximum Response Time 300 ms Characteristics...

Page 32: ...rite Command Inject gpsOneXTRA data file AT QGPSXTRADATA XTRA_data_fi lename Response OK If there is any error related to ME functionality CME ERROR errcode Maximum Response Time 300 ms Characteristic...

Page 33: ...AT QCFGEXT addgeo geoID mode shape lat1 lon1 lat2 lon2 lat3 lon3 lat4 lon4 Response If all parameters after addgeo are omitted query the current setting of all geo fences that have been added QCFGEXT...

Page 34: ...le URC to be reported when entering the geo fence 2 Enable URC to be reported when leaving the geo fence 3 Enable URC to be reported when entering or leaving the geo fence The URC is shown as below QI...

Page 35: ...Format ddd dddddd Range 180 000000 to 180 000000 lat2 When shape is 0 this parameter is a radius Unit meter Range 0 6000000 When shape is other values this parameter is a latitude Unit degree Format d...

Page 36: ...ID Range 0 10 10 means deleting all geo fences errcode Integer type Error code of operation See Chapter 4 for details AT QCFGEXT querygeo Query the Position with Respect to Geo fence Write Command AT...

Page 37: ...51 00 3150 7223N 11711 9293E 0 7 62 2 2 0 00 0 0 0 0 110513 09 OK AT QGPSEND Turn off GNSS OK 3 2 Application of GNSS NMEA_src When GNSS is turned on and NMEA_src is set to 1 NMEA sentences can be acq...

Page 38: ...irectly If gpsOneXTRA data file is invalid query via AT QGPSXTRADATA then perform the following procedures You can download the gpsOneXTRA data file through AT QHTTPGET from URL http xtrapath1 izatclo...

Page 39: ...procedures You can download the gpsOneXTRA data file to PC or MCU from URL http xtrapath4 izatcloud net xtra3grc bin or other URLs listed in Chapter 1 3 2 AT QFUPL UFS xtra2 bin 60831 60 Select the g...

Page 40: ...OK AT QCFGEXT querygeo 0 Query the position with respect to geo fence 0 QCFGEXT querygeo 0 1 The current position is inside the geo fence 0 OK When entering the geo fence 0 this URC will be reported...

Page 41: ...code Meaning 501 Invalid parameter 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...

Page 42: ..._ Manual BG96 HTTP AT Commands Manual Table 4 Terms and Abbreviations Abbreviation Description BeiDou BeiDou Navigation Satellite System DOP Dilution of Precision Galileo Galileo Satellite Navigation...

Page 43: ...s Memory PC Private Computer PDOP Position Dilution of Precision RMC Recommended Minimum Specific GNSS Data SNR Signal Noise Ratio SNTP Simple Network Time Protocol TTFF Time to First Fix UART Univers...

Reviews: