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:

TS-EMEA@telit.com TS-NORTHAMERICA@telit.com TS-LATINAMERICA@telit.com TS-APAC@telit.com

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: Telit’s 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 Telit’s 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 doesn’t 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