Upload
others
View
40
Download
1
Embed Size (px)
Citation preview
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
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -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 ............................................................ 6
3. Example ........................................................................................................................................ 7
Quectel
Confidential
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -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 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
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -4-
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
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -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
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
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -6-
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
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -7-
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
GSM Location AT Commands
GSM_Location_AT_Commands_Manual_V1.2 -8-
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]