at commands manual - quectel wireless solutions cellular engine gsm queclocator at commands manual...
TRANSCRIPT
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -2-
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -3-
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
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -5-
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -6-
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -7-
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -8-
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -9-
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -10-
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
AT+QGSMLOCSETL=0,0 //set language as English UTF-8
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
GSM QuecLocator AT Commands Manual
GSM_QuecLocator_AT_Commands_Manual_V1.3 -11-
AT+QGSMLOCSETL=0,0 //set language as English UTF-8
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
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]