Revision Sheet 2.0 [Xact Application User Manual] This document illustrates how to configure the Trax device and what parameters can be changed to support the user application. Each configuration parameter is defined in this documentation and examples given in clear context. The level of this document is technical and our goal is to communicate how to easily change the operational behavior of the TRAX device.
Revision Sheet Revision History Version Date Revision Description 1.0 06/15/2011 First Version 1.9 10/11/2011 Intro, Accelerometer Examples Added 2.0 10/25/2011 Corrected Configuration Value to Match V3.
Revision Sheet Proprietary Notices Words and logos marked with ® or ™ are registered trademarks or trademarks owned by Xact Technology, LLC. Other brands and names mentioned herein may be the trademarks of their respective owners. Copyright © 2011 by Xact Technology, LLC. All rights reserved.
Table of Contents REVISION HISTORY II TABLE OF CONTENTS 0 1. INTRODUCTION 3 PURPOSE 3 RELATED DOCUMENTS 3 CONVENTIONS 3 FEEDBACK & PROBLEM-REPORTING INSTRUCTIONS 4 2. OVERVIEW 5 INSTALLATION 5 RUNNING THE APPLICATION 5 3.
Xact Application User Manual BAND 9 APN SETTINGS 9 4.
Xact Application User Manual INVISIBLE OPERATION 19 MAGNETIC SENSOR 19 CRITICAL CONFIRMATION 19 PHONE NUMBER 19 SERVER IP ADDRESS 19 SERVER PORT 20 FENCE DIRECTION 20 DAYS ACTIVE 20 FENCE ACTIVE START/STOP TIME 21 FENCE 21 OPEN/SAVE CONFIGURATION 21 LOAD FROM/SEND TO DEVICE 22 5.
Xact Application User Manual 1. Introduction This chapter introduces this document, lists useful related documents, describes the typographic conventions being used in this document, and provides contact information for providing feedback on or reporting problems with this document. Purpose This document has been written for software and hardware developers, engineers, scientists, and others with a technical background who are developing Telemetry, Telematics, M2M, or wireless applications.
Xact Application User Manual directly to a device; for example, select parity from None, Odd, Even, Mark, or Space. Hexadecimal numbers are shown with a leading ―0x‖; for example, 0x0404. Feedback & Problem-Reporting Instructions If you encounter any problems (errors, omissions, etc.) with this manual, please contact Xact Technology at the company‘s technical support email address: support@xacttechnology.com.
Xact Application User Manual 2. Overview The application is simple, consisting of only two windows: the main application window and the Configuration Editor. The application is a standard Windows executable, has no external dependencies (e.g., .Net, etc.), and should run on most configurations of Windows computers. Installation To install the application: 1. make sure the USB Windows Drivers are downloaded and installed (Sierra/Wavecom modem for the WMP100 Wireless Microprocessor); 2.
Xact Application User Manual 3.
Xact Application User Manual This chapter describes the data fields and controls in the main application window. USB Serial Port Before communicating with the Xact Development Board or other Xact device, you need to set up the USB Serial Port; this panel lets you do just that. The window is opened with most of the contents disabled; once the port is selected and enabled, the window‘s remaining controls and fields are enabled.
Xact Application User Manual Firmware Here you can upload updated firmware to the device. Select the firmware binary (with a ―dwl‖ extension) by pressing the … button to show the file-open dialog. Select the file and press Open. Once the file path is shown in the ―Upload from:‖ field, press Upload to transfer the file to the device.
Xact Application User Manual AGPS ―AGPS‖ refers to Assisted GPS, which is a system that can improve the time-tofirst-fix (TTFF) for GPS. Whereas standalone GPS radio relies on signals from satellites, AGPS additionally uses network resources to locate and utilize the satellites faster — as well as better in poor signal conditions. To use this feature, you need to supply the latitude and longitude of the device.
Xact Application User Manual 4.
Xact Application User Manual This chapter describes all the data fields and controls in the Configuration Editor — the window revealed when the Open Editor button is pressed in the main application window. For each setting, values are given both for choices within the Configuration Editor and for sending data directly to the device. Send Acknowledgement to Server Checking this checkbox forces the configuration to be recorded.
Xact Application User Manual Configuration Editor Direct to Device SMS mode roaming allowed 0 GPRS UDP mode roaming allowed 1 GPRS TCP mode roaming allowed 2 GPRS UDP mode roaming allowed, SMS fallback if no GPRS available 3 GPRS TCP mode roaming allowed, SMS fallback if no GPRS available 4 SMS mode no roaming allowed 5 GPRS UDP mode no roaming allowed 6 GPRS TCP mode no roaming allowed 7 GPRS UDP mode no roaming allowed, SMS fallback if no GPRS available 8 GPRS TCP mode no roaming allow
Xact Application User Manual Tracking Interval Indicates an index corresponding to a time interval at which to transmit waypoint/tracking information, selected by the spinner.
Xact Application User Manual alert operates independently; if the MSB is 1, the motion alert operates with geofences. Accelerometer The following three fields govern the GPS module — specifically when it turns on or off under the presence of acceleration. These settings are available to optimize device power consumption, because GPS is the most power-hungry module on the device.
Xact Application User Manual Bread Crumb Mode Configuration Editor Direct to Device 0 1 2 bread crumb mode not active, no special case bread crumb mode active, no special case bread crumb mode not active, fence active start time = 0x5F 3 4 bread crumb mode not active, fence active stop time = 0x5F bread crumb mode not active, fence active start, stop time = 0x5F 5 6 7 bread crumb mode active, fence active start time = 0x5F bread crumb mode active, fence active stop time = 0x5F bread crumb mode activ
Xact Application User Manual GSM Alert Threshold This sets the number of times that wireless coverage must be lost before an alert is raised. Values range from 1 to 5, and Off. If sent directly to the device, the value is a decimal ASCII number (1 through 5, or „N‟ for Off): Battery Alert This sets a combination of battery low-voltage and device shutdown alerts. Note that battery voltage, not charge, is the defining parameter. Level 1 corresponds to 3.7V, and Level 2 corresponds to 3.8V.
Xact Application User Manual Hardware Revision Indicates the major and minor hardware revision numbers. Values range from 00 to FF hexadecimal (0-255 decimal). This is a read-only setting, and is shown in the device management portal. Vibration Motor Pattern Sets the vibration pattern (rate at which vibration pulses are generated) for the internal vibration motor. Values range from 1 to 9, each corresponding to a particular pattern.
Xact Application User Manual Configuration Editor Direct to Device Do not download 0 1 Hour 1 8 Hours 8 24 Hours (1 Day) 2 72 Hours (3 Days) 7 1 Week W All Data A LED Exercise Turn LEDs on and off according to a pattern. Values range from 1 to 9, each corresponding to a particular pattern. Select the pattern from the dropdown list. There are nine possible patterns because there are three LEDs, each of which can display three states: off, red, or green.
Xact Application User Manual If sent directly to the device, the value is a hexadecimal ASCII number ranging from 0000 to 210C. Active Fences This scrolling list indicates the geo-fences that are active. An active fence has its corresponding checkbox checked. If sent directly to the device, the value is a hexadecimal ASCII number ranging from 0x00000000000000 to 0xFFFFFFFFFFFFFF, where a bit position corresponds to a fence number.
Xact Application User Manual If sent directly to the device, the value is a hexadecimal ASCII number from 0x00000000 to 0xFFFFFFFF. For example, the IP address expressed as a dotted quad, 98.216.231.125, would be represented as 0x62D8E77D. Server Port The server port number. If sent directly to the device, the value is a ASCII hexadecimal number ranging from 0x0000 to 0xFFFF. For example, port 525 would be represented 0x020D.
Xact Application User Manual When sent directly to the device, the value is a hexadecimal number ranging from 0x20 to 0x6B.
Xact Application User Manual You‘ll see the usual file-open dialog; select a file (only files with a ―cfg‖ extension are initially shown) or enter a file name and press Open. The file‘s contents will be loaded and the Editor‘s fields set accordingly. Load From/Send To Device Having set or changed the configuration, you can install it on the device by pressing the Send To Device button. And if you wish to retrieve the device‘s current configuration for editing, press the Load From Device button.
Xact Application User Manual 5.
Xact Application User Manual Appendix A - Configuration File Format The device configuration file as created by the application is simply a text file with a continuous stream of ASCII characters. The format of the file is shown below.
Xact Application User Manual Field Critical Confirmation Server Phone Number Server IP Address Server Port Number Fence Direction and Day(s) of Week Latitude Longitude Latitude Longitude Latitude Longitude Latitude Longitude Fence Active Start Time Fence Active Stop Time Xact Application User Manual Bytes Characters Offset Count 1 1 14 8 4 1 8 8 8 8 8 8 8 8 1 1 66 67 81 89 93 94 102 110 118 126 134 142 150 158 159 67 81 89 93 94 102 110 118 126 134 142 150 158 159 160 1 4 4 4 4 4 4 4 4 1 1 Page 2