AT Commands Manual - Quectel Wireless Solutions Cellular Engine GSM QuecLocator AT Commands Manual...

0

GSM

Quectel Cellular Engine

GSM QuecLocator

AT Commands Manual GSM_QuecLocator_AT_Commands_Manual_V1.3

GSM QuecLocator AT Commands Manual

GSM_QuecLocator_AT_Commands_Manual_V1.3 -1-

Document Title GSM QuecLocator AT Commands Manual

Version 1.3

Date 2012-09-18

Status Released

Document Control ID GSM_QuecLocator_AT_Commands_Manual_V1.3

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

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

2.2.3. AT+QGSMLOCSETL Set GSMLOC Response Language .................................... 8

3. Example ........................................................................................................................................ 9

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 1. Added type 4, type5 and type 8 for AT

Command AT+QGSMLOC.

2. Added AT command AT+QLOCC.

1.2. 2011-10-27 Jay XIN Defined and described Locating

Algorithm A and B.

1.3 2012-09-12 Windy FANG 1. Document name has been changed

from GSM Location AT Command into

GSM QuecLocator AT Commands

2. Added type 7, type 9 and type 10 for

AT Command AT+QGSMLOC.

3. Added AT command:

AT+QGSMLOCSETL.

Quectel

Confidential


GSM_QuecLocator_ AT_Commands_ Manual _V1.3 -4-

1. Introduction

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

QuecLocator.

1.1. Reference

Table 1: Reference

SN Document name Remark

[1] Mxx_ATC.pdf The introduction to 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

AT+QGSMLOCSETL SET RESPONSE LANGUAGE AND CHAR-SET

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: (4,5,7-10)

OK

Parameter

See Write Command

Write Command

AT+QGSMLOC=<

type>[,<s_Longitud

e>,<s_Latitude>]

Response

If <type>=4/8 and command is running successfully:

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

e>

OK

If <type>= 5 and command is running successfully

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

OK

If <type>=7/9 and command is running successfully:

+QGSMLOC: <locationcode>,<longitude>,<latitude>,<accuracy>,<

date>,<time>,

<address>

OK

If <type>=10 then command should bring parameters

AT+QGSMLOC=10,<s_Longitude>,<s_Latitude> and command is

Quectel

Confidential



running successfully:

+QGSMLOC: <locationcode>,<longitude>,<latitude>,<accuracy>,<

date>,<time>,

<address>

OK

If error is related to ME functionality:

+CME ERROR: <err>

Parameter

<type> 4 Get longitude, latitude

5 Get time information

7 Get longitude, latitude, address

8 Get longitude latitude

9 Get longitude, latitude, address

10 Get address using longitude and latitude

<s_Longitude> The Longitude to be located should be accurate to six

after the decimal point , and the range is <-180.000000

to 180.000000 >.

<s_Latitude> The Latitude to be located should accurate to six after

the decimal point , and the range is

<-90.000000 to 90.000000 >

<locationcode> Imply success or failure

0 Success

1 Failure

<longitude> Current longitude in degrees

<latitude> Current latitude in degrees

<accuracy> The horizontal accuracy of the fix in meters at a 95%

confidence level, if there is no accuracy in response data

it will be 0.000000.

<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

< address >

{"country":"","country_code":"","region":"","city":"","street":"","street_

number":"”}

Reference Type 4,5,7 are located by single cell and 8,9 is located by multiple cell.

<s_Longitude> and <s_Latitude> should be within double quotations

and if the value is negative it presents south latitude or west longitude.

Quectel

Confidential



2.2.2. AT +QLOCC Set timeout for GSM Location

AT+QLOCC Set timeout for GSM Location

Test Command

AT+QLOCC=?

Response

+QLOCC: (10-60),(10-60)

OK

Parameter

See Write Command

Read Command

AT+QLOCC?

Response

+QLOCC: <readnodatatotaltimeout>,<waitresponsetime>

OK

Parameter

See Write Command

Write Command

AT+QLOCC=<

readnodatatotalti

meout>,<

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



2.2.3. AT+QGSMLOCSETL Set GSMLOC Response Language

AT+QGSMLOCSETL Set GSMLOC response language

Read Command

AT+QGSMLOCS

ETL?

Response

+QGSMLOCSETL：<Current response language>,<charset>

OK

Write Command

AT+QGSMLOC

SETL

=<Language> ,<C

HARSET>

Response

OK

Parameter

Language Server responses language in English or in Chinese

0 English

1 Chinese

CHARSET Charset return from the Google server

0 UTF-8

1 GB2312

2 GBK

Reference If the server does not support what you want it will use default configuration.

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

Example for type 4:

AT+QGSMLOC=4 //get the longitude, latitude and time

+QGSMLOC: 0,121.389018,31.168729,2011/10/26,05:49:10

OK

Example for type 5:

AT+QGSMLOC=5 //get the time

+QGSMLOC: 0,2011/10/26,05:49:17

OK

Example for type 7:

AT+QGSMLOCSETL=0,0 //set language as English UTF-8

OK

AT+QGSMLOC=7

+QGSMLOC:0,117.209040,31.858031,1321.000000,2012/06/13,05:42:05,{"country":"China"

,"country_code":"CN","region":"Anhui","city":"Hefei","street":"Mujiangli Rd"}

OK

AT+QGSMLOCSETL=1,1 //set language as Chinese GB2312

OK

Quectel

Confidential



AT+QGSMLOC=7

+QGSMLOC: 0,117.200860,31.842379, 1321.000000,2012/06/15,08:16:33,{"country":"中国

","country_code":"CN","region":"安徽省","city":"合肥市","street":"天柱路

","street_number":"13号"}

OK

AT+QGSMLOCSETL =1,2 //set language as Chinese GBK

OK

AT+QGSMLOC=7

+QGSMLOC: 0,117.198808,31.846309, 1321.000000,2012/06/15,08:18:27,{"country":"中国

","country_code":"CN","region":"安徽省","city":"合肥市","street":"天柱路

","street_number":""}

OK

Example for type 8:

AT+QENG=1

OK

AT+QGSMLOC=8

+QGSMLOC: 0,117.197135,31.844350,2012/06/13,05:34:54

OK

Example for type 9:

AT+QENG=1

OK


OK

AT+QGSMLOC=9

+QGSMLOC:0,117.209040,31.858031,1321.000000,2012/06/13,05:42:05,{"country":"China"

,"country_code":"CN","region":"Anhui","city":"Hefei","street":"Mujiangli Rd"}

OK

Example for type 10:

Quectel

Confidential




OK

AT+QGSMLOC=10,"-88.410000","43.700000" //query with west longitude and north latitude

+QGSMLOC: 0,-88.410000,43.700000,0.000000,2012/06/13,01:47:04,{"country":"United

States","country_code":"US","region":"Wisconsin","city":"Fond du

Lac","street":"Brookside Rd","street_number":"W5060","postal_code":"54937"}

OK

AT+QGSMLOC=10,"150.197135","-31.844350" //query with east longitude and south latitude

+QGSMLOC:0,150.197135,-31.844350,0.000000,2012/06/13,01:37:18,{"country":"Australia

","country_code":"AU","region":"New South

Wales","city":"Merriwa","street":"Hampshire Rd","street_number":"LOT

59","postal_code":"2329"}

OK

AT+QGSMLOC=10,"117.197135","31.844350" //query with east longitude and north latitude

+QGSMLOC:

0,117.197135,31.844350,0.000000,2012/06/13,01:34:07,{"country":"China","country_code":

"CN","region":"Anhui","city":"Hefei","street":"Mengyuan Rd","street_number":"11

鍙?}

OK

AT+QGSMLOC=10,"-50.197135","-31.844350" //query with west longitude and south latitude

+QGSMLOC: 0,-50.197135,-31.844350,0.000000,2012/06/13,01:36:59,

{"country":"Brazil","country_code":"BR"}

OK

Quectel

Confidential


GSM_QuecLocator_ AT_Commands_ Manual _V1.3

-12-

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]

AT Commands Manual - Quectel Wireless Solutions Cellular Engine GSM QuecLocator AT Commands Manual...

Documents

Transcript of AT Commands Manual - Quectel Wireless Solutions Cellular Engine GSM QuecLocator AT Commands Manual...