XT2500 Product Manual XT2500 Product Manual Firmware Version: 1183DA2.
XT2500 Product Manual TABLE OF CONTENTS 1. Functional Description 4 1.1. Overview 4 1.2. Mechanical 4 2. Device Setup 5 2.1. Configure Device Via PC (RS232 to USB) 5 3. Interfaces 6 3.1. UART 6 4. Device Configuration 7 4.1. APNs (apn) 8 4.2. OBD Accel and Decel (oad) 9 4.3. OBD RPM and Speed Events (ors) 10 4.4. OTA Prevent (ota) 11 4.5. Bluetooth Enabled (blt) 12 4.6. Buzzer Songs (bzr) 13 4.7. Destination (dst) 13 4.8. Generic Config Value (gcv) 14 4.9.
XT2500 Product Manual 5.2. Interpreter Scripting Trigger Block Examples 36 5.3. Packet Recipe 37 6. Command Language 76 6.1. Overview 76 6.2. Commands via UDP 76 6.3. Verb and Module 76 6.4. Object 76 6.5. Arguments 77 6.6. Device Command Modules 79 6.7.
XT2500 Product Manual 1. FUNCTIONAL DESCRIPTION 1.1. OVERVIEW The XT2500 series is a plug-n-play universal vehicle tracking unit (VTU) for use in light duty/passenger vehicles. The XT2500 also suits clientele with large fleets of heavy duty trucks with 9-pin/6-pin Deutsch connectors (RP1226 for newer trucks) via a cable harness/adapter.
XT2500 Product Manual 2. DEVICE SETUP 2.1. CONFIGURE DEVICE VIA PC (RS232 TO USB) 1. Connect the device to a variable power supply. 2. Set the power supply to output average 12 volts and verify the device is drawing current after it has powered up (the device will automatically switch on when it receives power). 3. Open "Device Manager" on windows and click the drop-down next to "Ports (COM & LPT)". 4. Attach a USB to RS232 coverter (Ex. USB-RS232-0.
XT2500 Product Manual 3. INTERFACES 3.1. UART XT2500 devices include a 2-wire asynchronous serial interface (UART) operated through RS232 for communication with a host device. RS232 interface is TIA/EIA-232-F compliant and will accept 0-5V signaling. The UART interface is a 3.0V TTL interface conforming to the ITU-T V.24 recommendation, with CMOS compatible signal levels (0V for low data bit or ON state and 3.0V for high data bit or OFF state).
XT2500 Product Manual 4. DEVICE CONFIGURATION System parameters are designed to be non-volatile and have the ability to be updated through a serial connection, USB, SMS, UDP and are used for many modules within the device. All system parameters (aka configs, params) have a default value that can always be restored in case the device ends up in an unknown state.
XT2500 Product Manual 4.1. APNS (APN) The APN parameter contains settings for APN gateway, username, and password. Configuration instances: 4 Command Type SET READ Parameter apn_name Syntax Command :wycfg apn[x] "" "" "" Response :OK Command :rycfg apn[x] Response | apn[x]: name:"", user:"", passwd:"" :OK Range 64 Char Description The name of the APN gateway used for GSM, GPRS, 3G and 4G cellular networks.
XT2500 Product Manual 4.2. OBD ACCEL AND DECEL (OAD) Configuration instances: 2 Command Type SET Syntax Command :wycfg oad[x] Response :OK Command :rycfg oad[x] Response | oad[x]: accdec: (hex_val) :OK READ Parameter rate Descriptions rate is measured in .1 mph Instance oad[0] oad[1] Range 10 to 200 Description OBD acceleration threshold. 10 to 200 Speed rate of change to exceed on acceleration to declare Hard Acceleration Event OBD deceleration threshold.
XT2500 Product Manual 4.3.
XT2500 Product Manual 4.4.
XT2500 Product Manual 4.5. BLUETOOTH ENABLED (BLT) The Bluetooth Enabled configuration sets the Bluetooth communication state.
XT2500 Product Manual 4.6. BUZZER SONGS (BZR) The Buzzer Songs configuration sets the frequency and duration of up to 8 notes on the device buzzer. Configuration instances: 10 Command Type SET READ Param frequencyX durationX Syntax Command :wycfg bzr[x] ... Response :OK Command :rycfg bzr[x] Response | bzr[x]: freq1: (hex_val), dur1: (hex_val), ...
XT2500 Product Manual Parameter || port_number Range 64 Characters 1 to 65533 Description This id is the location specified by the dst. It can take the form of an IP address (192.0.0.0), a hostname limited to 64 characters, or a local serial port. The valid local serial ports are as follows: l "SERIAL_AUX0" l "SERIAL_AUX1" l "USB" If using an IP address or a hostname, can be used to specify the port on which to connect. 4.8.
XT2500 Product Manual 4.9.
XT2500 Product Manual 4.10. MOTION SENSITIVITY (MST) Configuration instances: 1 Command Type SET Syntax Command :wycfg mst Response :OK Command :rycfg mst Response | mst: motion: (hex_val) :OK READ Parameter motion_ sensitivity_ value Range 1 to 2000 Description Configure accelerometer motion sensitivity in thousandths of a unit of gravity. 4.11.
XT2500 Product Manual Parameter baudrate Range N/A Description Acceptable baudrates: l 115200 bit/sec l 57600 bit/sec l 38400 bit/sec l 19200 bit/sec l 9600 bit/sec l 4800 bit/sec l 2400 bit/sec 1200 bit/sec Acceptable dps values: 8N1 Acceptable mode values: l dps_value Mode_value 3 Char N/A Value 0 3 6 Console_print N/A Description Console Garmin Aux Passthru -- Only one serial port can be an Aux Passthru at any given time.
XT2500 Product Manual 4.12. TIMER DURATION (TMR) Configuration instances: 32 Command Type SET READ Parameter Duration auto_start Syntax Command :wycfg tmr[x] Response :OK Command :rycfg tmr[x] Response | tmr[x]: sec: (hex_val), flags: (hex_val) :OK Range 0 to 4294967295 N/A Description The time that is set as the duration of the timer (s) Determines if the timer is set to start automatically or needs to be manually started.
XT2500 Product Manual 4.13. PACKET CREATION RECIPE (PCR) Configuration instances: 128 Command Type SET Syntax Command :wycfg pcr[x] "" Response :OK Command :rycfg pcr[x] Response | pcr[x]: resipe_hex_string:"" :OK READ NOTE: This parameter does not have a factory default setting. Parameter recipe_hex_string Description Refer to Packet Creation Recipe for configuration details 4.14.
XT2500 Product Manual Parameter checkin_freq Pid_list_1 Pid_list_2 Flag Range 0 to 255 0x0 to 0xFFFFFFFF Description Time in hours for periodic check to gateway server Bit list for supported pids 1 to 32 0x0 to 0xFFFFFFFF 0 to 255 Bit list for supported PIDs (32 to 32) Hex 0x8000000 0x4000000 0x2000000 0x1000000 0x0800000 0x0400000 0x0200000 0x0100000 0x0080000 0x0040000 0x0020000 0x0010000 0x0008000 0x0004000 0x0002000 0x0001000 0x0000800 Description Odometer (miles) (ppid 1 0x74) Oil Li
XT2500 Product Manual 4.15.
XT2500 Product Manual 4.16. VEHICLE BUS CONFIGURATION (VBS) Configuration instances: 1 Command Type SET Syntax Command :wycfg vbs Response :OK Command :rycfg vbs Response | gsf: detect: (hex_val), start: (hex_val), mode: (hex_val) :OK READ Parameter detect_mask start_mask mode Range 0x0 to 0xFF 0x0 to 0xFFFF 0 to 255 Description 8 bits, hex mask.
XT2500 Product Manual VBUS Mode Value 0 Description Use Case OBD-II Use this mode when you are sure you will be connected to a passenger vehicle. Supported transports per commlink: 1 PPID Mode Commlink0: J1850, Kline, HS Can Use this mode when you are sure you will be connected to a passenger vehicle, and want to enable proprietary PID collection.
XT2500 Product Manual 5. INTERPRETER 5.1. LANGUAGE 5.1.1. Interpreter Language Basics Overview Certain Xirgo products contain functionality to run user-created scripts. This allows functionality to be tuned and changed without needing Firmware updates. The device runs an interpreter which ‘interprets’ byte code that has been compiled from a human readable script. This document describes the language/syntax used for this script.
XT2500 Product Manual NOTE: if the speed oscillates between 80.0 and 80.1 kmh it is possible to cause the actions to be executed as frequently as the speed oscillates. In order to avoid this, make use of the debounce specifiers. How Conditional Action Block Tests Work Unlike Trigger Block Tests, Conditional Action Block Tests allow the action to be performed WHILE the test is true.
XT2500 Product Manual TOK_NUMBER: “2” 0x42 SMALL_CONST_VALUE (value: 2) 0xe0 INTERP_END binary script size: 134 file size: 142 file name: network_testing_script.bin Interpreter script format OK ilc v2.16 NOTE: Using Windows to drag the .txt file onto the ilc.exe as a means of execution will always result in a .bin file being generated, even if the compiler failed. It is recommended instead to always run ilc.exe from a command line interface. 5.1.3. Upload and Run Scripts 1.
XT2500 Product Manual :OK :grscr x 0 :OK Erasing FLASH memory Waiting for Xmodem Start (Ctrl-D twice to cancel) Starting xmodem transfer. Press Ctrl+C to cancel. Transferring V_Script_Nov_102015_JB.bin... 100% 572 bytes 572 bytes/sec 00:00:01 0 Errors Interpreter Script Download Successful Interpreter Script Stored in ChipFlash 5.1.4. Interpreter Commands All language elements presented in this section are case sensitive.
XT2500 Product Manual Keyword actions run Description Denotes the start of an Action Block Denotes the start of a single Action Transforms Script Language BitNot() BitAnd(, ) BitOr(, ) BitXor(, ) BitShift(, ) Add(, ) Subtract(, ) Multiply(, ) Description Bitwise NOT (one's compliment) of argument a Bitwise AND of arguments a and b Bitwise OR of arguments a and b Bitwise XOR of arguments a and b Shift the contents of argument a by the value of argument b; i.e.
XT2500 Product Manual System Values Script Language UnixTime GPSLat GPSLon GPSAlt GPSHeading GPSSpeed Inputs Outputs GSPTripOdom1 Description Maps directly to UnixTime packet field (ID: 0x06) Maps directly to Latitude packet field (ID: 0x07) Maps directly to Longitude packet field (ID: 0x08) Maps directly to Altitude packet field (ID: 0x09) Maps directly to Heading packet field (ID: 0x0a) Maps directly to GpsSpeed packet field (ID: 0x0b) Maps directly to InputStates packet field (ID: 0x0c) Maps directly t
XT2500 Product Manual Script Language ObdDtcEventIsActive(0) AccelCrashEventIsActive(0) Description Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 Description Reset Wakeup BootloaderUpgrade FWUpgrade ScriptUpgrade ParamSetUpgrade OverlayUpgrade (not implemented) ManualConfigChange CellRegistrationChange IPChange SMSReceived SMSSendOK SMSSendFailure UDPReceived UDPSendOK UDPSendFailure PacketStorageEmpty PacketStorageFull PdpConnectionReset (not implemented) Device Powerup OTA Reject (not imp
XT2500 Product Manual Script Language GeofenceState() SystemState() Description Index -1 0 1 Description is not configured Outside fence Inside fence Index range: 0 to 49 Evaluates to 1 when true, otherwise 0 Index range: 0 to 16 Index 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Description Valid Registration Valid IP Valid GPS Valid Script DM Session Active Accel Oriented Bluetooth Discoverable Bluetooth Paired (Not implemented) Bluetooth Connected Bluetooth Powered Cellular Powere
XT2500 Product Manual Actions Script Language ResetDevice() ResetModem() ResetGPS() AdjustUserVar (, , ) Description N/A N/A N/A Type range: 0 to 2 Type 0 1 2 Description 8bit variable 16bit variable 32bit variable Index range: Index 0 to 31 0 to 15 0 to 15 Description 8bit variables 16bit variables 32bit variables Adjust_amount range: Adjust Amount -128 to 127 -32768 to 32767 -2147483648 to 2147483647 SetFlag() ClearFlag() StartTimer(
XT2500 Product Manual Script Language Description Parameter Ack range Range 0 to 2 Description See Ack table below Ack table: Range 0 1 2 EnterSleep(, SendGarminMsg (, ) Description No acknowledgement needed Resend until acknowledged Priority packet: no storage, no acknowledgement See footnotes 1-3 below table.
XT2500 Product Manual Script Language index>) ClearOutput () PulseOutput (, ) Description FlashOutput (, ) Index range: 0 to 2 ClearDriverIds() CheckInNow() BuzzerPlay( ) N/A N/A Song_index range: 0 to 9 Index range: 0 to 2 Index range: 0 to 2 seconds_on range: 1 to 65535 Blink_rate range: 1 to 100 Hz Volume range: 0 to 100 Loops clamped to range: 0 to 255; 0 is continuous play BuzzerStop() ResetObdHarsh
XT2500 Product Manual every ten seconds for CATm devices). The throughput of the cellular design is the bottleneck. Messages will always be stored to flash and sent out eventually, unless the duration at such a rate causes the message storage space to be filled completely. If a customer is looking for continuous real time data, these are the limitations they should be made aware of. 4. SaveDataToFlash() Note: Persist data saves normally happen automatically every 60 seconds.
XT2500 Product Manual 5.2. INTERPRETER SCRIPTING TRIGGER BLOCK EXAMPLES 5.2.1. Packet Send Example This example shows an alternate message being sent every two minutes. If flag[0] is set, then send packet 1, otherwise, send packet 0. Always reset the timer and toggle the flag.
XT2500 Product Manual condact always actions run BuildAndSendMsg(4, 32, 1, 0) 5.2.3. Set User Flag 3 if OBD Reports PTO On PTO status resides in the bit 1 position of Fld_ObdRunStatus (0x2c). The example below uses the BitAnd() operator with a hex mask isolating the desired bit, comparing it to 0 for rising edge trigger. This operation works from the inside out, parenthetically. SystemVal (0x2c) grabs the value stored in Fld_ ObdRunStatus.
XT2500 Product Manual ID Name Description 0x03 DeviceId Unsigned integer representing numeric ESN Bytes 4 0x04 ReasonCode Units N/A PacketSerialNum Units N/A UnixTime Latitude Longitude Altitude Resolution 1 Range 0 to 65535 Units N/A Resolution 1 Range 0x0 to 0xffffffff Units Degrees Resolution 1.00E-06 Range -2147.483648 to 2147.483647 Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -90.0 to 90.
XT2500 Product Manual ID 0x0a Name Heading Description Bytes Units GpsSpeed InputStates OutputStates DriverIdCode1 DriverIdCode2 GSPTripOdom1 Flags Range 0 to 255 Units N/A Resolution 1 Range 0x0 to 0xff Units N/A Resolution 1 Range 0x00 to 0x1f Units N/A Resolution 1 Range 0 to 4294967295 Units N/A Resolution 1 Range 0 to 4294967295 See Odometer Details Table below Bytes 4 0x11 Resolution 1 Unsigned integer representing unique iButton ID Bytes 4 0x10 Units kmh Unsigned integ
XT2500 Product Manual ID 0x12 Name Hdop Description Bytes Units 4 N/A Resolution 1 Range 0 to 4294967295 Unsigned integer Bytes 1 Units DOP Resolution 0.1 Range 0.0 to 25.5 Units N/A Resolution 1 Range 0 to 255 0x13 NumSats Bytes 1 0x14 ReceiverSigStr See Signal Quality Measure Table below Bytes 2 Units dBm Resolution 1.
XT2500 Product Manual ID Name Description 0x1a AccelStartLat Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -180.0 to 180.0) Bytes 4 0x1b AccelStartLong Units Degrees Resolution 1.00E-06 Range -2147.483648 to 2147.483647 Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -90.0 to 90.0) Bytes 4 Units Degrees Resolution 1.00E-06 Range -2147.483648 to 2147.
XT2500 Product Manual ID 0x22 Name AccelEndLong Description Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -90.0 to 90.0) Bytes 4 Units Degrees Resolution 1.00E-06 Range -2147.483648 to 2147.
XT2500 Product Manual ID 0x2b Name CommandPayload * Description Bytes Variable 0x2c OBDRunStates Bitfield; see OBD Run States Bits Table below Bytes 1 0x2d OBDCommsState ObdDerivedTripOdom ObdLifetimeOdom Resolution N/A Range N/A Range 0 to 7 Units N/A Resolution N/A Range 0 to 3 Unsigned integer; see Odometer Details Table below Bytes 4 0x2f Units N/A Resolution N/A See OBD Comms State Table below Bytes 1 0x2e Units N/A Units m Resolution 1 Range 0 to 4294967295 Unsigned integer;
XT2500 Product Manual ID 0x34 Name UserVar8[2] Description 8-bit signed integer Bytes 1 0x35 UserVar8[3] UserVar8[4] UserVar8[5] UserVar8[6] UserVar8[7] UserVar8[8] UserVar8[9] Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Resolution 1 Range -128 to 127 Resolution 1 Range -128 to 127 8-bit signed integer Bytes 1 0x3b Range -128 to 127 8-bit signed integer Bytes
XT2500 Product Manual ID 0x3c Name UserVar8[10] Description 8-bit signed integer Bytes 1 0x3d UserVar8[11] UserVar8[12] UserVar8[13] UserVar8[14] UserVar8[15] UserVar16[0] UserVar16[1] Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 16-bit signed integer Bytes 2 0x43 Range -128 to 127 8-bit signed integer Bytes 1 0x42 Resolution 1 8-bit signed integer Bytes 1 0x4
XT2500 Product Manual ID 0x44 Name UserVar16[2] Description 16-bit signed integer Bytes 2 0x45 UserVar16[3] UserVar16[4] UserVar16[5] UserVar16[6] UserVar16[7] UserVar32[0] UserVar32[1] Units N/A Resolution 1 Range -32768 to 32767 Units N/A Resolution 1 Range -32768 to 32767 Units N/A Resolution 1 Range -32768 to 32767 Units N/A Resolution 1 Range -32768 to 32767 Resolution 1 Range -2147483648 to 2147483647 Resolution 1 Range -2147483648 to 2147483647 32-bit signed integer Bytes
XT2500 Product Manual ID Name Description 0x4c UserVar32[2] 32-bit signed integer Bytes 4 0x4d UserVar32[3] UserVar32[4] UserVar32[5] UserVar32[6] UserVar32[7] SystemStates Range -2147483648 to 2147483647 Units N/A Resolution 1 Range -2147483648 to 2147483647 Units N/A Resolution 1 Range -2147483648 to 2147483647 Units N/A Resolution 1 Range -2147483648 to 2147483647 Resolution 1 Range -2147483648 to 2147483647 32-bit signed integer Bytes 4 0x52 Resolution 1 32-bit signed intege
XT2500 Product Manual ID Name Description 0x53 WakeReason Hex byte value; see Wake Reason Values Table Bytes 1 0x54 ObdTrueOdometer ObdTotFuelUsed ObdTotEngHours ObdVehicleSpeed ObdEngRpm ObdEngCoolantTemp ObdFuelLevelPct Units liters Resolution 1 Range 0 to 4294967295 Units hours Resolution 1 Range 0 to 4294967295 Units kmh Resolution 0.
XT2500 Product Manual ID Name Description 0x5b ObdTotDrivingSec 32-bit unsigned integer Bytes 4 0x5c ObdTotCruiseSec ObdTotIdleSec ObdTotIdleFuel ObdHarshBreakTotCnt ObdSpeedExceedTotCnt ObdRPMExceedTotCnt ObdHarchAccelTotCnt Units s Resolution 1 Range 0 to 4294967295 Units liters Resolution 1 Range 0 to 4294967295 Units Resolution 1 Range 0 to 4294967295 Units Resolution 1 Range 0 to 4294967295 Resolution 1 Range 0 to 4294967295 Resolution 1 Range 0 to 4294967295 32-bit unsig
XT2500 Product Manual ID Name Description 0x63 Not implemented Available for future use 0x64 Bytes 1 Units N/A Resolution N/A Range N/A Bytes 1 Units N/A Resolution N/A Range N/A Units ascii Resolution N/A Range N/A BluetoothName * 0x65 ObdVIN Bytes 17 0x66 ExternADC0_1byte Value caps at 25.5v Bytes 1 Units v Resolution 0.1 Range 0.0 to 25.
XT2500 Product Manual ID 0x6c Name ObdDtcPacket Description Bytes 2 Units N/A Resolution N/A Range N/A ...... ...
XT2500 Product Manual ID 0x72 Name ObdTotPTOFuel Description Bytes Units FwRev OBDPidReserved1 OBDPidReserved2 OBDPidReserved3 OBDPidReserved4 OBDPidReserved5 Resolution N/A Range N/A Units N/A Resolution 0.1 Range -2147483648 to 2147483647 Units N/A Resolution 0.1 Range -2147483648 to 2147483647 Units N/A Resolution 0.
XT2500 Product Manual ID 0x79 Name ObdTransGear Description Bytes Units 4 N/A ObdFuelTemp ObdOilTemp ObdThottlePos ObdMPG ObdAccelPos ObdEngLoad Resolution 1 Range -40 to 215 Units Celsius Resolution 1 Range -40 to 215 Units % Resolution 1 Range 0 to 100 Units mpg Resolution 0.1 Range 0.0 to 256.
XT2500 Product Manual ID 0x80 Name ObdEngTorque Description Bytes 2 ObdOilLevel ObdOilPressure ObdCoolantPressure ObdIntakeAirTemp ObdManifoldTemp ObdCoolantLevel LinkageVer Resolution 1 Range 0 to 100 Units kPa Resolution 1 Range 0 to 100 Units kPa Resolution 1 Range 0 to 100 Units Celsius Resolution 1 Range -40 to 215 Units Celsius Resolution 1 Range -40 to 215 16-bit unsigned integer Bytes 2 0x87 Units % 16-bit signed integer Bytes 2 0x86 Range -125 to 125 16-bit signed i
XT2500 Product Manual ID 0x88 Name GSPTripOdom2 Description Bytes Units 4 N/A GenCfgVal0 GenCfgVal1 GenCfgVal2 GenCfgVal3 GenCfgVal4 OBDPidReserved6 OBDPidReserved7 Range 0 to 4294967295 Units N/A Resolution 1 Range 0 to 4294967295 Units N/A Resolution 1 Range 0 to 4294967295 Units N/A Resolution 1 Range 0 to 4294967295 Units N/A Resolution 1 Range 0 to 4294967295 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 0x8f Resolution 1 Generic Configuration Valu
XT2500 Product Manual ID 0x90 Name OBDPidReserved8 Description Bytes Units 4 N/A OBDPidReserved9 OBDPidReserved10 OBDHarshAccelValue OBDHarshBrakeValue CellSerialId PktChkSum Resolution 0.1 Range -2147483648 to 2147483647 Units N/A Resolution 0.
XT2500 Product Manual ID 0x97 Name TPSFields0 Description Bytes 1 TPSFields1 TPSFields2 TPSFields3 TPSFields4 OBDPidReserved11 OBDPidReserved12 Units N/A Resolution N/A Range N/A Units N/A Resolution N/A Range N/A Units N/A Resolution N/A Range N/A Units N/A Resolution N/A Range N/A 4-byte ascii normalization of the vehicle response Bytes 4 0x9d Range N/A Inclusion of a configured length variable content section defined by the corresponding pct config entry Bytes variable 0x9c R
XT2500 Product Manual ID 0x9e Name OBDPidReserved13 Description Bytes 4 OBDPidReserved14 OBDPidReserved15 Debug-PacketSize DebugPacket UserVar8[16] UserVar8[17] UserVar8[18] Resolution N/A Range N/A Units ascii Resolution N/A Range N/A Units N/A Resolution N/A Range N/A Units N/A Resolution N/A Range N/A Units N/A Resolution 1 Range -128 to 127 Resolution 1 Range -128 to 127 8-bit signed integer Bytes 1 0xa5 Units ascii 8-bit signed integer Bytes 1 0xa4 Range N/A Payload B
XT2500 Product Manual ID 0xa6 Name UserVar8[19] Description Bytes 1 UserVar8[20] UserVar8[21] UserVar8[22] UserVar8[23] UserVar8[24] UserVar8[25] UserVar8[26] Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Resolution 1 Range -128 to 127 8-bit signed integer Bytes 1 0xad Units N/A 8-bit signed integer Bytes 1 0xac Range -128 to 1
XT2500 Product Manual ID 0xae Name UserVar8[27] Description Bytes 1 UserVar8[28] UserVar8[29] UserVar8[30] UserVar8[31] UserVar16[8] UserVar16[9] UserVar16[10] Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -128 to 127 Units N/A Resolution 1 Range -32768 to 32767 Resolution 1 Range -32768 to 32767 16-bit signed integer Bytes 2 0xb5 Units N/A 16-bit signed integer Bytes 2 0xb4 Rang
XT2500 Product Manual ID 0xb6 Name UserVar16[11] Description Bytes Units 2 N/A UserVar16[12] UserVar16[13] UserVar16[14] UserVar16[15] UserVar32[8] UserVar32[9] Resolution 1 Range -32768 to 32767 Units N/A Resolution 1 Range -32768 to 32767 Units N/A Resolution 1 Range -32768 to 32767 Units N/A Resolution 1 Range -32768 to 32767 Resolution 1 Range -2147483648 to 2147483647 Resolution 1 Range -2147483648 to 2147483647 32-bit signed integer Bytes 4 0xbc Units N/A 16-bit signed in
XT2500 Product Manual ID 0xbd Name UserVar32[10] Description 32-bit signed integer Bytes 4 0xbe UserVar32[11] UserVar32[12] UserVar32[13] UserVar32[14] UserVar32[15] OBD Start Reason Range -2147483648 to 2147483647 Units N/A Resolution 1 Range -2147483648 to 2147483647 Units N/A Resolution 1 Range -2147483648 to 2147483647 Units N/A Resolution 1 Range -2147483648 to 2147483647 Resolution 1 Range -2147483648 to 2147483647 32-bit signed integer Bytes 4 0xc3 Resolution 1 32-bit signed
XT2500 Product Manual ID 0xc4 Name OBD End Reason Description Bytes Units TpsTagPayloadSize TpsTagPayload Units N/A Resolution 1 Range -2147483648 to 2147483647 Unsigned integer Bytes 2 0xc6 Range 2147483647 32-bit signed integer; see OBD Trip End Reason (bit mask) table below Bytes 4 0xc5 Resolution Units N/A Resolution 1 Range N/A Payload Bytes variable Units N/A Resolution N/A Range N/A 0xc7 OBD Seat Belt Status Bytes 1 0xc8 VehicleBattery_2byte 2-byte representation of vehic
XT2500 Product Manual ID 0xcb Name AuxPassthruPacket Description Bytes variable 0xcc Geofence States Bitfield 1 Bitfield representing current state of active geofences 0 to 31, where 1 is inside, and 0 is outside or inactive.
XT2500 Product Manual ID 0xd3 Name OBD debug packet Description Bytes variable 0xd4 Cell Access Technology Cell Access Technology values Bytes 1 0xd5 Derived Engine Seconds ECU Engine Seconds InputActiveStates CellularEnvironment Resolution N/A Range 0 to 7,255 Units seconds Resolution 1 Range 0 to 4294967295 Units seconds Resolution 1 Range 0 to 4294967295 Same as the Input States bitfield, only the reported states are determined by the IDP config settings (see Input State Bits table be
XT2500 Product Manual ID 0xde Name OBD MPG 5 second average Description Bytes Units 2 kph Resolution 0.01 Range 0.00 to 655.35 Averaging synchronized with OBD derived lifetime odometer timing. Bytes 2 Units mpg Resolution 0.1 Range 0.0 to 256.0 0xdf GPS Harsh Accel Violations Cnt Bytes 4 Units 0xe0 GPS Harsh Accel Value Bytes 2 Units kph/s 0xe1 GPS Harsh Decel Violations Cnt Bytes 4 Units 0xe2 GPS Harsh Decel Value Range 0.00 to 655.
XT2500 Product Manual 5.3.2.
XT2500 Product Manual 5.3.3.
XT2500 Product Manual 5.3.5. Signal Quality Measure (SQM) Table SQM Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 99 dBm -113.0 -111.8 -110.5 -109.3 -108.1 -106.8 -105.6 -104.4 -103.1 -101.9 -100.7 -99.4 -98.2 -97.0 -95.7 -94.5 -93.3 -92.0 -90.8 -89.6 -88.3 -87.1 -85.9 -84.6 -83.4 -82.2 -80.9 -79.7 -78.5 -77.2 -76.
XT2500 Product Manual 5.3.6.
XT2500 Product Manual 5.3.7. OBD Run States Bits Bit 0 1 2 3 State Engine Running PTO On Moving Ignition On 5.3.8. OBD Comms State Value 0 1 2 3 Description OBD comms off OBD comms pending (ECU detected, initiating connection) OBD comms connected (waiting for RPM change or vehicle motion) OBD comms active 5.3.9.
XT2500 Product Manual 5.3.11. OBD Trip Start Reason (Bit Mask) Value (Hex) 0x0001 0x0002 0x0004 0x0008 0x0010 Description Detected Alternator On or Switched Ignition Input Detected GPS Movement Detected Vehicle Bus Traffic Detected Changing Vehicle Speed Detected Changing RPM 5.3.12.
XT2500 Product Manual 5.3.13.
XT2500 Product Manual 5.3.15. BuildAndSend Message ACK Byte(s) 0-1 2-3 Value 0x8888 PacketSerialNum Type N/A 16-bit unsigned int, Description The first 2 bytes of the ACK must be set to 0x8888. This value is the unique packet serial/sequence number (Packet recipe ID: 0x05). big-endian byte order 5.3.16. Packet Creation Characteristics l A message is created from a single packet recipe and may be appended with fields from a separate append recipe.
XT2500 Product Manual is in range of 0 to 15 is a quoted string of hex bytes (represented by two ASCII characters) String Structure: ... to is the reason code range NOTE: A single reason code assignment is possible when = is in range of 0 to 1.
XT2500 Product Manual 6. COMMAND LANGUAGE 6.1. OVERVIEW The XT6300 device utilizes commands that can be sent over various methods such as USB, RS232, and SMS. This command language can be utilized to configure nearly all the device's parameters and morph its functionality to fit the requirements of a client. The implemented command language has been designed to be easy to learn/remember, human readable, and flexible.
XT2500 Product Manual 6.5.
XT2500 Product Manual Module Bluetooth TPS Device Geofence Flash GPS Watchdog GPIO Third Party Backend CMDLang Motion Garmin OBD Processor Flash Interpreter Buzzer Telematics/Cell USB Aux Passthru One-Wire-Bus Accelerometer System Zigbee Main Processor 2nd Processor available Code b c d e f g h i j k l m n o p r s t u v w x y z 1 2 q3-0 6.5.3.
XT2500 Product Manual Object Firmware Heap Info Monitor Memory Mode Message Option OTA Override Properties RAM Console Record Script Simulation Stack State Table Task Test Truststore Value Code fw hp (OR) heap i (OR) info m mem md (OR) mode msg opt ota ovrd p (OR) prop rc rec scr (OR) script sim stk (OR) stack st (OR) state tab tsk (OR) task t (OR) test trst val 6.6. DEVICE COMMAND MODULES 6.6.1. ADC Command :raval Function Read ADC values 6.6.2.
XT2500 Product Manual Command :qxi :exm :dxm :ext :dxt :uxcmd findz :uxcmd findxa :uxcmd findxd :uxcmd voidrot Function Query accelerometer info Enable accelerometer debug channel monitoring Disable accelerometer debug channel monitoring Enable accelerometer motion test Disable accelerometer motion test Force reorientation to z-axis Force reorientation to x-axis using acceleration Force reorientation to x-axis using deceleration Force void of current reorientation 6.6.3.
XT2500 Product Manual 6.6.6.
XT2500 Product Manual Command :rdval serial :rdval uptime :rdval wake :wdval serial "" :qdi :qdi cell :qdi gps :udcmd checkin :udcmd factory :udcmd factory keys :udcmd dslp Function Read device serial number Read device uptime (seconds since reset) Read device wake reason (only accurate if device has slept) Write the device serial number Query device info ("vtu query") Query cellular device info ("vtu query modem") Query GPS device info ("vtu query gps") Send a Device Manager C
XT2500 Product Manual Command :edm :ddm Function Enable device debug channel monitoring Disable device debug channel monitoring 6.6.8.
XT2500 Product Manual 6.6.10. Geofence Command :eem :dem :redm :wedm Function Enable Geofence debug channel monitoring Disable Geofence debug channel monitoring Read GPS debug mask Write the GPS debug mask 6.6.11. GPIO Command :qii :rival :wival <0|1|x> Function Query GPIO info (GPIO pin IDs and default states) Read state of GPIO pin Control the state of GPIO pin (x = give control back to micro) 6.6.12.
XT2500 Product Manual Command Function :sgsim coord :sgsim speed GPS simulator force coordinates GPS simulator force speed :sgsim head Values are in tenths (e.g. 300 = 30 mph) GPS simulator force heading :sgsim lock :sgsim hdop :sgsim clear Values are in tenths (e.g. 900 = 90 degrees) GPS simulator force lock state: Value Description 0 None 1 Unlocked 2 Locked 3 Sleep 4 LockedGood GPS simulator force hdop Disable GPS simulator 6.6.14.
XT2500 Product Manual Command :dtm :ett :ett direct :dtt :qti :qti ip :utcmd factory :utcmd reset :utcmd sleep :utcmd wake :utota ftp "" Function Disable transport debug channel monitoring Enable transport test mode (‘ct’ mode) Connect serial console directly to cellular port Disable transport test mode (‘ct’) Query transport info Query cellular mobile IP Set cellular module to factory default state Queue a reset for the cellular module Stop cellular module St
XT2500 Product Manual Command :utota s3 "" [[[ ] ""] ] Function Request HTTPS file transfer (only on AAb6 currently).
XT2500 Product Manual Command Function :rrval flags :rrval uservar :rrval timer :rrval gfnstat :wrval odom Read user script flags Read a uservar Read remaining time Read geofence active & inside status bitfields must be larger than current value: Index Description 0 GPS Trip 1 1 GPS Trip 2 2 OBD Trip 3 GPS Life 4 OBD Life :crval tripodom Clear a trip odometer: Index Description 0 GPS Trip 1 1 GPS Trip 2 2 OBD Trip :wrval flags :wrval user
XT2500 Product Manual 6.6.17. One-Wire Bus Command :wwdm :wwdm ts :wwdm drv :ewm :dwm :rwi :rwval Function Sets one-wire bus debug mask Sets one-wire bus temp sensor debug mask Sets one-wire bus driver id debug mask Enable one-wire bus debug channel monitoring Disable one-wire bus debug channel monitoring Read one-wire bus info Read one-wire bus temp sensor value 6.6.18.
XT2500 Product Manual Command :rycfg ... :wycfg ... :qycfg ...
XT2500 Product Manual 6.6.20.
XT2500 Product Manual 6.7. CALIFORNIA PROPOSITION 65 WARNING WARNING: This product can expose you to chemicals including Nickel (Metallic), which is known to the State of California to cause cancer and Bisphenol A (BPA), which is known to the State of California to cause birth defects or other reproductive harm. For more information go to www.P65Warnings.ca.
