AT Commands for GNSS Application
No | Command | Description |
C1401 | AT+CGNSPWR | GNSS Power Control |
C1402 | AT+CGNSINF | GNSS Navigation Information Parsed From NMEA Sentences |
C1403 | AT+CGNSURC | GNSS Navigation URC Report |
C1404 | AT+CGNSPORT | GNSS NMEA Out Port Set |
C1405 | AT+CGNSCOLD | GNSS Cold Start |
C1406 | AT+CGNSWARM | GNSS Warm Start |
C1407 | AT+CGNSHOT | GNSS Hot Start |
C1408 | AT+CGNSMOD | GNSS Work Mode Set |
C1409 | AT+CGNSCFG | GNSS NMEA Out Configure |
C1410 | AT+CGNSTST | GNSS NMEA Data Output to AT Port |
C1411 | AT+CGNSXTRA | GNSS XTRA Function Open |
C1412 | AT+CGNSCPY | GNSS XTRA File Copy |
C1413 | AT+CGNSRTMS | GNSS NMEA out frequency configure |
C1414 | AT+CGNSHOR | Configure Positioning Desired Accuracy |
C1415 | AT+CGNSUTIPR | Configure Baud Rate When NMEA Output From UART3 |
C1416 | AT+CGNSNMEA | Configure NMEA output sentences |
C1417 | AT+CGTP | IZAT GNSS Configure |
C1418 | AT+CGNSSUPLCFG | GNSS SUPL Configure |
C1419 | AT+CGNSSUPL | GNSS SUPL Control |
C1401 AT+CGNSPWR GNSS Power Control
T) AT+CGNSPWR=? |
+CGNSPWR: (list of supported <mode>s )
OK |
Parameters See Write Command |
|
R) AT+CGNSPWR? |
TA returns the current status of GNSS Power supply +CGNSPWR: <mode>
OK |
Parameters See Write Command |
|
W) AT+CGNSPWR=<mode> |
OK or ERROR |
Parameters <mode> 0 Turn off GNSS power supply 1 Turn on GNSS power supply |
|
Parameter Saving Mode | NO_SAVE |
Reference |
NMEA data will not out put to usb’s NMEA port when set AT+CGNSPWR=1 through uart port except config it by AT+CGNSCFG=1. |
C1402 AT+CGNSINF GNSS Navigation Information Parsed From NMEA Sentences
T) AT+CGNSINF=? | OK |
Parameters See Execution Command |
|
E) AT+CGNSINF |
+CGNSINF: <GNSS run status>,<Fix status>,<UTC date &Time>,<Latitude>, <Longitude>,<MSL Altitude>,<Speed OverGround>,<Course Over Ground>, <FixMode>,<Reserved1>,<HDOP>,<PDOP>,<VDOP>,<Reserved2>, <GNSSSatellites in View>,<GNSS Satellites Used>, <GLONASS Satellites Used>,<Reserved3>,<C/N0 max>,<HPA>,<VPA> OK |
<GNSS run status> 0 GNSS off 1 GNSS on <Fix status> 0 Not fixed position 1 Fixed position See below table 15-1. |
|
Parameter Saving Mode | NO_SAVE |
Index | Parameter | Unit | Range | Length |
1 | GNSS run status | — | 0-1 | 1 |
2 | Fix status | — | 0-1 | 1 |
3 | UTC date & Time | yyyyMMddhhmmss.sss |
yyyy: [1980,2039] MM : [1,12] dd: [1,31] hh: [0,23] mm: [0,59] ss.sss:[0.000,60.999] |
18 |
4 | Latitude | ±dd.dddddd | [-90.000000,90.000000] | 10 |
5 | Longitude | ±ddd.dddddd | [-180.000000,180.000000] | 11 |
6 | MSL Altitude | meters | 8 | |
7 | Speed Over Ground | Km/hour | [0,999.99] | 6 |
8 | Course Over Ground | degrees | [0,360.00] | 6 |
9 | Fix Mode | — | 0,1,2[1] | 1 |
10 | Reserved1 | 0 | ||
11 | HDOP | — | [0,99.9] | 4 |
12 | PDOP | — | [0,99.9] | 4 |
13 | VDOP | — | [0,99.9] | 4 |
14 | Reserved2 | 0 | ||
15 | GNSS Satellites in View | — | [0,99] | 2 |
16 | GPS Satellites Used | — | [0,99] | 2 |
17 | GLONASS Satellites used | — | [0,99] | 2 |
18 | Reserved3 | 0 | ||
19 | C/N0 max | dBHz | [0,55] | 2 |
20 | HPA[2] | meters | [0,9999.9] | 6 |
21 | VPA[2] | meters | [0,9999.9] | 6 |
Total : (94) chars |
NOTE
1.The range of <Fix Mode> depends on the GNSS chip
2. Reserved
C1403 AT+CGNSURC GNSS Navigation URC Report
T) AT+CGNSURC=? |
+CGNSURC: (0-255)
OK |
Parameters See Write Command |
|
R) AT+CGNSURC? |
TA returns the current URC setting +CGNSURC: <Navigation mode>
OK |
Parameters See Write Command |
|
Unsolicited Result Code +UGNSINF: <GNSS run status>,<Fix status>,<UTC date & Time>,<Latitude>,<Longitude>, <MSL Altitude>, <Speed Over Ground>,<Course Over Ground>,<Fix Mode>,<Reserved1>,<HDOP>,<PDOP>,<VDOP>, <Reserved2>,<GNSS Satellites in View>,<GNSS Satellites Used>,<GLONASS Satellites Used>, <Reserved3>,<C/N0 max>,<HPA>,<VPA> |
|
W) AT+CGNSURC=<Navigation mode> |
OK or ERROR |
Parameters <Navigation mode>: 0 Turn off navigation data URC report 1 Turn on navigation data URC report, and report every GNSS FIX 2 Turn on navigation data URC report, and report every 2 GNSS FIX … 255 Turn on navigation data URC report, and report every 255 GNSS FIX |
|
Parameter Saving Mode | NO_SAVE |
Reference |
Note Factory setting is “AT+CGNSURC=0“. URC “+UGNSINF: “parameters are the same as “+CGNSINF:” |
C1404 AT+CGNSPORT GNSS NMEA Out Port Set
T) AT+CGNSPORT=? |
+CGNSPORT: (list of supported <port>)
OK |
Parameters See Write Command |
|
R) AT+CGNSPORT? |
+CGNSPORT: <port>
OK |
W) AT+CGNSPORT=<port> |
OK If error is related to ME functionality: +CME ERROR: <err> |
Parameters <port> Num of the port NMEA out 3 NMEA port 4 NONE |
|
Parameter Saving Mode | AUTO_SAVE_REBOOT |
Reference |
Note Module must reboot to make it effect if <port> value is changed. |
C1405 AT+CGNSCOLD GNSS Cold Start
T) AT+CGNSCOLD=? | OK |
E) AT+CGNSCOLD |
If AT+CGNSXTRA=0 OK Else if AT+CGNSXTRA=1 OK
+CGNSXTRA: <mod> |
Parameters <mod> 0 Aid XTRA file success 1 XTRA file is not exist 2 XTRA file is not effective |
|
Parameter Saving Mode | NO_SAVE |
C1406 AT+CGNSWARM GNSS Warm Start
T) AT+CGNSWARM=? | OK |
E) AT+CGNSWARM | OK |
Parameter Saving Mode | NO_SAVE |
C1407 AT+CGNSHOT GNSS Hot Start
T) AT+CGNSHOT=? | OK |
E) AT+CGNSHOT | OK |
Parameter Saving Mode | NO_SAVE |
C1408 AT+CGNSMOD GNSS Work Mode Set
T) AT+CGNSMOD=? |
+CGNSMOD: (list of supported <gps mode>),(list of supported <glo mode>s), (list of supported <bd mode>s),(list of supported <gal mode>s)
OK |
Parameters See Write Command |
|
R) AT+CGNSMOD? |
+CGNSMOD: <gps mode>,<glo mode>,<bd mode>,<gal mode>
OK |
W) AT+CGNSMOD=<gps mode>,<glo mode>,<bd mode>,<gal mode> |
OK If error is related to ME functionality: +CME ERROR: <err> |
Parameters <GPS mode> GPS work mode 1 Start GPS NMEA out <glo mode> GLONASS work mode 0 Stop GLONASS NMEA out 1 Start GLONASS NMEA out <bd mode> BEIDOU work mode 0 Stop BEIDOU NMEA out 1 Start BEIDOU NMEA out 2 BEIDOU outside of us <ga mode> GALILEAN work mode 0 Stop GALILEAN NMEA out 1 Start GALILEAN NMEA out 2 GALILEAN outside of us |
|
Parameter Saving Mode | AUTO_SAVE_REBOOT |
C1409 AT+CGNSCFG GNSS NMEA Out Configure
T) AT+CGNSCFG=? |
+CGNSCFG: (list of supported <mode>s)
OK |
Parameters See Write Command |
|
R) AT+CGNSCFG? |
TA returns the current status of configure +CGNSCFG: <mode>
OK |
Parameters See Write Command |
|
W) AT+CGNSCFG=<mode> |
OK or ERROR |
Parameters <mode> 0 Turn off GNSS NMEA data output to USB’s NMEA port when set AT+CGNSPWR=1/0 through UART 1 Turn on GNSS NMEA data output to USB’s NMEA port when set AT+CGNSPWR=1/0 through UART 2 Turn on GNSS NMEA data output to UART3 port when set AT+CGNSPWR=1/0 |
|
Parameter Saving Mode | NO_SAVE |
Reference |
Note This command only supported in UART port. |
C1410 AT+CGNSTST GNSS NMEA Data Output To AT Port
T) AT+CGNSTST=? |
+CGNSTST: (0-1), (1-255)
OK |
Parameters See Write Command |
|
R) AT+CGNSTST? |
TA returns the current status of configure +CGNSTST: <TST>
OK |
Parameters See Write Command |
|
W) AT+CGNSTST=<TST>[,<cont>] |
OK or ERROR |
Parameters <TST> 0 Turn off GNSS NMEA data out put to AT port 1 Turn on GNSS NMEA data out put to AT port <cont> the number of NMEA data package 1-255 |
|
Parameter Saving Mode | NO_SAVE |
C1411 AT+CGNSXTRA GNSS XTRA Function Open
T) AT+CGNSXTRA=? |
+CGNSXTRA: (0-1)
OK |
Parameters See Write Command |
|
R) AT+CGNSXTRA? |
TA returns the current status of configure +CGNSXTRA: <enable>
OK |
Parameters See Write Command |
|
W) AT+CGNSXTRA=<enable> |
OK or ERROR |
Parameters <enable> 0 Disable XTRA function 1 Enable XTRA function |
|
E) AT+CGNSXTRA |
This command is used to query validate time of XTRA file. The XTRA file exists if the download and copy are successful. If XTRA file is not exist ERROR Else if XTRA file is exist <validDurationHours>,<Inject gpsOneXTR GPS time>
OK |
Parameters <validDurationHours> Validate time of XTRA file, Unit is Hour. Defaut value is 168. <Inject gpsOneXTR GPS time> Download time of XTRA file. |
|
Parameter Saving Mode | NO_SAVE |
C1412 AT+CGNSCPY GNSS XTRA File Copy
T) AT+CGNSCPY=? | OK |
Parameters See Execution Command |
|
E) AT+CGNSCPY |
+CGNSCPY: <ret>
OK |
Parameters <ret> 1 File not exist 0 Copy success |
|
Parameter Saving Mode | NO_SAVE |
C1413 AT+CGNSRTMS GNSS NMEA Out Frequency Configure
T) AT+CGNSRTMS=? |
+CGNSRTMS: (list of supported <frequency>s)
OK |
Parameters See Read Command |
|
R) AT+CGNSRTMS? |
+CGNSRTMS: <frequency >
OK |
Parameters <frequency> GNSS NMEA Out Frequency, range is 50-1000. Defaultvalue is 1000. |
|
Parameter Saving Mode | NO_SAVE |
C1414 AT+CGNSHOR Configure Positioning Desired Accuracy
T) AT+CGNSHOR=? |
+CGNSHOR: (0-1800000)
OK |
Parameters See Write Command |
|
R) AT+CGNSHOR? |
TA returns the current status of configure +CGNSHOR: <acc>
OK |
Parameters See Write Command |
|
W) AT+CGNSHOR=<acc> |
OK or ERROR |
Parameters <acc> Configure the positioning desired accuracy threshold in meters. Range 0-1800000 Default value is 50 |
|
Parameter Saving Mode | NO_SAVE |
C1415 AT+CGNSUTIPR Configure Baud Rate When NMEA Output From UART3
T) AT+CGNSUTIPR=? |
+CGNSUTIPR: (9600,19200,38400,57600,115200)
OK |
Parameters See Write Command |
|
R) AT+CGNSUTIPR? |
TA returns the current status of configure +CGNSUTIPR: <ipr>
OK |
Parameters See Write Command |
|
W) AT+CGNSUTIPR=<ipr> |
OK or ERROR |
Parameters <ipr> Baud rate when NMEA output from UART3. 9600 19200 38400 57600 115200 |
|
Parameter Saving Mode | NO_SAVE |
Reference |
Note When GPS is started, set AT+CGNSUTIPR=<ipr> first, then use AT+CGNSCFG=2 to configure UART3 output. After turning on GPS, you can use the set baud rate output in UART3. |
C1416 AT+CGNSNMEA Configure NMEA Output Sentences
T) AT+CGNSNMEA=? |
+CGNSNMEA: (range of supported <nmea>s)
OK |
Parameters See Write Command |
|
R) AT+CGNSNMEA? |
+CGNSNMEA: <nmea>
OK |
Parameters See Write Command |
|
W) AT+CGNSNMEA=<nmea> |
This command is used to configure NMEA output sentences which are generated by the GPS One engine when position data is available. OK or ERROR |
Parameters <nmea> Range is 0-262143. Each bit enables an NMEA sentence output as follows: Bit 0 GPGGA (global positioning system fix data) Bit 1 GPRMC (recommended minimum specific GPS/TRANSIT data) Bit 2 GPGSV (GPS satellites in view) Bit 3 GPGSA (GPS DOP and active satellites) Bit 4 GPVTG (track made good and ground speed) Bit 5 PQXFI (Global Positioning System Extended Fix Data.) Bit 6 GLGSV (GLONASS satellites in view GLONASS fixes only) Bit 7 GNGSA (1. GPS/2. Glonass/3. GALILE DOP and Active Satellites.) Bit 8 GNGNS (fix data for GNSS receivers;output for GPS,GLONASS,GALILEO) Bit 9 Reserved Bit 10 GAGSV (GALILEO satellites in view) Bit 11 Reserved Bit 12 Reserved Bit 13 Reserved Bit 14 Reserved Bit 15 Reserved, Bit 16 BDGSA/PQGSA (BEIDOU/QZSS DOP and active satellites) Bit 17 BDGSV/PQGSV (BEIDOUQZSS satellites in view) Set the desired NMEA sentence bit(s). If multiple NMEA sentence formats are desired, “OR” the desired bits together. |
|
Parameter Saving Mode | AUTO_SAVE_REBOOT |
Reference |
Note: Reserved default 0, set invalid. |
C1417 AT+CGTP IZAT GNSS Configure
T) AT+CGTP=? | OK |
Parameters See Write Command |
|
R) AT+CGTP? |
+CGTP: <feature_control>,<user_session_control>,<primary_svr_address>,<primary_svr_port>, <secondary_svr_address>,<secondary_svr_port>
OK |
Parameters See Write Command |
|
W) AT+CGTP=<feature_control> |
If successfully: OK If failed: ERROR |
Parameters <feature_control> 0 GTP disabled 1 GTP enabled If you want to use IZAT function, this value must be 1 <user_session_control> 0 Connection to the XTS is never permitted 1 Connection to the XTS is always permitted If you want to use IZAT function, this value must be 1 <primary_svr_address> the IP address of the primary GTP Server. If you want to use IZAT function, this value must be gtp1.izatclout.net <primary_svr_port> the port number of the primary If you want to use IZAT function, this value must be 443 <secondary_svr_address> the IP address of the secondary GTP Server. If you want to use IZAT function, this value must be gtp2.izatclout.net <secondary_svr_port> the port number of the primary If you want to use IZAT function, this value must be 443 <latitude> Latitude (specified in WGS84 datum). Type: Floating point Units: Degrees Range: -90.0 to 90.0 Positive values indicate northern latitude Negative values indicate southern latitude <longitude> Longitude (specified in WGS84 datum). Type: Floating point Units: Degrees Range: -180.0 to 180.0 Positive values indicate eastern longitude Negative values indicate western longitude <date> Output format is yyyy-mm-dd <time> UTC time output format is hh:mm:ss <accuary> Horizontal position uncertainty (circular). Type: Floating point Units: Meters |
|
E) AT+CGTP |
OK
+GTPCELL: <latitude>,<longitude>,<date>,<time>,<accuary> |
Parameters See Write Command |
|
Parameter Saving Mode | NO_SAVE |
Reference |
Note Before all IZAT related operations, we should ensure network is registered. IZAT flow Step 1: Configure IZAT NV param by AT+CGTP=1. Step 2: Query IZAT NV param by AT+CGTP? Step 3: Start IZAT location by AT+CGTP AT command example //Query IZAT NV set AT+CGTP? +CGTP: 1,1,gtp1.izatcloud.net,443,gtp2.izatcloud.net,443
OK //If query result is not this , need set it AT+CGTP=1 OK // Start IZAT location AT+CGTP OK
+GTPCELL: 32.943878,-117.214508,2019-08-23,17:28:03,1330.200928 |
C1418 AT+CGNSSUPLCFG GNSS SUPL Configure
T) AT+CGNSSUPLCFG=? |
+CGNSSUPLCFG: “APN”,”SUPLURL”,(0-31),(1-4),(0-1)
OK |
Parameters See Write Command |
|
R) AT+CGNSSUPLCFG? |
+CGNSSUPLCFG: <APN>,<URL>,<SRV>,<PDN>,<SECURITY>
OK |
Parameters See Write Command |
|
W) AT+CGNSSUPLCFG=<APN>, <SUPLURL>, <SRV>,<PDN>,<SECURITY> |
OK or ERROR |
Parameters <APN> APN name <SUPLURL> Server address url <SRV> Serving systems type Bit 0 CDMA Bit 1 HDR Bit 2 GSM Bit 3 WCDMA Bit 4 LTE <PDN> 1 IPV4 2 IPV6 3 IPV4V6 4 PPP <SECURITY> 0 Disables security 1 Enables security |
|
Parameter Saving Mode | AUTO_SAVE_REBOOT |
C1419 AT+CGNSSUPL GNSS SUPL Control
T) AT+CGNSSUPL=? |
+CGNSSUPL: (list of supported <mode>s)
OK |
Parameters See Write Command |
|
R) AT+CGNSSUPL? |
+CGNSSUPL: <mode>
OK |
Parameters See Write Command |
|
W) AT+CGNSSUPL=<mode> |
OK or ERROR |
Parameters <mode> 0 Turn off GNSS SUPL 1 Turn on GNSS SUPL |
|
Parameter Saving Mode | NO_SAVE |