GSM Quectel Cellular Engine

GSM Location AT Commands GSM_Location_AT_Commands_Manual_V1.2

0

GSM Location AT Commands

Document Title

GSM Location AT Commands

Version

1.2

Date

2011-10-31

Status

Release

Document Control ID

GSM_Location_AT_Commands_Manual_V1.2

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

General Notes Quectel offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Quectel. The information provided is based upon requirements specifically provided for customers of Quectel. Quectel has not undertaken any independent search for additional information, relevant to any information that may be in the customer’s possession. Furthermore, system validation of this product designed by Quectel within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are subject to change.

Copyright This document contains proprietary technical information of Quectel Co., Ltd. Copying of this document, distribution to others, and communication of the contents thereof, are forbidden without permission. Offenders are liable to the payment of damages. All rights are reserved in the event of a patent grant or registration of a utility model or design. All specification supplied herein are subject to change without notice at any time. Copyright © Quectel Wireless Solutions Co., Ltd. 2011

GSM_Location_AT_Commands_Manual_V1.2

-1-

GSM Location AT Commands

Contents Contents ............................................................................................................................................ 2 0. Revision history ............................................................................................................................ 3 1. Introduction ................................................................................................................................... 4 1.1 Reference.............................................................................................................................. 4 2. AT Commands for GSM Location ................................................................................................ 5 2.1. Overview ............................................................................................................................. 5 2.2. Detailed descriptions of AT Commands .............................................................................. 5 2.2.1. AT+QGSMLOC GSM Location and time................................................................. 5 2.2.2. AT+QLOCC Set timeout for GSM Location ............................................................ 6 3. Example ........................................................................................................................................ 7

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

GSM_Location_AT_Commands_Manual_V1.2

-2-

GSM Location AT Commands

0. Revision history Revision

Date

Author

Description of change

1.0

2010-06-08

Jay XIN

Initial

1.1

2011-08-08

Jay XIN

Added type 4, type 5 and type 8 Added AT command AT+QLOCC

1.2

2011-10-27

Jay XIN

Defined and described Algorithm A and B.

Locating

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

-3-

GSM Location AT Commands

1. Introduction This document is a reference guide for all AT commands and responses of GSM Location function.

1.1 Reference Table 1: Reference

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

SN

Document name

Remark

[1]

Mxx_ATC.pdf

The introduction of AT commands for Mxx

[2]

GSM_TCPIP_AN.pdf

Introduce how to use the internal TCP/IP stack

GSM_Location_AT_Commands_Manual_V1.2

-4-

GSM Location AT Commands

2. AT Commands for GSM Location

2.1. Overview Command

Description

AT+QGSMLOC

GSM LOCATION AND TIME

AT+QLOCC

SET TIMEOUT FOR GSM LOCATION

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

2.2. Detailed descriptions of AT Commands 2.2.1.

AT+QGSMLOC GSM Location and Time

AT+QGSMLOC GSM Location and Time Test Command AT+QGSMLOC=?

Response +QGSMLOC: (1,2,4,5,8) OK

Parameter See Write Command

Write Command AT+QGSMLOC=< type>

Response If =1/4/8 and command is running successfully: +QGSMLOC: ,,,, OK

If =2 or 5 and command is running successfully +QGSMLOC: ,, OK

If error is related to ME functionality: +CME ERROR: Parameter

1 2 4 5 8 GSM_Location_AT_Commands_Manual_V1.2

Get location information, see the Reference Get time information, see the Reference Get location information, see the Reference Get time information, see the Reference Get location information, see the Reference Imply success or failure -5-

GSM Location AT Commands

0 Success 1 Failure Current longitude in degrees Current latitude in degrees Format is YYYY/MM/DD, the time zone is GMT e.g. 2010/05/20 Format is hh:mm:ss, the time zone is GMT. e.g. 05:26:51 Reference

2.2.2.

Type 1 and 2 are defined as Locating Algorithm A. Type 4, 5, and 8 are defined as Locating Algorithm B. It is strongly recommended to use Locating Algorithm B. The difference between Type 4 and 8 is that the module can collect more information from nearby GSM coverage communities to execute positioning via Type 8. When use Type 8, AT+QENG=1 must be enabled.

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

AT+QLOCC Set timeout for GSM Location

AT+QLOCC Set timeout for GSM Location Test Command AT+QLOCC=?

Response +QLOCC: 60, 60 OK

Parameter See Write Command

Read Command AT+QLOCC?

Response +QLOCC: , OK

Parameter See Write Command

Write Command AT+QLOCC=< readnodatatotaltimeout>,< waitresponsetime>

Response OK

If error is related to ME functionality: +CME ERROR: Parameter

Reference

Set timeout in seconds for not reading any data Set timeout in seconds for waiting response

Configuration cannot be saved.

GSM_Location_AT_Commands_Manual_V1.2

-6-

GSM Location AT Commands

3. Example It is recommended to do some initialization before using AT+QGSMLOC to get the longitude, latitude and time, such as FGCNT id and APN settings, etc. For more details, please refer to the documents [1] Mxx_ATC.pdf and [2]GSM_TCPIP_AN.pdf . The following is the example about how to get the latitude, latitude and time: AT+QIFGCNT=0 //choose the context 0 to activate GPRS/CSD context for the TCPIP service, please refer to [1] and [2] OK

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

AT+QICSGP=1,"CMNET" OK

//choose GPRS mode and set the APN as "CMNET" when the operator is the China Mobile.

AT+QGSMLOC=4 //get the longitude, latitude and time +QGSMLOC: 0,121.389018,31.168729,2011/10/26,05:49:10 OK

AT+QGSMLOC=5 //get the time +QGSMLOC: 0,2011/10/26,05:49:17 OK

GSM_Location_AT_Commands_Manual_V1.2

-7-

GSM Location AT Commands

Shanghai Quectel Wireless Solutions Co., Ltd. Room 501, Building 13，No.99 Tianzhou Road, Shanghai, China 200233 Tel: +86 21 5108 6236 Mail: [email protected]

GSM_Location_AT_Commands_Manual_V1.2

-8-