background image

3.11. REPORTS’ MESSAGES

For detailed information on this message refer to the

EV

message

on the

Unit’s TAIP reference

chapter

When configuring the

Event Machine

, on each event definition, the

user decides what

Reporting Message

the event shall generate. For

information on events’ configuration refer to the

Event Machine

sec-

tion of the

Configuration chapter

.

Firmware Version 5.21 supports the addition of information tags to
the

EV

reporting message so that more information can be included

on an event’s report.

The Extended Reporting Messages (Extended EV)

When using an

Extended Reporting EV Message

, extra tags are added

at the end of the standard

EV

message presented above. These tags

allow the addition of information on:

Inputs and Outputs state.

Counters’ values: Timers and distance counters.

Vehicle’s acceleration.

Altitude (AMSL).

Analog to Digital Converter value.

Back-up battery level.

Number of GPS-satellites in view.

GPRS/GSM network state.

The information tags are messages separated by the ’;’ symbol. They
are displayed after the

Source

and

Age

fields of the

EV

message and

the last of the tags is the ”‘

;ID=

”’ tag which has always been present

on every unit’s report. One example of such a report is:

>

REV381442578250-0802813900000012;AC=000;AL=02595;

[...]

[...]

SV=08;ID=EXAMPLE

<

One extended message can contain one extra tag or it can contain all avail-
able tags. The user decides which tags the unit must add to an

EV

message.

For information on how to make the unit generate

Extended EV Messages

see the

Configuration

chapter and the

XAEF

and

ED

messages.

3.11.2

Responses to TAIP Commands Messages

Firmware 5.21 allows the report of the response generated by a TAIP com-
mand included on an event’s user-action. This enables the unit to auto-query
a TAIP command based on the

Event Machine

and have the response to the

60

Summary of Contents for Antares SB

Page 1: ......

Page 2: ...Antares SB TM GSM User s Manual FW 5 21 Digital Communications Technologies April 15 2008...

Page 3: ...EV XAFU XARD Expanded information on Over The Air section Added section Reports messages on Operation chapter Added information on extended EV message Added information on Driving Metrics Added inform...

Page 4: ...uding cable loss must not exceed 3 dBi at 1900 MHz 1 4 dBi at 850 MHz for mobile operating configurations and 7 dBi at 1900 MHz 1 4 dBi at 850 MHz for fixed mounted operations as defined in 2 1091 and...

Page 5: ...arranty program Anyone returning goods to Digital Communications Technologies must first obtain an authorization number Digital Com munications Technologies will not accept any shipment whatsoever for...

Page 6: ...re governed by the laws of the State of Florida USA WARNING Digital Communications Technologies recommends that the entire system be completely tested on a regular basis However despite frequent testi...

Page 7: ...1 6 TCP and UDP support 18 1 1 7 Over the air control consult 18 1 1 8 Over the air upgrade 18 1 1 9 Versatile RS 232 communication 19 1 1 10 Communication buffer 19 1 1 11 Automatic outputs control...

Page 8: ...1 5 Specifications 29 1 5 1 Dimensions 29 1 5 2 Environment 29 1 5 3 Power 29 1 5 4 Inputs Ignition 30 1 5 5 Outputs 30 1 5 6 Analog To Digital Converter 30 1 5 7 Audio 30 1 5 8 GSM GPRS module 31 1...

Page 9: ...1 Via IP hosts GPRS 50 3 8 2 Via SMS GSM 53 3 8 3 Voice GSM 53 3 9 TAIP console 53 3 9 1 TAIP Message Format 54 3 9 2 Reporting messages 55 3 9 3 Interacting 56 3 10 Remote host software 56 3 10 1 Wor...

Page 10: ...ns DPs and DAs 74 4 3 1 Destination Points DPs 74 4 3 2 Destination Addresses DAs 75 4 4 Reporting 76 4 5 Event Machine 77 4 5 1 Triggers 77 4 5 2 Actions 79 4 5 3 Events 81 4 5 4 Signals 83 4 5 5 Exa...

Page 11: ...tting Started 106 5 1 1 Setting the unit s ID 106 5 1 2 Setting the APN and PIN 106 5 1 3 Creating a Destination Point DP 107 5 1 4 Creating a Destination Address DA 108 5 1 5 Creating a time period c...

Page 12: ...5 6 3 Creating the violation report 118 5 6 4 Something is missing 118 5 6 5 Driving the LED 118 5 6 6 Script 119 5 7 START STOP monitoring 120 5 7 1 Setting a low speed limit 121 5 7 2 Start a counte...

Page 13: ...on 141 6 3 DA Destination Address 142 6 3 1 Examples 143 6 4 DP Destination Point 144 6 5 ED Event Definition 146 6 5 1 Examples 148 6 6 ER Error Report 150 6 6 1 Example 150 6 7 ET Event Report time...

Page 14: ...ext Message 181 6 26 1 Escape sequences 181 6 27 VR Version number 182 6 28 XAAC Analog to Digital converter 183 6 29 XABS Battery Status 184 6 30 XACR Counter Report 185 6 30 1 Reported Message 185 6...

Page 15: ...6 51 XASF Store Forward Buffer 210 6 52 XATD Current Destination Point 211 6 53 XATM User defined Text Messages 212 6 54 XATS TAIP console Sniffer 213 6 54 1 Example 213 6 55 XAUN UDP Network 214 6 56...

Page 16: ...ping AVL servers on DAs 234 10 11Defining a periodic timer 234 10 11 1Using a time counter 234 10 11 2Using a Time And Distance counter 234 10 12Creating an event 234 10 13Creating a turn by turn head...

Page 17: ...ents called Application Notes which contains some specific development that falls beyond the scope of this document This manual is intended to be used by anyone interacting with the unit and having so...

Page 18: ...big complement of the Operation and Configuration chapters The Quick Start Guide is a very condensed summary to get you started with the unit 0 3 Technical Assistance You can contact Digital Communic...

Page 19: ...d and or controlled by using the unit s discrete inputs outputs analog to digital converter audio support and its RS 232 serial port The last one useful to communicate with expanding accessories such...

Page 20: ...TCP and UDP support The unit may send its reports via GPRS to IP hosts using TCP and or UDP transport protocols As an improvement from previous versions all IP type Destinations can be used either on...

Page 21: ...SB TM will use the carrier s DNS servers to resolve names This feature is very useful when the IP host s resides on an IP changing environment 1 1 13 Turn by turn report By tracking the vehicle s head...

Page 22: ...t be erroneously interchanged because of the reverse polarity condition of the GPS antenna connector 1 1 18 Event Reporting Antares SB TM has the ability to interpret complex user defined report ing c...

Page 23: ...ector for main power GPS Fix state GSM roaming state GSM registration state GPRS registration state GPRS attach state GPS Antenna short circuit state TCP connections state indicators Software reset in...

Page 24: ...its operation frequency An active GPS antenna with magnetic support and reverse polarity connector The I O harness 10 color coded cables 1 meter 3 28 feet long attached to a female molex type recepta...

Page 25: ...RS 232 signals available for se rial communication The DB9 signals pin out is Use this port to configure or query the unit and to connect accessories like PDA like devices or MDTs The Antares SB TM s...

Page 26: ...coin to get the SIM card fully inserted until it clicks The SIM gets locked when it clicks A click is only possible with the correct orientation To remove the SIM card push it with a thin object unti...

Page 27: ...cations section for information on the type of speaker and microphone that can be used The connector is designed to use a 2 5mm stereo plug with the fol lowing configuration A non balanced speaker mic...

Page 28: ...e center con tact5 Use this connector for the GPS Antenna supplied with the unit The reverse polarity condition of the connector and of the GPS an tenna connector assures that the GSM and GPS antenna...

Page 29: ...nfigured as follows Signal Color IP1 White and brown IP2 White and red IP3 White and orange IP4 White and yellow ADC White XP1 Blue and brown XP2 Blue and red XP3 Blue and orange XP4 Blue and yellow G...

Page 30: ...1 4 BACK SIDE DESCRIPTION The Power Harness female molex type receptacle supplied with the unit is configured as follows Signal Color V Red GND Black Ignition F00 Yellow 28...

Page 31: ...Storage 30 C to 85 C Humidity Up to 95 non condensing 1 5 3 Power DC Voltage 8V 32 V Current consumption With internal battery at full charge IDLE 60mA 12V With internal battery at zero charge IDLE 6...

Page 32: ...pen 1 5 5 Outputs Open Drain Continuous current capacity 2A Maximum instantaneous current 1 sec 10A Maximum switching voltage 30V Maximum repetition rate 1 sec Logical Electrical state Logical State E...

Page 33: ...tic and TUHigh E GSM900 Reference Sensitivity 104 dBm Static and TUHigh DCS1800 Reference Sensitivity 102 dBm Static and TUHigh PCS1900 Reference Sensitivity 102 dBm Static and TUHigh Selectivity 200...

Page 34: ...ters 90 Velocity 0 06 m sec PPS 50 nanoseconds Acquisition Reacquisition 2 sec Hot Start 9 sec Warm Start 35 sec Cold Start TTFF 39 sec Out of the box 41 sec 1 5 10 GSM antenna connector SMA Sub Minia...

Page 35: ...es can be directly connected to the vehicle s battery 12 or 24 volts The maximum voltage the unit can take is 32V When using the unit outside a vehicle use a 12Volts DC adapter that supplies a minimum...

Page 36: ...taking the unit s power after the switch making the unit work with its back up battery every time the main power switch is off When the vehicle uses a switch for the negative line that goes between th...

Page 37: ...2 1 POWER SUPPLY 35...

Page 38: ...2 1 POWER SUPPLY 36...

Page 39: ...the input will be indicated as OFF inactive Any voltage below 1V on the input will be indicated as ON active The maximum input voltage is 32V 2 3 Ignition detection The electrical conditions for the i...

Page 40: ...that the user has to provide a pull up resistor to any positive voltage 30V max to detect an inactive output by voltage Each output can drive a continuous current of 2A The electrical conditions are...

Page 41: ...nnection diagrams The following illustrations show Panic Button detection Ignition sense Engine turn off2 2 Shutting and engine off without knowing a vehicle s state is not advised See the Operation c...

Page 42: ...2 5 CONNECTION DIAGRAMS 40...

Page 43: ...unit s operation is having it reporting a periodic status event to any IP server1 according to a Time And Distance2 or Time only cri teria and having the unit report other sort of events as an excepti...

Page 44: ...bit 9600 8N1 It does not use any flow control method and all of the RS 232 communication lines on the DB9 connector are used The Antares SB TM works as a DCE device meaning that it is connected to a P...

Page 45: ...a temporal lack of functionality but SIM card s initialization This is a temporary state that should not last more than 6 seconds and it may only happen after a system reset If it lasts longer you ma...

Page 46: ...s LED gives information on the GPRS session state OFF The unit is Not Registered on the GPRS network ON The GPRS session is up and ready When using TCP it also indicates that all of the TCP connection...

Page 47: ...e Event Machine s IP signals are used These signals are true whenever the corresponding input is true For information on signals consult the Event Machine section on the Configuration chapter The corr...

Page 48: ...riven locally or remotely using the TAIP console or the unit can be configured to automatically take outputs actions depending on different situations The Event Machine s signals asso ciated to output...

Page 49: ...ding method gives the converter the ability to filter rapid changes or voltage swings that are undesirable when the voltage is proportional to some physical variables prone to this behavior The actual...

Page 50: ...Warning The duration of the back up power depends on many factors like Frequency of the unit s reporting Network conditions Poor network signal demands more power from the unit Battery condition At fu...

Page 51: ...l is used See the Event Ma chine section on the Configuration chapter for more information Send event code 44 whenever the main power source gets discon Example nected SED44XV0 F13 Sending reports whe...

Page 52: ...on the Configuration chapter and are configured with the XADP TAIP message refer to those sections for information on how to create and configure Desti nations TAIP queries that generate multiple answ...

Page 53: ...reates is attached to the remote peer s address and port socket so an UDP origin port only listens to UDP datagrams coming from the peer to which the last report was sent In fact there is more than on...

Page 54: ...for a longer period the NAT server on the cellular carrier s side will silently close an active TCP connection or eliminate any UDP port translation making it impos sible for the AVL server to send q...

Page 55: ...eceives from the cellular operator as generating party Sometimes the number you use to dial is not exactly the number that appears on a phone when a SMS is generated For example although the generatin...

Page 56: ...t can be configured to output TAIP messages in response to queries or on a scheduled basis Each message has the following format ABB C ID DDDD where Field Meaning Start of a new message A Message qual...

Page 57: ...h messages are described on the TAIP reference chapter Vehicle ID The unit can be configured to output every message with the vehicle s ID This is optional and is controlled by the RM message The defa...

Page 58: ...nnecting to an AVL server an IP type Destination has to be configured first The configuration flag for this Destination must indicate a TCP host Refer to the Destinations section on the Configuration...

Page 59: ...sociated to the corresponding IP type Destination becomes true However it is more efficient and simple to use the second option when possible as it does not generate an extra report and makes it possi...

Page 60: ...00000000000000000000000000000000090 ID AB12 After receiving this the AVL software must send back just the unit s ID AB12 Otherwise the unit will keep on sending the same message waiting for a confirma...

Page 61: ...ses to TAIP commands messages 3 11 1 Events Reporting Messages When a non silent event is triggered a reporting message is generated The reporting message contains among the GPS state of the vehicle t...

Page 62: ...eleration Altitude AMSL Analog to Digital Converter value Back up battery level Number of GPS satellites in view GPRS GSM network state The information tags are messages separated by the symbol They a...

Page 63: ...g UDP The GPRS session is up but the IP host is not acknowledging UDP reports13 For Telephone Numbers destinations 1 The unit is not registered on the GSM network 2 There is no Telephone Number define...

Page 64: ...ed when trying to upgrade one of these units The feature can be enabled with instructions from DCT Warning The first method is preferred as it only requires the use of a single com mand for the unit t...

Page 65: ...to guarantee that if the download process gets interrupted there will be no loss of the unit s functionality The unit will inform the end of the process to the Destinations selected with the XAFU comm...

Page 66: ...ipts on which a complete configuration for the Antares SB TM can be created or read The software uses a command answer mechanism and a retry timeout mech anism that is suitable for communicating with...

Page 67: ...Configuration Tool and follow the next steps STEP 1 Selecting a COM port When the Comm Port menu is selected a list of the available serial ports detected by ACT at startup is displayed Before select...

Page 68: ...splayed every time there is a communication process with the unit If you cancel this window a warn ing message will indicate you that the configuration reading process has not been completed When the...

Page 69: ...CT s interface As stayed on the Configuration chapter to mix the regions created with ACT with the main configuration script it is not necessary to use all of ACT s configuration options only the regi...

Page 70: ...ter in the illustration Create Delete a region Step 1 With these buttons you can create a new region or eliminate the selected region When a region is created the name No name is assigned to it and th...

Page 71: ...between these two formats is automat ically and immediately done after changing the value in any of the two formats fields In the illustration s example the coordinates red circled correspond to point...

Page 72: ...long as the configuration confirmation mechanism is implemented it is irrelevant if the configuration commands are sent manually or if a script file tmf file is sent with the ACT3 software The order...

Page 73: ...ends a TAIP report message EV or ET by adding the postfix ID UNIT S ID to the message This postfix gives the AVL software information on who is sending the report The AVL software may use the QID quer...

Page 74: ...at any time but although the registra tion process is always done automatically the unit will take up some time on registering to the GSM network when a previous erroneous PIN was given or when no PIN...

Page 75: ...APN has the form of a server name on a dot separated format and it is supplied by the cellular carrier For example this is an apn com or internet carrier name com Setting the APN on the Antares SB TM...

Page 76: ...al IP address assigned by the operator through the chosen APN can be consulted with the XAIP command 4 3 Destinations DPs and DAs A destination makes reference to the device or user that is receiving...

Page 77: ...tion Up to 10 0 to 9 DAs may be defined Refer to the DA message for more information This command enables the user to group a list of DPs and or a range of DPs The main use for DAs is on the routing o...

Page 78: ...ormation on these messages refer to the TAIP reference For SMS destinations the EV and ET TAIP messages are used when an AVL application has access to a SMS server system8 capable of receiving the mes...

Page 79: ...d or execute an action but it is not all of the configuration needed by the unit When the user starts configuring the Event Machine it is assumed that he has already defined the Destination Addresses...

Page 80: ...river presses the alarm button Speed limit monitoring which includes a time condition seconds and a visual advisory using an output that gives the driver a chance to slow down before the actual speed...

Page 81: ...action Report action When the event machine detects that a trigger goes off it uses the configura tion of the report action to generate a report A report action configuration includes routing options...

Page 82: ...n and or time of day Start a situation timer For example to keep track of the time a secu rity door remains open Another example of using timers and events is to keep track of a vehicle s IDLE situati...

Page 83: ...ion field For example the following configuration SGC00TR00300 SED00NV0 C00 ACT QRP ACT QGC06V will make the unit report the GSM network state QRP and the value of the counter 06 QGC06V every 5 minute...

Page 84: ...3 F00 RED05NV1 A00 F03 TD3 F00 RED06XM0 F03 TD3 F00 RED07NV0 A00U00 ACT SSSU000 RED08NV1 A00 F03 U00 ACT SSSU000 RED09U RED10NV0 A00U01 ACT SSSU010 RED11NV1 A00 F03 U01 ACT SSSU010 RED12U RED13U RED14...

Page 85: ...rigger is configured by the user with the logical combination of situations A situations makes reference to a vehicle state which is in fact represented by signals and their state Antares SB TM signal...

Page 86: ...etwork F08 GPRS Attached True when the unit is attached to the GPRS network F09 MDT PAD Mode True when the unit is in MDT PAD mode See the MT message F10 PAD message True when an MDT message is receiv...

Page 87: ...se IP and XP signals instead of G signals These signals state can be directly altered by the user with the SS TAIP message Refer to the next paragraph The signals marked with a are signals for which t...

Page 88: ...t For complete examples containing both the Event Machine and the other parameters necessary to get the unit working refer to the Scenarios and Examples chapter To understand the events configuration...

Page 89: ...y following the rules described on the GR message 2 Have the ACT14 software generate a configuration script with the necessary GR messages from a region defined on its graphical user interface The sec...

Page 90: ...e unit so the ACT can then read it and generate an script file next step To pass this configuration go to the Antares menu and select Write configuration to antares DO NOT USE THE Write configuration...

Page 91: ...distance and decreases it when the vehicle is not moving This is more efficient than having the unit report by a time only criteria were almost all of the reports triggered when the vehicle is not mov...

Page 92: ...n evaluated in order to get ready for the activation of the signal again when the T D criteria is met on the future To create a tracking event that sends event code 49 based on a T D cri Example terio...

Page 93: ...TIMERS For counting distance DISTANCERS For counting situations COUNTERS For each counter a counter signal Cxx exists A counter signal gets true whenever the counter s value exceeds a user defined thr...

Page 94: ...s counter Reset the counter value to zero recycling counter creating thus a periodic counter signal To define a recycling counter Set the recycle flag to R See the next illustration of a recycling cou...

Page 95: ...d with the GC command Use the V command on a previously defined counter The next graph illustrates this Note that altering a counter s value does not affect its counting con figuration After altering...

Page 96: ...for counting not only seconds but minutes hours etc or for distance counter to count meters kilometers tens of kilometers etc COUNTERS type counters only count on a command basis meaning that count wh...

Page 97: ...that a user signal activation starts the safe engine turn off process This user signal activation is not done on the script as it is not part of the configuration of the unit but of its operation Whe...

Page 98: ...t 40 Set a heading delta of 45 degrees SXAGH021045 Now a reporting event can be created using the J signal associated with the heading delta we just created SED40NV0 J02 4 14 Driving Metrics Accelerat...

Page 99: ...for example that if a vehicle goes from 0 to 32mph in 4 seconds the resulting acceleration will be of 32 4 8 Miles h s When a vehicle breaks the resulting acceleration is measured in the same manner b...

Page 100: ...arrier in order for the unit to answer phone calls Note To determine the incoming voice call authorization on a given Destination the C field on the Phone Number type DP message is used Refer to the X...

Page 101: ...es When working in this mode the TAIP console over the serial port is disabled In order for the serial port to enable the TAIP console again the user defined escape character has to be entered The def...

Page 102: ...is transformed in order to be delivered to the remote destination and vice versa Supposing the external device sends the following data Note Non printable data is shown between symbols in hex value 02...

Page 103: ...every unit To instruct the unit to use its IMEI as ID instead of the ID set by the user with the ID command use the XAID command in the following way SXAID1 This will make Antares SB TM use its IMEI...

Page 104: ...or un derstanding the configuration messages To create a comment start a new line with the hash symbol and write ANY TEXT THAT DOES NOT CONTAIN THE OR CHARACTERS For example This is a valid comment Th...

Page 105: ...lowed by tmf Now the tmf file you just created can be passed to an unit using the ACT software see the Writing Scripts section for this If you prefer you can edit an existing script instead of creatin...

Page 106: ...connected and communicating with the Antares SB TM before proceeding Make sure of using version 1 6 4 or superior of ACT Contact Digital Communications Technologies TM for information on how to upgra...

Page 107: ...4 24 USING SCRIPTS option HW VSP works as the TP Server only box on the software For more information on these software tools contact Digital Communi cations Technologies TM 105...

Page 108: ...aximum For this example lets call our unit EXAMPLE SIDEXAMPLE 5 1 2 Setting the APN and PIN After configuring an ID the first step is enabling the unit on the GSM GPRS network For this an APN provided...

Page 109: ...end and receive communications from IP servers and phone num bers For our example we need to create a Destination Point DP which holds our remote server IP number or address and the serving port that...

Page 110: ...and or address is wrong 3 The server is behind a firewall router NAT that prevents the incom ing connection from passing to the TCP listener 4 The server is accepting the connection but it is immedia...

Page 111: ...At this point we need to ask ourselves what event code to chose and what kind of message send to the AVL server The answer lies on the AVL server configuration The event code has to have any meaning...

Page 112: ...which is the same as signal G032 SED05NV4 IP3 Now our unit is generating a 5 minutes periodic report and also a special report whenever the Input 3 goes high3 5 1 9 Script This example can be resumed...

Page 113: ...Phone Number on one of the unit s Phone Number Type Destination Point DPs 10 to 14 For no par ticular reason we choose DP 10 The number we are going to configure on DP 10 is 912345678 See an special...

Page 114: ...hich allows to create up to 50 user messages one for each event Refer to the XATM message on the TAIP reference for more in formation Let s use the text Input 3 has been activated SXATM05Input 3 has b...

Page 115: ...on the Over The Air section of the Operation chapter 5 2 6 Script This example which is based on the Getting Started example is resumed on the following script Antares SB script Getting Started exampl...

Page 116: ...12345678 Refer to the XADP message for more information The underlined value indicates the access parameter for this DP indicating that the Phone Num ber 912345678 has TAIP console access via SMS mess...

Page 117: ...cated voice call access In our previous example the 912345678 Phone Number was defined with the XADP messages as follows SXADP1010912345678 The Access is such that voice calls from that number are to...

Page 118: ...sense signal the F00 Continuing the Adding SMS reporting example to generate an event code 19 for an Ignition ON send to the unit SED19NV4 F00 And event code 20 for an Ignition OFF situation SED20NV4...

Page 119: ...ed Ignition ON event SED19NV4 F00 Ignition OFF event SED20NV4 F00 end 5 6 Speed violation with warning report An speed limit violation event that is generated whenever the vehicle ex ceeds a determina...

Page 120: ...counter definition that is it 15 seconds after the speed violation is detected 5 6 3 Creating the violation report Having C00 signal become true 15 seconds after the speed violation the only thing lef...

Page 121: ...n sense Speed viol and warning Delete any previous configuration SRT CONFIG SXADP U Units ID SIDEXAMPLE configuring the SIMs PIN SRFI1234 configuring the APN SRFAinternet carrier name com The remote A...

Page 122: ...nt SED41SV0 S07 ACT SGC00U Create the violation report SED10NV4 C00 Drive a LED on output 1 ON when the speed goes beyond the limit silent event SED42SV0 S07 ACT SSSXP11 Drive a LED on output 1 OFF wh...

Page 123: ...ant that situation to be reported as an STOP For our example let s use some typical values that work on the majority of configurations For speed limit let s use 8mph and as time condition 2 minutes Fo...

Page 124: ...that unde fines the counter in case the vehicle resumes its march before the 2 minutes condition to do so we use silent event 39 SED39SV0 S03 ACT SGC01U This assures that a vehicle s stop that lasts...

Page 125: ...efinition STD80300 Event triggered by T D signal SED37NV4 TD8 Input sense Input report event SED05NV5 IP3 User text message for event 05 SXATM05Input 3 has been activated Ignition sense Ignition ON ev...

Page 126: ...reate the STOP report SED30NV4 C01 Create the START report SED31NV4 S03C01 end 5 8 Safe engine turn off This configuration is used to drive an output high after a user command4 only when the following...

Page 127: ...r reason 5 8 3 Cutting the ignition Now we create a non silent event that sets the ignition OFF when the pre vious set counter reaches its threshold value of 16 seconds SED13NV5 C02U00 ACT SSSXP41 The...

Page 128: ...n SRT CONFIG SXADP U Essential configurations Units ID SIDEXAMPLE configuring the SIMs PIN SRFI1234 configuring the APN SRFAinternet carrier name com The remote AVL server address and port SXADP0000av...

Page 129: ...eed limit of 65mph SGS0710650 Start a 15 secs timer when speed limit is violated silent event SED40SV0 S07 ACT SGC00TC00015 Stop the timer when the speed falls below the limit silent event SED41SV0 S0...

Page 130: ...ed falls off the previously set value and as long as the user signal is set SED14SV0 S01 U00 ACT SGC02TC00016 Stop the timer when the speed condition is violated SED15SV0 S01 ACT SGC02U Ignition cut e...

Page 131: ...eria for the periodic tracking report event 37 This report is being generated every 5 minutes 24 7 This includes a lot of useless reports that show the same location and conditions when the vehicle re...

Page 132: ...increases and or only reporting when the vehicle s ignition is on To use the new T D criterion we change our T D 8 definition to STD80120000000203555 And leave the rest of the script unchanged 5 9 1 S...

Page 133: ...in 120 secs dist 2km max 3555 secs STD80120000000203555 Event triggered by T D signal SED37NV4 TD8 Input sense Input report event SED05NV5 IP3 User text message for event 05 SXATM05Input 3 has been ac...

Page 134: ...080 Start 2 minutes timer SED38SV0 S03 ACT SGC01TC00120 Stop the time SED39SV0 S03 ACT SGC01U Create the STOP report SED30NV4 C01 Create the START report SED31NV4 S03C01 Safe engine turn off Set the s...

Page 135: ...is situation a TCP reconnection event may be configured on the unit so it sends an event every time a connection is re established with the server This gives the AVL server immediate information on wh...

Page 136: ...pport for user messages ON SXADP1010912345678 A Destination Address holding the server destination SDA4 P00 A Destination Address holding the server destination and phone number SDA5 P00 P10 Time only...

Page 137: ...ED10NV4 C00 Drive a LED on output 1 ON when the speed goes beyond the limit silent event SED42SV0 S07 ACT SSSXP11 Drive a LED on output 1 OFF when the speed falls off the limit silent event SED43SV0 S...

Page 138: ...tion event for DP 00 SED49NV4 A00 end 5 11 Main power loss alarm If the units has a built in back up battery5 it can send a report whenever the main power source gets disconnected To do so we use the...

Page 139: ...C05 This will make the unit send the following reporting messages to Desti nation Address 2 whenever signal C05 goes from low to high RET201447152212 ID EXAMPLE REV211447147509 2578250 08028139015195...

Page 140: ...reporting messages Events 30 and 31 will be reported as REV301447147509 2578250 0802813901519512 AL 00003 AC 00 ID EXAMPLE REV311447147649 2578440 0802854301000512 AL 00001 AC 08 ID EXAMPLE And event...

Page 141: ...6 Unit s TAIP reference...

Page 142: ...E Chars Item Format Value Meaning 5 GPS Time AAAAA seconds GPS time of day 6 Altitude BBBBBB meters Above Mean Sea Level Altitude 4 Vertical Velocity CCCC mph Vertical velocity 1 Data Source D Data So...

Page 143: ...conds GPS time of day 7 Latitude BBB CCCC degrees Latitude in the WGS 84 datum Positive values indicate a northern latitude 8 Longitude DDDD EEEE degrees Longitude in the WGS 84 datum Positive values...

Page 144: ...nes Serial Port A Destina tion Address is not the actual IP address or SMS telephone of the receivers The message has the following format A PBB PBB PBB PBB A is the Destination Address index Its rang...

Page 145: ...n association of Destination Points 2 3 10 and 15 15 is the unit s serial port SDA5 P02 P03 P10 P15 To create Destination Address 0 with only one Destination Point for example the unit s serial port S...

Page 146: ...point s index In dexes 00 to 09 refer to IP addresses where an AVL software is listening for TAIP messages In dexes 10 to 14 refer to SMS receptor telephones for these indexes do not use this table us...

Page 147: ...Point 0 Report messages are sent as TAIP messages to this destination 1 User defined messages are sent in stead of TAIP See the XATM mes sage Other values are reserved for fu ture use 1 Access C Acce...

Page 148: ...n for the Antares SB TM An event is created by defining a boolean combination of signals as a trigger a routing indication for a gener ated event message EV or ET and a possible TAIP message to be exe...

Page 149: ...EV message T ET message A extended EV message A B extended EV message B C extended EV message C 1 Destination Address D 0 9 Destination address of the Event Message The value of this field is the ind...

Page 150: ...he event s trigger TD7 in order to trigger any other event s that include E05 as part of its trigger definition Send an Event Message when an input gets active Example Panic button SED31NV0 IP3 This d...

Page 151: ...event that generates an Example Reporting another extended EV reporting message extended EV report including the state of distance counter 12 whenever the vehicle is turned off SED24NB0 F00 SXAEFB CV1...

Page 152: ...2 Error Code AA Error code See the table of error codes at the end of this chapter varies TAIP message BBB TAIP message that generated the error It does no include the mes sage s and characters 6 6 1...

Page 153: ...of the generated event The message has the follow ing format AABBBBCDDDDD Chars Item Format Value Meaning 2 Event code AA 00 49 Event code 4 GPS Week BBBB week Number of weeks since 00 00AM January 6...

Page 154: ...0 is Sunday 5 GPS Time of day DDDDD seconds Time of the generated report 8 Latitude EEE FFFFF degrees WGS 84 Latitude It does include the sign Positive for north 9 Longitude GGGG HHHHH degrees WGS 84...

Page 155: ...bit1 Output 2 bit2 Output 3 bit3 Output 4 Bitwise representation of C inputs bit0 Input 1 1 ACTIVE 0 INACTIVE bit1 Input 2 bit2 Input 3 bit3 Input 4 NS ABCCDE GSM GPRS Network Status A Sim Card State...

Page 156: ...signal becomes active when the specified threshold value is reached 1 Command B See Counter s Com mands table A counter can be configured in one of three modes using the Counter C Timer T or Distancer...

Page 157: ...xamples Set counter 03 on Timer mode When the counter s value reaches 5 min Example 1 utes the C03 signal should get true The counter shall not recycle its value when reaching the 5 minutes or else we...

Page 158: ...e counter value at any time QGC05V Ant the unit shall respond RGC05V00997 Indicating that the traveled distance since the counter set is 99 7km 997 x 100m We can also consult the actual settings of a...

Page 159: ...TM does not have GPIOs It has 4 inputs and 4 outputs instead Note The message has the following format AA Chars Item Format Value Meaning 2 GPIOs I O Mask AA Hexadecimal The GPIOs input output mask An...

Page 160: ...ge has the following format AABCCCC Chars Item Format Value Meaning 2 Speed limit ID AA 00 09 Identification code assigned to speed limit 1 Active flag B flag 1 Speed limit is active U Delete speed li...

Page 161: ...lowing format AAB CCCCCCDDDDDDEEEEEEFFFFFF Chars Item Format Value Meaning 2 Time window ID AA 00 09 Identification code assigned to time window 1 Active flag B flag 1 Time window is active U Delete T...

Page 162: ...define a region 8 Point s latitude DDD EEEEE degrees WGS 84 point s latitude It does include sign Positive for north 9 Point s longitude FFFF GGGGG degrees WGS 84 point s longitude It does include sig...

Page 163: ...or the first parameter takes the neighbor s index and the second must be 99 When two points lie on the same longitude it is not relevant which is the point with lower index but an special consideratio...

Page 164: ...oint 01 has point 00 to its left and is connected to it so this is a left neighbor There are no more points to the left of 01 so the second neighbor parameter must be 99 Left Neighbor 1 00 Left Neighb...

Page 165: ...this Left neighbors Point 00 has no points on the left so it has no left neighbors Left Neighbor 1 99 Left Neighbor 2 99 Point 01 Left Neighbor 1 00 Left Neighbor 2 99 Point 02 has point 01 as left ne...

Page 166: ...ding 03 as left neighbor of point 02 Note Point 04 Left Neighbor 1 00 Left Neighbor 2 99 Point 05 Left Neighbor 1 03 Left Neighbor 2 04 A general example Example Region C Left neighbors Point 00 Left...

Page 167: ...eft Neighbor 1 01 Left Neighbor 2 99 Point 05 Left Neighbor 1 06 Left Neighbor 2 99 Point 06 Left Neighbor 1 99 Left Neighbor 2 99 Point 07 Left Neighbor 1 04 Left Neighbor 2 05 For more information o...

Page 168: ...d to set query unit s ID The message has the following format A AAA Chars Item Format Value Meaning 1 to 10 Vehicle ID A AAA string Identification code assigned to the vehicle This parameter may be al...

Page 169: ...6 15 MS MEMORY SESSION 6 15 MS Memory Session Qualifiers S R This message is deprecated and has no effect on the unit 167...

Page 170: ...lue Code for the character that is to be used as delimiter 1 PAD mode Default is 0D 3 Packet delimiter 2 FF hex value Code for the character that is to be used as delimiter 2 PAD mode Default is 0A 3...

Page 171: ...enerated report Latitude BBB CCCCC degrees WGS 84 Latitude It does include the sign Positive for north Longitude DDDD EEEEE degrees WGS 84 Longitude It does in clude the sign Positive for east Speed F...

Page 172: ...by issuing the command without the B string Note The message has the following format A BBB Item Format Value Meaning Parameter ID A char Values I SIM Card PIN A GPRS APN Access Point Name 40 chars ma...

Page 173: ...LAG C ER FLAG B Chars Item Format Value Meaning 1 ID Flag A flag Include the unit s ID on each mes sage with a ID postfix T True Default F False 1 EC Flag B flag When set the unit will echo any correc...

Page 174: ...ng 6 Not Registered No SIM PIN attempts 7 Not Registered SIM PIN er ror 8 Not Registered SIM PIN wait 9 Not Registered SIM in serted A Not Registered SIM re moved B Not Registered SIM PIN OK C Not Reg...

Page 175: ...6 20 RP REGISTRATION PARAMETERS CELLULAR NETWORK RSSI RSS GSM dBm 0 to 7 113 99 Very poor 8 to 13 97 87 Poor 14 to 17 85 79 Fair 18 to 20 77 73 Fair 21 to 24 71 65 Good 25 to 31 63 51 Excellent 173...

Page 176: ...sage has the following format CONFIG SIGNALS Qualifier Meaning CONFIG Resets almost all the configuration of the unit The preserved parameters are PIN APN ID Destination Points This pre vents loosing...

Page 177: ...cter identifier of the signal 1 Current signal status B 0 or 1 Status of the specified signal 6 22 1 Examples To know the state of the Region signal 03 Asking QSSR03 If the signal is OFF the vehicle i...

Page 178: ...6 22 SS SIGNAL STATUS SSSXP31 To deactivate it SSSXP30 See the Configuration and Operation chapters for more examples 176...

Page 179: ...ble satellites 0C Chosen satellite is unusable 1 Status Codes Nibble 1 B Hex characters 0 F Value 0 No problems reported 1 Antenna feedline fault 1 Status Codes Nibble 2 C Hex characters 0 F Value 0 N...

Page 180: ...ormat AABBCCDDDEEFFGGGGHHIJJKLLLL Chars Item Format Value Meaning 2 Hour AA decimal 2 Minutes BB decimal 5 Seconds CC DDD 2 Day EE decimal 2 Month FF decimal 4 Year GGGG decimal 2 GPS UTC Time Offset...

Page 181: ...t Time as trigger Note How does this criteria works First the signal has to be triggered by a distance threshold that tells the activate its associated TD signal whenever the accumulated distance exce...

Page 182: ...stance index 4 Minimum Time BBBB seconds Minimum amount of time elaps ing between reports To enable just time reporting this is the only parameter to set and the others should be set to 0 Setting this...

Page 183: ...e following format A Chars Item Format Value Meaning Text String A string Any printable character but These characters and any other non printable characters can be transmitted us ing the escape seque...

Page 184: ...number Qualifiers Q R This message returns the unit s firmware version The message has the fol lowing format Antares GPS A A AA B C Chars Item Format Value Meaning 3 Version number A AA Firmware versi...

Page 185: ...as the following format AAAAAPBBB Chars Item Format Value Meaning 5 ADC Com puted voltage AAAAA millivolts ADC computed value Average value over a 10 seconds interval of the ADC input voltage ADC volt...

Page 186: ...CC Chars Item Format Value Meaning 1 Main Power State A flag Indicates that the main power source vehicle s battery is ON 1 or OFF 0 4 Battery voltage BBBB millivolts Built in battery voltage 1 Indica...

Page 187: ...aracters of the field are digits the unit assumes the user is specifying a Destination Point Destination Addresses range from 0 to 9 Destination Points range from 00 to 15 6 30 1 Reported Message Afte...

Page 188: ...ACR COUNTER REPORT For example Distancer 2 S 1200 x 10m If no S is shown it means the counter is running The counter type Counter indicates a user defined counter See the GC message for more informati...

Page 189: ...ith a given destination s without requiring for an specific event to occur It is also a method for testing a DA definition and testing the remote host identification process of an EV message The messa...

Page 190: ...wn 5 Registered roaming 2 RSSI FF 00 31 Received Signal Strength Indicator 1 GPRS Attach G flag 1 indicates that the unit is GPRS attached 0 indicates GPRS de attached state 1 GPRS state H 0 9 GPRS st...

Page 191: ...6 32 XADM DIAGNOSTIC MESSAGE 189...

Page 192: ...no TAIP console access Error 8 is returned on every message Other values work but are reserved for future implementations The user should not use any value different than 0 1 and U 1 TCP UDP se lectio...

Page 193: ...s to this destination 1 User defined messages are sent in stead of TAIP See the XATM mes sage Other values are reserved for fu ture use 1 Access C Access for this Telephone 0 Full access 1 TAIP consol...

Page 194: ...cle altitude AD Analog To Digital Converter BL Battery level CVxx Counter xx value IO Input Outputs NS GSM GPRS Nework state SV GPS Satellites in view U Delete this format For example to set event 49...

Page 195: ...ple to update to FW 5 21 BBBB should be set to 0521 2 Firmware type CC Type of version to download Always set this value to SV 2 Diagnostics route DD Indicates where to send the diagnostic reports of...

Page 196: ...CCCC Chars Item Format Value Meaning 2 ADC level ID AA 00 04 Identification code assigned to the ADC level 1 Active flag B flag V ADC level defined as a voltage value P ADC level defined as a percent...

Page 197: ...mat AABCCCCC Chars Item Format Value Meaning 2 Battery level ID AA 00 04 Identification code assigned to the Battery level 1 Active flag B flag V Battery level defined as a volt age value P Battery le...

Page 198: ...oni tored See the Configuration chapter for more information on using heading deltas to create a turn by turn report 6 39 XAGP GPRS Pause Qualifiers Q S R Use this message to make the unit close any o...

Page 199: ...ge tells the unit whether to use or not defaults to not its IMEI as ID A Chars Item Format Value Meaning 1 action A 0 1 Use 1 to set the unit s ID with the IMEI Use 0 to set the unit s ID to the value...

Page 200: ...41 XAIM IMEI consult Qualifiers S Q R This message is used to consult the unit s IMEI International Mobile Equip ment Identity AAAAAAAAAAAAAAB Chars Item Format Value Meaning 14 IMEI A IMEI 1 IMEI s C...

Page 201: ...f Output 4 1 active 0 inactive 1 Out 3 B flag State of Output 3 1 Out 2 C flag State of Output 2 1 Out 1 D flag State of Output 1 1 Input 4 E flag State of Input 4 1 Input 3 F flag State of Input 3 1...

Page 202: ...0 0 0 is returned when the GPRS session is not up The message has the following format AAABBBCCCDDD Chars Item Format Value Meaning 3 1st number AAA 000 255 First number of the IP number 3 2nt number...

Page 203: ...mat Value Meaning 1 Action Response A 0 2 R C Action Response type R Summary Query Response to driving metrics summary C Clear Clear maximums and their GPS data 0 Max Positive Acc Query Response to ma...

Page 204: ...he connection between your server and your unit due to inactivity The keep alive packet contains the unit s ID without any TAIP message so your server has to expect these special non TAIP messages Thi...

Page 205: ...l port is rejected with error code 30 The message has the following format A BBBB Chars Item Format Value Meaning 1 Operation A Operation L Lock The console will be locked with the code defined on B U...

Page 206: ...he module according to network discovery information A mode change will be effective only after a system reset SRT or power cycle The allowed modes are presented in the next table The message has the...

Page 207: ...APN not set by user 08 Stopped 09 No network 10 13 Internal error 20 Closing 88 99 GPRS set up failure 1 Destination Point C 0 9 IP type destination point index for which D and EEE give information 1...

Page 208: ...normal mode On sleep state an input change detection or the wake up timer count are the only functionality available This command includes as optional field an input mask to indicate which inputs to...

Page 209: ...ield to indicate minutes or hours if no scalar factor is included a value of seconds is assumed The minimum value is 1 minute the maximum is 999h 999 hours 4 Inactivity time out KKKK This is the commu...

Page 210: ...1DDDDDDDD002h To configure the unit to go to sleep mode any time the external power 3 is removed and to go back to normal mode when the power is connected again 1 Create an event triggered when the po...

Page 211: ...ormation dis played with TX messages to a selected DA or DP The message has the following format AA Chars Item Format Value Meaning 2 DA or DP Action AA Command U Deactivate the resets diagnos tics A0...

Page 212: ...nation The message has the following format AA BBBBB CCCCC DDDDD Chars Item Format Value Meaning 2 Destination Point AA 00 14 Destination Point 5 Total capacity BBBBB integer Total buffer capacity exp...

Page 213: ...s message to know the DP index used on the actual communication channel The command will return the DP index used to generate the QXATD query The message has the following format AA Chars Item Format...

Page 214: ...om message the sent message is the one defined with this command XATM for the event code that generates the report The message has the following format AA BBB Chars Item Format Value Meaning 2 Event C...

Page 215: ...has the following format A BBB Chars Item Format Value Meaning 1 Action Direc tion indicator A flag When using the S qualifier Use 1 to activate the sniff 0 to deactivate For R responses I indicates t...

Page 216: ...rk s IP is any IP address that defines the common IP addresses values among the members of the UDP Network The mask is defined as the number of ones from left to right which define the host address po...

Page 217: ...nothing to do with the UDP Server Port XAUP The fixed UDP origin port will not listen for queries until the unit generates an UDP datagram Meanwhile the UDP Server Port is always listening Also notice...

Page 218: ...s IP address matches the UDP Network a response is sent too the peer6 If it does not match with the UDP Network it tries to find a match on any of the IP type UDP defined Destinations if a match is fo...

Page 219: ...entered and the selected Destination is found to have any value set a telephone number The message has the following format AA BCC Chars Item Format Value Meaning 2 Destination Point AA 10 14 Index of...

Page 220: ...ers S R Use this message to hang up any current voice call If no voice call is being held the command returns and does nothing The message has the following format No parameters Send SXAVE The unit im...

Page 221: ...e destinations in order for the unit to accept the call8 If set to OFF the unit will answer any incoming voice call regardless of the calling party s number being set or not on the Telephone type dest...

Page 222: ...o change the microphone gain for voice calls A Chars Item Format Value Meaning 1 Action value A 0 9 Gain value 0 9 or gain action to increase to decrease Default value is 5 Example to set the micropho...

Page 223: ...ange the speaker volume for voice calls A Chars Item Format Value Meaning 1 Action value A 0 9 Volume value 0 9 or volume action to in crease to decrease Default value is 5 Example to set the speaker...

Page 224: ...6 63 ERRORS LIST 6 63 Errors list The following table contains a list of the errors returned by the unit with the ER message See the ER message for more information 222...

Page 225: ...N can only be modified locally Use the serial port 27 APN can not be changed via IP communication Use serial port or SMS messages 28 Unrecognized RF parameter See the RF message 29 RF parameter longit...

Page 226: ...uct 63 Can not initiate a new voice call There is a voice call being held 64 Can not initiate voice call The selected Destination is not defined 65 No current voice call to end 68 Exceeded the allowed...

Page 227: ...7 Appendix A Quick Start Guide The next two pages are a quick guide for installing and configuring the unit You can print these two pages and have them at hand...

Page 228: ......

Page 229: ......

Page 230: ...us configuration SRT CONFIG SXADP U Unit s ID SIDEXAMPLE configuring the SIM s PIN SRFI1234 configuring the APN SRFAinternet carrier name com The remote AVL server address and port SXADP0000avl server...

Page 231: ...pendix C Signals Table For more information on signals refer to the Configuration chapter Event Machine section The available signals for the Antares SB TM are presented in the next table on the next...

Page 232: ...GPRS Attached True when the unit is attached to the GPRS network F09 MDT PAD Mode True when the unit is in MDT PAD mode See the MT message F10 PAD message True when an MDT message is received on the...

Page 233: ...is being held to Destination Point 10 to 14 respectively See the VC VE and XADP messages XP1 XP4 Outputs True when the corresponding output is on See the SS message Antares SB TM does not have GPIOs T...

Page 234: ...SIDAbcD 1234 10 2 Setting the APN To set the APN to internet carrier com send SRFAinternet carrier com 10 3 Configuring the SIM card PIN To set the PIN to 1234 send SRFI1234 To set the PIN as empty se...

Page 235: ...t confirmation send SXADP0002192 168 0 1 8000 To set the same IP port on UDP with confirmation send SXADP0003192 168 0 1 8000 To set the host name server name com rather than an IP address On TCP SXAD...

Page 236: ...ation Point 00 and unit s Serial Port send SDA4 P00 P15 To delete DA 4 grouping send SDA4U 10 11 Defining a periodic timer There are two alternatives to achieve a periodic timer 10 11 1 Using a time c...

Page 237: ...istance counter count kilometers 01000 meters send SGC12DC0000101000 To query the kilometer count of this counter send QGC12V To make the unit report the kilometer count automatically Define an event...

Page 238: ...it to sleep power mode To activate the power saving mode send SXAPMA To make the unit go to sleep mode immediately without activating the power saving mode once the unit wakes up it won t go to sleep...

Reviews: