TrimTrac ProE Locator Technical Manual Including Enhanced Features and Vehicle Adapter or Control Module Part Number 80200-00-UG Version 2.
REVISION HISTORY Version Primary Author(s) Description of Version Date Completed 1.0 Bill Dussell Initial production release of manual. Functional descriptions expanded. Various updates to reflect current firmware v1.03.00.0000. January 2007 1.1 Bill Dussell Clarifications and updates up to and including firmware v1.08.00.000 May 2007 2.0 Bill Dussell Control Module and v2.03.00.000 firmware updates August 2007 2.
Corporate Office THIS PRODUCT LIMITED WARRANTY IS PROVIDED TO RESELLERS AND TO RESELLERS ONLY. RESELLER IS 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 SOLELY RESPONSIBLE FOR ANY AND ALL WARRANTIES MADE TO ITS CUSTOMERS, AND TRIMBLE MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AND SHALL HAVE NO OBLIGATIONS OR LIABILITY TO RESELLER’S CUSTOMERS OR END-USERS OF THE PRODUCT.
OTHERWISE EXPRESSLY PROVIDED FOR IN THIS PRODUCT LIMITED WARRANTY, THE PRODUCT, ACCOMPANYING DOCUMENTATION AND MATERIALS, AND/OR ANY AND UPDATES EMBEDDED SOFTWARE/FIRMWARE THERETO ARE PROVIDED “AS-IS” AND WITHOUT EXPRESS OR IMPLIED WARRANTIES OF ANY KIND, BY EITHER TRIMBLE OR ANYONE WHO HAS BEEN INVOLVED IN ITS PRODUCTION, INSTALLATION OR CREATION, DISTRIBUTION, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT.
Regulatory Approvals CE The TrimTrac ProE 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 ProE product complies with the European Telecommunications Standards Institute Specifications ETS300-342-1 (EMC for GSM 900MHZ and DCS 1800MHZ Radio Equipment and Systems). EEC The TrimTrac ProE product complies with Directive 72/245/EEC as amended by Directive 95/54/EC (el*72/245*95/54).
Contents About this Manual ........................................................................................................................................ xii Related Information ...................................................................................................... xii Technical Assistance.................................................................................................... xiii Minimum Information Required for Technical Assistance ....................................
Vehicle Adapter or Control Module Equipped Units ................................................... 57 External GPS Antenna .................................................................................................. 63 Vehicle Placement Guidelines ...................................................................................... 66 Technical Tips and Troubleshooting ............................................................................................................ 68 Introduction......
List of Tables Table 1, Firmware Changes through v1.03.00.000......................................................... xvii Table 2, Firmware Changes v1.03.00.000 through v1.05.00.000.................................. xviii Table 3, Firmware Changes v1.05.00.000 through v1.06.00.000.................................. xviii Table 4, Firmware Changes v1.06.00.000 through v1.08.00.000.................................. xviii Table 5, Firmware Changes v1.08.00.000 through v2.03.00.000.............................
Table 44, AT+CTKX? Query ......................................................................................... 130 Table 45, AT+CTKY Assignment.................................................................................. 131 Table 46, AT+CTKY? Query ......................................................................................... 133 Table 47, AT+CTKZ Assignment .................................................................................. 134 Table 48, AT+CTKZ? Query...................
Table 90, Basic Unit, SMS and Security Parameters, Messages and Command ........... 188 Table 91, GPS Parameters, Messages and Command .................................................... 188 Table 92, Basic State Machine Parameters, Messages and Command........................... 189 Table 93, Enhanced Feature Parameters and Defaults.................................................... 192 Table 94, Vehicle Adapter or Control Module Parameters and Defaults. ......................
List of Figures Figure 1. TrimTrac ProE Shown with Optional External GPS Antenna and Quick Release Bracket........................................................................................................... 9 Figure 2. TrimTrac with Metal Bracket............................................................................. 9 Figure 3. Provisioning Module inserted into a TrimTrac ProE ....................................... 10 Figure 4. Vehicle Adapter Module inserted into a TrimTrac ProE .............
About this Manual Welcome to the TrimTracTM Pro 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 ProE locator. Any end-user documentation is to be prepared and furnished by the Resellers. This manual covers the TrimTrac ProE with 2.03.00.
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.
Minimum Information Required for Technical Assistance If you or a user reports difficulty with a TrimTrac ProE locator (i.e. no GPS fixes, not communicating, LED not working, etc.), it is helpful to retrieve directly from the unit all current configuration settings and the message log. In some cases, a more detailed debug log file is required to trouble shoot communications related issues. Please provide the requested information and follow the procedures described below: 1. Unit IMEI number 2.
Over-the-Air Retrieval If the TrimTrac ProE or Provisioning Module are not available, but the TrimTrac ProE is otherwise communicating with the server application: 1. Send the appropriate QUERY_CONFIG messages to the TrimTrac ProE to retrieve the GPS, Application, Provisioning, Extended Application and VAMonly parameters. (Reminder: Multiple QUERY_CONFIGs can be included in a single SMS message.) 2.
debug logging mode active for more than one state machine cycle, then the Anytime Polling mode should be set “2=OnDemand”. In so doing, the GSM modem will remained powered up continuously and, as a consequence, the debug logging will remain active. (Note: if Anytime Polling is set “2=OnDemand”, then either change configuration of the device to power off the GSM modem or cycle power to de-active the debug logging mode.) 7.
Firmware Release Notes This manual covers the TrimTrac ProE with 2.03.00.000 firmware. Firmware changes since 1.00.00.000 firmware are summarized in Table 1 through Table 5. CHANGE SUMMARY FROM 1.00.00.0000 TO 1.03.00.000 Schedule Hours Status flag added to Position Reports and Status Messages.
CHANGE SUMMARY FROM 1.03.00.0000 TO 1.05.00.000 Added Stop Report to Motion Report Flag Eliminated redundant Scheduled Report transmissions Improved GSM registration process while roaming on new networks Table 2, Firmware Changes v1.03.00.000 through v1.05.00.000 CHANGE SUMMARY FROM 1.05.00.0000 TO 1.06.00.000 Added concurrent GPRS/SMS operation.
Safety First Simple Guidelines Please follow these guidelines when configuring, using or recycling the TrimTrac ProE. 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 ProE to operate wherever wireless phone use is prohibited or when doing so may cause interference or danger.
Recycling For information on how to recycle this product in the European Union, go to www.trimble.com/environment/summary.html or call +31 497 53 2430 and ask for the "WEEE Associate" or mail a request for recycling instructions to: Trimble Europe BV c/o Menlo Worldwide Logistics Meerheide 45 5521 DZ Eersel, NL. TrimTrac ProE Locator Technical Manual v2.
Detailed Safety Information Exposure to Radio Frequency Signals The TrimTrac ProE 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.
Other Medical Devices If any other personal medical devices are used in the vicinity of a TrimTrac ProE, 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.
For Vehicles Equipped with an Air Bag An air bag inflates with great force. DO NOT place objects, including the TrimTrac ProE, in the area over the air bag or in the air bag deployment area. If in-vehicle wireless equipment is improperly installed and the air bag inflates, serious injury could result.
Overview Introduction This manual covers the TrimTrac ProE 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 ProEduct complies with the essential requirements of the R&TTE Directive 1999/5/EC as stated by the EC Declaration of Conformity (CE0681).
TrimTrac ProE New Features and Capabilities The TrimTrac ProE 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 ProE 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.
Figure 1. TrimTrac ProE Shown with Optional External GPS Antenna and Quick Release Bracket. Figure 2. TrimTrac with Metal Bracket. TrimTrac ProE Locator Technical Manual v2.
Optional Plug-In Modules The following options are available as plug-in modules that replace the standard TrimTrac ProE batteries: Provisioning Module. Allows configuration of the TrimTrac ProE via a USB 2.0 connection to a PC. Figure 3. Provisioning Module inserted into a TrimTrac ProE Vehicle Adapter Module. Allows connection to an external 9-32 VDC power supply and provides three types of open/closed switch and wiring monitoring connections.
Figure 4. Vehicle Adapter Module inserted into a TrimTrac ProE Control Module. Same as a Vehicle Adapter Module plus two 500 mA low-side driver outputs capable of controlling one automotive grade relay each. Figure 5. Control Module. TrimTrac ProE Locator Technical Manual v2.
Enhanced Functional Capabilities Position reporting triggered by motion continues to be an important attribute of the TrimTrac ProE; however, a range of powerful new functional enhancements now augments this basic capability. The TrimTrac ProE is backwards compatible with applications developed for the first generation TrimTrac. On-board Geofencing The TrimTrac ProE can self-monitor up to two geofences.
Report Delay Flag to provide enhanced in-route and start/stop reporting requirements. If no in-route position reports are to be transmitted, the standard Start/Stop Reporting modes available under the Report Delay Flag are used. Both cause the TrimTrac ProE to transmit one report upon first motion and one position report after coming to rest. There are no other regular reports transmitted while the device is in motion even though the device may be logging, but not transmitting, positions in the background.
Application Feature Details The TrimTrac ProE supports a number of important new application features that modify how the TrimTrac ProE 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 ProE state machine as detailed in State Machine Overview section or, preferably, the State Machine Design Details section.
If UDP is selected as the transport protocol, then it is strongly recommended that the GPRS Session Protocol be set “1=TrimTrac Session Protocol”. The TrimTrac Session Protocol is more fully described in the separate document “TrimTrac Session Protocol ICD”. The TrimTrac Session Protocol when used over UDP provides the most important benefits of TCP without the added overhead of TCP.
In all cases, the GPRS APN is provided by the carrier and determines how the mobile device connects to the GPRS network and is authenticated. It is the GPRS functional equivalent to the SMSC for SMS, if you will. The GPRS Destination Address, on the other hand, includes both the IP Address and Port Number of the application server. The IP address can either be a public IP address or, if the ASP has a direct connection to the carrier, then it can be a private IP address.
These GSM Status Codes are more fully explained Table 7, GSM Status Codes Explained, beginning on the following page. TrimTrac ProE Locator Technical Manual v2.
GSM Status Code Description 0=Network Available All the criteria for the configured Communication Mode were satisfied. This is the normal code used when there are no problems in original message transmission. For GPRS, the UDP/TCP connection was established and, if the TrimTrac Session Protocol is enabled, the session sign-on message was sent and acknowledged. 1=Message Logged (i.e. Report Delay Flag set=1) No attempt was made to transmit the message.
recorded in the message log if it’s the last available status when the TRANSMIT Timeout, T3, expires. 8=TCP Connection Failure Communication Mode is set “1=GPRS” or “2=AutoSelect” and the device is registered with a network on which GPRS service is available and a PPP session was successfully opened, but the TCP connection with the server application was not established.
Geofences By establishing and using geofences, geographic areas of authorized and unauthorized use can be defined and enforced. If a geofence violation occurs, the operation of the TrimTrac ProE will be adjusted based upon how it is configured. For instance, should you wish to establish an area where movement of the device is “authorized” and you only wish to receive position reports when the monitored asset leaves this area, then you would use the geofence capability of the TrimTrac ProE.
Geofence Shape and Size Once the centerpoint of the geofence has been determined, you must then define the overall dimensions of the geofence area. In the case of rectangular geofences, you will need to define the due East-West and North-South lengths. Alternately, you would define the diameter of the circular geofence area. Since the geofences used by TrimTrac are orthographic projections, latitude and longitude distortions increase as distance from the center point increases.
Parameter Settings Geofence ID Unique geofence identifier 1 or 2 Geofence Enforcement 0=Disabled; 1=Enforced; 2=LPA Input Enforced; 3=LPA Centered and Enforced. Geofence Schedule 0=24/7; 1=After Scheduled Hours; 2= During Scheduled Hours. (See Scheduled Hours Mode) Geofence Delta X 100s of meters (1 – 10000) Note: EastWest length of rectangular Geofence area or, if circular, the diameter.
7=Tx Start/Stop, Exception & Responses (No IDLE Status) Table 8. Geofence Parameters, Settings, Messages and Commands 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 ProE. 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.
message even though a geofence violation may be in effect. Nonetheless, if a geofence violation is in effect, the Geofence Status will still be set to “1=Violation” even if a RESP_GEOFENCE_CONFIG message is not attached. Each new POSITION_REP sent while a geofence violation is in effect will have the TriggerType set “2=Exception Report Alert”.
Trimble Navigation Ltd TrimTrac 1.5 (tm) Revision: 1.00.00.0000 AT+CTKC=43200,300,240,90,60,168,20,0,0,1,0 AT+CTKF=1,0,300,0,"0.0.0.0:0" AT+CTKK=1,1,1,10,0,"+37.3842980","-122.0070000" AT+CTKK=2,1,1,10,0,"+37.6493278","-121.7861028" AT+CTKX=0,0,0,2,3600,60,0,0,1,1,10,20,10,0 AT+CTKZ=10,0,0,43200,1,5,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,0 AT+CTKO? +CTKO: Device located within Geofence 1 area. Normal position reporting.
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 ProE only computes a new fix each time it enters the FIX State, then the latency in reporting a geofence violation is extended to the time it takes the TrimTrac ProE to cycle through the entire state machine.
When Scheduled Hours Mode is enabled, any unauthorized motion detected after hours (i.e. outside normal working hours as defined by the schedule) will cause the Scheduled Hours Flag to be set “1=After Hours Motion” and any motion-trigged messages will have the TriggerType set “2=Exception Report”. Setting the TriggerType to “2=Exception Report” will cause these messages to be transmitted regardless of how the Report Delay Flag may be set.
Runtime Meters There are two resetable equipment runtime meters available on the TrimTrac ProE. One is based upon motion while the other can be activated via a sensor switch connected to a Vehicle Adapter or Control Module as a LPA input (unless the LPA input is otherwise configured as a standard input or is used for geofences). These meters can be individually activated or reset. The LPA-based runtime meter accumulates hours whenever the switch contacts are closed.
Parameter Settings Runtime Motionbased 0=Disabled; 1=Enabled Runtime Motionbased Countdown, T29 In Hours (0=No Countdown, 1-990) Runtime LPAbased 0=Disabled; 1=Enabled Runtime LPAbased Countdown, T30 In Hours (0=No Countdown, 1-990) Runtime LPAbased Query 0=Report Only (No Reset); 1=Report with Reset Runtime Motionbased Query 0=Report Only (No Reset); 1=Report with Reset Runtime LPAbased Reading Accumulated seconds since last reset, always 10 digits Runtime LPAbased Reset Confirmation 0=Rep
Trimble Navigation Ltd TrimTrac 1.5 (tm) Revision: 1.00.00.
only every other or every X logged message. This saves recurring communication costs but gives a denser historical log of previous positions should the desire to query such logged positions arise. For instance, it may be useful in historical analysis of route adherence on an exception basis. The reporting frequency is determined by the Report Delay Flag. If set to “5”, then the TrimTrac ProE will log five motion triggered messages, either POSITION_REP and/or STATUS_MESSAGE, and then report the next one.
through. The only way to get true confirmation that the server application receive the message is for the server application to positively confirm back to the TrimTrac ProE that the message had indeed arrived safely. When set to “Automatic”, the TrimTrac ProE will continuously re-transmit priority alert messages until acknowledged, or cleared, by the server application.
Automatic Message Log Dump In certain geographic areas, TrimTrac ProE will travel in and out of GSM coverage. The device will continue logging position fixes and status messages even while out of GSM coverage, but obviously it will not be able to send them when they are logged if there is no GSM coverage.
If the application requires more immediate notice that a device has started to move (i.e. a “Start Report”), then the Motion Report Flag should be enabled. In so doing, the device will send an immediate STATUS_MESSAGE to the server application that motion has commenced while the device was in the IDLE State. After this initial STATUS_MESSAGE is sent, then the device will go compute a new position fix and commence further reporting in accordance with its other configuration settings.
and, if enabled, Scheduled Report Mode messages are transmitted regardless of how the Report Delay Flag is set. Additionally, the Report Delay Flag can selectively suppress motion-triggered transmissions by time of day, when used in conjunction with the Scheduled Hours Mode, or based upon the starting and stopping of motion.
The difference between “4=Tx Start/Stop, IDLE Status & Exception Reports” or “7=Tx Start/Stop & Exception Reports (No IDLE Status)” is that with “4=Tx Start/Stop, IDLE Status & Exception Reports” STATUS_MESSAGES triggered by expiration of the IDLE Timeout, T1, are transmitted; with “7=Tx Start/Stop & Exception Reports (No IDLE Status)” no such STATUS_MESSAGES are transmitted.
1. The speed measured while in the FIX State is greater than the Speed Enforcement threshold if 1 Hz GPS is NOT enabled; or 2. If 1 Hz GPS is enabled and measured speed is greater than ten (10%) less than the Speed Enforcement threshold. The Speeding Status flag will be or become set “0=No Violation” whenever: 1. The speed measured while in the FIX State is equal to or less than the Speed Enforcement threshold if 1 Hz GPS is NOT enabled; 2. 1 Hz GPS is enabled and: a.
If the Speeding Report Mode is set “1=Report Initial Violation”, the device will operate as follows: 1. Changing the Speeding Status flag from “0=No Violation” to “1=Violation” will: a. Cause the creation of a REPORT_POS in which the TriggerType will be set “2=Exception Report” if the Speeding Countdown Timer has expired or has not otherwise been enabled: b.
REPORT_POSITION. If the device had been unable to compute a new position fix since the most recently logged REPORT_POSITION, and there has been recent motion, then the new STATUS_MESSAGE will have the Position Age flag set to “1=Aged”. Enabling this Scheduled Report Mode has the added benefit of the server application knowing when the device will be connected to the GSM network.
Table 12. GSM Polling Options If communication with the device is required at all times, whether the device is moving or is at rest, then the Anytime Polling feature can be set “2=OnDemand”. The device will be able to receive and process messages sent from the server application in virtual real-time, regardless of which state the device may be in at the time, except when the device itself is already transmitting a message.
Final consideration on how polling is enabled is that network operators from time to time make changes on their networks that require power cycling of mobile devices. The power reset occurs automatically on the TrimTrac ProE each time the device cycles through the state machine in accordance with its default settings; however, if Anytime Polling is set “2=OnDemand” or if the device is in continuous motion and In-Motion Polling is set “1=Enabled”, the device may never power cycle off.
TRANSMIT Timeout, T3, expires or the message is successfully transmitted, whichever is earlier. In the case of normal position and status messages, the default number of transmit attempts is one, meaning that if the transmission attempt fails prior to expiration of the TRANSMIT Timeout, T3, either due to an error received from the GSM protocol stack or loss of GSM network connection, then the device will terminate the current TRANSMIT state and move on.
Variable State Timeouts for High and Medium Priority Alerts During normal conditions, the TrimTrac ProE operates in accordance with its current parameter configurations; however, when a High or Medium Priority Alert is activated, the frequency at which the TrimTrac ProE cycles through the state machine can be varied. For instance, the TrimTrac ProE may be configured to report once every 15 minutes, which may be adequate under “normal” conditions.
Application Scenarios Introduction The TrimTrac ProE 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 ProE, consider the following: 1. What is the expected frequency and duration of motion? 2.
The TrimTrac ProE is designed to compute new position fixes while the device is in motion. The rate at which the TrimTrac ProE computes new position fixes needs not be the same rate at which it transmits those logged positions to the server application. While the device is in motion, the DELAY Timeout, T4, setting largely determines the frequency at which the TrimTrac ProE will attempt to compute and log a new position fix.
A final consideration on whether or not to enable polling is that network operators make changes on the GSM network from time to time that require mobile devices to be turned off and then powered back up before such changes take effect. If the modem is left on continuously due to polling being enabled, then this power cycling will not happen automatically. Enabling any polling capability will have a significant impact on power consumption.
Query-to-Fix Applications Some applications may not need regular position updates at all and only need regularly scheduled status updates to confirm device health and battery level. In such applications, the device would occasionally be queried for its current position on an “as-need” basis.. Setting Report Delay Flag set to “1=Tx Exception Reports Only”.
When the device is to be queried for its current position, send it a QUERY_POSITION message with Position Query Mode set “P=Compute New Position” Upon receipt of the QUERY_POSITION message, the device will compute a new position fix regardless of how the Position Age flag is set.
Stationary Assets Whereas a personal automobile normally moves on a daily basis, other assets are expected to remain stationary. When a stationary asset does move, it truly 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 the locator 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 Automatic Message Log Dump set “1=Enabled” Continuous computation of GPS positions while in motion. Increases resolution of Geofence enforcement and stopped position reporting Causes the transmission of messages logged while outside GSM coverage upon restoration of GSM Coverage Heavy impact on power consumption and, if used, battery life. Messages may be received out of sequence at the server application.
“1=Duty-Cycled”; Polling Duty-Cycle Frequency, T19, set to 60 Seconds; Polling Duty-Cycle OnTime, T20. actively computing a new position fix or transmitting a message. position fixes are being computed and transmitted. Actual battery life dependent upon, amongst other things, how frequently the GSM network forces the device to re-register on the network.
Vehicle Adapter or Control Module without Alerts 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 PROE TO IMMEDIATELY ACTIVATE A MEDIUM PRIORITY ALERT AND BEGIN TRANSMITTING NOMINALLY EVERY 2-3 MINUTES UNTIL AN ACKNOWLEDGEMENT IS RECEIVED.
Runtime LPA-based Countdown, T30 Runtime Motion-based Scheduled Hours Mode set “1=Enabled” Scheduled Report Mode set to “2=Weekly” Geofence Enforcement GPS Fix Rate set “1=GPS 1Hz” position (no regard to motion). Can be used to monitor specific implements on the equipment, such as PTOs. Provides automatic reports based upon runtime. Good for maintenance, billing or taxation. Good for monitoring when equipment is being transported or used.
Under these sample configuration settings, the device will compute and log positions at a nominal rate of once every 17-18 minutes. These and other messages will be transmitted, if and only if: • The device leaves the inclusive geofence area; • Motion is sensed outside normal working hours; • Motion-based Runtime Meter has accumulated 100 hours since last runtime report; • Speed limit of 50 mph is violated; • Query messages is received; or • It is time to transmit a weekly status report.
Summary End-user and Installation Instructions Battery Powered Units 1. Configure and provision the TrimTrac ProE 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 ProE 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 PROE BASE REQUIRED CONNECTIONS: 1. Connect RED wire to a constant, non-switched 9-32 VDC source of power (+). An 1.0 Amp fuse rated for 1000 Amp interrupt capability is required (Examples include Littelfuse p/n 0257001 and Bussmann p/n BK/ATC-1). 2. Connect the BLACK wire to vehicle ground. 3. Connect YELLOW wires as follows: a.
Figure 9. Control Module with Stand-by Battery Leads Connected OPTIONAL INPUTS AND ALERTS: 1. Refer to the Vehicle Adapter and Control Module wiring diagrams provided in the Technical Manual, in Figure 36 or Figure 37 on pages 213 and 214, respectively. 2. Mount the monitored input switches or devices in the desired locations. It is best to install resistors with the values specified on the wiring diagram at the monitored switch or device (instead of at the TrimTrac ProE).
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. Remove the TrimTrac ProE base cover and any previously installed module to access the SIM cardholder. 3. Insert the activated SIM card from your service provider or wireless carrier into the SIM cardholder and close latch making sure the SIM card is securely seated and locked into place. Figure 10. Properly inserted SIM Card and latched holder. 3.
Figure 11. Align Arrows on base and module. 4. Press down on the module to snap in securely in place on all four corners making sure all corner tabs are all fully engaged. Figure 12. Module with all four corners securedly snapped into place. TrimTrac ProE Locator Technical Manual v2.
5. If a Vehicle Adapter or Control Module is being used, remove rubber channel plug from the TrimTrac ProE base unit. Figure 13. Rubber Channel Plug Removed 6. Route the wires from the Vehicle Adapter or Control Module through the wiring channel in the TrimTrac ProE base. If a Vehicle Adapater Module is being used, press the molded rubber piece into the channel. Figure 14. Vehicle Adapter Module Wires Properly Routed. TrimTrac ProE Locator Technical Manual v2.
Figure 15. Control Module Wires Properly Routed 7. Install TrimTrac ProE base cover and tighten the hold down screw being careful not to pinch any wires if a Vehicle Adapter or Control Module are being used. Figure 16. Cover in place with Wires Properly Routed TrimTrac ProE Locator Technical Manual v2.
8. Place the TrimTrac ProE at a slight incline (TrimTrac logo facing up) with as clear of a view of the sky as possible. Use the optional metal bracket for permanent installations. STANDBY BATTERY RECHARGE: The internal standby battery should be recharged no less frequently than once every three months.
Figure 17. External GPS Antenna RF Connector Plug. Figure 18. External GPS Antenna RF Connector. TrimTrac ProE Locator Technical Manual v2.
Figure 19. External GPS Antenna Connected to TrimTrac ProE TrimTrac ProE Locator Technical Manual v2.
Vehicle Placement Guidelines 1. Placing the TrimTrac ProE, 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 ProE be placed where it is subjected to extreme environmental conditions (temperature, vibration, water). For instance: a. DO NOT leave the TrimTrac ProE on the dashboard exposed to direct sunlight or extreme temperatures (hot or cold). b.
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 ProE and accessories are designed to operate in the conditions outlined in the Specifications on page 182. When used and maintained properly, the TrimTrac ProE provides years of trouble-free service. The TrimTrac ProE has no user-serviceable parts other than its replaceable batteries. Should the TrimTrac ProE fail to operate properly, the user or service technician should troubleshoot the installation before returning any components for repair.
Battery Temperature Ranges The TrimTrac ProE is specified to operate from –10 to +55 degrees C. This does not necessarily mean that the TrimTrac ProE stops working outside this range. In the case of the TrimTrac ProE, for instance, it means that its operation is type approved over this range.
GPS Antennas The TrimTrac ProE has an internal GPS antenna or can be used with an optional external GPS antenna. When an external GPS antenna is first connected, the TrimTrac ProE will not recognize that an external GPS antenna is attached until the next time it enters the FIX State. On the other hand, if the external GPS antenna is disconnected for five or more seconds, then the device will begin using the internal GPS antenna immediately without first having to enter the FIX State.
ability to track GPS satellite signals. Generally, the stronger the other transmitting device, the wider the distance required between antennas. For the TrimTrac ProE, Trimble recommends a minimum clearance of 50cm (approximately 18 in.) from these transmitting devices. Land-based transmitters, including microwave and television transmitters, can also interfere with GPS reception.
way to truly test different placements is to have one device in each location operating simultaneously with all the other units. An example evaluation plan might be to have one device with its external antenna placed on the roof, one unit operating on the internal antenna on the dashboard with a clear view of the sky, one unit in the glove box and one under the front seat. This would require a total of four units, all identically configured.
1. Inspect the spring loaded connectors on the TrimTrac ProE to confirm that none are damaged or misaligned. 2. It may be helpful to clean the contact pads on the Provisioning Module, especially if the Provisioning Module has been in service for an extended period of time. A pencil eraser has proven effective in removing any residue or oxidation that may have built up. 3.
6. Use the AT+CTKO? command with a provisioning module to review logged messages while paying particular attention to the GSM Status field. Working with GPRS If a GPRS session has been established by the mobile device and data is being actively exchanged between the mobile device and server application, then it is known conclusively that: 1. The GSM modem in the device is powered up; 2. GPRS service is available1; and 3. The device is using GPRS to communicate with the server application.
session is in effect. Unlike SMS, GPRS has no SMSC-based store-and-forward capabilities. Therefore, server applications utlitizing GPRS communications may benefit from having a message queing capability such that messages can be generated and readied for delivery whenever the next GPRS session is established by the mobile device.
2. Verify the Server Application software is sending messages to the correct SIM MSISDN and using the correct Unit ID, Security Password and, if required by the SIM card, the SIM PIN, or if using GPRS, that the correct parameters are being used. TrimTrac ProE Not Reporting If it appears that the TrimTrac ProE is not reporting to the server application as expected, diagnose as follows: 1. Configuration.
Generally speaking, increasing the ratio between Static Motion Filter Timeout, T7 and the associated Static Motion Filter Counter, N3, will increase the motion detector sensitivity in the IDLE state; provided, however, that Static Motion Filter Timeout, T7, is not set to “0”. If Static Motion Filter Timeout, T7, is set to “0”, then the Static Motion Filter Counter, N3, setting is ignored and the motion detector is undamped.
filter window (Static Motion Filter Timeout, T7, or Dynamic Motion Filter Timeout, T21, respectively) will decrease the motion sensor sensitivity. Additionally, increasing the Motion Counter Threshold will decrease the relative sensitivity of both motion detection filters. TrimTrac Will Not Stop Reporting Every 2-3 Minutes Chances are a Vehicle Adapter or Control Module was inserted into a TrimTrac ProE base when the MPA Mode was set “0=Automatic” and before the Vehicle Adapter or Control Module was: 1.
have been. Verifying checksums helps avoid wasted time spent evaluating invalid messages. Out of Sequence Messages Regardless of which protocol (SMS, TCP/IP or UDP) is being used, messages received by the server application may be received out of sequence. If Automatic Message Log Dump is enabled, and the device left and re-entered GSM coverage, then the device will transmit messages logged while outside of GSM coverage after GSM has been re-established.
delivery. In some cases, the longer the SMS is held at the SMSC, the lower in the delivery priority the message may become. As a consequence, the SMSC may not send the queued SMS message before the QUERY Timeout, T5, has expired, especially if the TrimTrac ProE has not been registered on the GSM network for a long time. Therefore, if it can be reasonably expected that an application will have extended periods of time between QUERY states, then extending the QUERY Timeout, T5, should be considered.
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 22. Warm Start TTFFs TrimTrac ProE Locator Technical Manual v2.
TrimTrac Basic State Machine Introduction In most applications, motion-based reporting is the fundamental operating premise of the TrimTrac ProE as shown in Figure 23. 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 ProE attempts to be in a sleep mode as much as possible. Sleep modes occur both during the IDLE and DELAY states.
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 eight TriggerTypes: 0=IDLE Timeout 1=Motion Detected 2=Exception Report Alert 3=Query 4=Scheduled Report 5=Runtime Meter Report 6=Start/Stop Report 7=Reserved 8=Attempted LPA-based Geofence Center while no GPS The primary ReportType variable can be either: STATUS_MSG or REPORT_POS.
General Alert Handling Unless the alert mode (as opposed to “alert status”) is configured as “3=Monitoronly”, alerts are processed in descending order of priority. High Priority Alerts, for instance, will always take precedence over Medium and Low Priority Alerts and so on. Other than having their status included in any outgoing data messages, lesser priority alert alarms are ignored until all higher priority alerts have been either cleared to “0=Normal” or set “3=Acknowledged”.
immediately. If in FIX or TRANSMIT, then go to STATUS upon completion of current FIX or TRANSMIT state (Note: This allows the device to complete a “fresh” fix or complete sending any current messages prior to processing the new LPA). Alerts can be changed to: 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.
2. When the unit enters the IDLE State and no motion has been detected, it starts the IDLE Timeout, T1, and waits for a TriggerType event to occur. (LED OFF, unless Anytime Polling mode is set “2=Anytime OnDemand”.) 3.
TriggerType event occurs or the next time the Polling Duty-Cycle Frequency, T19, timer expires. • If the Scheduled Report Mode is set to either “1=Daily” or “2=Weekly” the TriggerType will be set “4=Scheduled Report” upon expiration of Scheduled Report Time, T18, timer regardless of the Report Delay Flag setting.
FIX State The FIX State is the state where the GPS engine is running trying to get a fix. While in this state the GPS hardware is always turned on and the GSM radio hardware may or may not be turned off depending upon the current configuration settings in effect. In TrimTrac ProE, the GPS receiver and GSM Modem can operate simultaneously (unlike earlier generations of the TrimTrac locator). 1.
The TrimTrac ProE dwells in the STATUS state only long enough to update the report structure. This process is virtually instantaneous and all alerts shall have no effect on STATUS state. TRANSMIT State Upon entering the TRANSMIT state from the STATUS state, the TrimTrac ProE will: 1. Power up the GSM hardware (if not already operational); 2. Start the TRANSMIT Timeout, T3 (LED Blink: Short ON, Long OFF); 3.
2. To the FIX state if: a. The TriggerType had become set “1=Motion Detected” during the most recent IDLE state (Note: GPS Status Code will be set “7=No Fix Attempted”); AND b. Motion Report Flag is set “1=Report Motion in IDLE”; AND c. The GSM protocol stack confirms that the attempt to send the queued Motion Report succeeded; the TRANSMIT Timeout, T3, has expired OR if Status Message Transmit Attempts, N2, have been made. 3.
Figure 24. HPA Processing in TRANSMIT TrimTrac ProE Locator Technical Manual v2.
Figure 25. MPA Processing in TRANSMIT TrimTrac ProE Locator Technical Manual v2.
Figure 26. LPA Processing in TRANSMIT TrimTrac ProE Locator Technical Manual v2.
Figure 27. Other Message Processing in TRANSMIT TrimTrac ProE Locator Technical Manual v2.
QUERY State The QUERY State is where the TrimTrac ProE 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 ProE 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.
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 ProE 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 ProE 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 ProE 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 36. Vehicle Adapter Module Alert Wiring Diagram on page 83 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 ProE 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 ProE. Please see Table 25, High Priority Alert Processing on page 106. Also, Figure 24.
Please see Table 27, Low Priority Alert Processing on page 108. Also, Figure 26. LPA Processing in TRANSMIT, on page 96 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=Exception Report 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 ProE Configuration Introduction Configuration is the process of setting the operational and communication parameters of the TrimTrac ProE. 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 ProE 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.
Figure 29. Open SIM Card Holder. Figure 30. Properly Latched SIM Card Holder. TrimTrac ProE Locator Technical Manual v2.
3. Insert Provisioning Module into base TrimTrac ProE making sure that all four corners are securely snapped into place. Figure 31. Properly Inserted Provisioning Module. Figure 32. Provisioning Module Improperly Inserted. Upper Tab not Latched Properly. TrimTrac ProE Locator Technical Manual v2.
4. Connect the USB 2.0 Type-A Male end of the data cable to the Provisioning Module. 5. Connect the other USB 2.0 Type-A Male end of the cable to the PC USB 2.0 port. (Note: if the PC sound is enabled, there may be an audible sound when the cable and Provisioning Module are connected to the PC. This indicates that the USB port on the PC may not have sufficient power.) Figure 33. TrimTrac ProE Connected to PC via Provisioning Module and USB A-to-A Cable.
4. On the next panel and under “Port Settings”, select the following from the pull down menus: 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.
and set the line delay to 500 milliseconds from the HyperTerminal ASCII Setup panel under File, Properties, Settings. To send a text file, select and open the desired text file from Transfer, Send Text File panel. TrimTrac ProE Locator Technical Manual v2.
Provisioning AT Commands AT Command Summary The following AT commands are used to provision and configure the TrimTrac ProE 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 ProE. It can query the current settings or change them to new values. AT+CTKC=,,,,,,,,,, OK In seconds (10 – 999990).
Default: AT+CTKC=43200,300,300,900,60,168,20,0,0,1,0 AT+CTKC? +CTKC: ,,,,,,,,,, OK In seconds (10 – 999990). Default 43200 In seconds (10 – 3600). Default 300
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 ProE 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 (TrimTrac Session Protocol mandatory); 1=TCP. Default: 1 0=None; 1=TrimTrac Session Protocol (See Separate ICD Document, v1.0). Default: 0
AT+CTKJ GPRS Setup Provisioning The AT+CTKJ command configures the GPRS setup provisioning parameters. All fields must be enclosed with quotations . All GPRS setup provisioning parameters are provided by the GPRS service provider. AT+CTKJ=,, OK Access Point Name (APN) Web address up to 40 case sensitive alphanumeric characters as assigned by GPRS network operator. Example: “apn.trimble.com”. 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. Unless you are very familiar with the types of parameters listed below and how changes will effect overall GPS performance in any given application environment, it is recommended that you leave these parameters at their factory default settings.
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; 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; 2=LPA Input Enforced; 3=LPA Centered and Enforced.. Default: 0 0=24/7; 1=After Scheduled Hours; 2= During Scheduled Hours. (See Scheduled Hours Mode).
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 40, 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 ProE.
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 ProE. It can query the current settings or change them to new values.
QUERY state prior to the expiration of QUERY Timeout, T5. Default 0 0=Formerly “Extended Motion Detection” in TrimTrac 1.0 Not used in TrimTrac ProE. Default 0 0=Until T3 Expires; 1-255=Number of Tx Attempts. Default 1 0=Until T3 Expires; 1-255=Number of Tx Attempts. Set to 1 if Communication Mode set “1=GPRS-only”. Default 1 In Seconds (1-90).
AT+CTKX? +CTKX: ,,,,,,,,,,,,, OK
0=Until T3 Expires; 1-255=Number of Tx Attempts. Default 1 0=Until T3 Expires; 1-255=Number of Tx Attempts. Set to 1 if Communication Mode set “1=GPRS-only”. 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.
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).
Default: AT+CTKY=10,10,10,10,0,300,60,0,0,0,0,1,0 TrimTrac ProE Locator Technical Manual v2.
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 Mode, Runtime Meter and other operation parameters as defined below.
AT+CTKZ? +CTKZ: ,,,,,,,,,,,,,,,,,,
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 49, ATI Query TrimTrac ProE Locator Technical Manual v2.
TrimTrac ProE Defaults Introduction Factory default settings of the TrimTrac ProE are listed in Table 90 through Table 94, beginning on page 188. 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 ProE 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 (Green except as noted) 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 ProEs that have already been provisioned and deployed to the field. The TrimTrac ProE 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 51, 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 ProE is connected to a Provisioning Module. The TrimTrac ProE 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 ProE does not match the Security Password configured in the TrimTrac ProE, then the message is ignored. Unit ID The Unit ID must be used in all communications with the TrimTrac ProE.
/******************************************************************************* * 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 161 QUERY_LOG >QTKR 164 164 QUERY_METERS QUERY_POSITION >QTKM >QTKD 161 161 161 162 161 161 161 161 161 161 147 148 149 152 154 155 156 156 157 158 149 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 ProE 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 ProE to acknowledge or clear alert states; provided, however, that the TrimTrac ProE is connected to a Vehicle Adapter or Control Module. When received the TrimTrac ProE will send a RESP_ALERT_STATE (page 169) 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 ProE. When received the TrimTrac ProE will send a RESP_APP_CONFIG (page 170) 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).
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 (page 181) 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’.
SET_EXT_APP_CONFIG This message is used to set the Extended Application parameters in the TrimTrac ProE. When received the TrimTrac ProE will send a RESP_EXT_APP_CONFIG (page 171) message in response. >STKABCCCCCCDEFFFFFFGGGGGGHIJJJKKKLLMMNNO;PW=PPPPPPPP; ID=YYYYYYYY;*ZZ< A B CCCCCC D E TrimTrac Configuration Set: ‘X’ = Extended Application Parameters Scheduled Report Mode. 0=None; 1=Daily; 2=Weekly. Default 0 Scheduled Report Time, T18. In Seconds (0-604799).
JJJ KKK LL Position Report Transmit Attempts, N1. 0=Until T3 Expires; 1255=Number of Tx Attempts. Default 1. Status Message Transmit Attempts, N2. 0=Until T3 Expires; 1255=Number of Tx Attempts. Set to 1 if Communication Mode set “1=GPRS-only”. 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.
SET_EXT2_APP_CONFIG This message is used to set the Extended 2 Application parameters in the TrimTrac ProE. When received the TrimTrac ProE will send a RESP_EXT2_APP_CONFIG (page 173) message in response. >STKABBBBCDDDDDEEEEEFGHIJJJKKKLMNNNOQQQUVVVVVVXXXXXXXX XXXXXXXXXXXXXXX;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A TrimTrac ProE Configuration Set: ‘Z’ = Extended 2 Application Parameters BBBB Motion Counter Threshold: Counter (1-2000). Default 10 C Scheduled Hours Mode: 0=Disabled; 1=Enabled.
YYYYYYYY ZZ ONLY. . Default 00000000 Unit ID. Always 8 alphanumeric characters, UPPER CASE ONLY Checksum. Table 61, SET_EXT2_APP_CONFIG Message TrimTrac ProE Locator Technical Manual v2.
SET_GEOFENCE_CONFIG This message is used to set up a Geofence in the TrimTrac ProE device. When received the TrimTrac ProE device will send a RESP_GEOFENCE_CONFIG (page 175) 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 (page 152) or AT+CTKZ (page 134).
SET_GPRS_CONNECT_CONFIG This message is used to set the GPRS Connection Configuration Values in the TrimTrac ProE device. When received the TrimTrac ProE device will send a RESP_GPRS_CONNECT_CONFIG (page 177) message in response. >STKABCDDDDDEEEEEFFFFFFFFFFFFFFFFFFFFF”;PW=PPPPPPPP;ID =YYYYYYYY;*ZZ< A TrimTrac ProE Configuration Set: ‘F’ = GPRS Communication Configuration Parameters. B GPRS Transport Protocol: 0=UDP (TrimTrac Session Protocol mandatory); 1=TCP.
SET_GPRS_SETUP_CONFIG This message is used to set the GPRS Setup Configuration Values in the TrimTrac ProE device. All GPRS setup provisioning parameters are provided by the GPRS service provider. When received the TrimTrac ProE device will send a RESP_GPRS_SETUP_CONFIG (page 177)message in response.
SET_GPS_CONFIG The SET_GPS_CONFIG message is used by the server application to set the TrimTrac GPS parameter values in the TrimTrac ProE. When received the TrimTrac ProE will send a RESP_GPS_CONFIG (page 157) 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.
JJJ KKK L M N PPPPPPPP YYYYYYYY ZZ MPA Transmit Attempts, N6. 0=Until T16 Expires; 1255=Number of Tx Attempts before T16 expires. Default 0 LPA Transmit Attempts, N7. 0=Until T3 Expires; 1255=Number of Tx Attempts before T3 expires. Default 0 HPA Mode. 0=Automatic; 1=Disabled; 2=Network Acknowledgement; 3= Monitor-only. Default 0 0=Automatic; 1=Disabled; 2=Network Acknowledgement; 3= Monitor-only.
TrimTrac ProE Locator Technical Manual v2.
TrimTrac ProE Locator Technical Manual v2.
Query Messages QUERY_CONFIG This QUERY_CONFIG message is used by the server application to request the TrimTrac ProE send its TrimTrac Application, GPS or Communication parameters in the appropriate response message as indicated below.
QUERY_GEOFENCE_CONFIG This QUERY_GEOFENCE_CONFIG message is used by the server application to request the TrimTrac ProE send its geofence parameters in the appropriate RESP_GEOFENCE_CONFIG (page 175) message. >QTKABB;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A TrimTrac Configuration Set: ‘K’ = Geofence Parameters BB Geofence ID: Unique geofence identifier 1 or 2. Use lead 0. PPPPPPPP Security Password. Always 8 alphanumeric characters, UPPER CASE ONLY. Default 00000000 YYYYYYYY ZZ Unit ID.
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 ProE 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 ProE 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. TrimTrac ProE responds by sending a RESP_METERS (page 178) message. >QTKABC;PW=PPPPPPPP;ID=YYYYYYYY;*ZZ< A Always ‘M’: Indicates a query runtime meters message.
Response to QUERY_POSITION QTKD Rec’d L=Last Logged Position Query Mode Set to P=New Fix S=New Fix if Motion Since last Fix No Motion Since Last FIX State Yes No Successful GPS Fix Yes Respond with: New RTKS and Last Logged RTKP Respond with: New RTKS Respond with: New RTKP Figure 34. QUERY_POSITION Response Flowchart TrimTrac ProE Locator Technical Manual v2.
new STATUS_MSG and the most recently logged REPORT_POS (in a single SMS message if Communication Mode is set “0=SMS”) if: 1. QUERY_POSITION has the Position Query Mode set “L=Status Report with Last Logged Position”; OR 2. QUERY_POSITION has the Position Query Mode set “S= Compute if Position Aged”, but there has been no motion since the last logged position (i.e. Position Aged is set “0=Current”); OR 3.
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. >RTKABBBBCDDDEFFFFGGGGGGSTVOPQRWXabU[HHHIIIIIIIJJJJKKK KKKKLLLLLLMMMNNN];ID=YYYYYYYY;*ZZ< A BBBB C DDD E FFFF GGGGGG S T TrimTrac Report Type: ‘P’ = Position Report ‘S’ = Status Report Protocol Sequence Number.
V O P Q R W X a b U YYYYYYYY ZZ HHH.IIIIII I JJJJ.
deleted. The Message Log can be queried with the QUERY_LOG message from the server application. RESP_ALERT_STATE The TrimTrac ProE sends this message after a SET_ALERT_STATE (page 147) request is received and processed; provided, however, that the TrimTrac ProE 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.
RESP_APP_CONFIG This is the response message to the SET_APP_CONFIG (page 148) and QUERY_CONFIG (page 161) 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) Less than 300 not recommended EEEEEE DELAY Timeout, T4.
RESP_EXT_APP_CONFIG This is the response message to the SET_EXT_APP_CONFIG (page 150) and QUERY_CONFIG (page 161) message containing the Extended Application Parameter values. >RTKABCCCCCCDEFFFFFFGGGGGGHIJJJKKKLLMMNNO;ID=YYYYYYYY; *ZZ< A B CCCCCC D TrimTrac Configuration Set: ‘X’ = Extended Application Parameters Scheduled Report 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. Set to 1 if Communication Mode set “1=GPRS-only”. 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.
RESP_EXT2_APP_CONFIG This is the response message to the SET_EXT2_APP_CONFIG (page 152) and QUERY_CONFIG (page 161)message containing the Extended 2 Application Parameter values. >RTKABBBBCDDDDDEEEEEFGHIJJJKKKLMNNNOQQQUVVVVVVXXXXXXXX XXXXXXXXXXXXXXX;ID=YYYYYYYY;*ZZ< A TrimTrac ProE Configuration Set: ‘Z’ = Extended 2 Application Parameters BBBB Motion Counter Threshold: Counter (1-2000). Default 10 C Scheduled Hours Mode: 0=Disabled; 1=Enabled.
ZZ Checksum. Table 78, RESP_EXT2_APP_CONFIG Message TrimTrac ProE Locator Technical Manual v2.
RESP_GEOFENCE_CONFIG This is the response message to the SET_GEOFENCE _CONFIG (page 154)and QUERY_GEOFENCE_CONFIG (page 162) message containing the Geofence Parameter values. It is also sent with any REPORT_POS and STATUS_MSG having TriggerType set “2=Exception Report Alert” and Geofence Status set “1=Violation” or “5=New LPA-based Geofence”, except when some other new event, such as a Speed Violation, has triggered the REPORT_POS OR STATUS_MSG.
RESP_GPRS_CONNECT_CONFIG This is the response message to the SET_GPRS_CONNECT _CONFIG (page 155) and QUERY_CONFIG (page 176) message containing the GPRS Connection Parameter values. >RTKABCDDDDDEEEEEFFFFFFFFFFFFFFFFFFFFF”;ID=YYYYYYYY;*Z Z< A TrimTrac ProE Configuration Set: ‘F’ = GPRS Communication Configuration Parameters. B GPRS Transport Protocol: 0=UDP (TrimTrac Session Protocol mandatory); 1=TCP. Default 1 C GPRS Session Protocol: 0=None; 1=TrimTrac Session Protocol (See Separate ICD Document, v1.0).
RESP_GPRS_SETUP_CONFIG This is the response message to the SET_GPRS_SETUP _CONFIG (page 156) and QUERY_CONFIG (page 177) message containing the GPRS Setup Parameter values.
RESP_METERS This is the response message to the QUERY_METERS (page 164) message. This message is also sent whenever either Runtime meter reaches it automatic report threshold, if so enabled. (See SET_EXT2_APP_CONFIG page 152 for runtime meter setup instructions). >RTKABCDDDDDDDDDDEEEEEEEEEE;ID=YYYYYYYY;*ZZ< A Always ‘M’: Indicates a query runtime meters message.
RESP_QUERY_AGGR The TrimTrac ProE sends this message after a QUERY_LOG (page 163) 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 ProE in response to the SET_MODULE_APP_CONFIG (page 157) and QUERY_CONFIG (page 161) 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.
RESP_CONTROL_OUTPUT This is the by the TrimTrac ProE in response to the SET_CONTROL_OUTPUT (page 149)or QUERY_CONTROL_OUTPUT (page 161) messages. >RTKABCDDDDDDDDDDDDDDDD;ID=YYYYYYYY;*ZZ< A Always ‘U’: Indicates a set Control Module output message. B Output 1 Status: 0=Output Low; 1=Output High; 2=No Change (STKU-only); 3=No Module Attached C Output 2 Status: 0=Output Low; 1=Output High; 2=No Change (STKU-only); 3=No Module Attached DDDDDDDDD Reserved for future use. Must be sent as ‘0000000000000000’.
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 ProE and accessories: Part Number Description TrimTrac ProE with Cover and Battery Module TrimTrac ProE with Cover and Vehicle Adapter Module TrimTrac ProE with Cover and Vehicle Adapter and Battery Modules TrimTrac ProE with Cover and Control Module TrimTrac ProE with Cover and Control and Battery Modules TrimTrac ProEvisioning Module Kit TrimTrac ProE Starter Kit Accessories and Parts TrimTrac ProE Base TrimTrac ProE Cover Tr
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 TrimTrac ProE Locator Technical Manual v2.
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) Less than 300 not recommended Default 43200 300 300 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 Report Mode Scheduled Report Time, T18 In-Motion Polling Anytime Polling Polling Duty-Cycle Frequency, T19 Polling Duty-Cycle OnTime, T20 Unit/Notes Default 0=None; 1=Daily; 2=Weekly 0 In Seconds (0-604799). Note: This is either the seconds into 0 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 Dynamic Motion Filter Timeout, T21 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 ProE. 0=Until T3 Expires; 1-255=Number of Tx Attempts.
Parameter Dynamic Motion Filter Counter, N4 Motion Sensor Override Unit/Notes In Seconds (1-90). Note: This parameter is enabled only when Dynamic Motion Filter Timeout, T21, is active. WARNING: Dynamic Motion Filter Counter, N4, must always be set equal to or less than the setting for Dynamic Motion 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 TrimTrac Session Keepalive 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 as assigned by GPRS network operator. Example: “apn.trimble.com”.
Extended TrimTrac ProE 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 Mode 0=Disabled; 1=Enabled Scheduled Hours Daily In Seconds (0 – 86399) after 12:00AM UTC. Start Time, T27 Scheduled Hours Work In Seconds (0 – 86400) Note: Number of seconds worked Day Length, T28 each workday.
Geofence Settings: Parameter Geofence ID Geofence Enforcement Geofence Schedule 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; 2=LPA Input Enforced; 3=LPA Centered and Enforced. 0=24/7; 1=After Scheduled Hours; 2= During Scheduled Hours. (See Scheduled Hours Mode) 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 Output 2 0=Output Low; 1=Output High; 2=No Change Runtime Motion-based Query Runtime LPA-based Query Position Query Mode 0=Report Only (No Reset); 1=Report with Reset Message or Command >STKU Position Query Fix Timeout Erase/Restore Mode >QTKM 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. In Seconds (10-3600).
Read-Only Parameters, Formats and Ranges Parameter Protocol Sequence Number TriggerType Battery Level Battery Changed Flag GPS Time Week GPS Time Seconds 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=Exception Report Alert 3=Query 4=Scheduled Report 5=Runtime Meter Report 6=Start/Stop Report 7=Reserved 8=Attempted LPA-based Geofence Center while no GPS 0-100%, 999%=Low Voltage Cut-out T=True; F=False Alway
Parameter GSM Status Code Position Age HPA Status MPA Status LPA Status Geofence Status External Power Scheduled Hours Flag Speeding Status Latitude Longitude Altitude Speed Heading Value 0=Network Available 1=Message Logged (i.e.
Parameter Runtime Motion-based Reading Runtime LPA-based Reading Runtime Motion-based Reset Confirmation Runtime LPA-based Reset Confirmation Battery Change Week Battery Change Time Firmware Version Output 1 Status Output 2 Status Value Accumulated seconds since last reset, always 10 digits Accumulated seconds since last reset, always 10 digits 0=Report without Reset; 1=Report with Reset; 2=Disabled Messages >RTKM 0=Report without Reset; 1=Report with Reset; 2=Disabled GPS Week Number, always 4 digits S
Parameter List (All) Parameter Almanac Timeout, T6 Altitude Anytime Polling Automatic Message Log Dump Battery Change Time Battery Change Week Battery Changed Flag Battery Level Communication Mode DELAY Timeout, T4 Diagnostics Mode Dynamic Motion Filter Timeout, T21 Dynamic Motion Filter Counter, N4 Erase/Restore Mode Unit/Notes In hours (10 – 990) Feet (-9999 to 99999) 0=Disabled; 1=Duty-Cycled; 2=OnDemand 0=Disabled 1=Enabled GPS Time Seconds GPS Time Week T=True; F=False 0-100%, 999%=Low Voltage Cut-out
Parameter Geofence Delta Y Geofence Enforcement Geofence ID Geofence Schedule Geofence Status Geofence Type GPRS APN GPRS Destination Address GPRS Password TrimTrac Session Keepalive Timeout, T25 GPRS Session Protocol GPRS Session Timeout, T26 GPRS Transport Protocol GPRS Username GPS Dynamics Mode GPS Elevation Mask GPS Fix Rate GPS PDOP Mask GPS PDOP Switch GPS Signal Mask GPS Status Code Unit/Notes 100s of meters 0=Disabled; 1=Enforced; 2=LPA Input Enforced; 3=LPA Centered and Enforced.
Parameter GPS Time Seconds GPS Time Week GSM Status Code Heading HPA Delay Timeout, T13 HPA Idle Timeout, T11 HPA Mode HPA Query Timeout, T17 HPA Status HPA Transmit Attempts, N5 HPA Transmit Timeout, T15 IDLE Timeout, T1 Unit/Notes 1=2D GPS Fix 2=Fix Timeout, 0 SVs 3=Fix Timeout, 1 SV 4=Fix Timeout, 2 SVs 5=Fix Timeout, 3 SVs 6=GPS Error 7=No Fix attempted Always 6 Digits Always 4 Digits 0=Network Available 1=Message Logged (i.e.
Parameter In-Motion Polling Latitude Longitude LPA Input Arming Delay, T31 LPA Mode Unit/Notes 0=Disabled; 1=OnDemand -90.0000000 to +90.0000000 Degrees -180.0000000 to +180.
Parameter Output 2 Output 2 Status Polling Duty-Cycle Frequency, T19 Polling Duty-Cycle OnTime, T20 Position Age Position Query Fix Timeout Position Query Mode Position Report Transmit Attempts, N1 Protocol Sequence Number Query Hold Flag QUERY Timeout, T5 Report Delay Flag Reserved Runtime LPA-based Unit/Notes 0=Output Low; 1=Output High; 2=No Change 0=Output Low; 1=Output High; 2=No Change (STKUonly); 3=No Module Attached In Seconds (10-999990) In Seconds (0, 10-3600) Default Messages >STKU >RTKU Com
Parameter Runtime LPA-based Countdown, T30 Runtime LPA-based Query Runtime LPA-based Reading Runtime LPA-based Reset Confirmation Runtime Motion-based Runtime Motion-based Countdown, T29 Runtime Motion-based Query Runtime Motion-based Reading Runtime Motion-based Reset Confirmation Scheduled Hours Daily Start Time, T27 Scheduled Hours First Weekly Work Day Scheduled Hours Flag Scheduled Hours Mode Scheduled Hours Work Day Length, T28 Scheduled Hours Work Days per Week Scheduled Report Mode Scheduled Report
Parameter SMS Destination Address Speed Speeding Countdown Timer Speed Enforcement Speeding Report Mode Speeding Status Static Motion Filter Counter, N3 Static Motion Filter Timeout, T7 Status Message Transmit Attempts, N2 TRANSMIT Timeout, T3 TriggerType Unit ID Unit/Notes 24 characters including optional international dialing “+” sign and country code for SMS messages. Miles Per Hour.
AT Command and Default Summary Command Description AT+CTKC AT+CTKC? AT+CTKF AT+CTKF? AT+CTKJ AT+CTKJ? AT+CTKG AT+CTKG? AT+CTKK AT+CTKK? AT+CTKP AT+CTKP? AT+CTKX AT+CTKX? AT+CTKY Assigns Application parameters Queries Application parameters Assigns GPRS Connection parameters Queries GPRS Connection parameters Assigns GPRS Setup parameters Queries GPRS Setup parameters Assigns GPS parameters Queries GPS parameters Assigns Geofence parameters Queries Geofence parameters Assigns SMS Communication parameters
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 161 QUERY_LOG >QTKR 164 164 QUERY_METERS QUERY_POSITION >QTKM >QTKD 161 161 161 162 161 161 161 161 161 161 147 148 149 152 154 155 156 156 157 158 149 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 ProE Versus Earlier TrimTrac Versions TrimTrac ProE In-Motion Polling SMS Destination Address Reserved Polling Duty-Cycle On-Time, T20 Polling Duty-Cycle Frequency, T19 Anytime Polling 300 Seconds Previous TrimTrac Versions DELAY State Polling Mode Destination Address Dynamic Motion Filter IDLE State Cycled Polling Duration, T20 IDLE State Cycled Polling Interval, T19 IDLE State Polling Mode 60 Seconds Reason/Comment Concurrent GPS & GSM enabled Avoid confusion with GPRS
Figure 36. Vehicle Adapter Module Alert Wiring Diagram TrimTrac ProE Locator Technical Manual v2.
Figure 37. Control Module Wiring Diagram TrimTrac ProE Locator Technical Manual v2.
CONTROL MODULE INSTALLATION NOTES (See Control Module Wiring Diagram On Previous Page) Table 105. Control Module Installation Notes TrimTrac ProE Locator Technical Manual v2.
