TT8750 Event Cookbook V2.pdf

32
Skypatrol TT8750+ GSM/GPRS Function Cookbook Release 1.00a Confidential and Proprietary Information – © 20012 Skypatrol, LLC. Do not duplicate without express permission from Skypatrol, LLC. Application Note: TT8750+

Transcript of TT8750 Event Cookbook V2.pdf

Page 1: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750+ GSM/GPRS

Function Cookbook Release 1.00a

Confidential and Proprietary Information – © 20012 Skypatrol, LLC. Do not duplicate without express permission from Skypatrol, LLC.

Application Note: TT8750+

Page 2: TT8750  Event Cookbook  V2.pdf

Version: 1.00a Date: 28/03/12 Status: Draft Document Control ID: TT8750 Plus General All efforts have been made to ensure the accuracy of material provided in this document at the time of release. However, the items described in this document are subject to continuous development and improvement. All specifications are subject to change without notice and do not represent a commitment on the part of Skypatrol, LLC. Skypatrol, LLC. will not be responsible for any loss or damages incurred related to the use of information contained in this document. This product is not intended for use in life support appliances, devices or systems where a malfunction of the product can reasonably be expected to result in personal injury. Skypatrol, LLC. customers using, integrating, and/or selling this product for use in such applications do so at their own risk and agree to fully indemnify Skypatrol, LLC. for any damages resulting from illegal use or resale. Copyright Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording or otherwise), or for any purpose, without the express written permission of Skypatrol, LLC. Skypatrol may have patents, patent applications, trademarks, copyrights or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Skypatrol, the furnishing of this document does not give you any license to these patents, trademarks, copyrights or other intellectual property. ©20012, Skypatrol, LLC. All rights reserved.

Page 3: TT8750  Event Cookbook  V2.pdf

Revision History

Skypatrol Evolution GSM/GPRS MLU Function Cookbook

TT8500AN014

Date Rev Author Description

March 28, 2012 1.00a Flor. Hernandez Initial Release

Page 4: TT8750  Event Cookbook  V2.pdf

Table of Contents OBJECTIVE: ........................................................................................................................................................ 1 SUPPORTED DEVICES: ....................................................................................................................................... 1 EQUIPMENT NEEDED: ....................................................................................................................................... 1 REFERENCES: ..................................................................................................................................................... 1 PROCEDURES: ................................................................................................................................................... 2

1. SKYPATROL TT8750+ TEST WIRING DIAGRAMS. .............................................................................................. 3 2. TT8750 PLUS DEFINITIONS ........................................................................................................................ 3 3. PULSE FUNCTION CONFIGURATION ............................................................................................................... 7 4. MAX SPEED EXCEEDED REPORTING CONFIGURATION ....................................................................................... 11 5. TIME-DISTANCE REPORTING CONFIGURATION ............................................................................................... 12 6. GEO-FENCING CONFIGURATION ................................................................................................................. 20 7. GPS IDLE TRIGGER.................................................................................................................................. 24 8. INVALID GPS DATA ................................................................................................................................. 25 9. PANIC BUTTON SAMPLE DESIGN................................................................................................................. 25 10. DOOR SWITCH DETECT TO SMS MESSAGE ............................................................................................... 26

Page 5: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 1 of 32

Objective: The intent of this document is to provide information that details the steps necessary to configure the Skypatrol TT8750+ interface. Supported devices:

• TT8750+ Note: Some features may not be available on some hardware or firmware revisions. Please consult the applicable hardware documentation and firmware release notes.

Equipment Needed:

In this example the requirements are:

• A modem • A notebook or desktop computer with any version of Microsoft Windows

that has the HyperTerminal communications program. If this software is not available, the user could use a DOS terminal emulation program or DUMB ASCII terminal.

References:

Page 6: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 2 of 32

Procedures:

!

Please note that the following function commands are examples only. When implementing, use the command AT$TTFNT? to query the function table and use the next sequential function group number. Failure to do so could potentially cause unpredictable results.

Some of these examples require that communication is established with a remote server. Read and understand the appropriate Quick Start Guide for your device prior to attempting these examples. Always verify that the local serial connection session is actually established with the Skypatrol TT8750+ modem.

Page 7: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 3 of 32

1. Skypatrol TT8750+ Test Wiring Diagrams.

a. The following diagrams detail additional wiring that will be required to validate some of these examples.

i. TT8750+

Switch and LED connection

2. TT8750 Plus Definitions

a. There are a total of three LEDs on the Skypatrol TT8750+. • The power LED reflects the state of the power supplied to the unit. The

user cannot change the power LED functionality. • The other two LEDs are user-configurable and can be changed from the

factory default definitions. The following displays the factory default settings.

Page 8: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 4 of 32

Power LED display: o LED ON when power line connected to the device or the internal

battery is working o LED OFF when the device is disconnected from the unit

Registration LED display (GSM): o LED OFF when unit is not registered or not trying to register or the

unit has no power o LED blinking when unit is trying to register to the network o LED solid ON when GSM is connected

GPS Fix LED display (GPS): o LED OFF when a GPS fix has not been acquired o LED solid ON when GPS fix has been acquired

The LED’s on the Skypatrol TT8750+ are controlled by the function processing capability provided in the AT command structure. The following AT command settings provide an example of the use of function processing to reflect registration and GPS status. This example uses the actual GPIO7 / GSM for the Registration LED. The other user configurable LED (GPIO8 / GPS).

AT$TTFNT=1,0,19,1,1

GPS status ending value of 1 GPS status beginning value of 1 Monitor GPS Status Input transition function Function group 1 AT$TTFNT=1,3,8,1,1

N/A N/A Set GPIO8 (GPS) to high Output function Function group 1

Page 9: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 5 of 32

AT$TTFNT=2,0,19,0,0

GPS status ending value of 0 GPS status beginning value of 0 Monitor GPS Status Input transition function Function group 2 AT$TTFNT=2,3,8,0,0

N/A N/A Set GPIO 8 (GPS) to low Output function Function group 2 AT$TTFNT=3,0,11,2,4

+CREG ending value of 4 +CREG starting value of 2 Monitor +CREG value Input transition function Function group 3 AT$TTFNT=3,3,18,1,0

Flash forever Flash at ¼ second intervals Flash GPIO 7 (GSM) Output function Function group 3

Page 10: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 6 of 32

AT$TTFNT=4,0,11,5,5

+CREG ending value of 5 – Registered on network, Roaming +CREG starting value of 5 – Registered on network, Roaming

Monitor +CREG value Input transition function Function group 4 AT$TTFNT=4,4,11,1,1

+CREG ending value of 1 +CREG starting value of 1 Monitor +CREG value Or condition Function group 4 AT$TTFNT=4,3,7,1,1

N/A N/A Set GPIO7 (GSM) to High Output function Function group 4 AT$TTFNT=5,0,11,0,0

+CREG ending value of 0 – Not Registered +CREG starting value of 0 – Not Registered Monitor +CREG value Input transition function Function group 5 AT$TTFNT=5,3,7,0,0

N/A N/A Set GPIO7 (GSM) to Low Output function Function group 5

Page 11: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 7 of 32

Query the FUNCTION table: AT$TTFNT? The table should reflect the following: $TTFNT: funcgrp functyp funccat p1 p2

1A 0 19 1 1 1B 3 8 1 1 2A 0 19 0 0 2B 3 8 0 0 3A 0 11 2 4 3B 3 18 1 0 4A 0 11 5 5 4B 4 11 1 1 4C 3 7 1 1 5A 0 11 0 0 5B 3 7 0 0

Results: GPIO7 (GSM) should flash at ¼ second intervals until device is registered on home or roaming networks. Once registered, GPIO7 (GSM) will go high. If registration status is lost, the I/O pin will flash.

3. Pulse Function Configuration

Note: In the following discussion, OFF equals a signal low (0 Vdc) state and ON equals a signal High state.

a. The Skypatrol TT8750+ product line contains detailed function processing

capability via the AT command structure. The TT8750+ modem allows a user to toggle the GPIO line to an On/Off state. The I/O line can pulse in multiples of quarter second (250 ms) increments. The user can select ON time and OFF time (in multiple of 250 ms increments) as desired.

b. Parameter 1 defines the flash pattern of the LED:

The upper 16 bits (bits 16 – 31) are defined as OFF time while the lower 16 bits (bits 0 – 15) are defined as ON time. If the OFF time is not specified (set to 0), then ON time will be the same as OFF time.

Page 12: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 8 of 32

c. Parameter 2 defines the toggle count.

A value of 0 for toggle count means the I/O will be toggled forever. A user can select the number of times the pattern is toggled starting from the current I/O state. The user can select the final state of the I/O line to be either same as the current state or opposite of the current state. To select the final state to be the same as current state, the toggle count should be set to an even number. To select the final state to be opposite of the current state, the toggle count should be set to an odd number.

d. The following AT command settings provide an example of the use of function processing to toggle an output line based on an input function.

Example 1: AT$TTFNT=10,0,0,1,1

Ending range of 1 (high) Starting range of 1 (high) Activity on I/O line #1 based on range Input transition function Function group 10

AT$TTFNT=10,3,18,1,8

(Parameter 2) Pulse 8 times before returning (Parameter 1) Pulse at ¼ second intervals Pulse GPIO #7 based on Parm1 and Parm2 values Output function Function group 10

Query the FUNCTION table: AT$TTFNT? The table should reflect the following:

$TTFNT: funcgrp functyp funccat p1 p2 10A 0 0 1 1 10B 3 18 1 8 AT$TTTRGV (to test this example):

Page 13: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 9 of 32

Note: In order to perform the test again, both AT$TTTRGV commands need to be sent. Set the IOGP to be in low state. AT$TTTRGV=0,0 Create a low input signal Function category 0 (Input line 1) AT$TTTRGV=0,1 Create a high input signal

Function category 0 (Input line 1)

Results: GPIO pin #7 will toggle 8 times (4 high and 4 low state transitions) at ¼ second intervals each time the AT$TTTRGV sequence above is issued.

Note: If Example 1 was entered into the modem, function 10 will need to be deleted prior to performing example 2. Send the following command to delete existing function 10. AT$TTFNTDEL =10

Example 2:

AT$TTFNT=10,0,0,1,1

Ending range of 1 (high) Starting range of 1 (high) Activity on I/O line #1 based on range Input transition function Function group 10

AT$TTFNT=10,3,18,65539,5

(Parameter 2) Pulse 5 times before returning (Parameter 1) Pulse at ¼ second intervals and ¾ second at high transition Pulse GPIO #7 based on Parm1 and Parm2 values Output function Function group 10

Query the FUNCTION table:

Page 14: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 10 of 32

AT$TTFNT? The table should reflect the following:

$TTFNT: funcgrp functyp funccat p1 p2 10A 0 0 1 1 10B 3 18 65539 5 Note: The value 65539 for Parm1 is derived as follows:

Bits 0 – 15 describe the High state for the I/O. In this example, we have selected the IO to remain in high state for ¾ seconds or 0x0003 (hex) as the lower 16 bits. Bits 16 – 31 describe the Low state for the I/O. In this example, we have selected the IO to remain in low state for ¼ second or 0x0001 (hex) as the upper 16 bits. When we combine the upper and lower 16 bits, we get: 0x00010003 in hex or 65539 in decimal.

AT$TTTRGV (to test this example): AT$TTTRGV=0,0 Create a low input signal Function category 0 (Input line 1) AT$TTTRGV=0,1 Create a high input signal

Function category 0 (Input line 1)

Results: GPIO pin #7 will toggle 5 times (3 high and 2 low state transitions). The IO will initially start with a High state. It will remain in that state for ¾ seconds and then transition to low state for ¼ second. After a total toggle count of 5, the IO will remain in the final state – High (since our starting

Page 15: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 11 of 32

state was Low). Issue the AT$TTTRGV command sequence to observe the results again.

4. Max Speed Exceeded Reporting Configuration

Note: The following examples require the TT8750+ device to report to a remote server. If you do not have one configured, refer to the appropriate User Guide to enable communication with Skypatrol’s test server.

a. Type the following commands to send a GPS RMC NMEA message OTA when MLU exceeds 30 Knots.

Maximum Speed = 30 (knots) (30 Knots ≈ 35 mph ≈ 56 Km/Hr) AT$TTFNT=11,0,15,30,250

250 (max speed) Max Speed to monitor (0 – 249) Monitor speed (Input Function Number) Input transition function Function group 11

AT$TTFNT=11,3,20,40,1

OTA Message mask User Specified number Send OTA UDP Message to first IP address Output function Function group 11

Results:

The output message format is generated based on the number “4350” set in the AT command: AT$TTMSGMASK =<Message type>, <message mask>

Message type Description

0 Keep alive message 1 Position report messages 2 Counter messages 3 Variables messages 4 Geofence messages

Page 16: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 12 of 32

Message Mask Decode is as follows:

AT$TTMSGMASK=1,4350 Message Mask decode = 4350 Bit 00 > ASCII Bit 01 > PARAM1 (11 bytes ASCII) Bit 02 > MDMID (22 bytes ASCII) Bit 03 > GPIO (6 bytes ASCII) Bit 04 > A/D 1 (5 bytes ASCII) Bit 05 > A/D 2 (5 bytes ASCII) Bit 06 > Store messages if out of GPRS coverage Bit 07 > Input Function Number (3 bytes ASCII) Bit 08 > Bit 09 > Bit 10 > Bit 11 > Bit 12 > RMC NMEA (Data max 80 bytes ASCII) Bit 13 > Bit 14 > Bit 15 > Bit 16 > Bit 17 > Bit 18 > Bit 19 > Bit 20 > Bit 21 >

A GPS RMC NMEA message will be sent to the IP address and port number (set by AT$TTSRVDST) every time the device exceeds speed of 30 Knots. The TT8750+ modem has to go below the set speed of 30 Knots in order to trigger the function again.

. 5. Time-Distance Reporting Configuration

a. Type the following commands to send a GPS RMC NMEA message OTA to a remote Server when time and/or distance settings are violated. Users must use time counters for minimum and maximum time when setting up for this feature. The time and/or distance feature is designed as described in the example table below:

Minimum Maximum Distance Comments

Page 17: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 13 of 32

Time (seconds)

Time (seconds)

(meters)

0 0 100 GPS message sent every 100 meters 0 60 0 GPS message sent every 60 seconds

30 0 100 GPS message sent when the vehicle has moved 100 meters or 30 seconds have elapsed.

0 60 100

GPS message sent every 60 seconds if the vehicle has not moved 100 meters. GPS messages will be sent every 100 meters if the vehicle is moving and traveling the distance of 100 meters in less than 60 seconds. In short, message is sent upon expiration of time or moving of distance – whichever occurs first.

30 60 100

GPS message sent every time the device travels 100 meters and 30 seconds have elapsed OR seconds have elapsed.

!

Choose only one option, from options 1 – 5 below, using section as a reference. Before attempting another option delete the existing functions by issuing the following commands: AT$TTFNTDEL=12 AT$TTFNTDEL=13 Use AT$TTMSGMASK=1,4350

The following AT command settings provide examples of the use of function processing to configure the Time and/or Distance feature.

1. Send GPS message every predefined distance is reached.

Page 18: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 14 of 32

AT$TTFNT=17,1,14,1,0

Counter limit, 0 defined by AT$TTCNT Counter index Counter function Input occurrence function Function group 17

AT$TTFNT=17,3,20,17,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 17

Results: A GPS RMC NMEA message will be sent to a remote user at

every z meters defined by AT$TTCNT command.

AT$TTCNT=1,1,z,0 Always 0 for distance counter Limit of the counter Counter type (Distance) Number of the counter

2. Send GPS message when Time expires.

Page 19: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 15 of 32

AT$TTFNT=12,1,14,7,0

Counter limit, 0 defined by AT$TTCNT Counter index Counter function Input occurrence function Function group 12

AT$TTFNT=12,3,20,80,1

OTA Message Mask User Specified number Send OTA UDP Message Output function Function group 12

Results: A GPS RMC NMEA message will be sent to a remote user at

every y time interval defined by AT$TTCNT command.

AT$TTCNT=7,2,y,0 Always 0 for time counter Limit of the counter Counter type (Time) Number of the counter

3. Send GPS message when Time OR Distance has elapsed.

Define the counters using AT$TTCNT command. AT$TTCNT=1,2,y,0 Y = time AT$TTCNT=2,1,z,0 Z= distance

Page 20: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 16 of 32

AT$TTFNT=12,1,14,1,0

Counter limit defined by $TTCNT Counter index Counter function (Time) Input occurrence function Function group 12

AT$TTFNT=12,4,14,2,0

Counter limit, 0 defined by AT$TTCNT Counter index 2 Counter function (Distance) Input OR function Function group 12

AT$TTFNT=12,3,20,8,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 12

AT$TTFNT=12,3,27,1,0

Reserved Reset Counter 1 Reset/Restart Timer Output function Function group 12

Results: A GPS RMC NMEA message will be sent to a remote user

every time the device travels z distance or y time interval has elapsed.

4. Send GPS message based on Time AND Distance. In this instance, a GPS message will not be sent to the remote user until the device travels specified distance and time has expired.

AT$TTCNT=1,2,x,0

Page 21: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 17 of 32

X = time AT$TTCNT=2,1,z,0 Z= distance AT$TTFNT=12,1,14,1,0

Counter limit defined by $TTCNT Counter index 1 Counter function (Time) Input occurrence function Function group 12

AT$TTFNT=12,0,14,2,0

Counter limit, 0 defined by AT$TTCNT Counter index 2 Counter function (Distance) Input transition function Function group 12

AT$TTFNT=12,3,27,1,0

Reserved Reset Counter 1 Reset/Restart Timer Output function Function group 12

AT$TTFNT=12,3,20,8,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 12

Page 22: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 18 of 32

Results: A GPS RMC NMEA message will be sent to a remote user every time the device travels z distance and x time interval has elapsed.

5. Send GPS message based on Minimum Time AND Distance OR when Maximum Time has elapsed.

In this instance, a GPS message will not be sent to the remote user until the device travels specified distance and minimum time has expired or distance has not been traveled and maximum time has expired.

Note: Maximum Time (y > x) has to be greater than Minimum Time

AT$TTCNT=1,2,x,0 X = time counter 1 AT$TTCNT=2,2,y,0 Y = time counter 2 AT$TTCNT=3,1,z,0 Z= distance AT$TTFNT=12,1,14,1,0

Counter limit defined by $TTCNT Counter index 1 Counter function (Time) Input occurrence function Function group 12

AT$TTFNT=12,0,14,3,0

Counter limit, 0 defined by AT$TTCNT Counter index 3 Counter function (Distance) Input transition function Function group 12

AT$TTFNT=12,3,27,1,0

Reserved Reset Counter 1 Reset/Restart Timer Output function Function group 12

Page 23: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 19 of 32

AT$TTFNT=12,3,27,2,0

Reserved Reset Counter 2 Reset/Restart Timer Output function Function group 12

AT$TTFNT=12,3,20,8,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 12

AT$TTFNT=13,1,14,2,0

Counter limit defined by $TTCNT Counter index 2 Counter function (Time) Input occurrence function Function group 13

AT$TTFNT=13,3,27,1,0

Reserved Reset Counter 1 Reset/Restart Timer Output function Function group 13

AT$TTFNT=13,3,27,2,0

Reserved Reset Counter 2 Reset/Restart Timer Output function Function group 13

AT$TTFNT=13,3,20,9,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 13

Results: A GPS RMC NMEA message will be sent to a remote user every time the device travels z distance and x time interval has

Page 24: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 20 of 32

elapsed OR y time interval has elapsed.

A GPS RMC NMEA message will be sent to the IP address and port number (set by AT$TTSRVDST).

The output message format is generated based on the number “4350” set in the AT command: AT$TTMSGMASK =<Message type>, <message mask>

Message type Definition

0 Keep alive message 1 Position report messages 2 Counter messages 3 Variables messages 4 Geofence messages

6. Geo-Fencing Configuration

a. The Skypatrol TT8750+ allows a user to configure maximum of 25 circular shape geo-fences. Skypatrol TT8750+ can be configured to send GPS messages to a remote user (server) whenever a device enters or exits a geo-fenced area. The geo-fence feature has to be configured with two commands: AT$TTGEOFNC and AT$TTFNT. To configure sending messages when a device enters or exits the geo fenced area, follow the example below:

NOTE:

• NMEA messages provide Latitude and Longitude information in “Degrees Minute Minute” format.

• To obtain the decimal value for Degrees, take Minute.Minute of the actual Latitude or Longitude and divide it by 60.

• Latitude value should be between –90.0 to +90.0 Degrees • Longitude value should be between –180.0 to +180.0 Degrees. • Latitude North of Equator line should always be positive Value. • Latitude South of the Equator line should always be negative value. • Longitude East of the GMT line should always be positive. • Longitude West of the GMT line should always be negative

Page 25: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 21 of 32

North

South

EastWest

GMT

Equator

Figure 1. Map of World Displaying Latitude and Longitude

Ex: Send a NMEA RMC GPS message when the SkyPatrol TT8750+ moves in/out

of the geo-fence area 1. Geo fence 1 is a 100 meter radius from the center point defined by Latitude = 33 01.5023 (North) and Longitude = 096 42.3853 (West). According to figure 6 above, Latitude of 33 01.5023 (North) would be a positive value (since its above the Equator line) but Longitude of 96 42.3853 (West) would be a negative value since it is west of the GMT line.

Verify each AT command sent to the modem returns OK. Radius: 100 meters Latitude: 33 01.5023 North = 33 + 01.5023/60

= 33.02503833 Longitude: 096 42.3853 West = -96 + 42.3853/60

= -96.70642167 AT$TTGEOFNC=1,100,33.02503833,-96.70642167

a. Send a GPS message when the unit leaves geo-fence 1

Page 26: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 22 of 32

AT$TTFNT=14,0,18,1,0

Transition OUT of geo-fence area Geo-Fence index Geo-Fence function category Input transition function Function group 14

AT$TTFNT=14,3,20,14,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 14

b. Send a GPS message when the unit enters geo-fence 1

AT$TTFNT=15,0,18,1,1

Transition IN the geo-fence area Geo-Fence index Geo-Fence function category Input transition function Function group 15

AT$TTFNT=15,3,20,15,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 15

Results: A GPS RMC NMEA message will be sent to a remote user

every time the device enters or exits the geo fence area. To add Geo-Fence 2, send the following commands to the TT8750+ and verify that an OK is returned.

AT$TTGEOFNC=2,100,34.02503833,-97.70642167 AT$TTFNT=16,0,18,2,0 AT$TTFNT=16,3,20,16,1 AT$TTFNT=17,0,18,2,1 AT$TTFNT=17,3,20,17,1

Page 27: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 23 of 32

For additional Geofences, repeat the 5 commands below by changing the GeoFence (index) number (A), radius (100), latitude (34.02503833), and longitude (-97.70642167) information for AT$GEOFNC command. And, increment the Function group numbers (B, C), Input Function (D), and User Specified Number (E, F) for AT$TTFNT command. Use the following table for the relationship between the numbers AT$TTGEOFNC=A,100,34.02503833,-97.70642167 AT$TTFNT=B,0,18,A,E AT$TTFNT=B,3,20,D,F AT$TTFNT=C,0,18,A,E AT$TTFNT=C,3,20,D,F

GeoFence Input Trigger Function number

Leave GeoFence Enter GeoFence Function User Number Function User Number

A D B E C F 1 14 14 0 15 1 2 15 16 0 17 1 3 16 18 0 19 1 4 17 20 0 21 1 5 18 22 0 23 1 6 19 24 0 25 1 7 20 26 0 27 1 8 21 28 0 29 1 9 22 30 0 31 1

10 23 32 0 33 1 11 24 34 0 35 1 12 25 36 0 37 1 13 26 38 0 39 1 14 27 40 0 41 1 15 28 42 0 43 1 16 29 44 0 45 1 17 30 46 0 47 1 18 31 48 0 49 1 19 32 50 0 51 1 20 33 52 0 53 1 21 34 54 0 55 1 22 35 56 0 57 1 23 36 58 0 59 1 24 37 60 0 61 1 25 38 62 0 63 1

Page 28: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 24 of 32

b. Results:

A GPS RMC NMEA message will be sent to the IP address and port number (set by AT$TTSRVDST) when it enters or exits a defined geo fence. The output message format is generated based on the number “4350” set in above example with the AT$TTFNT command.

17 TT8750Plus 75 0 0 14 GPRMC,222241.00,A, 3301.5023N,09642.3853,W,0.741,,100412,,,A*6D

7. GPS Idle Trigger

The Skypatrol TT8750+ maintains GPS Idle count. The Idle count is incremented every second that the unit has not moved and is stationary in one position. The user can elect to receive a GPS message when the Idle count exceeds. Idle count is measured in seconds.

Note: A GPS Idle Trigger message will only be sent once when the timer expires. The message will not be repeated if the device/vehicle has not moved.

1. To send a GPS message when the device/vehicle stays idle for 2 minutes (120

seconds), configure as follows:

AT$TTFNT=68,0,23,120,1000000

Max timeout value Idle time in seconds (120 seconds) GPS Idle Trigger Input Function Input transition function Function group 68

AT$TTFNT=68,3,20,68,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 68

Page 29: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 25 of 32

8. Invalid GPS data

The Skypatrol TT8750+ maintains GPS Invalid count. The Invalid count is incremented every second when the unit does not have valid GPS data. The user can select to receive a message when the Invalid count exceeds a set period. Invalid count is measured in seconds.

Note: A GPS Invalid Trigger message will only be sent once when the timer expires. The message will not be repeated if the device/vehicle has not acquired valid GPS data.

1. To send a message when the device/vehicle stays idle for 1 minutes (60 seconds), configure as follows:

AT$TTFNT=69,0,22,60,1000000

Max timeout value Idle time in seconds (60 seconds) GPS Invalid Function Input transition function Function group 69

AT$TTFNT=69,3,20,69,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 69

9. Panic Button Sample Design

In this example the Skypatrol TT8750+ will be configured to monitor a push button switch, flash a LED on switch closure, and send 10 additional messages to each server in the AT$TTSRVDST list or until one of the servers sends an acknowledgment response back. A message must be sent from the server to turn off the flashing LED. This example requires access to a UDP server.

1. Configure the modem to send a message twice to each server, 5 seconds

apart or until one of the servers sends the acknowledgement packet back. AT$TTACKCFG =10,5,0

Page 30: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 26 of 32

2. Add the following AT$TTFNT commands.

AT$TTFNT=72,0,0,1,1

Ending range of 1 (high) Starting range of 1 (high) Activity on I/O line #1 based on range Input transition function Function group 72

AT$TTFNT=72,3,17,1,0

Flash Forever Starting range of 1 (¼ second intervals) Flash GPIO 6 Output transition function Function group 72

AT$TTFNT=72,3,25,911,1

OTA Message mask User Specified number Send OTA UDP Message Output function Function group 72

3. Press the “Panic” button on the Skypatrol TT8750+. The LED attached to GPIO 6 will begin to flash at ¼ second intervals. Also the Skypatrol TT8750+ will start sending UDP messages.

4. After a couple of messages, an ACK has to be sent. One more message should

be sent and then the messages will stop. 5. To extinguish to LED type in the AT Command AT$TTIOCO6=0.

10. Door Switch Detect To SMS Message

In this example the Skypatrol TT8750+ will be configured to monitor a push button switch, such as the “door ajar” switch mounted on a vehicle, to inform the user via SMS messages on the state of the switch.

Page 31: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 27 of 32

1. Add the following AT$TTFNT commands to the TT8750+ AT$TTFNT=73,0,0,1,1

Ending range of 1 (high) Starting range of 1 (high) Activity on I/O line #1 based on range Input transition function Function group 73

AT$TTFNT=73,3,28,1,0

N/A Execute First AT$TTSTOCMD Command Execute AT$TTSTOCMD Output transition function Function group 73

AT$TTFNT=74,0,0,0,0

Ending range of 0 (low) Starting range of 0 (low) Activity on I/O line #1 based on range Input transition function Function group 74

AT$TTFNT=74,3,44,2,0

N/A Execute Second AT$TTSTOCMD Command Execute AT$TTSTOCMD Output transition function Function group 74

2. Set the Skypatrol TT8750+ AT$TTSTOCMD to send the “Door State” SMS messages.

AT$TTSTOCMD=1,AT$TTSNDMG=1,"Door open" AT$TTSTOCMD=2,AT$TTSNDMG=1,"Door closed"

3. Configure the cell phone number with the command

Page 32: TT8750  Event Cookbook  V2.pdf

Skypatrol TT8750 Plus GSM/GPRS Function Cookbook

TT8750 Plus (1.00a) Copyright 2012, Skypatrol, LLC.

Page 28 of 32

AT$TTSMSDST=1,"+15443515617" 4. Save the settings by using:

AT&W

5. Reset the Modem and allow it to attach to the GSM/GPRS Network. 6. When the switch is pushed on the modem, it will send the SMS message

stored in AT$TTSTOCMD =2. When the switch is released the SMS message stored in AT$TTSTOCMD =1.

End of Document