Quectel UC20 Manual de instalación

UC20 GNSS

AT Commands Manual

WCDMA Module Series

Rev. UC20_GNSS_AT_Commands_Manual_V1.0

Date: 2013-08-23

www.quectel.com

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 1 / 25

Our aim is to provide customers with timely and comprehensive service. For any

assistance, please contact our company headquarters:

Quectel Wireless Solutions Co., Ltd.

Room 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233

Tel: +86 21 5108 6236

Mail: info@quectel.com

Or our local office, for more information, please visit:

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

For technical support, to report documentation errors, please visit:

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

GENERAL NOTES

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. ALL INFORMATION SUPPLIED HEREIN ARE SUBJECT TO

CHANGE WITHOUT PRIOR NOTICE.

THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF

QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS

DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS 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.

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 2 / 25

About the Document

History

Revision

Date

Author

Description

1.0

2013-08-23

Scott HU

Initial

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 3 / 25

Contents

About the Document................................................................................................................................... 2

1Introduction .......................................................................................................................................... 4

1.1. How to Use GNSS ...................................................................................................................... 4

1.2. NMEA Sentence Type................................................................................................................. 5

1.3. Introduction of gpsOneXTRA...................................................................................................... 5

1.4. GNSS Power Saving Management ............................................................................................ 6

1.4.1. DPO (Dynamic Power Optimization) ............................................................................... 6

1.4.2. ODP (On-Demand Positioning)........................................................................................ 6

2Description of AT Command .............................................................................................................. 8

2.1. AT+QGPSCFG Configure GNSS ............................................................................................. 8

2.2. AT+QGPSDEL Delete Assistance Data ................................................................................. 11

2.3. AT+QGPS Operate GPS Session.......................................................................................... 12

2.4. AT+QGPSEND Terminate GNSS Session............................................................................. 13

2.5. AT+QGPSLOC Obtain Fixed Position.................................................................................... 14

2.6. AT+QGPSGNMEA Obtain NMEA Sentences ........................................................................ 15

2.7. AT+QGPSXTRA Enable gpsOneXTRA Functionality ............................................................ 16

2.8. AT+QGPSXTRATIME Inject gpsOneXTRA Time................................................................... 17

2.9. AT+QGPSXTRADATA Inject gpsOneXTRA Data Manually................................................... 18

2.10. Introduction of URC................................................................................................................... 19

2.10.1. Expired XTRA Data........................................................................................................ 19

3Example .............................................................................................................................................. 21

3.1. Turn On and Off the GNSS Engine........................................................................................... 21

3.2. Application of GNSS nmeasrc .................................................................................................. 21

3.3. Examples of Injecting gpsOneXTRA ........................................................................................ 22

4Appendix A Reference....................................................................................................................... 24

5 Appendix B Summary of Error Codes ............................................................................................. 25

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 4 / 25

1Introduction

UC20 integrates a GNSS engine, which supports GPS and GLONASS system and provides

gpsOneXTRA assistance. UC20 GNSS engine is high-performance and suitable for various applications

which lowest-cost and accurate positioning are needed. Meanwhile, it can also support position tracking

without network assistance, and GNSS capabilities when GSM/WCDMA is out of network coverage areas.

UC20 GNSS can be applied in the following occasions: turn-by-turn navigation applications, asset

tracking, buddy tracking, location-aware games, homing and fleet management.

1.1. How to Use GNSS

UC20 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.

Step 2: Active GNSS engine by AT+QGPS.

Step 3: After GNSS session is started successfully and GNSS had fixed, positioning information can be

obtained by three ways:

(1) NMEA sentences output to "usb nmea" port by default, you can read the port to obtain NMEA

sentences.

(2) You can use AT+QGPSLOC to obtain some positioning information directly, such as latitude,

longitude, height, time and positioning type and so on .

(3) After enabling <nmeasrc> by AT+QGPSCFG, you can acquire the specified NMEA sentence by

AT+QGPSGNMEA. If <nmeasrc> is disabled, this command cannot be used.

Step 4: You can terminate GNSS by two ways:

(1) If the parameter <fixcount> of the AT+QGPS is set to 0 in Step 2, GNSS engine will get

position continuously, and it can be ended by AT+QGPSEND.

(2) If the actual fixed times reach the specified value which is set to <fixcount>, the engine will

stop automatically; in this process it can use the command AT+QGPSEND also to end session.

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 5 / 25

1.2. NMEA Sentence 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:

GPGGA - Global Positioning System Fix Data, Time, Position and related fix data.

GPRMC - Recommended minimum data.

GPGSV - Detailed satellite data.

GPGSA - Overall satellite data.

GPVTG - Vector track and speed over the ground.

And for GLONASS sentences, the prefixes are "GL" and "GN", as below:

GLGSV - Detailed satellite data.

GNGSA - Overall satellite data.

GNGNS -

1.3. Introduction of gpsOneXTRA

gpsOneXTRA assistance enhances standalone performance, and simplifies GNSS assistance delivery to

GNSS engine, including ephemeris, almanac, ionosphere, UTC, health and coarse time assistance.

Booting with gpsOneXTRA, TTFF (Time to First Fix) can be reduced by 18 to 30 sec (or more in harsh

signal environments). And the gpsOneXTRA data needs to be updated once per day (or every a couple of

days) from an XTRA server on the network.

In order to apply gpsOneXTRA feature in GNSS engine, valid gpsOneXTRA assistance data is necessary.

Firstly download a new gpsOneXTRA binary file from one of the gpsOneXTRA assistance web servers via

HTTP. The files are named xtra.bin for GPS only and xtra2.bin for GPS+GLONASS. The exact file size is

less than 50kB:

http://xtra1.gpsonextra.net/xtra.bin

http://xtra2.gpsonextra.net/xtra.bin

http://xtra3.gpsonextra.net/xtra.bin

http://xtra1.gpsonextra.net/xtra2.bin

http://xtra2.gpsonextra.net/xtra2.bin

http://xtra3.gpsonextra.net/xtra2.bin

gpsOneXTRA data needs to be updated regularly. Actually, you can query the gpsOneXTRA data status

by AT+QGPSXTRADATA?, then you can update gpsOneXTRA data properly.

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 6 / 25

The working procedure of gpsOneXTRA is shown as follows:

Step 1: If gpsOneXTRA is disabled, enable it by AT+QGPSXTRA and restart the module.

Step 2: Confirm the current validity of gpsOneXTRA data by AT+QGPSXTRADATA?.

Step 3: Download xtra.bin or xtra2.bin to the module via HTTP AT command

Step 4: Inject the correct time by AT+QGPSXTRATIME.

Step 5: Inject the downloaded xtra.bin or xtra2.bin file by AT+QGPSXTRADATA.

Step 6: Others steps see chapter 1.1.

1.4. GNSS Power Saving Management

UC20 GNSS engine provides power saving solutions by DPO and ODP, 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. DPO takes effect when <dpoenable> is configured via AT+QGPSCFG.

There are several preconditions to turn on the DPO, shown as below:

All SVs>26 dB-Hz must have ephemeris or recent (<3.5 days) XTRA almanac corrections for those

SVs.

Health or UTC information is not transmitted over-the-air.

Valid position and HEPE is less than 50m and also less than the users’ specified value in QoS.

6 SVs>37 dB-Hz or 4 SVs>26 dB-Hz and have almanac and health for all SVs.

Benefits and impacts:

When the DPO feature is on and the SV or navigational data cannot be decoded, the GPS receiver

will not be continuous.

During the DPO, the SBAS feature is effectively disabled. The receiver cannot demodulate the SBAS

messages. DPO always takes precedence over SBAS.

TTFF and yield will not be impacted.

1.4.2. ODP (On-Demand Positioning)

When On-Demand Positioning (ODP) is enabled, standalone GNSS positioning will be triggered in the

background. The positions calculated as a result of ODP are not presented to the application, NMEA, or

the network. However, when the on-demand session is operating and the users or network request a

GNSS session, the on-demand session is immediately terminated and the incoming request is

implemented.

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 7 / 25

ODP system requirements:

(1) ODP requires valid gpsOneXTRA assistance data.

(2) ODP requires that UC20 is in service.

If these two requirements are not fulfilled ODP will be turned off automatically. ODP will be suspended if a

regular GNSS

In the enabled low power mode, the GNSS engine is turned on to consume low power. Requests to

determine the GNSS position are returned with a reduced time-to-fix while this mode is active. In the

enabled Ready mode, the GNSS engine is kept active and is available to perform fixed position. Requests

to determine the GNSS position are immediately returned while this mode is active. The impact on battery

life is great in this mode. Maintenance of position and time uncertainty also improves the performance of

E911 on UMTS.

Configure <odpcontrol> to set two different modes by AT+QGPSCFG:

Low power mode:

Low-frequency background GNSS tracking session.

In good signal condition, use shorter interval with frequent ODP session (i.e., per 5 min).

In weak signal condition, use longer interval, but less frequent ODP session (i.e., twice per hour).

Ready mode:

GNSS engine will start 1 Hz positioning session.

Main goal is to keep GNSS engine ready so that when the application demands a position from the

GNSS engine, position can be reported quickly.

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 8 / 25

2Description 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.

AT+QGPSCFG Configure GNSS

Test command

AT+QGPSCFG=?

Response

+QGPSCFG:

“outport”,(“none”,”usbnmea”,”uartdebug”,”cmux3”)

+QGPSCFG: “nmeasrc”,(0,1)

+QGPSCFG: “gpsnmeatype”,(0-31)

+QGPSCFG: “glonassnmeatype”,(0-7)

+QGPSCFG: “glonassenable”,(0,1)

+QGPSCFG: “odpcontrol”,(0-2)

+QGPSCFG: “dpoenable”,(0,1)

Configure NMEA sentences out port.

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

Response

When there are two parameters:

+CME ERROR: <errcode>

When the second parameter is omitted, query the current

setting:

+QGPSCFG: ”outport”,<outport>

Enable nmeasrc, obtain NMEA

sentences by AT+QGPSGNMEA.

AT+QGPSCFG=“nmeasrc”[,<nmeasrc

Response

When there are two parameters:

+CME ERROR: <errcode>

Quectel

Confidential

WCDMA Module

UC20 GNSS AT Commands Manual

UC20_GNSS_AT_Commands_Manual Confidential / Released 9 / 25

When the second parameter is omitted, query the current

setting::

+QGPSCFG: “nmeasrc”,<nmeasrc>

Configure output type of GPS NMEA

sentences.

AT+QGPSCFG=“gpsnmeatype”[,<gps

nmeatype>]

Response

When there are two parameters:

+CME ERROR: <errcode>

When the second parameter is omitted, query the current

setting:

+QGPSCFG: “gpsnmeatype”,<gpsnmeatype>

Configure output type of GLONASS

NMEA sentences.

AT+QGPSCFG=“glonassnmeatype”[,

<glonassnmeatype>]

Response

When there are two parameters:

+CME ERROR: <errcode>

When the second parameter is omitted, query the current

setting:

+QGPSCFG: “glonassnmeatype”,<glonassnmeatype>

Configure GLONASS.

AT+QGPSCFG=“glonassenable”[,<gl

onassenable>]

Response

When there are two parameters:

+CME ERROR: <errcode>

When the second parameter is omitted, query the current

setting:

+QGPSCFG: “glonassenable”,<glonassenable>

Configure ODP mode.

AT+QGPSCFG=“odpcontrol”[,<odpco

ntrol>]

Response

When there are two parameters:

+CME ERROR: <errcode>

Quectel

Confidential

Otros manuales para UC20

Tabla de contenidos

Otros manuales de Módulo GSM/GPRS de Quectel

Quectel

Quectel BG950A-GL Manual de usuario

Quectel

Quectel RM505Q-AE Manual de usuario

Quectel

Quectel L89 R2.0 Manual de usuario

Quectel

Quectel EC21 Mini PCIe Series Suplemento

Quectel

Quectel SC200E Series Manual de usuario

Quectel

Quectel BG96 Instrucciones de instalación y funcionamiento

Quectel

Quectel UC20 Manual de usuario

Quectel

Quectel EG91 Series Suplemento

Quectel

Quectel GSM/GPRS Module Series Instrucciones de instalación

Quectel

Quectel RMU500-EKNM Manual de usuario

Quectel

Quectel 5G-M2 EVB Manual de usuario

Quectel

Quectel BC66 Suplemento

Quectel

Quectel LC79D (A) EVB Manual de usuario

Quectel

Quectel EG25-GL Suplemento

Quectel

Quectel UMTS Module Series Suplemento

Quectel

Quectel M10 Manual de usuario

Quectel

Quectel GL100 Manual de usuario

Quectel

Quectel BC66 Suplemento

Quectel

Quectel UG96 Suplemento

Quectel

Quectel MC60 Guía

Quectel

Quectel M20 Manual de usuario

Quectel

Quectel FC800L Manual de usuario

Quectel

Quectel FC41D-TE-B Manual de usuario

Quectel

Quectel UMTS<E EVB R2.0 Manual de usuario

Manuales populares de Módulo GSM/GPRS de otras marcas

Laird

Laird BL600 Series Guía de configuración rápida

Smartgen

Smartgen SG361 Manual de usuario

Vanderbilt

Vanderbilt SPCN320 Manual de usuario

Neoway

Neoway M590E V1 Manual de instalación y operación

Gilbarco

Gilbarco PA025800 Series Guía rápida

Fracarro

Fracarro ESP-CT-GSM Manual de usuario

Bosch

Bosch Multicom BMC-3G Manual de usuario

Zte

Zte MG2639 Manual de usuario

Airlink101

Airlink101 Raven G3210 Manual de usuario

Vanderbilt

Vanderbilt SPCN310 Manual de usuario

Thitronik

Thitronik GSM-pro Manual de usuario

Teknim

Teknim TXM-0502 Manual de instrucciones

Safeline

Safeline LYRA Manual de usuario

mangOH

mangOH Green Manual de usuario

Campbell

Campbell Airlink Raven X-Telus Manual de usuario

Ai-Thinker

Ai-Thinker A9G Manual de usuario

Autoplugin

Autoplugin PGSM4 Manual de usuario

GOSUNCN

GOSUNCN WeLink ME3616 Manual de usuario