Quectel Quec Locator AT Commands Manual V1.0

User Manual: Pdf

Open the PDF directly: View PDF PDF.
Page Count: 12

DownloadQuectel Quec Locator AT Commands Manual V1.0
Open PDF In BrowserView PDF
QuecLocator
AT Commands Manual
UMTS/HSPA Module Series
Rev. QuecLocator_AT_Commands_Manual_V1.0
Date: 2014-10-28

www.quectel.com

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233
Tel: +86 21 5108 6236
Mail: info@quectel.com

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

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 IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.

COPYRIGHT

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.

Copyright © Quectel Wireless Solutions Co., Ltd. 2014. All rights reserved.

QuecLocator_AT_Commands_Manual

Confidential / Released

1 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

About the Document
History
Revision
1.0

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
Date

Author

Description

2014-10-28

Jonathan WEN/
Nina WANG

Initial

QuecLocator_AT_Commands_Manual

Confidential / Released

2 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

Contents
About the Document ................................................................................................................................... 2
Contents ....................................................................................................................................................... 3
Table Index ................................................................................................................................................... 4
1

Introduction .......................................................................................................................................... 5
1.1. Scope of the Document .............................................................................................................. 5
1.2. General Process of QuecLocator ............................................................................................... 5
1.3. Error Handling ............................................................................................................................. 5
1.3.1. Executing QuecLocator AT Command Fails .................................................................... 5
1.3.2. PDP Activation Fails ......................................................................................................... 6
1.3.3. Error Response of AT+QCELLLOC ................................................................................. 6

2

Description of AT Command .............................................................................................................. 7
2.1. AT+QLOCCFG Configuration of QuecLocator ......................................................................... 7
2.2. AT+QCELLLOC Get Location Information by QuecLocator .................................................... 8

3

Example ................................................................................................................................................ 9
3.1. Get the Location Information by QuecLocator ............................................................................ 9

4
5

Summary of Error Codes .................................................................................................................. 10
Appendix A Reference....................................................................................................................... 11

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

QuecLocator_AT_Commands_Manual

Confidential / Released

3 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

Table Index
TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 10
TABLE 2: RELATED DOCUMENTS ................................................................................................................... 11
TABLE 3: RELATED DOCUMENTS ................................................................................................................... 11

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C
QuecLocator_AT_Commands_Manual

Confidential / Released

4 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

1

Introduction

Quectel provides QuecLocator to get location information by base station. This document is a reference
guide to all the AT commands defined for QuecLocator.

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

1.1. Scope of the Document

QuecLocator function is applicable to the following modules:



UC20 UMTS/HSPA+ series
UC15 UMTS/HSDPA series

1.2. General Process of QuecLocator
Step 1: Configure and activate the PDP context.
1)

2)
3)

Configure the PDP context parameters of , ,  and other parameters by
AT+QICSGP (Please refer to Quectel_UC20_TCPIP_AT_Commands_Manual for details). If QoS
settings need to be updated, configure them by the commands AT+CGQMIN, AT+CGEQMIN,
AT+CGQREQ, and AT+CGEQREQ (Please refer to Quectel_UC20_AT_Commands_Manual for
details).
Activate the PDP context by AT+QIACT.
Configure the PDP context ID for QuecLocator by AT+QLOCCFG="contextid",.

Step 2: Get the location information by AT+QCELLLOC. Step 2 can be repeated.

1.3. Error Handling
1.3.1.

Executing QuecLocator AT Command Fails

If you execute QuecLocator AT command and receive response “ERROR” from UC20 module, please
check if the SIM card is inserted and AT+CPIN? is in “+CPIN: Ready” status.

QuecLocator_AT_Commands_Manual

Confidential / Released

5 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

1.3.2.

PDP Activation Fails

If you failed to activate PDP context by AT+QIACT command, please check the following aspects:
1.
2.
3.
4.
5.

Query whether the PS domain is attached by AT+CGATT? command or not. If not, please execute
AT+CGATT=1 command to attach PS domain.
Query the CGREG status by AT+CGREG? and make sure the PS domain has been registered.
Query the PDP context parameters by AT+QICSGP command and make sure the APN of specified
PDP context has been set.
Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT
command.
According to 3GPP specification, it only supports three PDP contexts activated simultaneously, so
you must make sure the number of activated PDP contexts is less than 3.

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

If the result of checking is OK, but you still fail to activate PDP context by executing AT+QIACT command,
please reboot the UC20 module to resolve this issue. After booting the UC20 module, please check the
terms mentioned above at least three times and each time at an interval of 10 minutes to avoid frequently
rebooting UC20 module.

1.3.3.

Error Response of AT+QCELLLOC

If “+CME ERROR:  is returned after operating AT+QCELLLOC, please re-execute AT+QCELLLOC.
If it fails again, you should deactivate the PDP context by AT+QIDEACT command, and try again (Please
refer to Chapter 1.3.2).

QuecLocator_AT_Commands_Manual

Confidential / Released

6 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

2

Description of AT Command

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

2.1. AT+QLOCCFG

Configuration of QuecLocator

You can configure the PDP context ID and timeout value by AT+QLOCCFG.

AT+QLOCCFG

Configuration of QuecLocator

Test Command
AT+QLOCCFG=?

Response
+QLOCCFG: "contextid",(1-16)
+QLOCCFG: "timeout",(1-300)
OK

Read Command
AT+QLOCCFG?

Response
+QLOCCFG: "contextid",
+QLOCCFG: "timeout",
OK

Write Command
AT+QLOCCFG="contextid"[,]

Response
If  is not omitted:
OK
or
+CME ERROR: 

Else query the current settings:
+QLOCCFG: "contextid",
OK

Write Command
AT+QLOCCFG="timeout"[,]

Response
If  is not omitted:
OK
or
+CME ERROR: 
Else query the current settings:
+QLOCCFG: "timeout",
OK

QuecLocator_AT_Commands_Manual

Confidential / Released

7 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

Parameter



Integer type, PDP context ID, the range is 1-16, default value is 1.
Integer type, the maximum time waiting for data from server. If there is no data
coming from server within timeout value, it will return error. The default value is 60, unit
is second. The range is 1-300.

2.2. AT+QCELLLOC

Get Location Information by QuecLocator

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

AT+QCELLLOC

Get the Location Information by QuecLocator

Test Command
AT+QCELLLOC=?

Response
OK

Write Command
AT+QCELLLOC

Response
+QCELLLOC: ,
OK
or
+CME ERROR: 

Parameter




Float type, the longitude of the location information. This value should be accurate to
six after the decimal point, and the range is <-180.000000 to 180.000000>.
Float type, the latitude of the location information. This value should be accurate to six
after the decimal point, and the range is <-90.000000 to 90.000000>.
Integer type, indicates the operation error code. It is the type of error (Please refer to
the Chapter 4)

QuecLocator_AT_Commands_Manual

Confidential / Released

8 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

3

Example

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

3.1. Get the Location Information by QuecLocator
//Step 1: Configure and activate the PDP context.

//Configure PDP context 1, APN is “UNINET” for
China Unicom.
//Activate PDP context 1.
//Activate successfully.
//Query the state of PDP context.

AT+QICSGP=1,1,"UNINET","","",1
OK
AT+QIACT=1
OK
AT+QIACT?
+QIACT: 1,1,1,"10.7.157.1"
OK
AT+QLOCCFG="contextid",1
OK
AT+QLOCCFG="contextid"
+QLOCCFG: "contextid",1
OK

//Set the PDP context ID as 1. The PDP context ID
must be activated first.
//Query the PDP context ID.

//Step 2: Get the location information by QuecLocator.
AT+QCELLLOC
+QCELLLOC: 117.206001,31.847601
OK

QuecLocator_AT_Commands_Manual

//Get the serving cell location.

Confidential / Released

9 / 11

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

4

Summary of Error Codes

 indicates an error related to mobile equipment or network. The details about  are described in
the following table.

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

Table 1: Summary of Error Codes

721
730
731
732

Meaning

Decode error

Invalid parameter

Failed to get location
Timeout

QuecLocator_AT_Commands_Manual
11

Confidential / Released

10 /

UMTS/HSPA Module Series
QuecLocator AT Commands Manual

5

Appendix A Reference

Table 2: Related Documents

l
e
t
l
c
a
e
i
t
u
n
Q ide
f
n
o
C

SN

Document Name

Remark

[1]

Quectel_UC20_TCPIP_AT_Commands_Manual

UC20 TCPIP AT commands

[2]

Quectel_UC20_AT_Commands_Manual

UC20 AT commands manual

Table 3: Related Documents
Abbreviation

Description

PDP

Packet Data Protocol

URL

Uniform Resource Locator

QuecLocator_AT_Commands_Manual
11

Confidential / Released

11 / 11



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Has XFA                         : No
Language                        : zh-CN
XMP Toolkit                     : Adobe XMP Core 4.2.1-c041 52.342996, 2008/05/07-20:48:00
Format                          : application/pdf
Creator                         : kelly
Create Date                     : 2014:10:28 16:48:49+08:00
Creator Tool                    : Microsoft® Word 2010
Modify Date                     : 2014:10:28 16:55:50+08:00
Metadata Date                   : 2014:10:28 16:55:50+08:00
Producer                        : Microsoft® Word 2010
Document ID                     : uuid:7344972f-854b-4772-86f6-15db316e1c19
Instance ID                     : uuid:6bbd2a4c-c72b-4b2d-8c13-6983065a111d
Page Count                      : 12
Author                          : kelly
EXIF Metadata provided by EXIF.tools

Navigation menu