GSM Location AT Commands...0 GSM Quectel Cellular Engine GSM Location AT Commands...

0

GSM

Quectel Cellular Engine

GSM Location

AT Commands GSM_Location_AT_Commands_Manual_V1.2

GSM Location AT Commands

GSM_Location_AT_Commands_Manual_V1.2 -1-

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

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

Quectel

Confidential



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

Quectel

Confidential



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 Locating

Algorithm A and B.

Quectel

Confidential



1. Introduction

This document is a reference guide for all AT commands and responses of GSM Location

function.

1.1 Reference

Table 1: Reference

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

Quectel

Confidential



2. AT Commands for GSM Location

2.1. Overview

Command Description

AT+QGSMLOC GSM LOCATION AND TIME

AT+QLOCC SET TIMEOUT FOR GSM LOCATION

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 <type>=1/4/8 and command is running successfully:

+QGSMLOC: <locationcode>,<longitude>,<latitude>,<date>,<tim

e>

OK

If <type>=2 or 5 and command is running successfully

+QGSMLOC: <locationcode>,<date>,<time>

OK

If error is related to ME functionality:

+CME ERROR: <err>

Parameter

<type> 1 Get location information, see the Reference

2 Get time information, see the Reference

4 Get location information, see the Reference

5 Get time information, see the Reference

8 Get location information, see the Reference

<locationcode> Imply success or failure

Quectel

Confidential



0 Success

1 Failure

<longitude> Current longitude in degrees

<latitude> Current latitude in degrees

<date> Format is YYYY/MM/DD, the time zone is GMT e.g.

2010/05/20

<time > Format is hh:mm:ss, the time zone is GMT. e.g. 05:26:51

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

2.2.2. 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: <readnodatatotaltimeout>,<waitresponsetime>

OK

Parameter

See Write Command

Write Command

AT+QLOCC=<

readnodatatotaltimeout>,<

waitresponsetime>

Response

OK

If error is related to ME functionality:

+CME ERROR: <err>

Parameter

<readnodatatotaltimeout> Set timeout in seconds for

not reading any data

<waitresponsetime> Set timeout in seconds for

waiting response

Reference Configuration cannot be saved.

Quectel

Confidential



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

AT+QICSGP=1,"CMNET" //choose GPRS mode and set the APN as "CMNET" when

the operator is the China Mobile.

OK

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

Quectel

Confidential



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]

mailto:[email protected]

GSM Location AT Commands...0 GSM Quectel Cellular Engine GSM Location AT Commands...

Documents

Transcript of GSM Location AT Commands...0 GSM Quectel Cellular Engine GSM Location AT Commands...