TrimTrac 1.5 Locator Technical Manual Including Enhanced Features and Vehicle Adapter or Control Module See Exceptions for Firmware Revision: 0.80.03.0001 on Page xv ***DRAFT*** SUBJECT TO CHANGE WITHOUT NOTICE Part Number 54200-XX-UG Version 0.
REVISION HISTORY Version Primary Author(s) Description of Version Date Completed 0.1 Bill Dussell Initial draft created for internal distribution and review comments. 0.2 Bill Dussell Revised descriptions, defaults and some parameter name changes 4/26/2006 0.3 Bill Dussell 0.3a Bill Dussell Modified SAR data section 5/22/2006 0.3b Bill Dussell Modified safety information 5/31/2006 0.
Corporate Office Trimble Navigation Limited 935 Stuart Avenue Post Office Box 3642 Sunnyvale, CA 94086-3642 U.S.A. Phone: +1-408-481-8940 1-800-545-7762 www.trimble.com www.trimtrac.com Copyright and Trademarks © 1997–2006, Trimble Navigation Limited. All rights reserved. Printed in the United States of America. Printed on recycled paper. The Circle & Parallelogram and TrimTrac are trademarks of Trimble Navigation Limited.
THE FOREGOING TERMS OF THE PRODUCT LIMITED WARRANTY STATE TRIMBLE’S ENTIRE LIABILITY, AND RESELLER’S EXCLUSIVE REMEDIES, RELATING TO USE AND PERFORMANCE OF THE PRODUCT.
Changes and modifications not expressly approved by the manufacturer or registrant of this equipment can void your authority to operate this equipment under Federal Communications Commission rules. Regulatory Approvals CE The TrimTrac 1.5 product complies with the essential requirements of the R&TTE Directive 1999/5/EC as stated by the EC Declaration of Conformity (CE0681). The TrimTrac 1.
Contents About this Manual ........................................................................................................................................ xii Related Information ...................................................................................................... xii Technical Assistance.................................................................................................... xiii Information Required for Technical Assistance ............................................
TrimTrac State Machine............................................................................................................................... 52 Introduction................................................................................................................... 52 State Machine Overview............................................................................................... 52 Motion Detection and Filtering............................................................................
List of Tables Table 1, Firmware Exceptions – TrimTrac 1.5................................................................. xv Table 2. Geofence Parameters, Settings, Messages and Commands ............................... 12 Table 3. Scheduled Hours Parameters, Settings, Messages and Commands................... 15 Table 4. Runtime Meter Parameters, Settings, Messages and Commands...................... 16 Table 5. Fix, Log and Reporting Rate Parameters, Settings, Messages and Commands 17 Table 6.
Table 45, Sample XOR Checksum Source Code............................................................ 108 Table 46, TrimTrac Application Protocol Messages (Sorted by Name) ........................ 109 Table 47, TrimTrac Application Protocol Messages (Sorted by Header) ...................... 110 Table 48, TrimTrac Command and Response Summary................................................ 111 Table 49, SET_ALERT_STATE Message .....................................................................
Table 91, Read-only Parameters ..................................................................................... 159 Table 92, Summary of AT Commands and Defaults...................................................... 160 Table 93, TrimTrac Application Protocol Messages (Sorted by Name) ........................ 161 Table 94, TrimTrac Application Protocol Messages (Sorted by Header) ...................... 162 Table 95, TrimTrac Command and Response Summary................................................
List of Figures Figure 1, Vehicle Placement versus Expected Number of Reports .................................. 39 Figure 2, Expected Reporting Frequencies....................................................................... 50 Figure 3, Warm Start TTFFs............................................................................................. 51 Figure 4, Summary TrimTrac Operational State Diagram ............................................... 52 Figure 5, HPA Processing in TRANSMIT .................
About this Manual Welcome to the DRAFT TrimTracTM 1.5 Locator Technical Manual. This manual is intended for use by system integrators, service providers and application developers (collectively, “Resellers”). It is not intended for end-users of the TrimTrac 1.5. Any end-user documentation is to be prepared and furnished by the Resellers. This manual covers the TrimTrac 1.5 with 1.
Technical Assistance If you have a problem and cannot find the information you need in the product documentation, please contact your local Trimble Component Technologies sales office, sales engineer or distributor. The Trimble technical support organization can be reached by telephone at 1-800-767-4822 when dialing from within the United States, or at +1408-481-7921 when dialing from outside the United States. Alternately, you can contact your nearest authorized TrimTrac distributor: Africa: GLT, Ltd.
Information Required for Technical Assistance 1. Unit IMEI number 2. Current configurations settings and message log according to: ATI AT+CTKC? AT+CTKF? AT+CTKJ? AT+CTKG? AT+CTKK? AT+CTKP? AT+CTKX? AT+CTKY? AT+CTKZ? AT+CTKO? (See Page 101) (See Page 83) (See Page 85) (See Page 87) (See Page 88) (See Page 89) (See Page 91) (See Page 93) (See Page 97) (See Page 99) (See Page 91) 3. Name of SIM Card Carrier DRAFT TrimTrac 1.5 Technical Manual v0.
Firmware Exceptions This manual covers the TrimTrac 1.5 with 1.00 firmware. The following features do not work as specified in firmware Revision: 0.80.03.0001 EXCEPTIONS Automatic Message Log Dump does not function correctly and should not be enabled. Initial geofence violations are reported correctly; however, subsequent positions are reported with TriggerType set “1=Motion” instead of being set to “2=Alert” while any geofence violation persists.
Safety First Simple Guidelines Please follow these guidelines when configuring, using or recycling the TrimTrac 1.5. Violating these guidelines may be dangerous, illegal or otherwise detrimental. Further detailed information is provided in this manual. Do Not Operate Where Prohibited Do not allow the TrimTrac 1.5 to operate wherever wireless phone use is prohibited or when doing so may cause interference or danger.
Detailed Safety Information Exposure to Radio Frequency Signals The TrimTrac 1.5 is a low power radio transmitter and receiver. When it is ON, it receives and also sends out radio frequency (RF) signals. In August 1996, the Federal Communications Commissions (FCC) adopted RF exposure guidelines with safety levels for hand-held wireless phones. Those guidelines are consistent with safety standards previously set by both U.S. and international standards bodies: ANSI C95.
If there is any reason to suspect that interference is taking place, the TrimTrac 1.5 Battery Pack or Vehicle Adapter or Control Module should be removed immediately. Other Medical Devices If any other personal medical devices are used in the vicinity of a TrimTrac 1.5, consult the manufacturers of the medical devices to determine if they are adequately shielded from external RF energy. Physicians may be able to assist in obtaining this information. Disable operation of the TrimTrac 1.
below deck on boats; fuel or chemical transfer or storage facilities; vehicles using liquefied petroleum gas (such as propane or butane); areas where the air contains chemicals or particles (such as grain, dust, or metal powders); and any other area where it would normally be advisable to turn off motor vehicle engines. For Vehicles Equipped with an Air Bag An air bag inflates with great force. DO NOT place objects, including the TrimTrac 1.5, in the area over the air bag or in the air bag deployment area.
Overview Introduction This manual covers the TrimTrac 1.5 operating on 850 MHz, 900 MHz, 1800 MHz and 1900 MHz GSM networks. As used in this manual, the term GSM shall include any and all of these frequencies. Regulatory Approvals CE The TrimTrac product complies with the essential requirements of the R&TTE Directive 1999/5/EC as stated by the EC Declaration of Conformity (CE0681).
TrimTrac 1.5 New Features and Capabilities The TrimTrac 1.5 locator is a small, lightweight asset-monitoring device that requires little, if any, installation when used in its battery-powered configuration. Different hardware and setting options allow the device to be configured to meet a variety of demanding installation and operational requirements. Motion-based reporting continues to be an important tool in minimizing power consumption and recurring communication costs.
Cost-effective, Universally Available Communications The TrimTrac 1.5 takes advantage of the near universal availability of GSM SMS text messaging while also leveraging cost-effective GPRS data rate plans. Typical SMS plans offer very extensive inter-network roaming capabilities, both within a host country and internationally. SMS plans also tend to be too pricey for applications requiring more than a few reports per day.
Enhanced Functional Capabilities Position reporting triggered by motion continues to be an important attribute of the TrimTrac 1.5; however, a range of powerful new functional enhancements now augments this basic capability. The TrimTrac 1.5 is backwards compatible with applications developed for the first generation TrimTrac. On-board Geofencing The TrimTrac 1.5 can self-monitor up to two geofences.
This mode causes the TrimTrac 1.5 to compute and transmit one position report upon first motion and one position report after coming to rest. There are no reports transmitted in between even though the device may be logging, but not transmitting, positions in the background. This provides a historical log that could be queried should the need arise while minimizing communication costs in the mean time.
Application Feature Details The TrimTrac 1.5 supports a number of important new application features that modify how the TrimTrac 1.5 cycles through the basic state machine described in the previous sections. Before reading this section, it would be useful to have a basic understanding of the TrimTrac 1.5 state machined as detailed in State Machine Overview section or, preferably, the State Machine Design Details section. Even though the TrimTrac 1.
Geofence Center To establish a geofence area, whether circular or rectangular in shape, you must first select the center point of the geofence area defined in latitude and longitude. This can be done in three ways. Either you enter it into the TrimTrac 1.5 during the provisioning process, by sending a TrimTrac Application command via the GSM network, or, if the TrimTrac 1.
Parameter Settings Geofence ID Unique geofence identifier 1 or 2 Geofence Enforcement 0=Disabled; 1=Enforced 24/7; 2=LPA Input Enforced; 3=LPA Centered and Enforced. Geofence Delta X 100s of meters (1 – 10000) Note: East-West length of rectangular Geofence area or, if circular, the diameter. 1=100 Meters Msg.
Reporting Geofence Violations To avoid nuisance geofence violations, a 30-meter diameter circle is established with the center point being the current position of the TrimTrac 1.5. Before a geofence violation is recorded, this circle must be 100% either inside or outside the geofence area or, if the geofence is a boundary crossing type, 100% crossed over the boundary line on either side.
POSITION_REP will have the TriggerType set “2=Alert”, the position that first triggered the boundary crossing notice and the Geofence Status field will be set “1=Violation”. The RESP_GEOFENCE_CONFIG message will denote which particular geofence had a boundary crossed. Geofences and GPS Fix Rate Depending upon how strictly geofences must be enforced, it may be advantageous to set the GPS Fix Rate to “1=GPS 1Hz”. Geofences are enforced based upon the most recently computed GPS position. If the TrimTrac 1.
which day of the calendar week beginning Sunday UTC constitutes the first workday of the workweek and how many consecutive workdays are included in each workweek. You cannot specify a beginning workday later than the total number of workdays per week. For instance, if you specify Monday as the first workday of week, you cannot specify seven consecutive workdays since there are only six calendar days remaining in the calendar week.
Parameter Settings Runtime Meter Motion-based 0=Disabled; 1=Enabled Runtime Meter Motion-based Countdown, T29 In Hours (0=No Countdown, 1-990) Runtime Meter LPA-based 0=Disabled; 1=Enabled Runtime Meter LPA-based Countdown, T30 In Hours (0=No Countdown, 1-990) Runtime Meter LPA-based Query 0=Report Only (No Reset); 1=Report with Reset Runtime Meter Motion-based Query 0=Report Only (No Reset); 1=Report with Reset Runtime LPAbased Reading Accumulated seconds since last reset, always 10 digits
Fix Rate In its default configuration, the TrimTrac 1.5 will compute a new position fix each time the device cycles through the FIX State. Certain applications may, however, benefit from having more continuous GPS fixes available, in which case, the GPS receiver can be configured to operate at 1 Hz. Operating the GPS receiver at 1 Hz enables more real time geofence enforcement.
Input Modes Both the Vehicle Adapter and Control Modules support three priority types of switch closure inputs: High, Medium and Low Priorities. In addition to the Automatic and Disabled Modes, two new modes of operation have been added as described below. See AT+CTKY Module-only Application Configuration on page 97 and SET_MODULE_APP_CONFIG on page 121. Automatic Mode When set to automatic, any activated alert can only be silenced after an acknowledgement is received from the server application.
SET_ALERT_STATE messages are required to either acknowledge or clear the alerts. Once the monitored devices or conditions have been returned to “normal”, then the input status will be updated accordingly. LPA Input Delay In earlier versions of TrimTrac, a Low Priority Alert would become “armed” whenever the monitored switch was closed for 250 mSeconds or longer and become “activated” upon any detection of subsequent motion.
transmitted alert messages will have Report Sequence Numbers lower than the alert message first received by the server application. Finally, the TrimTrac 1.5 message log could be completely filled with alert messages if the device remained outside GSM coverage for a long enough time period while one or more alerts were activated. The message log will hold up to 1,024 most recent messages. Once full, new messages will overwrite the oldest messages. Motion Report Flag If a TrimTrac 1.
Additionally, the Report Delay Flag can selectively suppress transmissions by time of day, when used in conjunction with the Scheduled Hours, or based upon the starting and stopping of motion. When set to “Start/Stop” reporting, the device will send a new STATUS_MESSAGE, along with its most recently logged position message, when the device first starts to move.
Polling Polling on the TrimTrac 1.5 has been implemented somewhat differently than earlier generations of the TrimTrac locator. Polling can be implemented on the TrimTrac 1.5 either based upon motion or regardless of motion. In order to enable polling, the TrimTrac 1.5 remains connected to the GSM network in states other than just the TRANSMIT or QUERY states. Connection to the GSM network requires that the device keep the internal GSM modem powered up and operating.
enabled, if the device loses connection to the GSM network while in the QUERY state, it will not attempt to re-establish connection again until the has cycled back through the state machine and again re-enters the TRANSMIT or QUERY states. If the Query Hold Flag is set, then the device will attempt to re-establish connection to the GSM network if connection to the GSM network was lost prior to the expiration of the QUERY State Timeout, T5.
Motion Sensor Override This parameter is most useful during server application development and as an override for units in the field that may have had a motion sensor failure. During “normal” operation, however, the Motion Sensor Override should always be set to default. Setting the Motion Sensor Override to either “1=Motion Always” or “0=Motion Never” causes the TrimTrac 1.5 operate as if it is in constant motion or at rest, respectively.
Application Scenarios Introduction The TrimTrac 1.5 is both elegant and powerful in its simplicity. How to best configure it for any given application, however, may not always be intuitively obvious. The intent of this section is to provide operational insight and specific configuration suggestions based on different application environments. General Considerations When deciding how to best configure the TrimTrac 1.5, consider the following: 1. What is the expected frequency and duration of motion? 2.
How frequently those logged positions are transmitted, however, is determined mostly by the Report Delay Flag setting. For instance, if the Report Delay Flag is set to some value other than “0=Transmit All Messages”, some or all of the logged positions may not be transmitted unless a QUERY_LOG or similar message is received by the TrimTrac 1.5 or if the Scheduled Reporting Mode is set to either “1=Weekly” or “2=Daily”.
Example Applications Baseline (Default) Application TrimTrac 1.5 default values are based upon two trips per day (frequency) with each trip being one hour in length (duration). Market research studies indicate that most end-user consumers believe a nominal 15-minute position reporting interval while the vehicle is moving is a good combination of timely information, reasonable SMS communication costs, and battery life.
position fix even though there may be actual motion. Anytime Polling set “2=Cycled” Polling Duty-Cycle Frequency, T19, based on the desired maximum response time to a query. For instance, if a one-hour response time to a position query is acceptable, then set T19 to 3600 seconds; Polling Duty-Cycle OnTime, T20, set to 60 seconds.
Stationary Assets Whereas a personal automobile normally moves on a daily basis, some other assets may almost never move and, when they do move, it is an extraordinary event requiring immediate action. Under normal stationary conditions, perhaps all that is required is a periodic heartbeat from the unit letting the server application know that it is still alive and functioning.
High-Performance Tracking and Reporting If power consumption and communication costs are of no object and the application requires maximum fix density and constant communication, then the device can be configured to report as frequently as once every 30 seconds and could be polled at any time. The communication cost would increase substantially if the device were transmitting position fixes at the rate of one every 30 seconds.
GPS Fix Rate set “1=1Hz GPS Continuous computation of GPS positions while in motion. Increases resolution of Geofence enforcement and stopped position reporting Heavy impact on power consumption and, if used, battery life.
WARNING: Before inserting a Vehicle Adapter or Control Module into a TrimTrac base unit: A) Connect the red (+) and black (-) wires to a 9-32 VDC power source and install a 100k Ohm resistor across the yellow wires; OR B) Set the TrimTrac MPA Mode to “1=Disabled”. FAILURE TO DO EITHER OF THESE WILL CAUSE THE TRIMTRAC 1.5 TO IMMEDIATELY ACTIVATE A MEDIUM PRIORITY ALERT AND BEGIN TRANSMITTING NOMINALLY EVERY 2-3 MINUTES UNTIL AN ACKNOWLEDGEMENT IS RECEIVED.
Construction Equipment Monitoring Many construction equipment scenarios are “exception” based reporting applications, meaning reports are not typically sent unless there is some sort of exception to the normal daily routine. Exceptions might include, for instance, equipment that has left a designated construction site, motion outside normal hours of operation, or the need to perform some sort of maintenance based upon runtime hours.
Scheduled Reporting Mode set to “2=Weekly” Geofence Enforcement GPS Fix Rate set “1=GPS 1Hz” background Useful if equipment can be idle for extended periods of time Prevents nuisance transmissions so long as equipment is being used where it supposed to be used. Provides for more continuous geofence enforcement If geofence established and activated onsite via LPA switch, then a module is required.
Summary End-user and Installation Instructions Battery Powered Units 1. Configure and provision the TrimTrac 1.5 as described in the TrimTrac Technical Manual. As a minimum, the device must be provisioned with a Destination Address and, if required by the SIM card provider, a SIM PIN, even if all other factory default settings are used. 2. If SIM card is already installed, remove the TrimTrac 1.5 base cover and any installed modules to access the SIM cardholder. 3.
Vehicle Adapter or Control Module Equipped Units PLEASE CONNECT ALL WIRE LEADS PRIOR TO INSERTING THE VEHICLE ADAPATER MODULE INTO THE TRIMTRAC 1.5 BASE REQUIRED CONNECTIONS: 1. Connect RED wire to a constant, non-switched 9-32 VDC source of power (+). 2. Connect the BLACK wire to vehicle ground. 3. Connect YELLOW wires as follows: a. Connect YELLOW wires to High, Medium and/or Low Priority Alert devices as described in the OPTIONAL INPUTS AND ALERTS below; OR. b. Cut or tape off the YELLOW wires.
5. Place the Vehicle Adapter or Control Module in the TrimTrac 1.5 base while aligning the arrow on Vehicle Adapter or Control Module with the arrow on the TrimTrac 1.5 base. 6. Press down on the Vehicle Adapter or Control Module to snap in securely in place on all four corners making sure all corner tabs are all fully engaged. 7. Route the wires and press the molded rubber piece into the channel provided. 8. Install TrimTrac 1.5 base cover and tighten the hold down screw. 9. Place the TrimTrac 1.
Vehicle Placement Guidelines 1. Placing the TrimTrac 1.5, or the optional external GPS antenna, where it has a clear view of the sky unobstructed by metal will maximize its ability to determine its location. Under no circumstances should the TrimTrac 1.5 be placed where it is subjected to extreme environmental conditions (temperature, vibration, water). For instance: a. DO NOT Leave the TrimTrac 1.5 on the dashboard exposed to direct sunlight b. DO NOT mount it inside the engine compartment c.
Report Density v. Unit/Antenna Placement and DELAY State Timeout, T4 110 On Dashboard or with external GPS antenna (Typ. 60 Sec GPS Fix) Expected Number of Reports 100 90 In Glovebox (Typ. 190 Sec GPS Fix) 80 70 Under Front Seat (Typ. 345 Sec GPS Fix) 60 As DELAY State Timeout, T4, increases, the difference in the number of reports based on unit placement decreases. GPS fix times remain constant even as T4 increases.
Technical Tips and Troubleshooting Introduction The TrimTrac 1.5 and accessories are designed to operate in the conditions outlined in the Specifications on page 141. When used and maintained properly, the TrimTrac 1.5 provides years of troublefree service. The TrimTrac 1.5 has no user-serviceable parts other than its replaceable batteries. Should the TrimTrac 1.5 fail to operate properly, the user or service technician should troubleshoot the installation before returning any components for repair.
fixes and transmitting or receiving messages both above and below this range, however, such operation is neither specified or guaranteed by Trimble or type approved. In practice, the limiting factors in any battery-powered device in terms of temperature ranges are the batteries themselves. The capacity of alkaline batteries is, for instance, severely compromised when subjected to high temperatures. The TrimTrac 1.
GPS Almanac Loading A current almanac can be collected from any operational TrimTrac 1.5 using the PC-based TrimTrac GPS Almanac Tool. This collected almanac can, in turned, be loaded into any other TrimTrac 1.5. Converting GPS Time (UTC), GMT and Local Times Sample source code for converting GPS (UTC), GMT, and local times is available on the www.trimtrac.com/documents partners’ page. Orientation The TrimTrac 1.
2. Remove and reinsert the existing SIM to verify proper installation. 3. Check the TrimTrac 1.5 configuration to ensure the correct PIN is programmed. 4. Make sure that the SIM card hold-down latch is securely fasten and all four corners are locked down. Even in areas with strong GSM service, there may be pockets where GSM service is poor or nonexistent due to how the carrier builds the network. Contact your local service provider for information on GSM coverage.
In general, testing done to date indicates that a unit located in the glove box will on average get approximately 50% fewer position fixes than a unit located on the dashboard of the vehicle. Units placed under the front seat will performance about the same as units placed in the glove box unless the seat is a power seat. Power seats have considerably more metal than manually adjusted seats and the added metal attenuates the GPS signal that much more.
Defective TrimTrac 1.5 To confirm that a TrimTrac 1.5 is defective, do the following: 1. Try a known-good TrimTrac 1.5. 2. Move into an area with strong GSM coverage. 3. Send the TrimTrac 1.5 a data message requesting a response. Note – Before returning the TrimTrac 1.5, be sure to save the TrimTrac 1.5’s configuration settings, and remove your SIM.
4. No Reports Generated. The TrimTrac 1.5 is expected to spend a majority of its time in either the IDLE or DELAY states, during which the unit will not send any messages until motion causes a transition, the appropriate RTC-based timeouts have expired, or if an Alert condition occurs.
Continued Reporting After Coming to Rest In the event a TrimTrac 1.5 continues to report after coming to rest, it may be because the motion detector is overly sensitive for the given application environment. Fine-tuning of the motion detector settings is achieved by changing the motion timeout and second-count settings.
AND BEGIN TRANSMITTING NOMINALLY EVERY 2-3 MINUTES UNTIL AN ACKNOWLEDGEMENT IS RECEIVED. Verify Checksums when Analyzing Data An easy way to analyze data received from The TrimTrac 1.5 is to log the actual messages into a text file and verify that the messages are valid by checking the checksums. Available from www.trimtrac.com is a simple checksum checker executable that can be run against a text file containing messages sent from a TrimTrac 1.5.
2. that are SET_ALERT_STATE messages in which a priority alert status is set “0=Clear” but the underlying condition that triggered the original alert message has not been returned to its “normal” condition. Different network operators may also handle queued up SMS messages differently. For instance, if the TrimTrac 1.
TrimTrac Placement vs.
Typical GPS Fix Times (Warm Start, 50%) Time-To-First-Fix 50% (Seconds) 1000 300 Time-To-First-Fix (Typical, 50%) Default T2 Setting, 300 Seconds 100 10 -136 Obscured Sky View -135 -134 -133 GPS Signal Strength (dBm) -132 -131 -130 Clear, Unobstructed Sky View Figure 3, Warm Start TTFFs DRAFT TrimTrac 1.5 Technical Manual v0.
TrimTrac State Machine Introduction In most applications, motion-based reporting is the fundamental operating premise of the TrimTrac 1.5 as shown in Figure 4. This generally means that the unit computes and reports new GPS position fixes only if the unit is in motion and once more after coming to rest. To conserve power and minimize communication costs, the TrimTrac 1.5 attempts to be in a sleep mode as much as possible. Sleep modes occur both during the IDLE and DELAY states. In general, the TrimTrac 1.
is set “0=Disabled”. If the Motion Report Flag is set “1=Enabled” then motion will cause a transition to STATUS. Expiration of IDLE Timeout, T1, causes a transition to the STATUS state. The programmable IDLE Timeout, T1, is stored as seconds and is typically on the order of 12 to 48 hours. There are also optional Anytime Polling settings that allow the device to run the communications protocol stack during the IDLE state to receive and process incoming messages.
DELAY: The device disables the motion sensor wakeup and goes to sleep for a programmable DELAY Timeout, T4. When the unit wakes up it transitions to the IDLE state by enabling the motion sensor and going back to sleep. The programmable DELAY Timeout, T4, is stored as seconds and is typically on the order of 10 to 20 minutes.
The TriggerType variable refers to what event caused the device to transition from the IDLE state. There are six TriggerTypes: 0=IDLE Timeout, T1 1=Motion Detected 2=Alert set “Activated” (Module-only) 3=Query 4=Scheduled Report 5=Stop Report The primary ReportType variable can be either: STATUS_MSG or REPORT_POS. The principal difference between STATUS_MSG and REPORT_POS is that REPORT_POS contains position and related information whereas STATUS_MSG does not contain such information.
lesser priority alert alarms are ignored until all higher priority alerts have been either cleared to “0=Normal” or set “3=Acknowledged”. The status of alerts configured in the “3=Monitor-only” mode will be included in all STATUS_MSG and REPORT_POS messages, but activation of any such monitored alerts will not in and by themselves result in new message transmissions. When a VAM or Control Module equipped TrimTrac 1.
1. “2=Sent” from “1=Activated” during the TRANSMIT state if and only if the GSM protocol software has confirmed that the message has been successfully transmitted to the GSM network. 2. “3=Acknowledged” from “1=Activated” or “2=Sent” only upon the receipt of an appropriate SET_ALERT_STATE message or, if the Alert Mode is set “2=Network Acknowledgement”, upon confirmation from the GSM protocol software that the message has been successfully transmitted to the GSM network. 3.
• Upon expiration of the IDLE Timeout, T1, the TriggerType is set “0=IDLE Timeout, T1”, the TrimTrac 1.5 will transition to the STATUS state (bypassing the FIX state). • If motion is detected while in the IDLE state, the TrimTrac 1.5 will activate the Static Motion Filter Timeout, T7, and apply the Static Motion Filter Counter, N3.
• If either of the Runtime meters have a threshold set to some value other than “0 hours” and the accumulated runtime hours or either exceed the associated threshold, then the TriggerType will be set “5=Runtime Meter” and the device will transition to the STATUS State. • If the Report Delay Flag is set “4=Start/Stop Report” and there has been no motion since the most recently completed FIX State, then the TriggerType will be set “6=Stop Report” and the device will transition to the STATUS State.
settings in effect. In TrimTrac 1.5, the GPS receiver and GSM Modem can operate simultaneously (unlike earlier generations of the TrimTrac locator). 1. When the unit enters the FIX State it enables the GPS hardware and starts the FIX Timeout, T2 (Very rapid LED blink rate followed by a repeated Long ON, Long OFF LED blink rate). 2. Upon completion of a successful position fix, the relevant position related information is extracted and the internal the RTC is updated. 3.
TRANSMIT State Upon entering the TRANSMIT state from the STATUS state, the TrimTrac 1.5 will: 1. Power up the GSM hardware (if not already operational); 2. Start the TRANSMIT Timeout, T3 (LED Blink: Short ON, Long OFF); 3. Attempt find a suitable 850, 900, 1800 or 1900 MHz GSM network, establish SIM communication and register on the network; AND 4. If a suitable GSM network connection is made, transmit the latest queued messages before expiration of the TRANSMIT Timeout, T3. The TrimTrac 1.
3. To the QUERY state if the GSM protocol stack confirms that the attempt to send queued TrimTrac 1.5 messages, other than a Motion Report, succeeded. 4. To the DELAY state if the TriggerType is set “1=Motion Detected” and: a. The TrimTrac 1.5 has already cycled through the FIX state due to the Motion Report Flag being set “1=Report Motion in IDLE”; OR b. The TRANSMIT Timeout, T3, expires or the TrimTrac 1.
Figure 5, HPA Processing in TRANSMIT DRAFT TrimTrac 1.5 Technical Manual v0.
Figure 6, MPA Processing in TRANSMIT DRAFT TrimTrac 1.5 Technical Manual v0.
Figure 7, LPA Processing in TRANSMIT DRAFT TrimTrac 1.5 Technical Manual v0.
Figure 8, Other Message Processing in TRANSMIT DRAFT TrimTrac 1.5 Technical Manual v0.
QUERY State The QUERY State is where the Application waits for incoming messages from the server. During this state the GPS hardware may be powered off but the GSM radio is powered on. 1. Upon entering the QUERY state, the TrimTrac 1.5 starts QUERY Timeout, T5 (LED Blink: Long ON, Short OFF). 2. The application then waits until the QUERY Timeout, T5, expires or a valid data message arrives, either via SMS or GPRS. 3.
1. If HPA Status is set: a. “1=Activated”, then go to immediately to the IDLE state; b. “2=Sent”, then ignore all data messages received prior to the receipt of SET_ALERT_STATE message and: i. If Position Age is set “1=Aged”, then go immediately to the IDLE state; or ii. If Position Age is set “0=Current”, then go to the IDLE state upon expiration of HPA Query Timeout, T17. 2. If MPA Status is set: a. “1=Activated”, then go to immediately to the IDLE state; b.
DELAY State The DELAY State is where the TrimTrac 1.5 normally dwells after a state machine cycle and ignores any detected motion. This effectively restricts the unit to reporting no more often than the DELAY Timeout, T4; provided, however, all Vehicle Adapter or Control Module alerts are in the “0=Normal” status condition or have their modes set “1=Disabled” or “3=Monitor-only”. 1. Upon entering the DELAY State, the TrimTrac 1.5 starts DELAY Timeout, T4. (LED Blink: OFF). 2.
ii. If Position Age is set “0=Current”, then go to the IDLE state upon expiration of MPA Delay Timeout, T14. c. “3=Acknowledged”, then go to the IDLE state upon expiration of DELAY Timeout, T4. 7. Proceed immediately to the IDLE state whenever: a. The LPA switch is in its “armed” closed position regardless of how the LPA Status is set. b. LPA Status is set “1=Activated” regardless of the LPA switch position (“unarmed” open or “armed” closed). 8.
Alert Processing Summary of Alert Sequence Processing. Assuming that alert modes are NOT set “1=Disabled” or “3=Monitor-only, the following is a summary of how alerts are processed: 1. 2. 3. 4. 5. 6. 7. 8. 9. Monitored device or condition changes to “alert” condition TrimTrac begins transmitting alert messages Alert message received by server application Server application automatically sends an ACKNOWLEDGE message to TrimTrac. This will stop the continuous re-transmission of alert messages.
Operation of the TrimTrac 1.5 is altered depending upon the status of each monitored device and status of the alert. By definition, an alert is considered “normal” when in the condition as shown in Figure 9, Vehicle Adapter Module Alert Wiring Diagram on page 52 and all previous alerts have been cleared (more on clearing of alerts shortly). An alert is said to have been “Initiated” when its status first changes from the “0=Normal” to “1=Activated” condition.
Initiation of a High Priority Alert will cause the TrimTrac 1.5 to terminate immediately whatever state it happens to be in at the time and to commence continuous transmission of the alert message until a SET_ALERT_STATE message acknowledging or clearing the activated High Priority Alert is received by the TrimTrac 1.5. Please see Table 17, High Priority Alert Processing on page 75.
Please see Table 19, Low Priority Alert Processing on page 77. Also, Figure 7, LPA Processing in TRANSMIT, on page 65 has a detailed flow chart on how Low Priority Alerts are processed in the TRANSMIT state. Server Application-side Considerations Upon the receipt of any alert message with a status of either “1=Activated” or “2=Sent”, the server application should automatically send an immediate SET_ALERT_STATE message acknowledging (not clearing) the alert.
Position Age High Priority Alert (HPA) Flag “0=Normal” “1=Aged” “0=Current” Normal Operation Upon initiation of a HPA, the HPA Status flag is set “1=Activated” and the device terminates its current operation immediately and transitions to STATUS state. While in the STATUS state, the devices generates a new STATUS_MESSAGE in which the TriggerType is set “2=Alert”. This STATUS_MESSAGE is combined with most recent logged POSITION_REPORT, collectively “HPA Report”.
Position Age Medium Priority Alert (MPA) Flag “0=Normal” “1=Aged” “0=Current” Normal Operation Upon initiation of a MPA, the MPA Status flag is set “1=Activated” and the device terminates its current operation immediately, unless in the TRANSMIT state, and transitions to STATUS state. If in the TRANSMIT state, then the current TRANSMIT state is completed prior to transitioning to the STATUS state.
Position Age Low Priority Alert (LPA) Flag “0=Normal” “1=Aged” “0=Current” Normal Operation Upon motion and initiation of a LPA, the LPA Status flag is set “1=Activated” and the device terminates its current operation immediately, unless in the FIX or TRANSMIT states, and transitions to STATUS state. If in the FIX or TRANSMIT state, then those states are completed prior to transitioning to the STATUS state.
TrimTrac 1.5 Configuration Introduction Configuration is the process of setting the operational and communication parameters of the TrimTrac 1.5. Most, but not all, of these parameters can be set or changed over the air; however, certain non-default entries, such as the Unit ID, Security Password and SIM PIN, can only be entered or changed when the TrimTrac 1.5 is connected to a PC via a Provisioning Module.
Select, download and install the appropriate VCP Driver for either Win'98 / ME / 2000 / XP (with enhanced BM series support) driver following the instructions provided on the Web site and with the driver. HyperTerminal HyperTerminal is a standard program included in all current versions of Microsoft Windows (2000, XP) and can be typically found in the Communications directory under Accessories.
Bits Per Second: 115200 Data Bit 8 Parity None Stop Bits 1 Flow Control None Click “OK” when done. 5. If you wish to view what you type on the HyperTerminal Screen, click on File, Properties, Settings, ASCII Settings and checkmark the “Echo Typed Characters Locally” box. Click “OK” to close each panel. 6. To check whether you have successfully connected the TrimTrac 1.5 and Provisioning Module to HyperTerminal, type: AT+CTKC? 7.
To send a text file, select and open the desired text file from Transfer, Send Text File panel. DRAFT TrimTrac 1.5 Technical Manual v0.
Provisioning AT Commands AT Command Summary The following AT commands are used to provision and configure the TrimTrac 1.5 via HyperTerminal when connected to the Provisioning Module.
AT+CTKC Application Configuration The AT+CTKC command is used to configure the Basic Read/Write parameters of the TrimTrac 1.5. It can query the current settings or change them to new values. AT+CTKC=,,,,,,,,,, OK In seconds (10 – 999990).
AT+CTKC? +CTKC: ,,,,,,,,,, OK In seconds (10 – 999990). Default 300 In seconds (10 – 3600). Default 300 In seconds (10 – 3600).
AT+CTKE Factory Default & Log Erase Command The AT+CTKE command restores configuration parameters back to factory default values and erase the message log from the TrimTrac 1.5 device. After a slight pause, the RDY response will appear. Wait for RDY to appear before executing additional commands.
AT+CTKF? CTKF:,,,, OK 0=UDP; 1=TCP. Default: 1 0=None; 1=TrimTrac ICD (See Separate Document). Default: 0 GPRS destination address in the following format: 111.222.333.444:12345.
AT+CTKJ GPRS Setup Provisioning The AT+CTKJ command configures the GPRS setup provisioning parameters. All fields must be enclosed with quotations AT+CTKJ=,, OK Access Point Name (APN) Web Address up to 40 case sensitive alphanumeric characters. Example: “apn.trimble.com”. Must use quotation marks “_”. Default: Up to 40 case sensitive alphanumeric characters. Must use quotation marks “_”.
AT+CTKG GPS Configure The AT+CTKG command configures the GPS parameters. This command mirrors the functionality of the over-the-air GPS_CONFIG message. It can query the current settings or change them to new values. AT+CTKG=,,,, OK In tenths of PDOP (60 – 200).
AT+CTKK Geofence Configuration The AT+CTKK command configures the Geofence parameters. All Geofences must be the same type as defined in AT+CTKZ or SET_EXT2_APP_CONFIG. AT+CTKK=,,,,,, OK Unique geofence identifier 1 or 2. Default: 1 0=Disabled; 1=Enforced 24/7; 2=LPA Input Enforced; 3=LPA Centered and Enforced..
AT+CTKK? CTKK: ,,,,,, OK Unique geofence identifier 1 or 2. Default: 1 0=Disabled; 1=Enforced 24/7; 2=LPA Input Enforced; 3=LPA Centered and Enforced.. Default: 0 Future Use. Default: 0 100s of meters (1 – 10000) Note: East-West length of rectangular Geofence area or, if circular, the diameter. 1=100 Meters.
AT+CTKO? Retrieve Message Log Command The AT+CTKO? command will retrieve all messages stored in the log while in the service mode, in the order of protocol sequence number. AT+CTKO? +CTKO: {message} OK Table 32, AT+CTK0? Query Note: When using AT+CTKO? in HyperTerminal, use the “Capture Text” command under the “Transfer” menu to save the messages to a text file. Otherwise, some messages may be partially truncated as they are retrieved from the TrimTrac 1.5.
AT+CTKP? +CTKP: ,,, OK Always 8 alphanumeric characters, UPPER CASE ONLY 24 characters including optional international dialing “+” sign and country code for SMS messages.. If used, must be between 4 and 8 digits.
AT+CTKX Extended Application Configuration The AT+CTKX command is used to configure the enhanced Basic Read/Write parameters of the TrimTrac 1.5. It can query the current settings or change them to new values.
0=Formerly “Extended Motion Detection” in TrimTrac 1.0 Not used in TrimTrac 1.5. Default 0 0=Until T3 Expires; 1-255=Number of Tx Attempts. Default 1 0=Until T3 Expires; 1-255=Number of Tx Attempts. Default 1 In Seconds (1-90). Note: This parameter is used only while Static Motion Filter Timeout, T7, is running in the IDLE State.
AT+CTKX? +CTKX: ,,,,,,,,,,,,, OK
Attempts, N1> Default 1 0=Until T3 Expires; 1-255=Number of Tx Attempts. Default 1 In Seconds (1-90). Note: This parameter is used only while Static Motion Filter Timeout, T7, is running in the IDLE State. It is superseded by the Dynamic Motion Filter Counter, N4 whenever: A. Anytime Polling is set “2=Anytime OnDemand”; OR B. Polling Duty-Cycle On-Time, T20, is running due to Anytime Polling being set “1=Duty-Cycled”.
AT+CTKY Module-only Application Configuration The AT+CTKY command configures the application parameters specific to the Vehicle Adapter or Control Module. AT+CTKY=,,,,,,,,,,,, OK In Seconds (10-999990).
AT+CTKY? CTKY: ,,,,,,,,,,,, OK In Seconds (10-999990). Default 10 In Seconds (10-999990). Default 10 In Seconds (10-86400).
AT+CTKZ Daily Hours, Runtime & Other Extended Settings The AT+CTKZ command configures the Scheduled Hours of Operation, Runtime Meter and other operation parameters as defined below.
AT+CTKZ? CTKZ: ,,,,,,,,,,,,, OK
ATI Retrieve Firmware Version Command The ATI command will retrieve the firmware version. Note that no “?” mark is used in this query ati Trimble Navigation Ltd TrimTrac (tm) Revision: {message} OK Table 41, ATI Query DRAFT TrimTrac 1.5 Technical Manual v0.
TrimTrac 1.5 Defaults Introduction Factory default settings of the TrimTrac 1.5 are listed in Table 82 through Table 86, beginning on page 147. All such default settings can be easily changed to suit the particular application requirements. The challenge for most is figuring out the true applications requirements.
up. The SIM PIN setting is stored in the firmware and is used if the SIM requests it. If so requested, the SIM PIN is used to attempt to unlock the SIM. If the unlock fails, the SIM PIN is marked as having caused a failure and not retried until the user physically connects the TrimTrac 1.5 to a Provisioning Module and uses the AT+CKTP command to change the SIM PIN. This is to prevent the SIM from becoming unusable after 10 SIM PIN failures. The SIM PIN cannot be read back once set.
TrimTrac State IDLE while sensing motion or if Anytime Polling is active Starting FIX State FIX TRANSMIT QUERY DELAY DELAY to IDLE IDLE while waiting for motion (IDLE “sleep”) Collecting Almanac All except DELAY State Blink Rate 250ms ON / 250 ms OFF In Plain Words… Rapid blinking 100ms ON / 300ms OFF.
TrimTrac Application Protocol Introduction The TrimTrac Application Protocol is used to communicate with and control TrimTrac 1.5s that have already been provisioned and deployed to the field. The TrimTrac 1.5 communicates with the server application by sending and receiving data messages based on an ASCII-like protocol (in lieu of the AT commands used during initial provisioning).
Element Meaning C Data string. PPPPPPPP Security Password. Always 8 alphanumeric characters, UPPER CASE ONLY. Default 00000000 YYYYYYYY Unit ID. Always 8 alphanumeric characters, UPPER CASE ONLY. Default 00000000 ZZ 2-character checksum. {x} Signifies that x can occur zero or more times [x] Signifies that x may optionally occur once Table 43, Basic Message Format Message Framing Each TrimTrac Application Protocol message is framed by the start, end ASCII characters ‘>’, ‘<’, respectively.
alphanumeric password of up to eight characters while the TrimTrac 1.5 is connected to a Provisioning Module. The TrimTrac 1.5 checks all incoming messages for a Security Password and all incoming message must include a Security Password. If the Security Password included in a message sent to TrimTrac 1.5 does not match the Security Password configured in the TrimTrac 1.5, then the message is ignored. Unit ID The Unit ID must be used in all communications with the TrimTrac 1.5. The TrimTrac 1.
/******************************************************************************* * Function: AppProtocolCalcTAIPChecksum * Parameters: pszTAIPMsg, checksum * Returns: Pointer to Checksum Header ;* if found, NULL otherwise. * Description: This function checks for the presense of the TAIP checksum * header. If it exists it calculates the checksum and * places it in the checksum parameter and returns a pointer * to the checksum header. * Otherwise it returns NULL without changing checksum.
TrimTrac Application Protocol Message Summary (Sorted by Name) Header Message Name Description >QTK{x} >QTKR >QTKM >QTKD >QTKU >RTKP >RTKL >RTKA >RTKX >RTKZ >RTKK >RTKF >RTKJ >RTKG >RTKM >RTKV >RTK{1-4} >RTKR >RTKY >RTKU >STKL >STKA >STKX >STKZ >STKK >STKF >STKJ >STKG >STKV >STKY >STKU >RTKS QUERY_CONFIG QUERY_LOG QUERY_METERS QUERY_POSITION QUERY_CONTROL_OUTPUTS REPORT_POS RESP_ALERT_STATE RESP_APP_CONFIG RESP_EXT_APP_CONFIG RESP_EXT2_APP_CONFIG RESP_GEOFENCE_CONFIG RESP_GPRS_CONNECT_CONFIG RESP_GPRS_S
TrimTrac Application Protocol Message Summary (Sorted by Header) Header Message Name Description >QTK{x} >QTKD >QTKM >QTKR >QTKU >RTK{1-4} >RTKA >RTKF >RTKG >RTKJ >RTKK >RTKL >RTKM >RTKP >RTKR >RTKS >RTKU >RTKV >RTKX >RTKY >RTKZ >STKA >STKF >STKG >STKJ >STKK >STKL >STKU >STKV >STKX >STKY >STKZ QUERY_CONFIG QUERY_POSITION QUERY_METERS QUERY_LOG QUERY_CONTROL_OUTPUTS RESP_QUERY_AGGR RESP_APP_CONFIG RESP_GPRS_CONNECT_CONFIG RESP_GPS_CONFIG RESP_GPRS_SETUP_CONFIG RESP_GEOFENCE_CONFIG RESP_ALERT_STATE RESP_M
TrimTrac Command and Response Summary COMMANDS SENT TO TRIMTRAC See Command Message Name Command Page Header 123 QUERY_LOG >QTKR 125 125 QUERY_METERS QUERY_POSITION >QTKM >QTKD 123 123 123 123 123 123 123 123 123 123 112 113 114 116 117 118 119 119 120 121 122 QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG SET_ALERT_STATE SET_APP_CONFIG SET_EXT_APP_CONFIG SET_EXT2_APP_CONFIG SET_GEOFENCE_CONFIG SET_GPRS_CONNECT_CONFIG
Configuration Messages The following messages are sent to the TrimTrac 1.5 to configure application, GPS and GSM parameters and to set Vehicle Adapter or Control Module alert and application parameters. SET_ALERT_STATE This message is sent to the TrimTrac 1.5 to acknowledge or clear alert states; provided, however, that the TrimTrac 1.5 is connected to a Vehicle Adapter or Control Module. When received the TrimTrac 1.5 will send a RESP_ALERT_STATE message in response, UNLESS: 1.
SET_APP_CONFIG The SET_APP_CONFIG message is used by the server application to set the primary state machine parameters in the TrimTrac 1.5. When received the TrimTrac 1.5 will send a RESP_APP_CONFIG message in response. >STKABBBBBBCCCCCCDDDDDDEEEEEEFFFFFFGGGTTHIJK;PW=PPPPPPP P;ID=YYYYYYYY;*ZZ< TrimTrac Configuration Set: ‘A’ = Application Parameters A BBBBBB IDLE Timeout, T1. In seconds (10 – 999990). Default 43200 CCCCCC FIX Timeout, T2. In seconds (10 – 3600). Default 300 DDDDDD TRANSMIT Timeout, T3.
SET_EXT_APP_CONFIG This message is used to set the Extended Application parameters in the TrimTrac 1.5. When received the TrimTrac 1.5 will send a RESP_EXT_APP_CONFIG message in response. >STKABCCCCCCDEFFFFFFGGGGGGHIJJJKKKLLMMNNO;PW=PPPPPPPP; ID=YYYYYYYY;*ZZ< A B CCCCCC D E TrimTrac Configuration Set: ‘X’ = Extended Application Parameters Scheduled Reporting Mode. 0=None; 1=Daily; 2=Weekly. Default 0 Scheduled Report Time, T18. In Seconds (0-604799).
KKK LL 255=Number of Tx Attempts. Default 1. Status Message Transmit Attempts, N2. 0=Until T3 Expires; 1255=Number of Tx Attempts. Default 1. Static Motion Filter Counter, N3. In Seconds (1-90). Note: This parameter is used only while Static Motion Filter Timeout, T7, is running in the IDLE State. It is superseded by the Dynamic Motion Filter Counter, N4 whenever: A. Anytime Polling is set “2=Anytime OnDemand”; OR B.
SET_EXT2_APP_CONFIG This message is used to set the Extended 2 Application parameters in the TrimTrac 1.5. When received the TrimTrac 1.5 will send a RESP_EXT2_APP_CONFIG message in response. >STKABBBBCDDDDDEEEEEFGHIJJJKKKLMNNNO;PW=PPPPPPPP;ID=YY YYYYYY;*ZZ< A TrimTrac-1.5 Configuration Set: ‘Z’ = Extended 2 Application Parameters BBBB Motion Counter Threshold: Counter (1-2000). Default 10 C Scheduled Hours: 0=Disabled; 1=Enabled.
SET_GEOFENCE_CONFIG This message is used to set up a Geofence in the TrimTrac-1.5 device. When received the TrimTrac-1.5 device will send a RESP_GEOFENCE_CONFIG message in response. Please note that all geofences must be the same type (Boundary Crossing, Exclusive, Inclusive) as determined by either SET_EXT2_APP_CONFIG or AT+CTKZ. >STKABBCDEEEEEFFFFFGGGHHHHHHHIIIIJJJJJJJ;PW=PPPPPPPP;I D=YYYYYYYY;*ZZ< A TrimTrac-1.
SET_GPRS_CONNECT_CONFIG This message is used to set the GPRS Connection Configuration Values in the TrimTrac-1.5 device. When received the TrimTrac-1.5 device will send a RESP_GPRS_CONNECT_CONFIG message in response. >STKABCDDDDDEEEEEFFFFFFFFFFFFFFFFFFFFF”;PW=PPPPPPPP;ID =YYYYYYYY;*ZZ< A TrimTrac-1.5 Configuration Set: ‘F’ = GPRS Communication Configuration Parameters. B GPRS Transport Protocol: 0=UDP; 1=TCP. Default 1 C GPRS Session Protocol: 0=None; 1=TrimTrac ICD (See Separate Document).
SET_GPRS_SETUP_CONFIG This message is used to set the GPRS Setup Configuration Values in the TrimTrac-1.5 device. When received the TrimTrac-1.5 device will send a RESP_GPRS_SETUP_CONFIG message in response. >STKABBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB”CCCCCCCC CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC”DDDDDDDDDDDDDDDDDDDD” ;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A TrimTrac-1.
SET_GPS_CONFIG The SET_GPS_CONFIG message is used by the server application to set the TrimTrac GPS parameter values in the TrimTrac 1.5. When received the TrimTrac 1.5 will send a RESP_GPS_CONFIG message in response. Please note that these GPS configuration parameters will seldom need to be changed from default values. It is NOT recommended that they be changed without first consulting with your Trimble representative.
SET_MODULE_APP_CONFIG This message is used by the server to set the Application Parameter Values associated with the Vehicle Adapter and Control Modules. When received the TrimTrac 1.5 will send a RESP_MODULE_APP_CONFIG message in response. TrimTrac 1.5s not equipped with a MODULE ignore the message. >STKABBBBBBCCCCCCDDDDDDEEEEEEFFFFFFGGGGGGHHHHHHIIIJJJK KKLMN;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A MODULE-only Configuration Set: ‘Y’ = MODULE-only Parameters BBBBBB HPA Idle Timeout, T11.
SET_CONTROL_OUTPUT This message is sent by the server to set the Control Module Output pins to the desired state. When received the device will send a RESP_CONTROL_OUTPUT message. >STKABCDDDDDDDDDDDDDDDD;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A Always ‘U’: Indicates a set Control Module output message. B Output 1: 0=Output Low; 1=Output High; 2=No Change. C Output 2: 0=Output Low; 1=Output High; 2=No Change. DDDD Reserved for future use. 16 digits. Must be sent as DDDD ‘0000000000000000’.
Query Messages QUERY_CONFIG This QUERY_CONFIG message is used by the server application to request the TrimTrac 1.5 send its TrimTrac Application, GPS or Communication parameters in the appropriate RESP_APP_CONFIG, RESP_PROV_CONFIG or RESP_GPS_CONFIG message.
QUERY_LOG This message is used by the server application to request logged REPORT_POS or STATUS_MSG messages that may not have been received at the server application. The TrimTrac 1.5 will send the corresponding messages to the server application in response to this message at the rate of one REPORT_POS or STATUS_MSG per message. At the end of the messages a RESP_QUERY_LOG or RESP_QUERY_AGGR is sent. The TrimTrac 1.5 log contains 1,024 of the most recent messages.
QUERY_METERS This message is sent by the server to request the current state of the runtime meters (See SET_EXT2_APP_CONFIG for runtime meter setup instructions). The meters can also be individually cleared via this message. >QTKABC;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A Always ‘M’: Indicates a query runtime meters message. B Runtime Meter Motion-based Query: 0=Report Only (No Reset); 1=Report with Reset C Runtime Meter LPA-based Query: 0=Report Only (No Reset); 1=Report with Reset PPPPPPPP Security Password.
b. QUERY_POSITION Operation Mode is set “P=Compute New Position Fix”. The new STATUS_MSG will have the TriggerType set to “3=Query” and the Position Aged flag will be set ‘1’=Aged if there has been motion since the last logged position; else the Position Aged flag will be set “1=Current”. >QTKABCCCC;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A Always ‘D’: Indicates a query Position message. B Position Query Mode.
Position, Status and Response Messages REPORT_POS and STATUS_MSG These two messages are the most common. The difference between the REPORT_POS and STATUS_MSG is that the REPORT_POS message contains position information. STATUS_MSG does not contain any position. >RTKABBBBCDDDEFFFFGGGGGGSTVOPQRWXUUU[HHHIIIIIIIJJJJKKK KKKKLLLLLLMMMNNN];ID=YYYYYYYY;*ZZ< A BBBB C TrimTrac Report Type: ‘P’ = Position Report ‘S’ = Status Report Protocol Sequence Number.
Q R W X UUU YYYYYYYY ZZ HHH.IIIIII I JJJJ.KKKKK KK LLLLLL MMM NNN 3=Acknowledged; 4=Monitor Activated LPA Status: 0=Normal; 1=Activated; 2=Sent; 3=Acknowledged; 4=Monitor Activated External Power: 0=Bad (Below 5 VDC); 1=Good (5 VDC or higher) Geofence Status: 0=Normal; 1=Violation; 5= New LPA-based Geofence Extended GPS Status code: 0=Internal Antenna, Almanac Complete 1=External Antenna, Almanac Complete 2=Int. Antenna, Almanac Incomplete 3=Ext.
RESP_ALERT_STATE The TrimTrac 1.5 sends this message after a SET_ALERT_STATE request is received and processed; provided, however, that the TrimTrac 1.5 is connected to a Vehicle Adapter or Control Module. If battery powered, then this message will not be sent upon receipt of a SET_ALERT_STATE request. >RTKABCD;ID=YYYYYYYY;*ZZ< A Always ‘L’: Indicates operation mode setting B HPA Status. 0=Normal; 1=Activated; 2=Sent; 3=Acknowledged; 4=Monitor Activated C MPA Status.
RESP_APP_CONFIG This is the response message to the SET_APP_CONFIG and QUERY_CONFIG messages containing the Application Parameter values. >RTKABBBBBBCCCCCCDDDDDDEEEEEEFFFFFFGGGTTHIJKLLLLMMMMMMNP P;ID=YYYYYYYY;*ZZ< A TrimTrac Configuration Set: ‘A’ = Application Parameters BBBBBB IDLE Timeout, T1. In seconds (10 – 999990) CCCCCC FIX Timeout, T2. In seconds (10 – 3600) DDDDDD TRANSMIT Timeout, T3. In seconds (10 – 3600) EEEEEE DELAY Timeout, T4. In seconds (10 – 86400) FFFFFF QUERY Timeout, T5.
RESP_EXT_APP_CONFIG This is the response message to the SET_EXT_APP_CONFIG and QUERY_CONFIG message containing the Extended Application Parameter values. >RTKABCCCCCCDEFFFFFFGGGGGGHIJJJKKKLLMMNNO;ID=YYYYYYYY; *ZZ< A B CCCCCC D TrimTrac Configuration Set: ‘X’ = Extended Application Parameters Scheduled Reporting Mode. 0=None; 1=Daily; 2=Weekly Scheduled Report Time, T18. In Seconds (0-604799).
KKK LL Status Message Transmit Attempts, N2. 0=Until T3 Expires; 1255=Number of Tx Attempts. Static Motion Filter Counter, N3. In Seconds (1-90). Note: This parameter is used only while Static Motion Filter Timeout, T7, is running in the IDLE State. It is superseded by the Dynamic Motion Filter Counter, N4 whenever: A. Anytime Polling is set “2=Anytime OnDemand”; OR B. Polling Duty-Cycle On-Time, T20, is running due to Anytime Polling being set “1=Duty-Cycled”.
RESP_EXT2_APP_CONFIG This is the response message to the SET_EXT2_APP_CONFIG and QUERY_CONFIG message containing the Extended 2 Application Parameter values. >RTKABBBBCDDDDDEEEEEFGHIJJJKKKLMNNNO;ID=YYYYYYYY;*ZZ< A TrimTrac-1.5 Configuration Set: ‘Z’ = Extended 2 Application Parameters BBBB Motion Counter Threshold: Counter (1-2000). Default 10 C Scheduled Hours: 0=Disabled; 1=Enabled. Default 0 DDDDD Daily Start Time, T27: In Seconds (0 – 86399) after 12:00AM UTC..
RESP_GEOFENCE_CONFIG This is the response message to the SET_ GEOFENCE _CONFIG and QUERY_GEOFENCE_CONFIG message containing the Geofence Parameter values. >RTKABBCDEEEEEFFFFFGGGHHHHHHHIIIIJJJJJJJ;ID=YYYYYYYY;* ZZ< A TrimTrac-1.5 Configuration Set: ‘K’ = Geofence Parameters BB Geofence ID: Unique geofence identifier 1 or 2. Default 1 C Geofence Enforcement: 0=Disabled; 1=Enforced 24/7; 2=LPA Input Enforced; 3=LPA Centered and Enforced.. Default 0 D Reserved.
RESP_GPRS_CONNECT_CONFIG This is the response message to the SET_ GPRS_CONNECT _CONFIG and QUERY_CONFIG message containing the GPRS Connection Parameter values. >RTKABCDDDDDEEEEEFFFFFFFFFFFFFFFFFFFFF”;ID=YYYYYYYY;*Z Z< A TrimTrac-1.5 Configuration Set: ‘F’ = GPRS Communication Configuration Parameters. B GPRS Transport Protocol: 0=UDP; 1=TCP. Default 1 C GPRS Session Protocol: 0=None; 1=TrimTrac ICD (See Separate Document).
RESP_GPRS_SETUP_CONFIG This is the response message to the SET_ GPRS_SETUP _CONFIG and QUERY_CONFIG message containing the GPRS Setup Parameter values. >RTKABBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB”CCCCCCCC CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC”DDDDDDDDDDDDDDDDDDDD” ;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A TrimTrac-1.5 Configuration Set: ‘J’ = GPRS Communication Configuration Parameters BBB…BBB GPRS APN: Access Point Name (APN) Web Address up to 40 (40 case sensitive alphanumeric characters. Example: chars) “apn.trimble.
RESP_METERS This is the response message to the QUERY_METERS message. This message is also sent whenever either Runtime meter reaches it automatic report threshold, if so enabled. (See SET_EXT2_APP_CONFIG for runtime meter setup instructions). >RTKABCDDDDDDDDDDEEEEEEEEEE;ID=YYYYYYYY;*ZZ< A Always ‘M’: Indicates a query runtime meters message.
RESP_QUERY_AGGR The TrimTrac 1.5 sends this message after a QUERY_LOG request is received and processed, and if Aggregate Log Reporting Flag is ‘enabled’. It will contain messages in aggregated format as shown below. The entire message can be no more than 160-byte SMS message. >RTKA{B};ID=YYYYYYYY;*ZZ< A B YYYYYYYY ZZ ‘1’ to ‘4’: Indicates number of REPORT_POS messages contained in this RESP_QUERY_AGGR message. Message fields from Report Type to the first semi-colon (excluded). Unit ID.
RESP_MODULE_APP This is the by the TrimTrac 1.5 in response to the SET_MODULE_APP_CONFIG and QUERY_CONFIG message. >RTKABBBBBBCCCCCCDDDDDDEEEEEEFFFFFFGGGGGGHHHHHHIIIJJJKKKLMN;ID=YY YYYYYY;*ZZ< A BBBBBB CCCCCC DDDDDD EEEEEE FFFFFF GGGGGG HHHHHH III JJJ KKK L M N YYYYYYYY ZZ MODULE-only Configuration Set: ‘Y’ = MODULE-only Parameters HPA Idle Timeout, T11. In Seconds (10-999990) MPA Idle Timeout, T12. In Seconds (10-999990) HPA Delay Timeout, T13. In Seconds (10-86400) MPA Delay Timeout, T14.
RESP_CONTROL_OUTPUT This is the by the TrimTrac 1.5 in response to the SET_CONTROL_OUTPUT or QUERY_CONTROL_OUTPUT messages. >RTKABCDDDDDDDDDDDDDDDD;ID=YYYYYYYY;*ZZ< A Always ‘U’: Indicates a set Control Module output message. B Output 1: 0=Output Low; 1=Output High; 2=No Module Attached0=Output Low; 1=Output High; 2=No Change; 3=No Module Attached C Output 2: DDDDDDDDD Reserved for future use. Must be sent as ‘0000000000000000’. DDDDDDD YYYYYYYY ZZ Unit ID.
Specifications GSM Specifications GSM 850/900/1800/1900 MHz Normal MS – SMS Data Only Class 4 (2W) @ 900 MHz (EGSM) and 850 MHz (GSM) Class 1 (1W) @ 1800 MHz (GSM 1800 DCS) and 1900 MHz (GSM 1900 PCS) Subscriber Identity Module Environmental Specifications Temperature Operating: -10oC to + 55oC Humidity 5% to 95% RH noncondensing @ +40oC Vibration* 1.8/3.0 Volt 0.008 g2/Hz 5 Hz to 20 Hz 0.
TrimTrac Part Numbers The following are Trimble part numbers for the TrimTrac 1.5 and accessories: Part Number Description TrimTrac 1.5 with Cover and Battery Module TrimTrac 1.5 with Cover and Vehicle Adapter Module TrimTrac 1.5 with Cover and Vehicle Adapter and Battery Modules TrimTrac 1.5 with Cover and Control Module TrimTrac 1.5 with Cover and Control and Battery Modules TrimTrac Provisioning Module Kit TrimTrac 1.5 Starter Kit Accessories and Parts TrimTrac 1.5 Base TrimTrac 1.5 Cover TrimTrac 1.
Bibliography European Telecommunications Standards Institute (ETSI). ETSI is the standards body for GSM worldwide operations. Specifications on various aspects of GSM phone operations (AT commands, installation requirements, and terminology) are available for download from ETSI at: www.etsi.org GPS, A Guide to the Next Utility, Trimble P/N 18239 (1992). A short, nontechnical introduction to GPS. Explains what GPS does, how it works, and its capabilities and limitations. www.trimble.
Glossary The Glossary defines technical terms and abbreviations used in this manual. It includes terms from the fields of wireless communications and GPS technology. 0D Time only in GPS terminology. 2D Two dimensions and time in GPS terminology. 3D Three dimensions and time in GPS terminology. 2D GPS Two-dimensional GPS position fix and time. 3D GPS Three-dimensional GPS position fix and time. Altitude Height above mean sea level (MSL). ASCII American Standard Code for Information Interchange.
Longitude Longitude coordinate of position fix with positive value indicating East. LPA Low Priority Alert MPA Medium Priority Alert PC Windows (2000, XP)-compatible Personal Computer. PCS Personal Communications Service. PIN Personal Identity Number. RF Radio Frequency. SIM Subscriber Identity Module. SMPP Short Message Peer to Peer. SMS Short Message Service. SPS TAIP Standard Positioning Service. Trimble ASCII Interface Protocol.
Quick Reference Tables DRAFT TrimTrac 1.5 Technical Manual v0.
Basic Unit, SMS and Security Parameters, Messages and Command Parameter Unit ID SMS Destination Address SIM PIN Security Password Unit/Notes Unique unit identifier. Always 8 alphanumeric characters, UPPER CASE ONLY, and can only be changed using Provisioning Module. Destination address to which all SMS messages will be sent (See GPRS Destination Address for IP addresses).
Basic State Machine Parameters, Messages and Commands Parameter IDLE Timeout, T1 FIX Timeout, T2 TRANSMIT Timeout, T3 DELAY Timeout, T4 QUERY Timeout, T5 Almanac Timeout, T6 Static Motion Filter Timeout, T7 Motion Report Flag Report Delay Flag Diagnostics Mode Communication Mode Unit/Notes In seconds (10 – 999990) In seconds (10 – 3600) In seconds (10 – 3600) In seconds (10 – 86400) In seconds (10 – 3600) In hours (10 – 990) In seconds (0 – 90).
Enhanced Feature Parameter Ranges and Default Settings Parameter Scheduled Reporting Mode Scheduled Report Time, T18 In-Motion Polling Anytime Polling Polling Duty-Cycle Frequency, T19 Polling Duty-Cycle OnTime, T20 Unit/Notes 0=None; 1=Daily; 2=Weekly In Seconds (0-604799). Note: This is either the seconds into the day or into the week for the device to schedule transmission of a STATUS_MESSAGE plus the most recently logged POSITION_REP, if any, when this feature is enabled.
Parameter Query Hold Flag Reserved Position Report Transmit Attempts, N1 Status Message Transmit Attempts, N2 Static Motion Filter Counter, N3 Unit/Notes 0=Disabled; 1=Enabled. Note: Unit attempts to reconnect to the GSM network if the connection is lost during the QUERY state prior to the expiration of QUERY Timeout, T5. 0=Formerly “Extended Motion Detection” in TrimTrac 1.0 Not used in TrimTrac 1.5.
Parameter Dynamic Motion Filter Counter, N4 Motion Sensor Override Unit/Notes In Seconds (1-90). Note: This parameter is enabled only when Dynamic Filter Timeout, T21, is active. WARNING: Dynamic Motion Filter Counter, N4, must always be set equal to or less than the setting for Dynamic Filter Timeout, T21; else the unit may not exit QUERY state.. 0=Normal; 1=Motion Always; 2=Motion Never. Note: Overrides the motion sensor if set to a value other than “0=Normal”..
Vehicle Adapter or Control Module Parameter Ranges and Default Settings Parameter HPA Idle Timeout, T11 MPA Idle Timeout, T12 HPA Delay Timeout, T13 MPA Delay Timeout, T14 HPA Transmit Timeout, T15 MPA Transmit Timeout, T16 HPA Query Timeout, T17 HPA Transmit Attempts, N5 MPA Transmit Attempts, N6 LPA Transmit Attempts, N7 HPA Mode MPA Mode LPA Mode Unit/Notes Default In Seconds (10-999990) 10 In Seconds (10-999990) 10 In Seconds (10-86400) 10 In Seconds (10-86400) 10 0=Infinity; Else in Seconds (10-99999
GPRS Communication Provisioning Read/Write Parameters : Parameter GPRS APN GPRS Username GPRS Password GPRS Session Keep-alive Timeout, T25 GPRS Session Protocol GPRS Transport Protocol GPRS Session Timeout, T26 GPRS Destination Address Unit/Notes Access Point Name (APN) Web Address up to 40 case sensitive alphanumeric characters. Example: “apn.trimble.com”.
Extended1.5 Read/ Write Parameters : Parameter Unit/Notes Motion Counter Threshold Counter (1-2000). Note: Number of motion counts per second required before motion counter is set. Scheduled Hours 0=Disabled; 1=Enabled Daily Start Time, T27 In Seconds (0 – 86399) after 12:00AM UTC. Work Day Length, T28 In Seconds (0 – 86400) Note: Number of seconds worked each workday.
Geofence Settings: Parameter Geofence ID Geofence Enforcement Reserved Geofence Delta X Geofence Delta Y Geofence Center Latitude Geofence Center Longitude Geofence Type Unit/Notes Unique geofence identifier 1 or 2 0=Disabled; 1=Enforced 24/7; 2=LPA Input Enforced; 3=LPA Centered and Enforced. Future Use 100s of meters (1 – 10000) Note: East-West length of rectangular Geofence area or, if circular, the diameter.
Stateless Operations Parameter Output 1 Unit/Notes 0=Output Low; 1=Output High; 2=No Change Message or Command >STKU Output 2 0=Output Low; 1=Output High; 2=No Change Runtime Meter Motionbased Query Runtime Meter LPA-based Query Position Query Mode 0=Report Only (No Reset); 1=Report with Reset Position Query Fix Timeout Erase/Restore Mode >QTKM >RTKM 0=Report Only (No Reset); 1=Report with Reset S=Compute if Position Aged; P=Compute New Position Fix; L=Status Report with Last logged position.
Read-Only Parameters, Formats and Ranges Parameter Protocol Sequence Number TriggerType Battery Level Battery Changed Flag GPS Week Number GPS Seconds into Week GPS Status Code Extended GPS Status code Value 16-bit Hex (0000-FFFF) incrementing by 1 for each logged report 0=IDLE Timeout 1=Motion Detected 2=Alert set “Activated” (Modules-Only) 3=Query 4=Scheduled Report 5=Runtime Meter Report 6=Stop Motion Report 0-100% T=True; F=False Always 4 Digits Always 6 Digits 0=3D GPS Fix 1=2D GPS Fix 2=Fix Timeout
Parameter GSM Status Code Position Age HPA Status MPA Status LPA Status Geofence Status External Power Latitude Longitude Altitude Horizontal Speed Heading Runtime Motion-based Reading Runtime LPA-based Reading Runtime Motion-based Reset Confirmation Value 0=Network Available 1=Message Logged (i.e. Report Delay Flag set=1) 2=Network Timeout 3=SIM Error / No SIM 4=SIM PIN Error 5=Pre-TX log (Low battery). 0=Current (i.e. no motion since last position) 1=Aged (i.e.
Parameter Runtime LPA-based Reset Confirmation Battery Change Week Battery Change Time Firmware Version Output 1 Output 2 Value 0=Report without Reset; 1=Report with Reset; 2=Disabled Messages GPS Week Number, always 4 digits Seconds into GPS Week, always 6 digits Numeric String 0=Output Low; 1=Output High; 2=No Change; 3=No Module Attached 0=Output Low; 1=Output High; 2=No Change; 3=No Module Attached >RTKA >RTKU Table 91, Read-only Parameters AT Command and Default Summary Command Description AT+C
AT+CTKY? Queries Vehicle Adapter and Control Module parameters AT+CTKZ Assigns Extended 2 Application parameters AT+CTKZ? Queries Extended 2 Application parameters AT+CTKE Restores Defaults and/or Erases Log AT+CTKO? Retrieves Logged Messages ATI Queries Firmware Version AT+CTKY=10,10,10,10,0,120,60,0,0,0,0,1,0 AT+CTKZ=10,0,0,43200,1,5,0,0,0,0,0,0,0,1 Not Applicable Not Applicable Not Applicable 99 85 99 101 Table 92, Summary of AT Commands and Defaults DRAFT TrimTrac 1.5 Technical Manual v0.
TrimTrac Application Protocol Message Summary (Sorted by Name) Header Message Name Description >QTK{x} >QTKR >QTKM >QTKD >QTKU >RTKP >RTKL >RTKA >RTKX >RTKZ >RTKK >RTKF >RTKJ >RTKG >RTKM >RTKV >RTK{1-4} >RTKR >RTKY >RTKU >STKL >STKA >STKX >STKZ >STKK >STKF >STKJ >STKG >STKV >STKY >STKU >RTKS QUERY_CONFIG QUERY_LOG QUERY_METERS QUERY_POSITION QUERY_CONTROL_OUTPUTS REPORT_POS RESP_ALERT_STATE RESP_APP_CONFIG RESP_EXT_APP_CONFIG RESP_EXT2_APP_CONFIG RESP_GEOFENCE_CONFIG RESP_GPRS_CONNECT_CONFIG RESP_GPRS_S
TrimTrac Application Protocol Message Summary (Sorted by Header) Header Message Name Description >QTK{x} >QTKD >QTKM >QTKR >QTKU >RTK{1-4} >RTKA >RTKF >RTKG >RTKJ >RTKK >RTKL >RTKM >RTKP >RTKR >RTKS >RTKU >RTKV >RTKX >RTKY >RTKZ >STKA >STKF >STKG >STKJ >STKK >STKL >STKU >STKV >STKX >STKY >STKZ QUERY_CONFIG QUERY_POSITION QUERY_METERS QUERY_LOG QUERY_CONTROL_OUTPUTS RESP_QUERY_AGGR RESP_APP_CONFIG RESP_GPRS_CONNECT_CONFIG RESP_GPS_CONFIG RESP_GPRS_SETUP_CONFIG RESP_GEOFENCE_CONFIG RESP_ALERT_STATE RESP_M
TrimTrac Command and Response Summary COMMANDS SENT TO TRIMTRAC See Command Message Name Command Page Header 123 QUERY_LOG >QTKR 125 125 QUERY_METERS QUERY_POSITION >QTKM >QTKD 123 123 123 123 123 123 123 123 123 123 112 113 114 116 117 118 119 119 120 121 122 QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_GEOFENCE_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG QUERY_CONFIG SET_ALERT_STATE SET_APP_CONFIG SET_EXT_APP_CONFIG SET_EXT2_APP_CONFIG SET_GEOFENCE_CONFIG SET_GPRS_CONNEC
Parameter Cross Reference TrimTrac 1.5 Versus Earlier TrimTrac Versions TrimTrac 1.
Yellow TrimTrac Vehicle Adapter Module HPA Resistor 4.7k Ohm LPA Resistor 37.
Figure 10, Control Module Wiring Diagram (TBD) DRAFT TrimTrac 1.5 Technical Manual v0.
