m2mLOCATE Application Note

80000NT10090A Rev. 2 2013-10-10

m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 2 of 12
Mod. 0809 2011-07 Rev.2



APPLICABILITY TABLE

Software Version
GC Family ( Compact )
10.00.xx7
GC864-QUAD
GC864-QUAD V2
GC864-DUAL V2
GE/GL Family ( Embedded )
GE864-QUAD
GE864-QUAD V2
GE864-QUAD Automotive V2
GE864-QUAD ATEX
GE864-DUAL V2
GE864-GPS
GE865-QUAD
GL865-DUAL
GL865-QUAD
GL868-DUAL
GE910-QUAD
13.00.xx4
GE910-GNSS
GL865-DUAL V3
16.00.xx2
GL868-DUAL V3
GL865-QUAD V3
16.00.xx3
GE910-QUAD V3
HE910 Family (Embedded)




12.00.xx4
HE910
HE910-GA
HE910-D
HE910-EUR / HE910-EUD
HE910-EUG / HE910-NAG
HE910-NAR / HE910-NAD
UE910 Family (Embedded)
UE910-EUR / UE910-EUD
UE910-NAR / UE910-NAD
CE910 Family (Embedded) 18.01.022 (Verizon)
18.11.001 (Sprint)
18.11.013 (Aeris)
CE910-DUAL
CE910-SC 18.01.393
DE910 Family (Embedded)
DE910-DUAL 15.00.024 (Verizon)
DE910-SC 15.00.393
GT Family ( Terminal )
10.00.xx7
GT863-PY
GT864-QUAD
GT864-PY

Note: the features described in the present document are provided by the products equipped
with the software versions equal or higher than the versions shown in the table.





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 3 of 12
Mod. 0809 2011-07 Rev.2
SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE
Notice
While reasonable efforts have been made to assure the accuracy of this document, Telit
assumes no liability resulting from any inaccuracies or omissions in this document, or from
use of the information obtained herein. The information in this document has been carefully
checked and is believed to be entirely reliable. However, no responsibility is assumed for
inaccuracies or omissions. Telit reserves the right to make changes to any products described
herein and reserves the right to revise this document and to make changes from time to time
in content hereof with no obligation to notify any person of revisions or changes. Telit does
not assume any liability arising out of the application or use of any product, software, or
circuit described herein; neither does it convey license under its patent rights or the rights of
others.
It is possible that this publication may contain references to, or information about Telit
products (machines and programs), programming, or services that are not announced in your
country. Such references or information must not be construed to mean that Telit intends to
announce such Telit products, programming, or services in your country.
Copyrights
This instruction manual and the Telit products described in this instruction manual may be,
include or describe copyrighted Telit material, such as computer programs stored in
semiconductor memories or other media. Laws in the Italy and other countries preserve for
Telit and its licensors certain exclusive rights for copyrighted material, including the
exclusive right to copy, reproduce in any form, distribute and make derivative works of the
copyrighted material. Accordingly, any copyrighted material of Telit and its licensors
contained herein or in the Telit products described in this instruction manual may not be
copied, reproduced, distributed, merged or modified in any manner without the express
written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed
to grant either directly or by implication, estoppel, or otherwise, any license under the
copyrights, patents or patent applications of Telit, as arises by operation of law in the sale of a
product.
Computer Software Copyrights
The Telit and 3rd Party supplied Software (SW) products described in this instruction manual
may include copyrighted Telit and other 3rd Party supplied computer programs stored in
semiconductor memories or other media. Laws in the Italy and other countries preserve for
Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted computer
programs, including the exclusive right to copy or reproduce in any form the copyrighted
computer program. Accordingly, any copyrighted Telit or other 3rd Party supplied SW
computer programs contained in the Telit products described in this instruction manual may
not be copied (reverse engineered) or reproduced in any manner without the express written
permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase of Telit products
shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any
license under the copyrights, patents or patent applications of Telit or other 3rd Party supplied
SW, except for the normal non-exclusive, royalty free license to use that arises by operation
of law in the sale of a product.






m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 4 of 12
Mod. 0809 2011-07 Rev.2
Usage and Disclosure Restrictions
License Agreements
The software described in this document is the property of Telit and its licensors. It is
furnished by express license agreement only and may be used only in accordance with the
terms of such an agreement.
Copyrighted Materials
Software and documentation are copyrighted materials. Making unauthorized copies is
prohibited by law. No part of the software or documentation may be reproduced, transmitted,
transcribed, stored in a retrieval system, or translated into any language or computer language,
in any form or by any means, without prior written permission of Telit
High Risk Materials
Components, units, or third-party products used in the product described herein are NOT
fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control
equipment in the following hazardous environments requiring fail-safe controls: the operation
of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic
Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its supplier(s)
specifically disclaim any expressed or implied warranty of fitness for such High Risk
Activities.
Trademarks
TELIT and the Stylized T Logo are registered in Trademark Office. All other product or
service names are the property of their respective owners.

Copyright Telit Communications S.p.A.





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 5 of 12
Mod. 0809 2011-07 Rev.2
Contents

1. Introduction ........................................................................................................... 6
1.1. Scope ............................................................................................................................ 6
1.2. Audience ....................................................................................................................... 6
1.3. Contact Information, Support ...................................................................................... 6
1.4. Text Conventions .......................................................................................................... 7
1.5. Related Documents ..................................................................................................... 7
2. Document History .................................................................................................. 7
3. General Description ............................................................................................... 8
4. Basic Architecture ................................................................................................. 8
4.1. How to get the Location Data ....................................................................................... 9
5. Appendix .............................................................................................................. 11
5.1. AT Commands to Collect Location Data .................................................................... 11
5.1.1. AT#AGPSSND ................................................................................................................ 11
6. Abbreviations and acronyms ................................................................................ 12


Figures

fig. 1: Basic Architecture ..................................................................................................................................... 8







m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 6 of 12
Mod. 0809 2011-07 Rev.2

1. Introduction
1.1. Scope
The present document covers the AT commands developed by Telit to collect location data
using cellular network and cellular base stations position.

1.2. Audience
This document is intended for those users that need to develop applications dealing with
location data.

1.3. Contact Information, Support
For general contact, technical support, to report documentation errors and to order manuals,
contact Telit Technical Support Center (TTSC) at:

[email protected]
[email protected]
[email protected]
[email protected]

Alternatively, use:
http://www.telit.com/en/products/technical-support-center/contact.php
For detailed information about where you can buy the Telit modules or for recommendations
on accessories and components visit:
http://www.telit.com
To register for product news and announcements or for product questions contact Telit
Technical Support Center (TTSC).
Our aim is to make this guide as helpful as possible. Keep us informed of your comments and
suggestions for improvements.
Telit appreciates feedback from the users of our information.





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 7 of 12
Mod. 0809 2011-07 Rev.2
1.4. Text Conventions

Danger This information MUST be followed or catastrophic equipment failure or bodily
injury may occur.

Caution or Warning Alerts the user to important points about integrating the module, if
these points are not followed, the module and end user equipment may fail or malfunction.

Tip or Information Provides advice and suggestions that may be useful when
integrating the module.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD.

1.5. Related Documents
[1] AT Commands Reference Guide, Telit document: 80000ST10025a


2. Document History

Revision Date Changes
0 2013-02-14 First issue
1 2013-05-17 Updated Applicability Table
2 2013-10-10
Updated Applicability Table
Added measurement units to parameters of #AGPSSND





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 8 of 12
Mod. 0809 2011-07 Rev.2

3. General Description
Telit m2mLOCATE is the new cell-based location service that extends the Telit Location
Based Service portfolio currently based on the Telit A-GNSS service available for GNSS and
Combo Cellular+GNSS modules.
Telit m2mLOCATE represents the convergence of mobile communications and location
services conceived to provide Telit customers with positioning information when either
GNSS signals are obscured/jammed in outdoor, or in all indoor scenarios where GNSS signal
strength is too weak to get position.
m2mLOCATE service is based on the position estimation made through cellular base station
triangulation. The positioning data are made available by Telit Location Server without any
specific SW implementation on customer side


4. Basic Architecture

The fig. 1 shows the basic hardware/software configuration used by the AT commands
developed by Telit to collect the location information of the module. The architecture uses a
Client/Server Model.













fig. 1: Basic Architecture
AT Command
Interface

HTTP Client

TCP/IP
GPRS
Server
DCE: Telits Module
Network

DTE




m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 9 of 12
Mod. 0809 2011-07 Rev.2

4.1. How to get the Location Data

In this chapter it is assumed that the Telits module is connected to a DTE by means of the
Main Serial Port, refer to the Hardware User Guide in accordance with the used module.

Warning: to have more information about the syntax and parameters of the Telit AT
commands described in the present document refer to Appendix.

Starting condition: the module is powered off and its factory setting has not been modified.
Yet, turn on the module and enter the following command:
AT+CREG? Check if the module is registered
+CREG: 0,1 Yes, it is
OK
Enter the next command to check on which Network Operator the module is registered.
AT+COPS?
+COPS: 0,0,"I TIM" The Network Operator is I TIM
OK
As shown in fig. 1, the module is an HTTP client. Before creating the PDP context, it is
advisable to check the HTTP client configuration via the following command:
AT#HTTPCFG?
#HTTPCFG: 0,"",80,0,"","******",0,120,1
#HTTPCFG: 1,"",80,0,"","******",0,120,1
#HTTPCFG: 2,"m2mlocate.telit.com",9978,0,"","******",0,120,1
OK
It is the factoring setting configuration. Use the profile number 2. The last parameter refers to
the <cid> parameter of the AT+CGDCONT command, consequently the creation of the PDP
context must be done with the <cid> parameter equal to 1 and the APN of the used Network
Operator. In this example the Network Operator is I TIM and the APN is ibox.tim.it as shown
hereafter.
AT+CGDCONT=1,"IP","ibox.tim.it","0.0.0.0",0,0
OK PDP Context is created
Note that the just entered PDP Context configuration is stored in NVM.





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 10 of 12
Mod. 0809 2011-07 Rev.2

AT#SGACT=1,1 Activate PDP Context
#SGACT: 217.203.167.156
OK

Note: during the manual entering of the AT commands the time between two consecutive AT
commands can be greater than the <delay> parameter set via AT#SGACTCFG command, in
this case the PDP Context is deactivated. Enter the next command to check the delay value
expressed in seconds, see the last but one parameter (180 sec, factory setting):
AT#SGACTCFG?
#SGACTCFG: 1,0,180,0
OK.

Enter the next command to enable the caching of the mapping of the domain name to the IP
address
AT#CACHEDNS=1
OK

Request to the Server the Reference Location
AT#AGPSSND
OK
When the Server responds, the following URC is displayed on the DTE
#AGPSRING: 200,45.7134152,13.768286,0.0,4000.0,"",0

Check that the domain name is mapped to IP address. Now the module automatically uses the
IP address in order to speed up the response time of the next request.
AT#CACHEDNS=?
#CACHEDNS: ("m2mlocate.telit.com","65.39.128.145"),(0,1)
OK





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 11 of 12
Mod. 0809 2011-07 Rev.2

5. Appendix

Warning: to have more information about the syntax and parameters of the Telit AT
commands used in the present document and not shown in the next chapter refer to [1].

5.1. AT Commands to Collect Location Data
5.1.1. AT#AGPSSND

#AGPSSND send HTTP request to AGPS server SELINT 2
AT#AGPSSND Execution command performs a HTTP request to AGPS server to retrieve
the Reference Location data.

If sending ends successfully, the response is OK; otherwise an error code
is reported.

When the AGPS server answer is received, then the following URC is put
on the serial port:

#AGPSRING:
<http_status_code>,<lat>,<lon>,<alt>,<unc>,<err>,<unused>

Where:
<http_status_code> is the numeric status code, as received from
the server (see RFC 2616)
<lat> is the latitude, from -90.0 to 90.0 (in decimal degrees)
<lon> is the longitude, from -180.0 to 180.0 (in decimal degrees)
<alt> is the altitude above Mean Sea Level (in meters)
<unc> is the radius of horizontal uncertainty (in meters)
<err> is a string containing the server error message as it is received
in the Error tag, if present
<unused> unused value

Note: if the server doesnt answer within a time interval, then the URC
#AGPSRING <http_status_code> parameter has value 0

AT#AGPSSND=? Test command returns OK





m2mLOCATE Application Note
80000NT10090A Rev. 2 2013-10-10

Reproduction forbidden without written authorization from Telit Communications S.p.A. - All Rights Reserved. Page 12 of 12
Mod. 0809 2011-07 Rev.2

6. Abbreviations and acronyms

APN Access Point Name
DCE Data Communication Equipment
DTE Data Terminal Equipment
GNSS Global Navigation Satellite System
NVM Non Volatile Memory
PDP Packet Data Protocol
SW Software
TTFF Time To First Fix
URC Unsolicited Result Code