tt8750+an003 skypatrol comparison handbook rev 1_0 doc.pdf

22
Application Notes TT8750+_AN003 Comparison HandBook Version1.0 Revision 1.0 Confidential and Proprietary Information – © 2012 Skypatrol, LLC. Do not duplicate without express permission from Skypatrol, LLC

Upload: bruno-valarezo

Post on 20-Jul-2016

68 views

Category:

Documents


13 download

TRANSCRIPT

Page 1: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

Application Notes TT8750+_AN003

Comparison HandBook Version1.0

Revision 1.0

Confidential and Proprietary Information – © 2012 Skypatrol, LLC.

Do not duplicate without express permission from Skypatrol, LLC

Page 2: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

Revision: 1.0

GENERAL TERMS OF USE OF NEW MATERIALS - PLEASE READ CAREFULLY

From time to time, SkyPatrol LLC, in its sole discretion, may make available for download on its website (www.enfora.com), or may transmit via mail or email, updates or upgrades to, or new releases of, the firmware, software or documentation for its products (collectively, 'New Materials'). Use of such New Materials is subject to the terms and conditions set forth below, and may be subject to additional terms and conditions as set forth in SkyPatrol's Technical Support Policy (posted on its website) and/or any written agreement between the user and SkyPatrol LLC.

All New Materials are provided AS IS. SkyPatrol LLC makes no warranty or representation with respect to the merchantability, suitability, functionality, accuracy or completeness of any such New Materials. The user of such New Materials assumes all risk (known or unknown) of such use. SkyPatrol LLC reserves all rights in such New Materials. The user shall have only a revocable and limited license to use such New Materials in connection with the products for which they are intended. Distribution or modification of any New Materials without SkyPatrol's consent is strictly prohibited.

IN NO EVENT WILL ENFORA BE RESPONSIBLE FOR ANY INCIDENTAL, INDIRECT, CONSEQUENTIAL OR SPECIAL DAMAGES AS A RESULT OF THE USE OF ANY NEW MATERIALS. ENFORA'S MAXIMUM LIABILITY FOR ANY CLAIM BASED ON THE NEW MATERIALS SHALL NOT EXCEED FIFTY U.S. DOLLARS ($50).

COPYRIGHT © 2012 SkyPatrol LLC. All rights reserved. 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 and the SkyPatrol logo are either registered trademarks or trademarks of SkyPatrol LLC. in the United States.

3055 NW 84th Ave. Doral, FL 33126 USA Phone: (786) 331-3335 Email: [email protected] www.skypatrol.com

Page 3: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

Revision: 1.0

TABLE OF CONTENTS General ................................................................................................. 1

Copyright ............................................................................................... 1

Table of Contents ...................................................................................... 1

1 Overview ....................................................................................... 1

1.1 Objective ....................................................................................... 1

1.2 Scope ........................................................................................... 1

2 Comparison Table .............................................................................. 2

2.1 definition ....................................................................................... 2

2.2 TABLE ........................................................................................... 2

3 Commands Comparison ....................................................................... 4

4 Function Use ................................................................................... 8

5 Function Comparison .........................................................................11

Page 4: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 1 Revision: 1.0

1 Overview

1.1 OBJECTIVE This document presents the similarities and new features in unit TT8750+ compared with previous models.

1.2 SCOPE This document outlines a comparison between SkyPatrol models, command definitions and their equivalence with previous models and new features included.

Page 5: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 2 Revision: 1.0

2 Comparison Table

2.1 DEFINITION

SkyPatrol TT8750+ is a new hardware that includes the flexibility and robustness API of the TT8750 with new features that will leverage the options of configuration and new reports. A comparison table is shown below.

2.2 TABLE

Page 6: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 3 Revision: 1.0

Equipment Feature TT8750 TT8950 TT8750+

GSM Bands (MHZ) 850/900/1800/1900 850/900/1800/1900 850/900/1800/1900 GPS Channels 12 20 50Precision (meters) 3 2.5 2.5Sensitivity (dBm) -160 -162 -162Cold/Warm/Hot Start(seg) 35/<35/5 35/<35/3 35/<35/1Memory Log (aprox) 3000 registros(Binary) 3000 registros(Binary) 3000 registros(Binary)Firmware OTA Yes Yes YesCircular Geofences 25 25 250Poligonal Geofences 25 (Licensed) 25 (Licensed) 25Route Geofences N/A N/A 25UDP/TCP Yes Yes YesASCII/Binary Yes Yes YesBack-up Batery Yes Yes YesDigital Input 2 2

Digital Output 2(amplification required, non latched)

2 (150mA, non latched)

Latched Output 1 1 1Analog Inputs 0 2 1 ADC(0-16V) / 1(ADC2 or input)

Ignition Sensor 1 1 1Accelerometer / Motion 0 1 (A) 1 (M)GPS status Antenna Yes N/A YesGSM status Yes N/A YesJamming Detection Yes Yes YesProgramming Port USB 1 Mini USBData Port N/A 1 RS232User Variables 10 10 10Counters 10 10 32Script Lines 400 400 400Audio Stereo Audio Plug 2.5 mm Differential Audio Differential AudioPower Voltage 7 - 38 VDC 9 - 16 VDC 8 - 32 VDCWeight (gr) 100 85 89Odometer 2 2 2Heading Report Yes via script Yes YesData and I/O's connector Molex 8 Pins Molex 16 Pins Mini USB / Molex 16 PinsGSM Antenna connector Fakra Internal InternalGPS Antenna connector Fakra Internal Internal / External SMAPort Expander Yes N/A YesGarmin Support Yes N/A Yes*Temperature Sensor Yes N/A YesIbutton Yes N/A YesPC Onboard Reader Yes N/A Yes

2 GPIO

1 RS232

Page 7: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 4 Revision: 1.0

3 Commands Comparison

Page 8: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 5 Revision: 1.0

Page 9: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 6 Revision: 1.0

Page 10: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 7 Revision: 1.0

Page 11: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 8 Revision: 1.0

4 Function Use

The following are examples of functions supported in TT8750 and its equivalence in TT8750+

Distance Report

Description: The device will send a UDP messages to all servers, every 200 meters

For TT8750 we used to set a distance event using category 16 and set distance in param1, in the following example we will also filter the distance report with Ignition ON:

AT$EVENT=10,0,16,200,1000000

AT$EVENT=10,2,7,1,1

AT$EVENT=10,3,40,10,528454

In TT8750 the report mask is configured in every group, so it was a bit trickier to change report mask as it was necessary to change every group. In contrast to this in TT8750+ the report mask is configured in a single command AT$TTMSGMASK allowing to have an easier way to deal with report mask.

In TT8750+, the distance, timed and any other types of counters can be achieved with the combination of commands AT$TTCNT and AT$TTFNC. In example:

. We will use category 14 as a generic category for all counters like:

AT$TTMSGMASK=1,406327550 //Message Mask type 1

AT$TTCNT=1,1 //set Counter 1 as Distance Counter

AT$TTFNC=10,1,14,1,200 //set Distance Counter to 200 meters

Page 12: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 9 Revision: 1.0

AT$TTFNC=10,2,9,1,1 //Ignition ON

AT$TTFNC=10,3,26,10,1 //Report to all servers with Message Mask

Counter type 2: Time

Description: The device will send a UDP messages to all servers, every 300 second

In TT8750 a time report is done by setting time in command AT$EVTIM in combination with category 12 as an occurrence type like:

AT$EVTIM1=300

AT$EVENT=11,1,12,1,1

AT$EVENT=11,3,42,11,528590

In TT8750+ it would be like:

AT$TTCNT=2,2

AT$TTFNC=11,1,14,2,300

AT$TTFNC=11,3,26,11,1

The Skypatrol device can use the following type of counters:

• Distance (counter type 1) It is used to count distance, the value will be in meters

• Time (counter type 2) It is used to count time, the value will be in seconds

• High Time (counter type 3) It is used to measure time when function define by <group> is active.

• Low Time (counter type 4) It is used to measure time when function define by <group> is not active.

• High Distance (counter type 5) It is used to measure distance when function define by <group> is active.

Page 13: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 10 Revision: 1.0

• Low Distance (counter type 6) It is used to distance when function define by <group> is not active.

• Accumulator (counter type 7) It is incremented o decremented by action (output function category 55 and 56

• Toggle Accumulator (counter type 8) It increments on every change to set for given <group>

Page 14: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 11 Revision: 1.0

5 Function Comparison The <function type> parameter defines the type of function: Input or Output. An Input function can be defined as: Transition, Occurrence, or Input. The Output function is executed when input function conditions are met.

Type in TT8750+ Type in TT8X50 Description

0 0 Transition Trigger (Low to High) - Modified feature

1 1 Occurrence Trigger

2 2 AND condition

3 3 Output

4 N/A OR condition – New Feature

5 N/A NOT condition – New Feature

6 N/A Transition Trigger (High to Low) - Modified feature

The <function category> parameter defines the actual Input or Output Function number and their valid range for <parm1> and <parm2>. New and modified features have been highlighted.

Input Function Table Function Category TT8X50

Function Category TT8750+

Parm1 Parm2 Description

0 0 0 or 1 0 or 1 GPIO1 – General purpose Input #1 0 = Low 1 = High

1 1 0 or 1 0 or 1 GPIO2 – General purpose Input #2 2 2 0 or 1 0 or 1 Reserved

Page 15: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 12 Revision: 1.0

3 3 0 or 1 0 or 1

GPIO4 – General purpose input, detects the state of main power. 0 = Main power disconnected 1 = Main power connected

7 9 0 or 1 0 or 1 GPIO9 – General purpose input, detects the state of Ignition

8 10 1 1 Modem power up indication

9 11 0 to 5 0 to 5 Modem GSM registration (see AT+CREG command description for GSM registration status information)

10 12 0 to 8 0 to 8 Modem GPRS registration (see AT%CGREG command description for GPRS registration status information)

11 13 0 or 1 0 or 1 Receipt of IP address. 0 = No IP address 1 = Valid IP address obtained

12 to 15 66 to 69 14 1 - 32 0-2147483647

Counter function, <param1> is a <counter index> and <param2> is a counter limit, if <paream2> is equal 0 then the limit will be the value defined with the command AT$TTCNT

17 15 0 to 250 0-250 Current Velocity (unit of measurement is: Knots) 18 16 0-1600 0-1600 Analog input 1 function (mV) 19 17 0-1600 0-1600 Analog input 2 function (mV)

25 to 50 18 1 - 25 0 or 1

Geofence #. See AT$TTGEOFNC command for details on setting a circular geo-fence <param1> is a <geofence index> And <param2> 0 = Leaving Geofence area 1 = Entering Geofence area

27 19 0 or 1 0 or 1 GPS Status 0 = Invalid GPS data 1 = Valid GPS data

N/A 20 1 1 Time of day function N/A 21 1 - 32 1 Day of the week function

29 22 0 to 1000000 1000000 Invalid GPS data for a period of time (unit of measurement is: seconds)

30 23 0 to 1000000 1000000 Unit staying Idle in one place (unit of measurement is: seconds)

Page 16: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 13 Revision: 1.0

60 24 0 – 3200 0 – 3200 Number of Unsent Messages ($msglogrd count) 61 25 0 – 100 0 – 100 Memory full percentage ($msglogrd)

91 26 0-2147483647 0-2147483647 Current $TTODOM value

72 27 1 - 3 0-1

<param1> is an <over speed index> And <param2> is 0 = A GPS over speed interval has ended 1 = A GPS over speed interval has begun

70 28 0-2147483647 0-2147483647 Trip odometer (distance in meters)

150 29 0-1 0-1 Motion Function 0: Not motion 1: Motion

30 30 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 0

31 31 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 1

32 32 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 2

33 33 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 3

34 34 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 4

35 35 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 5

36 36 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 6

37 37 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 7

38 38 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 8

Page 17: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 14 Revision: 1.0

39 39 -2147483648

to 2147483647

-2147483648 to

2147483647

User variable 9

111 40 0 or 1 0 or 1

GSM_JAMMING_STATE Current state of the GSM jamming detection algorithm. JAMMED = 1 CLEAR = 0

41 41 0 0 Reserved

120 to 129 132 to 146

42 1-25 0 or 1

Polygon Geofence. See $TTPLYGFN for details on setting a polygonal geofence. <Param1> is a <polygon geofence index> And <param2> is 0 = Leaving Geofence area 1 = Entering Geofence area

N/A 43 1-25 0 or 1

Route. See $TTROUTE for details on setting a Route. <Param1> is a <route index> And <param2> is 0 = Leaving route 1 = Entering route

147 44 1 1

This function is triggered at the completion of a FOTA upgrade after the modem has rebooted with the new firmware (old firmware if the upgrade failed).

148 to 149 45 0-359 0-359 Heading function

71 46 0-1 0-1 GPS antenna status 0: Antenna disconnected 1: Antenna connected

N/A 47 0-1 0-1 Simcard status 0: Removed 1: Inserted

19 48 0-100 0-100 Internal battery level (%) 65 49 1-5 1-5 Voice call identification

N/A 50 300-1200 300-1200 External battery voltage

Page 18: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 15 Revision: 1.0

Output Function Table

Output Function Table

Function Category TT8X50

Function Category TT8750+

Parm1 Parm2 Description

8 to 22

3 0-1 0-1 Set GPIO3’s output state 5 0-1 0-1 Set GPIO5’s output state 6 0-1 0-1 Set GPIO6’s output state 7 0-1 0-1 Set GPIO7’s output state, USR1 LED 8 0-1 0-1 Set GPIO8’s output state, USR2 LED

N/A 9 0-1 0-1 Start/Stop buzzer N/A 10 See GPIO Flash Table Flash buzzer

32 to 38

15

See GPIO Flash Table

Flash GPIO #3 configured as Output 16 Flash GPIO #5 configured as Output 17 Flash GPIO #6 configured as Output 18 Flash GPIO #7 configured as Output 19 Flash GPIO #8 configured as Output

40 20

0 to 2147483647

See Messages type Table

Generate and transmit one UDP Message to first IP address and port listed in $TTSRVDST command on Parm1 and Parm2 values

N/A 21 Generate and transmit one UDP Message to second IP address and port listed in $TTSRVDST command on Parm1 and Parm2 values

N/A 22 Generate and transmit one UDP Message to third IP address and port listed in $TTSRVDST command on Parm1 and Parm2 values

N/A 23 Generate and transmit one UDP Message to forth IP address and port listed in $TTSRVDST command on Parm1 and Parm2 values

N/A 24 Generate and transmit one UDP Message to fifth IP address and port listed in $TTSRVDST command on Parm1 and Parm2 values

Page 19: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 16 Revision: 1.0

41 25

Generate and transmit a UDP message with Acknowledge. This message is controlled by $TTACKCFG command for number of retries sent. This message has to be acknowledged to avoid sending of retries.

42 26 Generate and transmit one UDP Message to all IP address and port listed in $TTSRVDST command based on Parm1 and Parm2 values

43 27 1 – 32 <limit> Resets the counter specified by Parm1 to the limit specified by Parm2.

44 28 1 – 25 0 Execute AT command stored at index number of the $TTSTOCMD command. Parm1 identifies the index number.

45 29 0 to 2147483647

See Messages type Table

Sends data over SMS to All SMS destination addresses configured via $TTSMSDST command. (For select $SMSDST entries, see function categories 54-58)

54 30 0 to 2147483647

See Messages type Table

Sends data over SMS to the first indexed SMS destination address configured via $TTSMSDST command.

55 31 0 to 2147483647

Sends data over SMS to the second indexed SMS destination address configured via $TTSMSDST command.

56 32 0 to 2147483647

Sends data over SMS to the third indexed SMS destination address configured via $TTSMSDST command.

57 33 0 to 2147483647

Sends data over SMS to the fourth indexed SMS destination address configured via $TTSMSDST.

58 34 0 to 2147483647

Sends data over SMS to the fifth indexed SMS destination address configured via $TTSMSDST command.

49 35 1 – 25 0 - 1000000 Set circular geo-fence specified by parm1 to current latitude & longitude with radius specified by parm2

50 36 0 – 57 0 to –1 Emulate AT$TTTRGEV command via function engine. Parm1 is the input function number while Parm2 is the value to emulate for the input function

52 37 0 to –1 See Messages type Table

Generate and transmit one TCP/IP Message to IP address & port number listed by $TTSRVDST command based on Parm1 and Parm2 values

Page 20: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 17 Revision: 1.0

60 38 0 to -1 See Messages type Table

Generate and transmit message to main serial port based on Parm1 and Parm2 values in ASCII. If messages format is in binary the information will be show in hexadecimal format

39 39 0 to –1 See Messages type Table

Save the Message in the log based on Parm1 and Parm2 values

N/A 40 0-1 0-1 Enter the GPS in sleep mode 0: No sleep 1: Sleep

N/A 41 0-2 0-2

Enter the Communication module in sleep mode 0: No sleep 1: GPRS in sleep 2: GSM and GRPS in sleep

125 42 0 – 9 -2147483648 to 2147483647

Sets user variable indicated by parm1 to value of parm2 (for example, if parm1 is 7 and parm2 is 50, this output function would set user variable 7 to 50)

126 43 0 – 9 -2147483648 to 2147483647

Increments user variable indicated by parm1 by value of parm2 (for example, if parm1 is 4, parm2 is 100, and user variable 4 was 200 prior to this function, user variable 4 would be incremented to 300 by this function)

127 44 0-9 -2147483648 to 2147483647

Decrements user variable indicated by parm1 by value of parm2 (for example, if parm1 is 4, parm2 is 100, and user variable 4 was 200 prior to this function, user variable 4 would be incremented to 300 by this function)

130 45 0 – 9 -2147483648 to 2147483647

Multiply user variable indicated by parm1 by value of parm2 (for example, if parm1 is 9, parm2 is 10, and user variable 9 was 50 prior to this function, user variable 9 would be decremented to 500 by this function)

131 46 0-9 -2147483648 to 2147483647

Divide user variable indicated by parm1 by value of parm2 (for example, if parm1 is 4, parm2 is 100, and user variable 4 was 200 prior to this function, user variable 4 would be incremented to 300 by this function)

128 47 0 – 9 -2147483648 to 2147483647

Copies value of a system variable into user variable indicated by parm1. Parm2 is used as an index to determine the system variable that will be copied (see User Variable Index Table)

Page 21: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 18 Revision: 1.0

N/A 48 0-4 0-1

Send buffer <param1> 0 = function data that was configured to be sent to a remote server via UDP 2 = function data that was configured to be sent to a remote server via SMS only 3 = function data that was configured to be sent to a remote server via TCPAPI only 4 = function data that was configured to be save in the buffer <param2> 0: Send to first server defined 1: Send to the serial port

N/A 49 1-2 1 Reset the GPS 1: cool boot 2: warm boot

N/A 50 1 1 Reset the communication module N/A 51 1 1 Reset the unit

53 52 0-16 0-1

Set the time of day function as a current RTC time <param1> function index <param2> 16-31 = period 0-16 bits = frequency 1 = minutes 2 = hours 4 = days 8 = months

N/A 53 1-32 1 to 2147483647

Increments counter indicated by parm1 by value of parm2 (for example, if parm1 is 4, parm2 is 100, and counter 4 was 200 prior to this function, counter 4 would be incremented to 300 by this function) It is applicable only for counter type 7

N/A 54 1-32 1 to 2147483647

Decrements counter indicated by parm1 by value of parm2 (for example, if parm1 is 4, parm2 is 100, and counter 4 was 200 prior to this function, counter 4 would be incremented to 100 by this function) It is applicable only for counter type 7

N/A 55 1-32 0 Disable counter indicated by parm1

Page 22: TT8750+AN003  SkyPatrol  Comparison Handbook  Rev 1_0 doc.pdf

SkyPatrol TT8750+ Application Notes – Comparison Handbook

P a g e 19 Revision: 1.0

N/A 56 1-32 0 Enable counter indicated by parm1