all | frequencies |
|
|
|
|
exhibits | applications |
---|---|---|---|---|---|---|---|
manual | photos | label |
app s | submitted / available | |||||||
---|---|---|---|---|---|---|---|---|
1 |
|
Manual | Users Manual | 1.31 MiB | March 28 2023 / September 24 2023 | delayed release | ||
1 |
|
Internal Photos | Internal Photos | 4.91 MiB | March 28 2023 / September 24 2023 | delayed release | ||
1 |
|
External Photos | External Photos | 672.11 KiB | March 28 2023 / September 24 2023 | delayed release | ||
1 |
|
Label | ID Label/Location Info | 218.33 KiB | March 28 2023 | |||
1 |
|
Attestation letter | Attestation Statements | 186.05 KiB | March 28 2023 | |||
1 |
|
Attestation letter 2.911(D)(5) | Attestation Statements | 230.62 KiB | March 28 2023 | |||
1 |
|
Attestation letter 2.911(D)(7) | Attestation Statements | 192.89 KiB | March 28 2023 | |||
1 | Block Diagram | Block Diagram | March 28 2023 | confidential | ||||
1 |
|
Confidentiality | Cover Letter(s) | 202.04 KiB | March 28 2023 | |||
1 |
|
Confidentiality short term | Cover Letter(s) | 200.28 KiB | March 28 2023 | |||
1 | Operational Description | Operational Description | March 28 2023 | confidential | ||||
1 |
|
RF Exposure report | RF Exposure Info | 327.77 KiB | March 28 2023 | |||
1 | Schematics | Schematics | March 28 2023 | confidential | ||||
1 |
|
Test Report | Test Report | 2.27 MiB | March 28 2023 | |||
1 |
|
Test setup photos | Test Setup Photos | 668.38 KiB | March 28 2023 / September 24 2023 | delayed release | ||
1 | Test Report | March 28 2023 | ||||||
1 | parts list | Parts List/Tune Up Info | March 28 2023 | confidential |
1 | Manual | Users Manual | 1.31 MiB | March 28 2023 / September 24 2023 | delayed release |
XT6384-1 Product Manual Firmware Version: 1133MA3 Revised October 24, 2022 XT6384-1 Product Manual TABLE OF CONTENTS 1. Release Notes 1.1. Firmware 1.2. Manual 2. Functional Description 2.1. Overview 2.2. Mechanical 3. Device Setup 3.1. Configure Device Via PC (RS232 to USB) 4. Interfaces 4.1. UART 4.2. LED Behavior 5. Bluetooth/BLE 5.1. Overview 5.2. AAb1/AAb6 BLE 5.3. AAb3 BLE 5.4. Legacy AAb2 BLE 5.5. AAb4 BLE 5.6. AAb5 BLE 6. Device Configuration 6.1. Acceleration Event Threshold (aet) 6.2. Acceleration Filter Coefficients (afc) 6.3. Acceleration Percent Correction (apc) 6.4. APNs (apn) 6.5. Acceleration Report Correction (arc) 6.6. Alternator State Threshold (ast) 6.7. BLEAuthentication Disable (bad) 6 6 6 7 7 7 8 8 9 9 9 12 12 13 16 22 25 28 32 33 34 35 36 38 39 41 2022 Sensata Technologies, Inc. All rights reserved. Page 2 | 194 XT6384-1 Product Manual 6.8. OBD Backoff (bko) 6.9. Bluetooth Enabled (blt) 6.10. Bluetooth Transmit Power (btp) 6.11. Buzzer Songs (bzr) 6.12. CAN Controller Settings (can) 6.13. Crash Event Parameters (cep) 6.14. Accelerometer Confidence Slew (csl) 6.15. Accelerometer Confidence Threshold (cth) 6.16. Destination (dst) 6.17. OBD DTC Threshold (dtc) 6.18. Flag Save Mask (fsm) 6.19. FTP Configuration (ftp) 6.20. Garmin Blacklist (gbl) 6.21. Generic Config Value (gcv) 6.22. Geofence (gfn) 6.23. GPS Motion Thresholds (gps) 6.24. Garmin Configuration (grm) 6.25. Impede Device Manager (idm) 6.26. Input Default Polarity (idp) 6.27. Ignition Sense (ign) 6.28. IoT Destination Address/Port (iip) 6.29. IoT Shadow Params (ish) 6.30. Input State Source (iss) 6.31. IoT Thing String (its) 6.32. MIP/SIP Control (mip) 6.33. MPG Control (mpg) 6.34. Motion Sensitivity (mst) 41 43 44 45 46 47 47 49 49 51 52 53 54 55 55 57 58 59 60 61 63 64 65 66 67 68 69 2022 Sensata Technologies, Inc. All rights reserved. Page 3 | 194 XT6384-1 Product Manual 6.35. NMEA Stream Output (nso) 6.36. OBD Accel and Decel (oad) 6.37. OBD Feature Enable/Disable (obd) 6.38. OBD Ign Off Accum (oio) 6.39. OBD RPM and Speed Events (ors) 6.40. OTA Prevent (ota) 6.41. OBD Override (ovr) 6.42. Packet Creation Append (pca) 6.43. Packet Creation Recipe (pcr) 6.44. Packet Configure TPS (pct) 6.45. PDP Reset (pdp) 6.46. Packet Retry (prt) 6.47. SMS Receive Mask (sms) 6.48. Serial Port Settings (sps) 6.49. Serial Pass Thru Settings (sts) 6.50. Synch Time Threshold (stt) 6.51. TPSConfig Values (tcv) 6.52. Tester Present Message (tpm) 6.53. Timer Duration (tmr) 6.54. Third-Party Config Values (tpv) 6.55. OBD Transmit Delay (txd) 6.56. Version Info (ver) 6.57. VIN (vin) 6.58. Variable Save Mask (vsm) 6.59. Wake Battery Voltage (wbv) 7. Device Manager Protocol 7.1. Definitions 70 71 72 75 76 77 77 79 80 81 82 83 84 84 86 87 88 88 89 90 91 92 93 94 95 96 96 2022 Sensata Technologies, Inc. All rights reserved. Page 4 | 194 XT6384-1 Product Manual 7.2. Device Manager Packet 7.3. Device Manager Header 7.4. Packet-Specific Data 7.5. Device Manager Check-in 8. Interpreter 8.1. Language 8.2. Interpreter Scripting Trigger Block Examples 8.3. Packet Recipe 8.4. DTC Packet Parsing 9. Command Language 9.1. Overview 9.2. Verb and Module 9.3. Object 9.4. Arguments 9.5. Device Commands 10. Electrical Characteristics 10.1. 24-Pin Connector 10.2. 14-Pin Connector 11. Appendix 11.1. UDPC 11.2. Dynamic Alternator 11.3. J1939 and J1708 Test Setup Block Diagram 11.4. J1939 Dual Can Test Setup Block Diagram 12. Regulatory Statements 12.1. FCC 12.2. IC 12.3. California Proposition 65 Warning 96 96 99 102 105 105 121 125 156 166 166 166 166 167 169 186 186 187 188 188 188 190 191 192 192 193 194 2022 Sensata Technologies, Inc. All rights reserved. Page 5 | 194 XT6384-1 Product Manual 1. RELEASE NOTES 1.1. FIRMWARE Firmware: 1133MA3 1.2. MANUAL Firmware: 1133MA3 l Doc improvements and stability l Added ClearDriverID(<index>) interpreter command l Added diesel pcrs and driver ID pcrs l Added DTC packet parsing information l Added TPM configuration 2022 Sensata Technologies, Inc. All rights reserved. Page 6 | 194 XT6384-1 Product Manual 2. FUNCTIONAL DESCRIPTION 2.1. OVERVIEW The XT6384-1 is a device that interfaces with a vehicle's on-board diagnostics port to monitor and record vehicle activity. The XT6384-1 was developed primarily for clientele with large automotive fleets such as vehicle rental companies or courier delivery services. The XT6384-1 uses an OBD-II interface, a cellular modem, a Bluetooth modem, a GPS modem, a piezo speaker, LEDs, and an accelerometer to collect information that may be of interest to a clients application. Alongside these build in services, a SWI and UART interface are available to interact with external devices to gather additional information. One key benefit of the XT6384-1 is the ability to easily adjust the devices operation to suit an individual clients desires. The XT6384-1 devices can be controlled through various channels, ranging from simple system parameters to more complex device interpreter scripts, which offer maximum customization as they are written completely by the customer. By configuring custom system parameters and interpreter scripts, not only can device functionality be adjusted, but entirely new functionality can be added to the device. In theory, the XT6384-1 can emulate any other Xirgo device if properly configured through the system script. 2.2. MECHANICAL 2.2.1. XT6384-1 Mechanical Dimensions Weight Physical Connections Operating Temperature 3.35 x 3.1 x 0.8 (8.5 cm x 7.9 cm x 2.0 cm) 3 oz. (85 g) 3.2 oz. (92g) with internal battery 14-pin micro-fit connector 24-pin micro-fit connector
-30C to 75C (No internal battery)
-30C to 60C (Internal battery) 2022 Sensata Technologies, Inc. All rights reserved. Page 7 | 194 XT6384-1 Product Manual 3. DEVICE SETUP 3.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.0) cable to a port on the computer and pins 17 and 18 of the 24-pin connector. NOTE: A "USB Serial Device" and the associated COM number should appear under "Ports". If nothing shows up, unplug the connection to the Device, flip it over, and plug it back in. Take note of the COM port number. 5. Open Secure CRT and double-click on the session with the correct COM port number. This should connect the device to the terminal. 6. Right-click the session and go to "Properties". 7. Ensure the following is set for the session:
a. Connection > Protocol > Serial b. Connection > Serial > Baud rate > 115200 c. Terminal > Check Auto reconnect d. Terminal > Emulation > Terminal [VT100]
8. Click "Okay". NOTE: The device should now be connected to the terminal and commands can be sent. 2022 Sensata Technologies, Inc. All rights reserved. Page 8 | 194 XT6384-1 Product Manual 4. INTERFACES 4.1. UART XT6384-1 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). If the l The default baud rate is 115200 bits/s l The default frame format is 8N1 (8 data bits, no parity, 1 stop bit) l The interface does not support flow-control The UART interface is active and requires no authentication by default. AES-128 challenge/response authentication can be enabled by enabling the console-authentication bit in the firmware flags setting of the device description. 4.2. LED BEHAVIOR 4.2.1. Amber LED Primary Operation Indicate Cellular Communication Status Cell Status Off (Low power mode/ sleep) Searching for network Registered home/roaming LED Status Off Fast Blink (5 Hz) On Secondary Operation Indicate Active Inputs (1-4) When any or all user inputs (1-4) are active, the LED will flash (1 Hz) the amount of times corresponding to the active input index, pause, then repeat. When multiple inputs are active, the LED will flash (1 Hz) the input index for each one that is active with a pause between to differentiate. When all active inputs have been indicated, the LED will pause before repeating everything again. If no user inputs are active, the LED will revert to Primary Operation. 2022 Sensata Technologies, Inc. All rights reserved. Page 9 | 194 XT6384-1 Product Manual Override Operation When ignition state is off, the LED will flash continuously at 0.5 Hz. When ignition state is on, the LED will revert to Primary Operation. When ignition state is off and there is no cellular registration, the LED will double-flash at 0.33Hz. When the ignition state is off and there is cellular registration, the LED will flash continuously at 0.5 Hz. When ignition state is on, the LED will revert to Primary Operation. Example: The diagram below shows the amber LED blink pattern indicating cellular searching for network. 4.2.2. Green LED Primary Operation Indicate GPS Lock Status GPS Lock Status Off (sleep) or unlocked Locked LED Status Off On for 2 seconds before transitioning to secondary operation Secondary Operation Indicate Locked Current Satellite Count When GPS solution is Locked Good and the Primary Operation has completed, the LED will flash (1Hz) the amount of times corresponding to the number of satellites utilized in the current GPS solution, with a pause before repeating. Example: LED Blink Pattern (after GPS solution is Locked Good and Primary Operation has completed) indicating number of satellites utilized in the current GPS solution. The example below shows the green LED indicating four satellites utilized in the GPS solution with a single blip at approximately 4.5 seconds before repeating. 2022 Sensata Technologies, Inc. All rights reserved. Page 10 | 194 XT6384-1 Product Manual 4.2.3. Blue LED Primary Operation Indicate bluetooth connection status BT Status Off or unconnected Connected LED Status Off Slow blink (0.5Hz) Secondary Operation Indicate System Module Faults If a system module fault is detected in firmware, the LED will flash at 1 Hz, the number of times corresponding to the fault index defined below, with a pause before repeating. LED Blinks 1 2 3 4 5 6 7 Description TPS module fault Cellular module fault GPS module fault N/A Bluetooth Module fault Accelerometer module fault OBD module fault Example: The diagram below expresses a blue LED blink pattern indicating Bluetooth connection. 2022 Sensata Technologies, Inc. All rights reserved. Page 11 | 194 XT6384-1 Product Manual 5. BLUETOOTH/BLE 5.1. OVERVIEW The XT6384-1 uses Bluetopia provided by StoneStreet one; the GAP and GATT profiles are of specific interest. 5.1.1. Security There are several layers Target AAb1 Pairing Just Works Authentication None Encryption None Android/iOS Both Advertising Name HarpBT_<serial>
AAb3 AAb4 AAb5 AAb6 Just Works N/A Just Works Just Works SHA256 Client/Server N/A None None AES-CBC N/A None None Both None Both Both HarpBT_<serial>
or Configurable N/A Link2_<serial>
HarpBT_<serial>
or Configurable 5.1.2. Definitions Keyword Pairing Description Bluetooth LE standard mechanism to exchange encryption keys, primarily handled by Bluetooth stack on client (phone or tablet). OS may prompt user for permission to pair and/or for a passkey. Keyword Just Works Passkey Description Mechanism in simple secure pairing (SSP) that allows for devices to pair with no explicit user authentication Authentication used when pairing with a remote device; device displays a number the user must enter using the keypad on the remote device Authentication Encryption Custom service providing another layer of security; the XT6384-1 won't let client read/write without completing the authentication process. Another layer of encryption (AES) on top of Bluetooth. Characteristics are expanded out to a multiple of 16 bytes. 2022 Sensata Technologies, Inc. All rights reserved. Page 12 | 194 XT6384-1 Product Manual 5.2. AAB1/AAB6 BLE 5.2.1. HOS Service UUID The HOS service does not have encrypted characteristics Description HOS UUID a59611ba-78b7-4fd2-96fb-9b0f66d2311e 5.2.2. HOS Service UUID List Descriptions GPS Info Speed True Odo Derived Odo Eng/Ign RPM Protocol VIN Eng Hours Moving ECM Fuel Level Eng Run Time Eng Hours Seconds External Power Start Trip GPS info Start Trip True Odo Start Trip Eng Hours Seconds ECU Eng Hours Seconds Start Trip ECU Eng Hours Seconds Start Trip System Unix Time System Unix Time Driver ID Start Trip Derived Odom UUID e7737830-1018-11e6-a148-3e1d05defe78 5eed6ea2-0390-11e5-8418-1697f925ec7b 5eed6d4e-0390-11e5-8418-1697f925ec7b 5eed6719-0390-11e5-8418-1697f925ec7b 5eed665c-0390-11e5-8418-1697f925ec7b 31e6e24b-f2fb-4bb9-a16b-9d17a9c4e4ad 5eed6477-0390-11e5-8418-1697f925ec7b a9b9f487-5e60-43d5-a249-4d1d3f317d7e 95dbace5-fcee-467f-bbe9-fe42e195bb04 5eed659a-0390-11e5-8418-1697f925ec7b 5eed70e6-0390-11e5-8418-1697f925ec7b 1c3917a6-7d33-4152-9a33-858b6f1fc99b b71eb3aa-4ed7-4990-ab22-ced09cf58f34 87e22dd2-e27b-4094-968a-03e1537e7eb7 0dd2af9d-7220-474f-8b34-4a94a6a97498 d7b083dd-bf65-44e5-9fa1-959bddf2af0b ba4ac777-52ec-4133-9f18-adad8b98f142 40418a44-9b8d-49f8-8ef2-afcea1643786 0d407e4c-39c9-11e8-b467-0ed5f89f718b d4fb1556-39d2-11e8-b467-0ed5f89f718b 0f834728-39d5-11e8-b467-0ed5f89f718b 48969a7e-39d5-11e8-b467-0ed5f89f718b 66aa658a-0003-4cee-86f0-4c775bbe5a54 5ceb24b2-c273-40b4-b84b-f499e14c3f09 5.2.3. HOS Service Characteristics Table Descriptions GPS Info Type Read Notify Size 19 Encr. Size 32 Data / Units See GPS Info Structure below 2022 Sensata Technologies, Inc. All rights reserved. Page 13 | 194 XT6384-1 Product Manual Descriptions Speed True Odo Derived Odo Eng/Ign Type Type: Notify on lock or time change Read Read Read Read Notify Type: Notify on change RPM Protocol Read Read VIN Eng Hours Read Read Moving Read Notify Type: Notify on change ECM Read Notify Type: Notify on change Fuel Level Eng Run Time Eng Hours Seconds External Power Read Read Read Read Size Encr. Size Data / Units 2+1 4+1 4+1 1 4+1 1 18 4 1 1 2 4 4 1 16 16 16 16 16 16 32 16 16 16 16 16 16 16 0.1 KPH + 1 byte updated indicator Meters + 1 byte updated indicator Meters + 1 byte updated indicator Index 0 1 Description Engine off Engine on RPM + 1 byte updated indicator Index 0 1 2 Description None J-Bus OBDII Null Terminated String Hours (Only available on Heavy Duty Vehicles, won't default to persist, not commonly used by customers) Index 0 1 Description Not Moving Moving (speed >
5KPH) Index 0 1 2 3 4 Description Inactive Pending Connected Active Disabled by cinfig Tenths of a percent Seconds Seconds (Defaults to persist when on non-heavy-duty vehicles) Description Index No external power 0 External power 1 2022 Sensata Technologies, Inc. All rights reserved. Page 14 | 194 XT6384-1 Product Manual Descriptions Start Trip GPS info Start Trip True Odo Start Trip Eng Hours Seconds ECU Eng Hours Seconds Start Trip ECU Eng Hours Seconds Start Trip System Unix Time System Unix Time Driver ID Type Read Read Read Read Read Read Read Read Write Size 19 4+1 4 4 4 4 4 4(R)/
8(W) Encr. Size 32 16 16 16 16 16 16 16 Start Trip Derived Odom Read 4 16 Data / Units See Below (but now historically flavored!) Meters + 1 byte updated indicator Seconds (Defaults to persist when on non-heavy-duty vehicles) ECU only (s) ECU only (s) Seconds since epoch Seconds since epoch ROM ID, i.e., 0x12345678. Driver ID values must be written in reverse byte order. Meters 5.2.4. GPS Info Structure Name Unix Time Lat Lon Speed Heading HDOP Sats Lock Size 4 4 4 1 2 2 1 1 Type sint32 sint32 sint32 uchar sint16 uint16 uchar uchar Description seconds since epoch degrees * 1e6 degrees * 1e6 0.1 KPH degrees * 10 hdop * 10 Number of Satellites Index 0 1 2 3 4 Description Unknown Unlocked Locked Sleep LockedGood 2022 Sensata Technologies, Inc. All rights reserved. Page 15 | 194 XT6384-1 Product Manual 5.3. AAB3 BLE AAb3 BLE implementation supports three services:
l Identity l Engine l Authentication 5.3.1. Identity Service Information Description Identity UUID decc0000-dc4f-4376-9df9-8de1f845b254 5.3.2. Identity Service UUID List Descriptions Device ID Product ID Interface Version UUID decc0001-dc4f-4376-9df9-8de1f845b254 decc0002-dc4f-4376-9df9-8de1f845b254 decc0003-dc4f-4376-9df9-8de1f845b254 5.3.3. Identity Service Characteristic Table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions Device ID Product ID Interface Version Type Read Read Read Size 10 5 4 Data / Units Esn
"AAb3"
Integer Version Number 5.3.4. Engine Service Information Description Engine Service UUID 1B19B844-038F-11E5-8418-1697F925EC7B 5.3.5. HOS Service UUID List Descriptions GPS Info UUID e7737830-1018-11e6-a148-3e1d05defe78 2022 Sensata Technologies, Inc. All rights reserved. Page 16 | 194 XT6384-1 Product Manual Descriptions Speed True Odo Derived Odo Eng/Ign RPM Protocol VIN Eng Hours Moving ECM Fuel Level Eng Run Time Eng Hours Seconds External Power Start Trip GPS info Start Trip True Odo Start Trip Eng Hours Seconds ECU Eng Hours Seconds Start Trip ECU Eng Hours Seconds Start Trip System Unix Time System Unix Time Driver ID Start Trip Derived Odom UUID 5eed6ea2-0390-11e5-8418-1697f925ec7b 5eed6d4e-0390-11e5-8418-1697f925ec7b 5eed6719-0390-11e5-8418-1697f925ec7b 5eed665c-0390-11e5-8418-1697f925ec7b 31e6e24b-f2fb-4bb9-a16b-9d17a9c4e4ad 5eed6477-0390-11e5-8418-1697f925ec7b a9b9f487-5e60-43d5-a249-4d1d3f317d7e 95dbace5-fcee-467f-bbe9-fe42e195bb04 5eed659a-0390-11e5-8418-1697f925ec7b 5eed70e6-0390-11e5-8418-1697f925ec7b 1c3917a6-7d33-4152-9a33-858b6f1fc99b b71eb3aa-4ed7-4990-ab22-ced09cf58f34 87e22dd2-e27b-4094-968a-03e1537e7eb7 0dd2af9d-7220-474f-8b34-4a94a6a97498 d7b083dd-bf65-44e5-9fa1-959bddf2af0b ba4ac777-52ec-4133-9f18-adad8b98f142 40418a44-9b8d-49f8-8ef2-afcea1643786 0d407e4c-39c9-11e8-b467-0ed5f89f718b d4fb1556-39d2-11e8-b467-0ed5f89f718b 0f834728-39d5-11e8-b467-0ed5f89f718b 48969a7e-39d5-11e8-b467-0ed5f89f718b 66aa658a-0003-4cee-86f0-4c775bbe5a54 5ceb24b2-c273-40b4-b84b-f499e14c3f09 5.3.6. HOS Service Characteristics Table The AAb3 HOS service has encrypted characteristics. l Types available are Read, Write, and Notify l Size and Encrypted Size is measured in bytes Descriptions Type GPS Info Speed Read Notify Type:
Notify on lock or time change Read Size 19 Encr. Size 32 Data / Units Data Type See GPS Info Structure below 2 16 0.1 KPH uint16 + uint8 2022 Sensata Technologies, Inc. All rights reserved. Page 17 | 194 XT6384-1 Product Manual Descriptions Type Size Encr. Size Data / Units Data Type True Odo Read Derived Odo Read Eng/Ign RPM Read Notify Type:
Notify on change Read Protocol Read 4 4 1 4 1 VIN Read 18 Eng Hours Read Moving ECM Read Notify Type:
Notify on change Read Notify Type:
Notify on change Fuel Level Eng Run Time Eng Hours Seconds Read Read Read 4 1 1 2 4 4 16 16 16 16 16 32 16 16 16 16 16 16 Meters Meters Index 0 1 RPM Index 0 1 2 Description Engine off Engine on Description None J-Bus OBDII Null Terminated String Configurable via ovr[0] to be ECU only, derived only, or derived if ECU unavailable (hours) Index 0 1 Description Not Moving Moving (speed >
5 KPH) Index 0 1 2 3 4 Description Inactive Pending Connected Active Disabled by config uint32 + uint8 uint32 + uint8 uint8 uint32 + uint8 sint8 Null Terminated String uint32 sint8 (value will not change if interpeted as uint8) sint8 (value will not change if interpeted as uint8) Tenths of a percent Seconds Seconds. Configurable via ovr[0]
to be ECU or Derived ONLY, or uint16 uint32 uint32 2022 Sensata Technologies, Inc. All rights reserved. Page 18 | 194 XT6384-1 Product Manual Descriptions Type Size Encr. Size Data / Units Data Type External Power Read 1 16 Start Trip GPS info Start Trip True Odo Start Trip Eng Hours Seconds ECU Eng Hours Seconds Start Trip ECU Eng Hours Seconds Start Trip System Unix Time System Unix Time Driver ID Read Read Read Read Read Read Read Read Write 19 4 4 4 4 4 4 4(R)/8
(W) Start Trip Derived Odom Read 4 32 16 16 16 16 16 16 16 16 Derived unless ECU is available Index 0 Description No external power External power 1 See Below Meters Configurable via ovr[0] to be ECU only, derived only, or Derived if ECU is unavailable (s) ECU only (seconds) ECU only (seconds) sint8 (value will not change if interpeted as uint8) uint32 uint32 uint32 uint32 Seconds since epoch uint32 Seconds since epoch ROM ID, i.e., 0x12345678. Driver ID values must be written in reverse byte order. Meters uint32 uint32 uint32 NOTE: () Contains a +1 updated byte only when in the encrypted version 2022 Sensata Technologies, Inc. All rights reserved. Page 19 | 194 XT6384-1 Product Manual 5.3.7. Authentication Service Process 5.3.8. Authentication Service UUID SHA256 is used for the authentication service on the AAb3 target. The input for each response includes the two challenges along with the customer AES key. Description Authentication UUID 1b19bf16-038f-11e5-8418-1697f925ec7b Descriptions Server_challenge Client_response Client_challenge UUID 5eedbbdd-0390-11e5-8418-1697f925ec7b 5eed91ef-0390-11e5-8418-1697f925ec7b 5eed8812-0390-11e5-8418-1697f925ec7b:
2022 Sensata Technologies, Inc. All rights reserved. Page 20 | 194 XT6384-1 Product Manual Descriptions Server_response Client_accepts UUID 5eed4793-0390-11e5-8418-1697f925ec7b 5eed58ad-0390-11e5-8418-1697f925ec7b 5.3.9. Authentication Service Characteristics Table Descriptions Server_challenge Type Read Size 16 Data / Units Randomly generated challenge value Client_response Write Client_challenge Write Server_response Read Notify Client_accepts Write 16 16 16 1 SHA256 Response computed by client sha256(cat(client_challenge, server_ challenge, secret_key ) ) Randomly generated challenge value SHA256 response computed by server sha256(cat(server_challenge, client_ challenge, secret_key ) ) Index 0 Description Client rejects server response Client accepts server response 1 5.3.10. GPS Info Structure Name Unix Time Lat Lon Speed Heading HDOP Sats Lock Size 4 4 4 1 2 2 1 1 Type sint32 sint32 sint32 uchar sint16 uint16 uchar uchar Description seconds since epoch degrees * 1e6 degrees * 1e6 0.1 KPH degrees * 10 hdop * 10 Number of Satellites Index 0 1 2 3 4 Description Unknown Unlocked Locked Sleep LockedGood 2022 Sensata Technologies, Inc. All rights reserved. Page 21 | 194 XT6384-1 Product Manual 5.4. LEGACY AAB2 BLE Legacy AAb2 BLE implementation supports three services:
l Engine l Timer l Pass-Through 5.4.1. Engine Service Information Description Engine UUID 1b19b844-038f-11e5-8418-1697f925ec7b 5.4.2. Engine Service UUID List Descriptions VIN ECM Status Ignition RPM Engine Time Engine Hours Derived Engine Hours GPS Status Date Time Longitude Latitude Speed Odometer (True) Odometer (Derived) Odo Interval Moving Protocol UUID a9b9f487-5e60-43d5-a249-4d1d3f317d7e 5eed70e6-0390-11e5-8418-1697f925ec7b 5eed665c-0390-11e5-8418-1697f925ec7b 31e6e24b-f2fb-4bb9-a16b-9d17a9c4e4ad 95dbace5-fcee-467f-bbe9-fe42e195bb04 5eed639c-0390-11e5-8418-1697f925ec7b 5eed628e-0390-11e5-8418-1697f925ec7b 5eed7230-0390-11e5-8418-1697f925ec7b 2a08 2aaf 2aae 5eed6ea2-0390-11e5-8418-1697f925ec7b 5eed6d4e-0390-11e5-8418-1697f925ec7b 5eed6719-0390-11e5-8418-1697f925ec7b f05252bb-9263-4491-9e06-40ab3e37dcf1 5eed659a-0390-11e5-8418-1697f925ec7b 5eed6477-0390-11e5-8418-1697f925ec7b 5.4.3. Engine Service Characteristic Table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions VIN ECM Status Type Read Read Notify Size 18 1 Data / Units Null terminated VIN string Description Index Off 0 Pending 1 2022 Sensata Technologies, Inc. All rights reserved. Page 22 | 194 XT6384-1 Product Manual Descriptions Type Size Ignition Read Notify RPM Engine Time Read Read Engine Hours Read Derived Engine Hours GPS Status Date Time Longitude Latitude Speed Odometer
(True) Odometer
(Derived) Odo Interval Moving Read Read Notify Read Read Read Read Read Notify Read Notify Read Write Read Notify Protocol Read 1 4 4 4 4 1 7 4 4 2 4 1 1 1 1 Data / Units Index 2 3 4 Description Connected Active Disabled by config Index 0 1 Description Ignition off Ignition On Engine RPM Seconds since last engine on.Once a trip ends, it reports the trip length and then restart to 0 on next ignition on. Number of hours engine has been on from OBD if available, otherwise the number is derived. Number of hours engine has been on, derived. Index 0 4 Description Unlocked or Unknown Locked and Integrated See GATT standard Longitude according to GATT standard; defaults to 0 if unavailable Latitude according to GATT standard; defaults to 0 if unavailable Units in 0.1 KPH (or KPH * 10) From OBD (m) Derived (m) Notify frequency (km) Index 0 1 Index 0 1 2 Description Not Moving Moving Description Unknown J-Bus OBDII 2022 Sensata Technologies, Inc. All rights reserved. Page 23 | 194 XT6384-1 Product Manual Descriptions Type Size Data / Units 5.4.4. Timer Service Information Description Timer UUID 1b19bb5a-038f-11e5-8418-1697f925ec7b 5.4.5. Timer Service UUID List Descriptions Timer Interval UUID 1B19BB5A-038F-11E5-8418-1697F925EC7B 5eed73b6-0390-11e5-8418-1697f925ec7b 5.4.6. Timer Service Characteristic Table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions Timer Interval Type Read Notify Read Write Size 4 1 Data / Units Current Unix Time (s) Notify interval (s) 5.4.7. Pass-Through Service Information UUID Description 1b19bce0-038f-11e5-8418-1697f925ec7b Pass-through 5.4.8. Pass-Through Service UUID List Descriptions TX RX Header UUID 5eed63d4-0390-11e5-8418-1697f925ec7b 5eed640e-0390-11e5-8418-1697f925ec7b 5eed627e-0390-11e5-8418-1697f925ec7b 5.4.9. Pass-through Service Characteristics Table l Types available are Read, Write, and Notify l Size is measured in bytes 2022 Sensata Technologies, Inc. All rights reserved. Page 24 | 194 XT6384-1 Product Manual Descriptions TX RX Header Cell State Type R/W/N Read Notify Read Write Read Notify Size 512 512 16 1 Data / Units See documentation N/A N/A N/A 5.5. AAB4 BLE 5.5.1. Overview AAb4 BLE supports two services:
l EDL l Info 5.5.2. EDL Service UUID Description EDL UUID 4117a79a-6c31-4ecc-a779-f1c9b177177b 5.5.3. EDL UUID List Descriptions VIN Moving Mileage/Odo Interval Mileage (True Odo) GPS Info Gear Position Engine Status Engine Hours Sec Engine Hours ECU Status Driver ID Date/Time ("Unix") Buffer Full UUID a9b9f487-5e60-43d5-a249-4d1d3f317d7e 5eed659a-0390-11e5-8418-1697f925ec7b f05252bb-9263-4491-9e06-40ab3e37dcf1 5eed6d4e-0390-11e5-8418-1697f925ec7b 53b13abb-41af-42de-8156-21e7b48143d7 9b342763-249d-46b5-9301-ba4612a5d9f6 5eed665c-0390-11e5-8418-1697f925ec7b 42d80e22-fc83-11e7-8450-fea9aa178066 95dbace5-fcee-467f-bbe9-fe42e195bb04 5eed70e6-0390-11e5-8418-1697f925ec7b 66aa658a-0003-4cee-86f0-4c775bbe5a54 2A08 7beb654c-98dc-4d8b-8cce-a427c8f3187f 2022 Sensata Technologies, Inc. All rights reserved. Page 25 | 194 XT6384-1 Product Manual 5.5.4. EDL Service Characteristic table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions VIN Moving Type Read Read Notify Size 18 1 Data / Units char[18] (Null Terminated) Description Bool Stopped 0 Moving 1 Mileage/Odo Interval Mileage (True Odo) GPS Info Gear Position Read Write 1 Kilometers Read Notify (on interval) Read Read Notify 4(R)/1
(W) 23 1 Meters (designed to fallback to gps lifetime odo when not available from engine bus) See GPS Info Structure Index 0 1 2 3 Description Neutral Forward Reverse Park Engine Status Read Notify Engine Hours Sec Engine Hours ECU Status Read Read Read 1 4 4 1 Driver ID Read Write Date/Time
("Unix") Read 4(R)/8
(W) 7 Bool 0 1 Description Off On Seconds Hours Index 0 1 2 3 4 char[8]**
Description Off Pending Connected Active Disabled by config
(See GATT Standard) 2022 Sensata Technologies, Inc. All rights reserved. Page 26 | 194 XT6384-1 Product Manual Descriptions Buffer Full Type Read Notify Size 1 Data / Units Bool 0 1 Description Not full Full 5.5.5. Info Service UUID Description Info UUID ede3469c-f706-11e7-8c3f-9a214cf093ae 5.5.6. Info Service UUID List Descriptions Main FW Version Bootloader FW Version gcv[0] value Device ID UUID 75ee1b84-f707-11e7-8c3f-9a214cf093ae 0cb8b4d8-f709-11e7-8c3f-9a214cf093ae 60fd30d2-f709-11e7-8c3f-9a214cf093ae d1371d4a-f709-11e7-8c3f-9a214cf093ae 5.5.7. Info Service Characteristic Table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions Main FW Version Bootloader FW Version gcv[0] value Device ID Type Read Read Read Read Size 16 16 4 4 Data / Units Version string Version string Unsigned long ESN 5.5.8. GPS Info Structure Name Unix Time Lat Lon speed Heading Type sint32 sint32 sint32 uchar sint16 Size 4 4 4 1 2 Description seconds since epoch degrees * 1e6 degrees *1e6 0.1 KPH degress*10 2022 Sensata Technologies, Inc. All rights reserved. Page 27 | 194 XT6384-1 Product Manual Name HDOP Sats Lock Type uint16 uchar uchar Size 2 1 1 Description HDOP*10 Number of Satellites Value 0 1 2 3 4 Description Unknown Unlocked Locked Sleep LockedGood Altitude sint32 4 meters*10 5.6. AAB5 BLE 5.6.1. Overview AAb5 BLE supports two services:
l EDL l Info 5.6.2. EDL Service UUID Description EDL UUID 4117a79a-6c31-4ecc-a779-f1c9b177177b 5.6.3. EDL UUID List Descriptions VIN Moving Mileage/Odo Interval Mileage (True Odo) GPS Info Gear Position Engine Status Engine Hours Sec Engine Hours ECU Status Driver ID UUID a9b9f487-5e60-43d5-a249-4d1d3f317d7e 5eed659a-0390-11e5-8418-1697f925ec7b f05252bb-9263-4491-9e06-40ab3e37dcf1 5eed6d4e-0390-11e5-8418-1697f925ec7b 53b13abb-41af-42de-8156-21e7b48143d7 9b342763-249d-46b5-9301-ba4612a5d9f6 5eed665c-0390-11e5-8418-1697f925ec7b 42d80e22-fc83-11e7-8450-fea9aa178066 95dbace5-fcee-467f-bbe9-fe42e195bb04 5eed70e6-0390-11e5-8418-1697f925ec7b 66aa658a-0003-4cee-86f0-4c775bbe5a54 2022 Sensata Technologies, Inc. All rights reserved. Page 28 | 194 XT6384-1 Product Manual Descriptions Date/Time ("Unix") Buffer Full UUID 2A08 7beb654c-98dc-4d8b-8cce-a427c8f3187f 5.6.4. EDL Service Characteristic table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions VIN Moving Type Read Read Notify Size 18 1 Mileage/Odo Interval Mileage (True Odo) GPS Info Gear Position Read Write Read Notify (on interval) Read Read Notify 4(R)/1
(W) 4 23 1 Data / Units char[18] (Null Terminated) Description Bool Stopped 0 Moving 1 Kilometers Meters (designed to fallback to gps lifetime odo when not available from engine bus) See GPS Info Structure Index 0 1 2 3 Description Neutral Forward Reverse Park Engine Status Read Notify Engine Hours Sec Engine Hours ECU Status Read Read Read 1 4 4 1 Bool 0 1 Description Off On Seconds Hours Index 0 1 2 3 4 Description Off Pending Connected Active Disabled by config 2022 Sensata Technologies, Inc. All rights reserved. Page 29 | 194 XT6384-1 Product Manual Descriptions Driver ID Type Read Write Date/Time
("Unix") Buffer Full Read Read Notify 1 Size 4(R)/8
(W) 7 Data / Units char[8]**
(See GATT Standard) Bool 0 1 Description Not full Full 5.6.5. Info Service UUID Description Info UUID ede3469c-f706-11e7-8c3f-9a214cf093ae 5.6.6. Info Service UUID List Descriptions Main FW Version Bootloader FW Version gcv[0] value Device ID UUID 75ee1b84-f707-11e7-8c3f-9a214cf093ae 0cb8b4d8-f709-11e7-8c3f-9a214cf093ae 60fd30d2-f709-11e7-8c3f-9a214cf093ae d1371d4a-f709-11e7-8c3f-9a214cf093ae 5.6.7. Info Service Characteristic Table l Types available are Read, Write, and Notify l Size is measured in bytes Descriptions Main FW Version Bootloader FW Version gcv[0] value Device ID Type Read Read Read Read Size 16 16 4 4 Data / Units Version string Version string Unsigned long ESN 5.6.8. GPS Info Structure Name Unix Time Type SINT32 Size 4 Description seconds since epoch 2022 Sensata Technologies, Inc. All rights reserved. Page 30 | 194 XT6384-1 Product Manual Name Lat Lon Speed Heading HDOP Sats LOCK Type SINT32 SINT32 UCHAR SINT16 UINT16 UCHAR UCHAR Size 4 4 1 2 2 1 1 Description degrees * 1e6 degrees *1e6 0.1 KPH Degrees*10 HDOP*10 Number of Satellites Value 0 1 2 3 4 Description Unknown Unlocked Locked Sleep LockedGood Altitude SINT32 4 Meters*10 2022 Sensata Technologies, Inc. All rights reserved. Page 31 | 194 XT6384-1 Product Manual 6. 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. The following two commands will be most relevant when dealing with the following configurations:
l :rycfg -- Used to read a system configuration l :wycfg -- Used to write a system configuration When using either of these commands, you must specify what configuration slot you wish to read/write, otherwise the console will default to the first slot (index[0]). In the case that the desired parameter does not have a factory default setting (configs PCR, PCA, &GFN) the console will not default to the first slot unless it has already been written. Example:
:wycfg tmr 30 0
:OK
:rycfg dst
|dst[0]: addr:"us.address.com", port:1234 (0x4d2)
: OK 2022 Sensata Technologies, Inc. All rights reserved. Page 32 | 194 XT6384-1 Product Manual 6.1. ACCELERATION EVENT THRESHOLD (AET) The Acceleration Event Threshold parameter determines which conditions must be met for an event to register. Configuration instances: 8 Command Type SET READ Syntax Command
:wycfg aet[x] <direction> <start_duration> <end_duration> <mg_thresh>
Response
:OK Command
:rycfg aet[x]
Response
| aet[x]: dir:<direction> (hex_val), start:<start_duration> (hex_val), end:<end_ duration> (hex_val), mg:<mg_thresh> (hex_val)
:OK Parameter direction Range N/A Description Value 0 1 2 3 Description Acceleration Deceleration Left Turn Right Turn start_duration end_duration 0 to 65535 0 to 65535 mg_thresh 0 to 2000 Time the acceleration in the target direction must stay above the mg_thresh before an event is considered to have started (ms). Time that an acceleration in the target direction must stay below the mg_ thresh before an event is considered to have concluded. If another acceleration threshold is exceeded before this time, it is negated (ms). The threshold that determines when start_duration and end_duration trigger (mg). Target AAb1, AAa4, AAb5, AAb6 Default Value(s) aet[0] 0 1500 1000 100 aet[1] 1 1500 1000 100 aet[2] 2 1500 1000 100 aet[3] 3 1500 1000 100 aet[4] 0 60000 1000 100 aet[5] 1 60000 1000 100 aet[6] 2 60000 1000 100 aet[7] 3 60000 1000 100 2022 Sensata Technologies, Inc. All rights reserved. Page 33 | 194 XT6384-1 Product Manual Target AAb3 Default Value(s) aet[0] 0 1000 1000 240 aet[1] 1 1000 1000 280 aet[2] 2 2000 1000 900 aet[3] 3 2000 1000 900 aet[4] 0 60000 1000 100 aet[5] 1 60000 1000 100 aet[6] 2 60000 1000 100 aet[7] 3 60000 1000 100 6.2. ACCELERATION FILTER COEFFICIENTS (AFC) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg afc <filter_len> <coef_1> <coef_2> ...... <coef_31>
Response
:OK Command
:rycfg afc Response
| afc: stages:<filter_len> (hex_val), coef1:<coef_val_1> (hex_val), coef2:<coef_val_2>
...... (hex_val), coef32:<coef_val_31> (hex_val)
:OK Parameter filter_len coef_val_XX Range 0 to 31 0 to 4294967295 Description The number of stages to be used in the FIR filter The coefficient for the filter stage denoted by 'XX'. It can be input as a decimal number (1.234567), as the internal system representation of the decimal value multiplied by one million (1234567), or as the raw hex of the system representation of the decimal value (0x12D687). NOTE: Ideally, all filter coefficients should sum to one unless attenuation or gain is desired. NOTE: This parameter does not have a factory default setting 2022 Sensata Technologies, Inc. All rights reserved. Page 34 | 194 XT6384-1 Product Manual 6.3. ACCELERATION PERCENT CORRECTION (APC) The Acceleration Percent Correction parameter is a scalar value multiplied by the filter output to produce gain or attenuation. APC is input as the explicit percent change interested in. Configuration instances: 1 NOTE: apc (and arc) corrections are only applied to the max mg value at the end of the event. They do NOT affect the determination of accelerometer events. The equation is (roughly) as follows:
E.g., if an APC of 50% is desired, set apc to the value of 50. There is a separate percent correction factor for the x axis and the y axis. There is no percent correction factor for the z axis. Command Type SET READ Syntax Command
:wycfg apc <percent_correction_factor_x_axis> <percent_correction_factor_y_axis>
Response
:OK Command
:rycfg apc Response
|apc: corr_x:<percent_correction_factor_x_axis> (hex_val), corr_y:<percent_ correction_factor_y_axis> (hex_val)
:OK Range 1 to 200 Description Percentage value 1 to 200 Percentage value Parameter percent_ correction_ factor_x_axis percent_ correction_ factor_y_axis Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) apc[0] 100 100 2022 Sensata Technologies, Inc. All rights reserved. Page 35 | 194 XT6384-1 Product Manual 6.4. APNS (APN) The APN parameter contains settings for APN gateway, username, and password. The device will hunt through the APNs in sequence (0, 1, 2, 3), attempting to activate context once on each, until it is successful. Configuration instances: 4 Command Type SET READ Syntax Command
:wycfg apn[x] "<apn_name>" "<username>" "<password>"
Response
:OK Command
:rycfg apn[x]
Response
| apn[x]: name:"<apn_name>", user:"<username>", passwd:"<password>"
:OK Parameter apn_name Range 64 Char Description The name of the APN gateway used for GSM, GPRS, 3G and 4G cellular networks. Examples of APN's are as follows:internet.t-mobile, wap.cingular, internet.mnc012.mcc345.gprs If instances 1 to 3 are configured as "disabled", the given slot will be skipped during APN hunting procedures. NOTE: For 4G AT&T modules, a blank APN configuration triggers a network-pushed APN. NOTE: APN characters are case sensitive. username password 32 Char 32 Char The username used to access the APN given by the first argument. The password used to access the APN given by the first argument. Target AAb1, AAb3, AAb4, AAb5, AAb6 Default Value(s) apn[0] "" "user" "passwd"
apn[1]"" "user" "passwd"
2022 Sensata Technologies, Inc. All rights reserved. Page 36 | 194 XT6384-1 Product Manual Target Default Value(s) apn[2]"" "user" "passwd"
apn[3]"" "user" "passwd"
NOTE: Network carriers are inconsistent with handling special characters (~`!@$%^&*()-_+={};/?,.) over SMS. It is recommended to only use UDP commands to set passwords that contain special characters. 2022 Sensata Technologies, Inc. All rights reserved. Page 37 | 194 XT6384-1 Product Manual 6.5. ACCELERATION REPORT CORRECTION (ARC) The acceleration report correction factor is a scalar value that is added to the output of the filter to add a DC offset to the signal.It can be input as a decimal number (1.234567), the internal system representation of the decimal value multiplied by one million (1234567), or as the raw hex of the system representation of the decimal value (0x12D687). There is a separate correction factor for the x axis and the y axis; there is no correction factor for the z axis. Configuration instances: 1 NOTE: arc (and apc) corrections are only applied to the max mg value at the end of the event. They do NOT affect the determination of accelerometer events. The equation is (roughly) as follows:
Command Type SET READ Syntax Command
:wycfg arc <correction_factor_x_axis> < correction_factor_y_axis>
Response
:OK Command
:rycfg arc Response
|arc: corr_x:<correction_factor_x_axis> (hex_val), corr_y:<correction_factor_y_axis>
(hex_val)
:OK Parameter correction_ factor_x_axis correction_ factor_y_axis Range
-2000 to 2000
-2000 to 2000 Description Scalar value Scalar value Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) arc[0] 0 0 2022 Sensata Technologies, Inc. All rights reserved. Page 38 | 194 XT6384-1 Product Manual 6.6. ALTERNATOR STATE THRESHOLD (AST) The Alternator State Threshold configuration determines the voltage and time thresholds that cause logic events. There are four alternator state thresholds, each with their own parameter ranges:
l ast[0] -> Alternator On Threshold l ast[1] -> Alternator Off Threshold l ast[2] -> 24V Check Threshold l ast[3] -> Dynamic Alternator Delta Configuration instances: 4 Command Type SET READ Syntax Command
:wycfg ast[x] <threshold> <time_val>
Response
:OK Command
:rycfg ast[x]
Response
|ast[x]: thresh:<threshold> (hex_val), time:<time_val> (hex_val)
:OK Instance ast[0]
Range 120 to 400 Description Threshold (0.1 V per bit) 1 to 60 Time_val (seconds) Number of seconds voltage is above threshold to begin OBD Ignition On logic Threshold (0.1 V per bit) If Alternator Off Threshold is greater than or equal to Alternator On Threshold, the internal Alternator Off Threshold will be limited to Alternator On Threshold - 0.1V. Time_val (seconds) Number of seconds voltage is below threshold to detect OBD Ignition Off logic Threshold (0.1 V per bit) ast[1]
100 to 400 1 to 60 0 (disable), 140 to 200 1 to 10 ast[2]
2022 Sensata Technologies, Inc. All rights reserved. Page 39 | 194 XT6384-1 Product Manual Instance Range Description Time_val (seconds) ast[3]
0 (disable), 3 to 10 Number of seconds voltage is above threshold to detect 24V system Threshold (0.1 V per bit) -- See Dynamic Alternator on p. 188 1 to 10 Time_val (seconds) Not used Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) ast[0] 132 3 ast[1] 131 3 ast[2] 160 1 ast[3] 0 1 2022 Sensata Technologies, Inc. All rights reserved. Page 40 | 194 XT6384-1 Product Manual 6.7. BLEAUTHENTICATION DISABLE (BAD) Disables or enables BLE authentication and encryption of characteristics for the AAb3 target only Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg bad <disable>
Response
:OK Command
:rycfg bad Response
|bad: disable:<disable> (hex_val)
:OK Parameter disable Description Disables Bluetooth:
Value 0 1 Description Enables BLE authentication and encryption of characteristics Disables BLE authentication and encryption of characteristics Target AAb3 Default Value(s) bad 1 6.8. OBD BACKOFF (BKO) Configuration instances: 6 Command Type SET READ Syntax Command
:wycfg bko[x] <enable_value>
Response
:OK Command
:rycfg bko[x]
Response
| bko[x]: enable:<enable_value> (hex_val)
:OK 2022 Sensata Technologies, Inc. All rights reserved. Page 41 | 194 XT6384-1 Product Manual Parameter enable Description OBD stops vehicle bus communication whenfeature is enabled. Index 0 1 Description Disable (default) Enable Instance bko[0]
bko[1]
bko[2]
bko[3]
bko[4]
bko[5]
Description Scantool Detect Enable (retries communication in 60 seconds) New MIL Status Detect Enable (end communication until next ignition cycle on a new MIL status detection) Persistent MIL Status Detect Enable (read MIL status for each ignition on, if still set, end communication) Protocol Detect Failure (OBD protocol failed start protocol three consecutive ignition cycles - disable OBD communication until this feature is disabled) Scantool Detect Enable (backs off until next ignition cycle) Scantool Detect Mask (for use with Scantool Detect) OBD stops vehicle bus communication on specific messages when mask is set. Mask range:
Hex 0x01 0x02 0x04 0x08 0x10 0x20 Description OnStar request OBDII request Diagnostic requests Security access requests User defined (currently not implemented) Ford EOL request (Target AAb3 only) Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) bko[0] 0 bko[1] 0 bko[2] 0 bko[3] 0 bko[4] 0 bko[5] 0x03 2022 Sensata Technologies, Inc. All rights reserved. Page 42 | 194 XT6384-1 Product Manual 6.9. BLUETOOTH ENABLED (BLT) The Bluetooth Enabled configuration sets the Bluetooth communication state. Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg blt <enable>
Response
:OK Command
:rycfg blt Response
|blt: en:<enable> (hex_val)
:OK Param enable Description Enables Bluetooth:
Value 0 1 Description Disables bluetooth communications Enables bluetooth communications (not available on AAa4 target) Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) blt[0] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 43 | 194 XT6384-1 Product Manual 6.10. BLUETOOTH TRANSMIT POWER (BTP) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg btp <power_val>
Response
:OK Command
:rycfg btp Response
| btp: power:<power_val> (hex_val)
:OK Parameter power_val Range 0 to 4 Description The Bluetooth Transmit Power setting; requires a reset to take effect. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) btp 4 2022 Sensata Technologies, Inc. All rights reserved. Page 44 | 194 XT6384-1 Product Manual 6.11. 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 Syntax Command
:wycfg bzr[x] <frequency1> <duration1> ... <frequency8> <duration8>
Response
:OK Command
:rycfg bzr[x]
Response
| bzr[x]: freq1:<frequency1> (hex_val), dur1:<duration1> (hex_val), ... freq8:<frequency8> (hex_val), dur8:<duration8> (hex_val)
:OK Param frequencyX Range 0 to 65535 durationX 0 (disable), 10-6535 Target AAb1, AAb3, AAb4, AAb5, AAb6 Description A frequency that corresponds to the Xth note to be played (Hz); 0 is silent. The duration of the Xth note to be played (ms) Default Value(s) bzr[0] 3000 500 0 200 0 0 0 0 0 0 0 0 0 0 0 0 bzr[1] 3000 500 0 50 0 0 0 0 0 0 0 0 0 0 0 0 bzr[2] 3000 200 0 800 0 0 0 0 0 0 0 0 0 0 0 0 bzr[3] 3000 200 0 300 0 0 0 0 0 0 0 0 0 0 0 0 bzr[4] 3000 3000 0 2 0 0 0 0 0 0 0 0 0 0 0 0 bzr[5] 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 bzr[6] 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 bzr[7] 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 bzr[8] 262 125 294 125 349 125 294 125 440 125 0 125 440 300 392 300 bzr[9] 262 250 294 125 349 125 294 125 392 125 0 125 392 300 349 300 2022 Sensata Technologies, Inc. All rights reserved. Page 45 | 194 XT6384-1 Product Manual 6.12. CAN CONTROLLER SETTINGS (CAN) Configuration instances: 6 Command Type SET READ Syntax Command
:wycfg can[x] <param_val>
Response
:OK Command
:rycfg can[x]
Response can[x]: value:<param_val>
:OK Parameter param_val Description Voltage threshold in 0.1 V per bit Instance can[0]
Range N/A Description CAN transmit Retry Index 0 1 Description Disable retry Enable retry can[1]
N/A CAN Baud rate Index 0 1 2 3 4 Description Autodetect (default) 500k 250k 125k 33k can[2]
can[3]
can[4]
can[5]
2 to 16 1 to 8 1 to 4 1 to 1024 CAN TSEG1 Time Segment Before Sample Point CAN TSEG2 Time Segment After Sample Point CAN SJW Synchronization Jump Width BRP Baud Rate Prescaler Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) can[0] 1 2022 Sensata Technologies, Inc. All rights reserved. Page 46 | 194 XT6384-1 Product Manual Target Default Value(s) can[1] 0 can[2] 8 can[3] 6 can[4] 4 can[5] 8 6.13. CRASH EVENT PARAMETERS (CEP) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg cep <delta_mg_thresh> <poll_freq> <hist_depth>
Response
:OK Command
:rycfg cep Response
| cep: mg:<delta_mg_thresh> (hex_val), freq:<poll_freq> (hex_val), depth:<hist_ depth> (hex_val)
:OK Parameter delta_mg_ thresh poll_freq hist_depth Range 1 to 2000 1 to 5 1 to 75 Description If the change in force in any direction exceeds this mg value, the event will trigger. How often the accelerometer is polled for history data (Hz). Number of accelerometer plots saved; each plot is a reoriented simple accelerometer vector (x, y, z). Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) cep 1000 5 75 6.14. ACCELEROMETER CONFIDENCE SLEW (CSL) Configuration only available for target AAb3 2022 Sensata Technologies, Inc. All rights reserved. Page 47 | 194 XT6384-1 Product Manual Command Type SET READ Syntax Command
:wycfg csl <rate_val>
Response
:OK Command
:rycfg csl Response
| csl: rate:<rate_val> (hex_val)
:OK Parameter rate_val Range 1 to 4294967295 Description Scalar for accelerometer orientation falling slew. Target AAb3 Default Value(s) csl 10000 2022 Sensata Technologies, Inc. All rights reserved. Page 48 | 194 XT6384-1 Product Manual 6.15. ACCELEROMETER CONFIDENCE THRESHOLD (CTH) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg cth <confidence_threshold> <hysteresis>
Response
:OK Command
:rycfg cth Response
|cth: conf:<confidence_threshold> (hex_val), hyst:<hysteresis> (hex_val)
:OK Parameter confidence_ threshold hysteresis Range 1 to 255 0 to 255 Description A value, above which accelerometer events will be reported to the interpreter. A hysteresis value applied to a falling confidence level. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) cth 120 60 6.16. DESTINATION (DST) The dst[9] instance is utilized for all Device Manager interactions, including device Checkin Messages; configure accordingly. Configuration instances: 10 Command Type SET READ Syntax Command
:wycfg dst[x] "<ip>|<hostname>|<local serial>" <port_number>
Response
:OK Command
:rycfg dst[x]
Response
|dst[x]: addr:"<ip>|<hostname>|<local serial>" port:<port_number> (hex_val)
:OK 2022 Sensata Technologies, Inc. All rights reserved. Page 49 | 194 XT6384-1 Product Manual Parameter
<ip>|<hostname>|
<local serial>
Range 64 Characters 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"
port_number 1 to 65533 If using an IP address or a hostname, can be used to specify the port on which to connect. Target AAb1, AAa4, AAb5, AAb6 AAb3 Default Value(s) dst[0] "0.0.0.0" 1024 dst[1] "0.0.0.0" 1024 dst[2] "0.0.0.0" 1024 dst[3] "0.0.0.0" 1024 dst[4] "0.0.0.0" 1024 dst[5] "0.0.0.0" 1024 dst[6] "0.0.0.0" 1024 dst[7] "0.0.0.0" 1024 dst[8] "0.0.0.0" 1024 dst[9] "216.70.51.106" 3110 dst[0] "0.0.0.0" 1024 dst[1] "0.0.0.0" 1024 dst[2] "0.0.0.0" 1024 dst[3] "0.0.0.0" 1024 dst[4] "0.0.0.0" 1024 dst[5] "0.0.0.0" 1024 dst[6] "0.0.0.0" 1024 dst[7] "0.0.0.0" 1024 dst[8] "0.0.0.0" 1024 dst[9] null 2022 Sensata Technologies, Inc. All rights reserved. Page 50 | 194 XT6384-1 Product Manual 6.17. OBD DTC THRESHOLD (DTC) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg dtc <poll period> <speed threshold 1mph/bit>
Response
:OK Command
:rycfg dtc Response
|dtc: polfreq:<poll period> (hex_val), thresh:<speed threshold 1mph/bit> (hex_val)
:OK Parameter poll period Range 0 to 30 Description When vehicle speed is at or below <speed threshold>, periodically poll for DTC change (in minutes) speed threshold 0 to 100 NOTE:Setting this to 5, for example, means the device will poll once every 5 min Begin DTC reading when vehicle is at or below <speed threshold> in mph Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) dtc[0] 0 10 2022 Sensata Technologies, Inc. All rights reserved. Page 51 | 194 XT6384-1 Product Manual 6.18. FLAG SAVE MASK (FSM) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg fsm <32bit_mask>
Response
:OK Command
:rycfg fsm Response fsm: mask:<32bit_mask>
:OK Parameter 32bit_mask:
Range 0x0 to 0xFFFFFFFF Description A bitmask value corresponding to which scriptable user flags will be saved in persist data. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) fsm 0 2022 Sensata Technologies, Inc. All rights reserved. Page 52 | 194 XT6384-1 Product Manual 6.19. FTP CONFIGURATION (FTP) FTP is only supported on SARA-R410M, LARA-4202 and ELS61-US cellular modules at this time. Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg ftp "<ip>|<hostname>" <port_number> "<directory>" "<username>"
"<password>" <mode_val> <retry_max>
Response
:OK Command
:rycfg ftp Response
| ftp: addr:"<ip>|<hostname>", port:<port_number> (hex_val), dir:"<directory>" , user:"<username>", passwd:"<password>", mode:<mode_val> (hex_val), rtrymax:<retry_max_val> (hex_val)
:OK Parameter
<ip>|<hostname>
port_number directory username password Range 63 char 1 to 65533 31 char 24 char 12 char Description Takes the form of an IP address (192.0.0.0), or a hostname . Specifies the port on which to connect to when using an IP address or hostname. A sub-directory on the FTP server where the requested files can be found. Username used to access the FTP server given by the first argument. Password used to access the FTP server given by the first argument. mode_val N/A NOTE: Network carriers are inconsistent with handling special characters (~`!@$%^&*()-_+={};/?,.) over SMS. It is recommended to only use UDP commands to set passwords that contain special characters. Index 0 1 Description
(Discontinued) Passive retry_max_val 0 to 255 Number of times the device tries to fetch the requested file before giving up and flushing the request queue. 2022 Sensata Technologies, Inc. All rights reserved. Page 53 | 194 XT6384-1 Product Manual Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) ftp "0.0.0.0" 21 "dir" "usn" "pwd" 0 3 6.20. GARMIN BLACKLIST (GBL) Configuration instances: 16 Command Type SET READ Syntax Command
:wycfg gbl[x] <flags_hex> <pid_hex> <size_val> <byte0_hex> <byte1_hex>
Response
:OK Command
:rycfg gbl Response
| gbl[x]: flags:<flags_hex>, pid:<pid_hex>, size:<size_val> (hex_val), byte0:<byte0_ hex>, byte1:<byte1_hex>
:OK Parameter flags_hex Range N/A Description Mask that configures the match method:
Description Hex Match byte 1 0x1 Match byte 0 0x2 Match size 0x4 Match PID 0x8 pid size byte0_hex byte1_hex 0x0 to 0xFF 0 to 255 0x0 to 0xFF 0x0 to 0xFF Single byte PID id match Single byte Garmin packet size match Single byte Garmin packet first byte match Single byte Garmin packet second byte match Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) gbl[x] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 54 | 194 XT6384-1 Product Manual 6.21. GENERIC CONFIG VALUE (GCV) Configuration instances: 64 Command Type SET READ Syntax Command
:wycfg gcv[x] <unsigned_long>
Response
:OK Command
:rycfg gcv[x]
Response
| gcv[x]: value:<unsigned_long> (hex_val)
:OK Parameter unsigned_ long Range 0 to 4494967295 Description A generic configuration value accessible within a script. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) gcv[x] 0 6.22. GEOFENCE (GFN) This config allows for both circular and polygonal geofences. Configuration instances: 50 Circular Fence Command Type SET READ Syntax Command
:wycfg gfn[x] <latitude> <longitude> <radius_value>
Response
:OK Command
:rycfg gfn[x]
Response
| gfn[x]: lat:<latitude> (hex_val), lon:<longitude> (hex_val), radius:<radius_value>
(hex_val)
:OK 2022 Sensata Technologies, Inc. All rights reserved. Page 55 | 194 XT6384-1 Product Manual Polygonal Fence At least 3, but no more than 11 coordinate pairs needed Command Type SET READ Syntax Command
:wycfg gfn[x] <latitude0> <longitude0>...<latitude10> <longitude10>
Response
:OK Command
:rycfg gfn[x]
Response
| gfn[x]: lat0:<latitude0> (hex_val), lon0<longitude0> (hex_val), ... lat10:<latitude10>
(hex_val), lon10:<longitude10> (hex_val)
:OK NOTE: This parameter does not have a factory default setting. Parameter latitude longitude radius_value Range
-90.000000 to 90.000000
-180.000000 to 180.000000 1 to 1000000 Description Latitude point to 6 decimal places (e.g. 44.863511) Longitude point to 6 decimal places (e.g. -93.340138) Only for circular fences, distance in meters from center point of circle to outer perimeter Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) all gfn[x] args default to '0'
2022 Sensata Technologies, Inc. All rights reserved. Page 56 | 194 XT6384-1 Product Manual 6.23. GPS MOTION THRESHOLDS (GPS) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg gps <motion_start> <motion_stop>
Response
:OK Command
:rycfg gps Response
| gps: start:<motion_start> (hex_val), stop:<motion_stop> (hex_val)
:OK Parameter motion_start motion_stop Range 0 to 200 0 to 200 Description Configure GPS motion detection start speed threshold in tenths of MPH. Configure GPS motion detection stop speed threshold in tenths of MPH Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) gps 100 10 2022 Sensata Technologies, Inc. All rights reserved. Page 57 | 194 XT6384-1 Product Manual 6.24. GARMIN CONFIGURATION (GRM) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg grm<filter_enable>
Response
:OK Command
:rycfg grm Response
| grm: enable:<filter_enable> (hex_val)
:OK Parameter filter_enable Range N/A Description Activates Garmin message filter that drops the first delete all stops request and the first stop 1 status request in a session. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) grm 0 2022 Sensata Technologies, Inc. All rights reserved. Page 58 | 194 XT6384-1 Product Manual 6.25. IMPEDE DEVICE MANAGER (IDM) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg idm <select>
Response
:OK Command
:rycfg idm Response
| idm: sel:<select> (hex_val)
:OK Parameter select Range N/A Description Index 0 1 Description DM service operates normally DM checkin messages and interactions are disabled Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) idm 0 2022 Sensata Technologies, Inc. All rights reserved. Page 59 | 194 XT6384-1 Product Manual 6.26. INPUT DEFAULT POLARITY (IDP) l idp[0] -> PUD on user input 1 l idp[1] -> PUD on user input 2 l idp[2] -> PUD on user input 3 l idp[3] -> PUD on user input 4 Configuration instances: 4 Command Type SET READ Syntax Command
:wycfg idp[x] <pullup_disable>
Response
:OK Command
:rycfg idp[x]
Response
| idp[x]: polrty:<pullup_disable> (hex_val)
:OK Parameter Input active level Range 0 to 1 Description Sets the corresponding user input "active" level by engagingan external pullup ('0') or pulldown ('1') oncorrespondingthatuser input. An idp setting of '1' means the user input is configured active high, so the user input is pulled down when not driven by external influences. An idp setting of '0' means the user input is configured active low, so the user input is pulled up when not driven by external influences. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) idp[0] 0 idp[1] 0 idp[2] 0 idp[3] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 60 | 194 XT6384-1 Product Manual 6.27. IGNITION SENSE (IGN) Configuration instances: 1 Command Type SET Syntax Command
:wycfg ign <type> <onsec> <offsec>
OR READ
:wycfg ign <type> <andmask> <ormask>
Response
:OK Command
:rycfg ign Response
| ign: type:<type> (hex_val), param1:<param1> (hex_val), param2:<param2> (hex_val)
:OK Parameter type Range 1 to 3 Description Ignition detection type. Type 1 and 2 use ignition onsec and offsec parameters. Type 3 is used for and/or masks. Index 1 2 3 Description Wired Vehicle Bus
(Composite) onsec offsec andmask/ormask 1 to 65535 1 to 65535 N/A Configured ignition type source must be true for x seconds before reported to script. Configured ignition type source must be false for x seconds before reported to script. Ignition detection masks Index 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 Description Wired Ignition IN1 IN2 IN3 IN4 Reserved Reserved Reserved 2022 Sensata Technologies, Inc. All rights reserved. Page 61 | 194 XT6384-1 Product Manual Parameter Range Description NOTE: Ignition sources above will attempt to have a 1:1 with Input/Output State Bits on p. 158 Index 0x0100 0x0200 0x0400 0x0800 0x1000 0x2000 0x4000 0x8000 Description Vehicle Bus Virtual Battery (Configured by Alternator State Threshold (ast) on p. 39) Virtual Vibration (Non-configurable) GPS-based movement (Configured by GPS Motion Thresholds (gps) on p. 57) Reserved Reserved Reserved ANDMODEbit l Default (when cleared):ANDMODE=ALL_OFF l when bit is set the ANDMODE=ANY_OFF l ANDMODEonly affects the judgement of ignition-off. All AND-sources must be on to judge ignition-on. Target AAb1, AAb3, AAb5, AAb6 AAa4 Default Value(s) ign 1 1 1 Ign 2 1 1 2022 Sensata Technologies, Inc. All rights reserved. Page 62 | 194 XT6384-1 Product Manual 6.28. IOT DESTINATION ADDRESS/PORT (IIP) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg iip "<ip>|<hostname>" <port_number> <QoS Level> <Keep Alive>
Response
:OK Command
:rycfg iip Response
| iip: addr:"<ip>|<hostname>", port:<port_number> (hex_val), qoslev:<QoS Level>
(hex_val), keepa:<Keep Alive> (hex_val)
:OK Parameter
<ip>|<hostname>:
port_number Range 128 Characters 1 to 65533 QoS Level N/A Description Can take the form of an IP address (192.0.0.0), or a hostname, e.g., www.xirgotech.com When using an IP address or hostname, port can be used to specify the port on which to connect. Quality of service level Keep Alive 30 to 1200 Index 0 1 Description Fire and forget; device will send messages once ACKrequired; device will send messages at least once MQTT keepalive interval. This tells the server how often to expect MQTT PING packets before disconnecting the device. An interval of 60 seconds will tell the server to expect a PING or some other traffic from the device every 60 seconds. If the device does not reply for 90 seconds (keepalive x 1.5) the server will assume the device has gone offline and will close the TLS socket. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) iip "0.0.0.0" 1024 1 60 2022 Sensata Technologies, Inc. All rights reserved. Page 63 | 194 XT6384-1 Product Manual 6.29. IOT SHADOW PARAMS (ISH) Configuration instances: 1 Command Type SET READ Parameter topic_string Shadow trim val Syntax Command
:wycfg ish "<topic_string>" <shadow trim val>
Response
:OK Command
:rycfg ish Response
| ish: topic:<topic_string>, shadtrm:<shadow trimval> (hex_val)
:OK Range 128 Characters N/A Description AWS Shadow topic string Shadow trim enable Index 0 1 Description Disable AWSshadow Enable AWSshadow Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) Ish "" 0 2022 Sensata Technologies, Inc. All rights reserved. Page 64 | 194 XT6384-1 Product Manual 6.30. INPUT STATE SOURCE (ISS) l iss[0] -> Source for user input 1 l iss[1] ->Source foruser input 2 l iss[2] ->Source foruser input 3 l iss[3] ->Source foruser input 4 Configuration instances: 4 Command Type SET READ Syntax Command
:wycfg iss[x] <source_val>
Response
:OK Command
:rycfg iss[x]
Response
| idp[x]: source:<source_val> (hex_val)
:OK Parameter source_val Description Index 0 1 Description Physical hardware pins determine reported state Script determines reported state Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) iss[0] 0 iss[1] 0 iss[2] 0 iss[3] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 65 | 194 XT6384-1 Product Manual 6.31. IOT THING STRING (ITS) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg its "<topic_string>" "<client id string>"
Response
:OK Command
:rycfg its Response
| its: topic:"<topic_string>", clntid:"<client id string>"
:OK Parameter topic_string client id string Range 128 Characters 64 Characters Description AWS topic string AWS client id string. If left blank, defaults to XT6379_<IMEI>
Target AAb1, AAb3, AAa4, AAb5, AAn6 Default Value(s) its "" ""
2022 Sensata Technologies, Inc. All rights reserved. Page 66 | 194 XT6384-1 Product Manual 6.32. MIP/SIP CONTROL (MIP) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg mip <mode_value>
Response
:OK Command
:rycfg mip Response
| mip: mode:<mode_value> (hex_val)
:OK Parameter mode value Description Select cellular mobile IP mode:
Index 0 1 2 Description Simple IP only Mobile IP preferred Mobile IP only Target AAb1, AAb3, AAa4, AAb5, AAb6 mip 1 Default Value(s) 2022 Sensata Technologies, Inc. All rights reserved. Page 67 | 194 XT6384-1 Product Manual 6.33. MPG CONTROL (MPG) This is a user configuration for MPG calculations. Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg mpg <fuel type value> <use type value> <EFRcoefficient> <MAF coefficient>
Response
:OK Command
:rycfg mpg Response
| mpg: fueltyp:<fuel type value> (hex_val), usetype:<use type value> (hex_val), efrcoef:<EFRcoefficient> (hex_val), mafcoef:<MAF coefficient> (hex_val)
:OK Parameter fuel type value Range N/A use type value N/A Description Index 0 1 2 Index 0 1 2 Description Discover Fuel Type from vehicle (default) Gasoline Diesel Description Discover support type from vehicle (default) Use Engine Fuel Rate Use Mass Air Flow EFR coefficient MAF coefficient 0 to 10 Coefficient used in EFR calculation 0 to 10 Coefficient used in MAF calculation Target AAb1, AAb3, AAa4, AAb5, AAb6 mpg 0 0 1 1 Default Value(s) 2022 Sensata Technologies, Inc. All rights reserved. Page 68 | 194 XT6384-1 Product Manual 6.34. MOTION SENSITIVITY (MST) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg mst <motion_sensitivity_value>
Response
:OK Command
:rycfg mst Response
| mst: motion:<motion_sensitivity_value> (hex_val)
:OK Parameter motion_ sensitivity_ value Range 1 to 2000 Description Configure accelerometer motion sensitivity in thousandths of a unit of gravity. Target AAb1, AAb3, AAa4, AAb5, AAb6 mst 100 Default Value(s) 2022 Sensata Technologies, Inc. All rights reserved. Page 69 | 194 XT6384-1 Product Manual 6.35. NMEA STREAM OUTPUT (NSO) l nso[0] -> USB l nso[1] -> Aux0 l nso[2] -> Aux1 Configuration instances: 3 Command Type SET READ Syntax Command
:wycfg nso[x] <8bit_mask>
Response
:OK Command
:rycfg nso[x]
Response
| nso[x]: mask:<8bit_mask>
:OK Parameter 8bit_mask Description One bit for each of the available NMEA sentences; values can be added to stream more than one sentence type. Set mask to zero to stop streaming. Hex 0x01 0x02 0x04 0x08 0x010 Description GPGGA GPGLL GPGSA GPGSV GPRMC Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) nso[0] 0 nso[1] 0 nso[2] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 70 | 194 XT6384-1 Product Manual 6.36. OBD ACCEL AND DECEL (OAD) Configuration instances: 2 Command Type SET READ Syntax Command
:wycfg oad[x] <rate>
Response
:OK Command
:rycfg oad[x]
Response
| oad[x]: accdec:<rate> (hex_val)
:OK Parameter rate Descriptions rate is measured in .1 mph Instance oad[0]
Range 10 to 200 Description OBD acceleration threshold. oad[1]
10 to 200 Speed rate of change to exceed on acceleration to declare Hard Acceleration Event OBD deceleration threshold. Speed rate of change to exceed on deceleration to declare Hard Deceleration Event Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) oad[0] 100 oad[1] 100 2022 Sensata Technologies, Inc. All rights reserved. Page 71 | 194 XT6384-1 Product Manual 6.37. OBD FEATURE ENABLE/DISABLE (OBD) Configuration instances: 8 Command Type SET READ Syntax Command
:wycfg obd[x] <flags_index> <mode_index>
Response
:OK Command
:rycfg obd[x]
Response
| obd[x]: flags:<flags_index> (hex_val), mode:<mode_index> (hex_val)
:OK NOTE: This parameter does not have a factory default setting. Instance obd[0]
Description Obd Comms Enable. flags_index Index 0 1 Description Disable Enable mode_index Index 0 1 Description Immediate Next Ignition off detected obd[1]
Obd VIN Read Enable. The OBD[1] VINRead Enable feature can be configured using masks to perform a Ford VINRead and a VINRead. Using this configuration will look for Ford VINfirst. If VINnot obtained via Ford VINread the device will attempt alternate VINread. flags_index Index 0 Description Disable 2022 Sensata Technologies, Inc. All rights reserved. Page 72 | 194 XT6384-1 Product Manual Instance Description Index 1 2 3 Description VIN enable Ford VIN Read enable FordVINRead enable and VINRead enable obd[2]
Obd Debug Enable (OBD Datalogger). flags_index Index 1 Description Enable mode_index Index 0 1 Description Overwrite old debug data continuously Cease logging when memory is full obd[3]
Obd Monitor Only (no bus requests) Enable. flags_index Index 0 1 2 Description Disable Enable Listen Only CAN/J1708 during protocol detect obd[4]
Obd Electric (JBUS only) Enable. flags_index Index 0 1 Description Disable Enable obd[5]
Obd ECO Enable. flags_index Index 0 1 Description Disable Enable mode_index Index 0 to 10 Description Eco mode end trip minutes 2022 Sensata Technologies, Inc. All rights reserved. Page 73 | 194 XT6384-1 Product Manual Instance obd[6]
Description Obd Wake Listen Enable. flags_index Index 0 1 Description Disable Enable obd[7]
Obd Wake GPS Movement Enable. flags_index Index 0 1 Description Disable Enable Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) obd[0] 1 1 obd[1] 1 1 obd[2] 1 0 obd[3] 0 1 obd[4] 0 0 obd[5] 1 3 obd[6] 1 0 obd[7] 1 0 2022 Sensata Technologies, Inc. All rights reserved. Page 74 | 194 XT6384-1 Product Manual 6.38. OBD IGN OFF ACCUM (OIO) l oio[0] -> Gps Lifetime Odometer ignition off accumulation l oio[1] -> Gps Trip Odometer 1 ignition off accumulation l oio[2] -> Gps Trip Odometer 2 ignition off accumulation Configuration instances: 3 Command Type SET READ Syntax Command
:wycfg oio[x] <accum>
Response
:OK Command
:rycfg oio[x]
Response
| oio[x]: offacc:<accum> (hex_val)
:OK Parameter accum Description Index 0 1 Description Do not accumulate distance when ignition is off Accumulate distance when ignition is off Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) oio[0] 0 oio[1] 0 oio[2] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 75 | 194 XT6384-1 Product Manual 6.39. OBD RPM AND SPEED EVENTS (ORS) Configuration instances: 2 Command Type SET READ Syntax Command
:wycfg ors[x] <threshold> <time sec>
Response
:OK Command
:rycfg ors[x]
Response
| ors[x]: thresh:<threshold> (hex_val), time:<time sec> (hex_val)
:OK Instance ors[0]
Description RPM Threshold Parameter threshold time sec Range 0 (disable), 100 to 20000 1 to 60 Description RPM in 1 rpm to exceed Time RPM must be greater than threshold to declare an RPM Exceeded Event ors[1]
Speed Threshold Parameter threshold Time sec Range 0 (disable), 20 to 150 1 to 60 Description Speed in 1 mph to exceed Time Speed must be greater than threshold to declare a Speed Exceeded Event Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) ors[0] 1500 15 ors[1] 75 15 2022 Sensata Technologies, Inc. All rights reserved. Page 76 | 194 XT6384-1 Product Manual 6.40. OTA PREVENT (OTA) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg ota <enable_mask>
Response
:OK Command
:rycfg ota <enable_mask>
Response
| ota: enable:<enable_mask>
:OK Parameter enable_mask Description Hex 0x0 0x1 0x2 Description OTA is not prevented due to OBDCommunications state or TPS Transfer Prevent OTAwhen OBD Communications are Active (OBD Communications detected) Prevent OTAwhen TPS Transfer is Active (TPS Transfer is in progress) Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) ota[0] 0 6.41. OBD OVERRIDE (OVR) Configuration instances: 3 Command Type SET READ Syntax Command
:wycfg ovr[x] <enable_value>
Response
:OK Command
:rycfg ovr[x]
Response
| ovr[x]: enable:<enable_value> (hex_val)
:OK 2022 Sensata Technologies, Inc. All rights reserved. Page 77 | 194 XT6384-1 Product Manual Parameter enable_value Description Instance ovr[0]
Description Override Engine Hours Index 0 1 2 Description use derived engine hours if ECU engine hours not available use Derived Engine Hours only ignore ECU engine hours use ECU Engine Hours only (keep in persist) do not calculate derived engine hours ovr[1]
Override ECU Vehicle Speed Index 0 1 Description use ECU Vehicle Speed use GPS Vehicle Speed enable_value (protocol) Instance ovr[2]
Description Override OBD Protocol Discovery Index 0 0x001 to 0x200 Description No override OBDProtocol Table in OBD Run States Bits on p. 159 NOTE: Any specified Protocol IDwill be the ONLY protocol attempted Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) ovr[0] 0 ovr[1] 0 ovr[2] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 78 | 194 XT6384-1 Product Manual 6.42. PACKET CREATION APPEND (PCA) Configuration instances: 16 Command Type SET READ Syntax Command
:wycfg pca[x] "<append_hex_string>"
Response
:OK Command
:rycfg pca[x]
Response
| pca[x]: append_hex_string:"<append_hex_string>"
:OK NOTE: This parameter does not have a factory default setting. Parameter append_hex_string Description Refer to Packet Creation Append for configuration details Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) pca[x] ""
2022 Sensata Technologies, Inc. All rights reserved. Page 79 | 194 XT6384-1 Product Manual 6.43. PACKET CREATION RECIPE (PCR) Configuration instances: 128 Command Type SET READ Syntax Command
:wycfg pcr[x] "<recipe_hex_string>"
Response
:OK Command
:rycfg pcr[x]
Response
| pcr[x]: resipe_hex_string:"<recipe_hex_string>"
:OK NOTE: This parameter does not have a factory default setting. Parameter recipe_hex_string Description See Packet Recipe on p. 125 for configuration details Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) pcr[x] ""
2022 Sensata Technologies, Inc. All rights reserved. Page 80 | 194 XT6384-1 Product Manual 6.44. PACKET CONFIGURE TPS (PCT) Configuration instances: 5 Command Type SET READ Syntax Command
:wycfg pct[x] <reason_lo> <reason_hi> <Tps_Tag0> <Sz_size0> ...<Tps_Tag9> <Sz_ size9>
Response
:OK Command
:rycfg pct[x]
Response
| pct[x]: rsnlo:<reason_lo> (hex_val), rsnhi:<reason_hi> (hex_val), tag0:<Tps_Tag0>
(hex_val), size0:<Sz_size0> (hex_val), ...tag9:<Tps_Tag9> (hex_val), size9:<Sz_size9>
(hex_val)
:OK Parameter reason_lo reason_hi Tps_Tagn Sz_Sizen Range 0 to 255 0 to 255 0 to 65535 0 to 255 Description Reason code range low end for TPS event data fetch Reason code range high end for TPS event data fetch Tag identifier to be fetched from TPS engine and placed into an outgoing packet Data size of the TPS tag data being fetched from the TPS engine Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) all pct[x] args default to '0'
2022 Sensata Technologies, Inc. All rights reserved. Page 81 | 194 XT6384-1 Product Manual 6.45. PDP RESET (PDP) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg pdp <minutes> <sessions>
Response
:OK Command
:rycfg pdp Response
| pdp: rsttime:<minutes> (hex_val), rsstintv:<sessions> (hex_val)
:OK Parameter minutes sessions Range 0 to 65535 0 to 255 Description Time threshold to issue a PDP connection reset Sessions threshold to issue a PDP connection reset Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) pdp 0 0 2022 Sensata Technologies, Inc. All rights reserved. Page 82 | 194 XT6384-1 Product Manual 6.46. PACKET RETRY (PRT) l prt[0] -> Ignition off l prt[1] -> Ignition on Configuration instances: 2 Command Type SET READ Syntax Command
:wycfg prt[x] <seconds>
Response
:OK Command
:rycfg prt[x]
Response
| prt[x]: sec:<seconds> (hex_val)
:OK Parameter seconds Range 0 to 65535 Description Number of seconds to wait between message send attempts Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) prt[0] 300 prt[1] 15 2022 Sensata Technologies, Inc. All rights reserved. Page 83 | 194 XT6384-1 Product Manual 6.47. SMS RECEIVE MASK (SMS) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg sms "<sms source match>"
Response
:OK Command
:rycfg sms <sms source match>
Response
| sms: numb:"<sms source match>"
:OK Parameter sms source match Range 32 Char Description ASCII string limiting SMS received messages to those whose source matches; 0 disables the match. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) sms "0"
6.48. SERIAL PORT SETTINGS (SPS) l sps[0] -> Aux port 0 l sps[1] -> Aux port 1 Configuration instances: 2 Command Type SET READ Syntax Command
:wycfg sps[x] <baudrate> <dps_value> <mode_value> <console_print>
Response
:OK Command
:rycfg sps[x]
Response
|sps[x]: baud:<baudrate> (hex_val), dps:<dps_value> (hex_val), mode:<mode_value>
(hex_val), conprt:<console_print> (hex_val)
:OK 2022 Sensata Technologies, Inc. All rights reserved. Page 84 | 194 XT6384-1 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 l 1200 bit/sec dps_value Mode_value 3 Char N/A Acceptable dps values: 8N1 Acceptable mode values:
Value 0 3 6 Description Console Garmin Aux Passthru -- Only one serial port can be an Aux Passthru at any given time. Console_print N/A Scripted console print from BuildAndSend() format Value 0 1 Description
(ASCII)
(Binary) Target AAb3, AAa4, AAb5, AAb6 AAb1 Default Value(s) sps[0] 115200 "8N1" 0 0 sps[1] 115200 "8N1" 0 0 sps[0] 9600 "8N1" 3 0 sps[1] 115200 "8N1" 0 0 2022 Sensata Technologies, Inc. All rights reserved. Page 85 | 194 XT6384-1 Product Manual 6.49. SERIAL PASS THRU SETTINGS (STS) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg sts <PktTimeoutMs> <PktByteCount><PktDataFormat>
Response
:OK Command
:rycfg sts Response
| sts: timeout:<PktTimeoutMs> (hex_val), numbyte:<PktByteCount> (hex_val), datafmt:<PktDataFormat> (hex_val)
:OK Parameter PktTimeoutMs PktByteCount Range 0 to 60000 0 to 256 PktDataFormat 0 to 1 Description A non-zero value defines a passthru packet with an inter-byte timeout. Setting 0 disables this packet delimiter. A non-zero value defines a passthru packet as a specific number of bytes. Setting 0 disables this packet delimiter. Represents the packet data format. A setting of 0 means passthru data sent out over cellular will be in ASCII format; 1 will be in binary hexadecimal. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) sts 1000 0 0 2022 Sensata Technologies, Inc. All rights reserved. Page 86 | 194 XT6384-1 Product Manual 6.50. SYNCH TIME THRESHOLD (STT) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg stt <threshold>
Response
:OK Command
:rycfg stt <threshold>
Response
| stt: thresh:<threshold> (hex_val)
:OK Parameter threshold Range 3 to 255 Description If the current system time is more than +/-threshseconds different than the latest GPS sourced time, an automatic system time-sync will occur. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) stt 3 2022 Sensata Technologies, Inc. All rights reserved. Page 87 | 194 XT6384-1 Product Manual 6.51. TPSCONFIG VALUES (TCV) Configuration instances: 1 Command Type SET READ Parameter Destination_ Index Timeout Retries_value Discovery_time Syntax Command
:wycfg tcv <destination_index> <timeout> <retries_value> <discovery_time>
Response
:OK Command
:rycfg tcv Response
| tcv: index:<destination_index> (hex_val), seconds:<timeout> (hex_val), retries:<retries_value> (hex_val), distime:<discovery_time> (hex_val)
:OK Range 0 to 9 Description The index of the DST that is used to point to the server 1 to 4294967295
-1 to 32767 0 to 4294967295 The time (sec) that the device will wait for a reply from the server The number of times the device will try to reach the server again after a timeout before cancelling communications The minimum amount of time (sec) that the device accepts a successful discovery session. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) tcv 7 30 3 60 6.52. TESTER PRESENT MESSAGE (TPM) Command Type SET Syntax Command
:wycfg tpm <enable>
Response
:OK Command
:rycfg tpm Response
| tpm: en:0 (0x0) :OK READ 2022 Sensata Technologies, Inc. All rights reserved. Page 88 | 194 XT6384-1 Product Manual Parameter enable Range 0 to 1 Description Enables tester present message. Value 0 1 Description Disables OBDII tester present message Enables OBDII tester present message Target AAb1, AAb3, AAa4, AAb5 Default Value(s) tpm 0 6.53. TIMER DURATION (TMR) Configuration instances: 32 Command Type SET READ Syntax Command
:wycfg tmr[x] <Duration> <auto_start>
Response
:OK Command
:rycfg tmr[x]
Response
| tmr[x]: sec:<Duration> (hex_val), flags:<auto_start> (hex_val)
:OK Parameter Duration auto_start 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. Index 0 1 Description Disables autostart Enables autostart Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) tmr[x] 0 0 2022 Sensata Technologies, Inc. All rights reserved. Page 89 | 194 XT6384-1 Product Manual 6.54. THIRD-PARTY CONFIG VALUES (TPV) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg tpv <dst_index> <checkin_freq> <pid_list_1> <pid_list_2> <Flag_value>
Response
:OK Command
:rycfg tpv Response
| tpv: index:<dst_index> (hex_val), checkin:<checkin_freq> (hex_val), pidlst1:<pid_ list1>, pidlst2:<pid_list2>, flag:<Flag_value> (hex_val)
:OK Parameter dst_index checkin_freq Pid_list_1 Range 0 to 9 0 to 255 0x0 to 0xFFFFFFFF Description Destination config index that points to the Xirgo Gateway Server Time in hours for periodic check to gateway server Bit list for supported pids 1 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 Life (%) (ppid 2 0x75) TPMS LF (psi) (ppid 3 0x76) TPMS RF (psi) (ppid 4 0x77) TPMS LR (psi) (ppid 5 0x78) TPMS RR (psi) (ppid 6 0x8E) TPMS LRI (psi) (ppid 7 0x90) TPMS RRI (psi) (ppid 8 0x90) TPMS SPR (psi) (ppid 9 0x91) Seatbelt D (ascii) (ppid 10 0x92) Seatbelt P (ascii) (ppid 11 0x9c) Fuel Level (%) (0x5A) Airbag Lamp (ascii) (ppid 12 0x9d) PRNDL (ascii) (ppid 13 0x9e) Parking Brake State (ascii) (ppid 14 0x9F) Parking Brake Lamp (ascii) (ppid 15 0xA0) 0x000001 (reserved) 2022 Sensata Technologies, Inc. All rights reserved. Page 90 | 194 XT6384-1 Product Manual Parameter Pid_list_2 Flag Range 0x0 to 0xFFFFFFFF 0 to 255 Description Bit list for supported PIDs (32 to 32) <reserved>
Reserved Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) tpv 8 24 0x00 0x00 0 6.55. OBD TRANSMIT DELAY (TXD) Configuration instances: 2 Command Type SET READ Syntax Command
:wycfg txd[x] <value ms>
Response
:OK Command
:rycfg txd[x]
Response
| txd[x]: value:<value ms> (hex_val)
:OK Parameter value Description Instance txd[0]
txd[1]
Range 0 to 800 0 to 10800000 Description Message transmit delay. Value (ms) Start OBD communication after ignition on detect (for immobilizer issues). Value (ms) Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) txd[0] 0 txd[1] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 91 | 194 XT6384-1 Product Manual 6.56. VERSION INFO (VER) l ver[0] -> Script l ver[1] -> Paramset l ver[2] -> Overlay0 l ver[3] -> Overlay1 l ver[4] -> Overlay2 l ver[5] -> Overlay3 l ver[6] -> Overlay4 l ver[7] -> Tps Configuration instances: 8 Command Type SET READ Syntax Command
:wycfg ver[x] "<string>" <revision no> <flags_hex>
Response
:OK Command
:rycfg ver[x]
Response
|ver[x]: str:"<string>" rev:<revision no> (hex_val), flags:<flags_hex>
:OK Parameter string revision no. flags_hex Range N/A 0 to 4294967295 N/A Description ASCII name for a loaded item (31 characters) Assigned revision number for a loaded item Bitmask of error status values pertaining to loaded item Hex 0x01 0x02 0x04 0x40 0x80 Description Default Locally Modified Error Unused Unknown Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) ver[0] "~unknown" 0 128 ver[1] "default" 0 1 2022 Sensata Technologies, Inc. All rights reserved. Page 92 | 194 XT6384-1 Product Manual Target Default Value(s) ver[2] "~unused" 0 64 ver[3] "~unused" 0 64 ver[4] "~unused" 0 64 ver[5] "~unused" 0 64 ver[6] "~unused" 0 64 ver[7] "~unknown" 0 128 6.57. VIN (VIN) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg vin "<string>"
Response
:OK Command
:rycfg vin Response
| vin: str:"<string>"
:OK Parameter String Rates 17 char Description Set VIN for vehicles that do not support VIN or have an invalid VIN Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) VIN ""
2022 Sensata Technologies, Inc. All rights reserved. Page 93 | 194 XT6384-1 Product Manual 6.58. VARIABLE SAVE MASK (VSM) l vsm[0] > covers uservar8 0-15, uservar16 0-7, and uservar32 0-7 l vsm[1] > covers uservar8 16-32, uservar16 8-15, and uservar32 8-15 Configuration instances: 2 Command Type SET READ Syntax Command
:wycfg vsm[x] <32bit_mask>
Response
:OK Command
:rycfg vsm[x]
Response
| vsm[x]: mask:<32bit_mask>
:OK Parameter 32bit_mask Range 0 to 0xFFFFFFFF Description Bitmask value corresponding to which scriptable user variables are saved in persist data. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) vsm[0] 0 vsm[1] 0 2022 Sensata Technologies, Inc. All rights reserved. Page 94 | 194 XT6384-1 Product Manual 6.59. WAKE BATTERY VOLTAGE (WBV) Configuration instances: 1 Command Type SET READ Syntax Command
:wycfg wbv <millivolts>
Response
:OK Command
:rycfg wbv <millivolts>
Response
| wbv: wakemv:<millivolts> (hex_val)
:OK Parameter millivolts Range 10000 to 16000 Description Configures the voltage threshold at which the device will wake from sleep if exceeded. Target AAb1, AAb3, AAa4, AAb5, AAb6 Default Value(s) wbv 13200 2022 Sensata Technologies, Inc. All rights reserved. Page 95 | 194 XT6384-1 Product Manual 7. DEVICE MANAGER PROTOCOL 7.1. DEFINITIONS 7.1.1. ACK/NAK An ACK is used to signal that a command has been accepted. The ACK packet is an echo of the CMD packet's header with the Packet Type changed to ACK. A NAK is used any time a command cannot be accepted (due to improper command formatting, device busy, etc.). The NAK packet is an echo of the CMD packet's header with the Packet Type changed to NAK. 7.1.2. BROADCAST A broadcast packet type does not expect a RESP/ACK/NAK, it is used to notify or send data that has been requested. 7.1.3. SESSION REJECT A session reject message can be sent by the device at any time during a transaction to cancel the session. 7.2. DEVICE MANAGER PACKET Byte(s) 0 - 7 8 - N Description DM Header Packet-Specific Data 7.3. DEVICE MANAGER HEADER Byte(s) 0 - 1 2 - 3 4 - 7 Description Packet Info Session ID ESN 7.3.1. Device Manager Header: Packet Info Bit(s) 0 - 3 (LSB) 4 - 7 8 - 12 13 - 15 (MSB) Description Action/Info Code Content Type Content Index Packet Type 2022 Sensata Technologies, Inc. All rights reserved. Page 96 | 194 XT6384-1 Product Manual Packet Info Register View Bit Range/Type Action/Info Code: 0 -
15 Content Type: 0 - 15 Description Bit 0 1 2 3 4 5 6 7 8 9 10 11 Description SessionAvailable SessionOpen SessionClose QueryContent Query MultiBlockSetup MultiBlockSend MultiBlockResend BlockSend RunCMDLang (TBD) CheckInNow (TBD) SessionReject Bit 0 1 2 3 4 5 6 7 8 9 10 11 Description Bootloader Application Script ParamSet CheckIn Control TPS
Overlay CMDlang ThirdParty Embedded Application ThirdParty Data Content Index: 0 - 31 Describes the index of the active Content Type. l Overlays are the only content Type to have multiple instances so the content Index for an overlay could be 0, 1, 2, 3, or 4. l All other content types have Content Index = 0. Packet Type: 0 - 7 Bit 0 1 2 3 4 Description ACK NAK CMD RESP BROADCAST 2022 Sensata Technologies, Inc. All rights reserved. Page 97 | 194 XT6384-1 Product Manual Bit Range/Type Description Bit 5 6 7 Description N/A N/A N/A 2022 Sensata Technologies, Inc. All rights reserved. Page 98 | 194 XT6384-1 Product Manual 7.4. PACKET-SPECIFIC DATA 7.4.1. BROADCAST: Session Available Byte(s) 8 to 11 12 to 15 16 to 17 Description Content Mask: one but flipped for each content type in session Session IP(v4) Session port 7.4.2. CMD: Multi-block Setup Byte(s) 8 to 9 Description Multi-block size code: the size of the block sent is (Multi-block size code * 16). 7.4.3. CMD: Multi-block Send Byte(s) 8 to 9 10 Description Block-start index: the index of the binary block to start with in the next multi-block sub-session. Where 0 = binary bytes 0 through ((Multi-block size code *16)-1). Number of blocks: number of consecutive binary blocks to send starting with Block-
start index (Valid values 0-31). The actual number of blocks desired/sent is (Number of blocks +1). 7.4.4. CMD: Multi-block Resend Byte(s) 8 to 11 Description Resend Mask: Each bit from LSB to MSB represents on of the binary blocks missed in the most recent Multi-block sub-session. 7.4.5. CMD: Block Send Byte(s) 8 to 11 10 Description Offset: binary offset of active content. Size: binary size to send (Starting at offset). 2022 Sensata Technologies, Inc. All rights reserved. Page 99 | 194 XT6384-1 Product Manual 7.4.6. RESP: Query Content Byte(s) 8 to 11 Description Content Mask: Each bit from LSB to MSB represents one instance of available content
(32 possible). Example: if three overlays are available, content mask = 0x7 (0b111). 7.4.7. RESP: Query NOTE: Bytes 12-N are only used for Script/ParamSet/Overlays/TPS, NOT for BootLoader/Application/ThirdParty. Byte(s) 8 to 11 12 to 15 16 to N Description Size: size of available content Revision: unique revision number of available content. Version: zero-terminated ASCII string. 7.4.8. BROADCAST: Multi-block Send Byte(s) 8 to 9 10 11 to N Description Block-start index. Multi-block sub-session index (Value 0-31). Block: binary block of size (Multi-block size code * 16). 7.4.9. RESP: Block Send Byte(s) 8 to 11 12 to 15 16 to N Description Offset: binary offset of active content. Size: binary size to send (starting at offset). Block: binary block of size. 7.4.10. Example Device Manager Session This example device manager session shows updating an interpreter script. The script used is an "empty script"
which is quite useless on the device but works well for this example. The binary contents of "empty_script.bin" are as follows:
00 00 00 00 00 00 00 00 00 2022 Sensata Technologies, Inc. All rights reserved. Page 100 | 194 XT6384-1 Product Manual Found below are the messages exchanged in the device manager session:
Broadcast:SessionAvail 50 80 ef be 15 cd 5b 07 04 00 00 00 7e 3c f1 32 57 30
SessionOpen 51 40 ef be 15 cd 5b 07
Ack:SessionOpen 51 00 ef be 15 cd 5b 07
Query 24 40 ef be 15 cd 5b 07
Resp:Query 24 60 ef be 15 cd 5b 07 09 00 00 00 01 00 00 00 65 6d 70 74 79 5f 73 63 72 69 70 74 2e 62 69 6e 00
MultiBlockSetup 25 40 ef be 15 cd 5b 07 3f 00
Ack:MultiBlockSetup 25 00 ef be 15 cd 5b 07
BlockSend 28 40 ef be 15 cd 5b 07 00 00 00 00 09 00 00 00
Resp:BlockSend 28 60 ef be 15 cd 5b 07 00 00 00 00 09 00 00 00 00 00 00 00 00 00 00 00 00
2022 Sensata Technologies, Inc. All rights reserved. Page 101 | 194 XT6384-1 Product Manual SessionClose 52 80 ef be 15 cd 5b 07
7.5. DEVICE MANAGER CHECK-IN NOTE: all 2 to 4 byte items are little endian byte-order. 2022 Sensata Technologies, Inc. All rights reserved. Page 102 | 194 XT6384-1 Product Manual Bit(s) 0 7 8 9 N Description DM Header (see description above) Check-in Format Version Check-in Data 7.5.1. Check-in Data Byte(s) 9 10 - x x x - x x x x x x x x x x x x - x x x - x x x - x x x - x x x - x x x - x x x x x x - x Size 1 variable 1 variable 4 1 4 1 1 4 1 4 1 1 variable 1 variable 1 variable 1 variable 1 variable 1 variable 1 4 1 1 variable Format Version 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 2 3 3 4 4 Description Bootloader Version string size Bootloader Version string FW Version string size FW Version string Script Revision Number Script Flags ParamSet Revision Number ParamSet Flags Number of Used Overlays one of the section for each Used Overlay Overlay Revision Number Overlay Flags IP address (unsigned integer) cell type: 0=CDMA, 1=GSM if cell type == 0 (CDMA) MEID string size MEID string MDN string size MDN string if cell type == 1 (GSM) IMEI string size IMEI string MSISDN string size MSISDN string ICCID string size ICCID string Third Party Version string size Third Party Version string Check-In message info bitfield TPS File Revision Number TPS File Flags Cell Module Model string size Cell Module Model string 2022 Sensata Technologies, Inc. All rights reserved. Page 103 | 194 XT6384-1 Product Manual Byte(s) x x - x x x - x x Size 1 variable 1 variable 4 Format Version 4 4 5 5 5 Description Cell Module FW Version string size Cell Module FW Version string I/OBox FW version string size (XT2500 Only) I/OBox FW version string (XT2500 Only) I/OBox ESN (XT2500 Only) 7.5.2. Script/Parameter Set/Overlay Flags Hex 0x01 0x02 0x04 0x40 0x80 Description Default (Parameter Set ONLY) Locally Modified (Parameter Set ONLY) Error Unused (Overlays ONLY) Unknown (Script ONLY) 7.5.3. Check-in Message Info Bitfield Definitions Hex 0x01 0x02 0x04 0x08 0x10 0x20 0x40 0x80 Description Vehicle Comms active TPS transfer active N/A N/A N/A N/A N/A N/A 7.5.4. Check-in Message Changelog Rev 0 1 2 3 4 5 Description Initial Offering Stop truncating bootloader and main firmware revision strings Added check-in message info bitfield Added TPS file revision information Added cell module model and FWversion strings (JA1.1) Added I/O Box FWversion string and ESN(XT2500 Only) 2022 Sensata Technologies, Inc. All rights reserved. Page 104 | 194 XT6384-1 Product Manual 8. INTERPRETER 8.1. LANGUAGE 8.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. Byte-Code Characteristics Blocks Script Trigger Description Each Script Block can contain unlimited Trigger Blocks (limited only by memory reserved for byte code on device itself). Each Trigger Block has one Trigger Block Test. A test is usually made of one comparison, but the language also allows to use more than one comparison in which the test is true if ANY of the comparisons are true or if ALL the comparisons are true. A Trigger Block Test may contain up to 2 comparisons. Conditional Action NOTE: Each Trigger Block can contain unlimited Conditional Action Blocks. Each Conditional Action Block may optionally contain one Conditional Action Block Test. A Conditional Action Block Test may contain up to 5 comparisons (Using same any or all logic as described for Trigger Block Test). Action NOTE: Each Conditional Action Block must contain one Action Block. Each Action Block can contain 1 3 Actions How Trigger Block Tests Work Each Trigger Block is entered when the Trigger Block Test becomes true. The Trigger Block is not entered WHILE the test is true, only the moment it becomes true. Example: If you want to trigger actions when vehicle speed goes above 80 KPH:
trigger when Gt(GPSSpeed, 800) [Debounce(0, 0)]
... The interpreter will enter the trigger block the moment the vehicle speed increases above 80 KPH. It will not continue to enter the trigger block during subsequent evaluations where the speed remains above 80 KPH. Once the speed drops below 80 (for at least one evaluation), then the trigger block will be entered again next time the speed increases above 80 KPH. 2022 Sensata Technologies, Inc. All rights reserved. Page 105 | 194 XT6384-1 Product Manual NOTE: if the speed oscillates between 80.0 and 80.1 km/h 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. Continuing with the example above, lets say we want to further limit our actions to only execute the moment speed goes above 80 km/h AND the vehicle heading is within 10 degrees of North:
trigger when Gt(GPSSpeed, 800) [Debounce(0, 0)]
condact any InRange(GPSHeading, 3500, 3600) [Debounce(0, 0)]
InRange(GPSHeading, 0, 100) [Debounce(0, 0)]
actions
... 8.1.2. Compiling scripts with ILC 1. Type the script (as noted above) with your text editor and save as a text file with .txt file extension. 2. Recommended:Put both ilc.exe and your script <name>.txt in the same folder. 3. Start your preferred command line terminal (cmd.exe or powershell). 4. Change directory to the folder where your script is located. Example command prompt:
cd USERPROFILE\Documents\XT6300\Scriptsfor cmd.exe orcd env:USERPROFILE\Documents\XT6300\Scriptsfor powershell 5. Run ilc.exe from the command line:ilc.exe <name>.txt (If "Interpreter script format OK" appears at the end, your script was successfully compiled). Example Command Prompt 0x40 SMALL_CONST_VALUE (value: 0) TOK_NUMBER: 22 0x56 SMALL_CONST_VALUE (value: 22) TOK_NUMBER: 0 0x40 SMALL_CONST_VALUE (value: 0) 2022 Sensata Technologies, Inc. All rights reserved. Page 106 | 194 XT6384-1 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. 8.1.3. Upload and Run Scripts 1. Connect to the device using standard USB-to-Serial or USB-to-RS232 cabling. 2. Open the terminal emulator program (ZOC or similar) and connect to active COM port. 3. Ensure connectivity by issuing the command :qti. 4. Issue command to start script upload: :grscr x <port_index> whereport_indexis one of the following:
Index 0 1 2 Description USB Port RS232 1 RS232 2 5. Upload your script file (<name>.bin) using your terminal emulator program via Xmodem. NOTE: your compiled script must be less than 16 KBin order to be loaded onto the device. 2022 Sensata Technologies, Inc. All rights reserved. Page 107 | 194 XT6384-1 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 8.1.4. Interpreter Commands All language elements presented in this section are case sensitive. Definitions Keyword Comments Numbers Debounce Specify Definition Comments start with the pound (#) character and continue until the end of the line. Numbers can be specified in decimal (e.g., 0, 1, 100, 256, -359) or in hex when the value is non-negative (e.g., 0x0, 0x1, 0x64, 0x100) Debounce(<hi>, <lo>)- wherehiandloare specified in seconds (max 15). The 'Debounce Specify' element is only used following certain tests (see below). When a debounce is specified, it means that a test is true only AFTER the comparison is true forhiseconds and false AFTER the comparison is false forloseconds. NOTE: NOTE: A test debounce MUST be specified any time the first argument in the test is either a system value or a special function; its the script designers responsibility to input appropriate values for hi and lo. Keywords Keyword trigger condact when any all always Description Denotes the start of a Trigger Block Denotes the start of a conditional Action Block Denotes the start of a test when only one comparison is used Use when grouping multiple comparisons; test is true when ANY of the comparisons are true Use when grouping multiple comparisons; ALL comparisons must be true for test to be true Use when there are no tests for a Conditional Action Block. The actions inside a Conditional 2022 Sensata Technologies, Inc. All rights reserved. Page 108 | 194 XT6384-1 Product Manual Keyword actions run Description Action Block will ALWAYS run when the Trigger Block's test(s) are true. Denotes the start of an Action Block Denotes the start of a single Action Transforms Script Language BitNot(<a>) BitAnd(<a>, <b>) BitOr(<a>, <b>) BitXor(<a>, <b>) BitShift(<a>, <b>) Add(<a>, <b>) Subtract(<a>,
<b>) Multiply(<a>,
<b>) Description Bitwise NOT (one's compliment) of argumenta Bitwise AND of argumentsaandb Bitwise OR of argumentsaandb Bitwise XOR of argumentsaandb Shift the contents of argumentaby the value of argumentb; i.e., ifbis negative the shift is Left, and ifBis positive the shift is Right Arithmetic addition of argumentsaandb Arithmetic subtraction of argumentbfroma Arithmetic multiplication of argumentsaandb Tests Script Language InRange(<a>, <b>, <c>) NinRange(<a>, <b>, <c>) Eq(<a>, <b>) Neq(<a>, <b>) Gt(<a>, <b>) Lt(<a>, <b>) GtEq(<a>, <b>) LtEq(<a>, <b>) Description True when argumentais between argumentband argumentc(inclusive) True whenais less thanborais greater thanc;b must be less than a True whenaequalsb True whenais not equal tob True whenais greater thanb True whenais less thanb True whenais greater than/equal tob True whenais less than/equal tob Test items <a>, <b>, and <c> below should be one of the following:
l System Value l Event l Special Function l Numbers (constants) 2022 Sensata Technologies, Inc. All rights reserved. Page 109 | 194 XT6384-1 Product Manual System Values Script Language SystemVal(<index>) UnixTime GPSLat GPSLon GPSAlt GPSHeading GPSSpeed Inputs Outputs DriverId1 DriverId2 GSPTripOdom1 OdomDelta GPSHDOP GPSNumSats InternVoltage BattVoltage GPSLifetimeOdom GPSOdom MotionState EngineState OBDLifetimeOdom OdomDiff WakeReason ExtADC0 Events Description Pass the enumeration index of the desired System Value to be accessed (see Packet Recipe Fields for acceptable range) 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 to OutputStates packet field (ID: 0x0d) Maps directly to DriverIdCode1 packet field (ID: 0x0e) Maps directly to DriverIdCode2 packet field (ID: 0x0f) Maps directly to GpsTripOdom1 packet field (ID: 0x10) Maps directly to Hdop packet field (ID: 0x12) Maps directly to NumSats packet field (ID: 0x13) Maps directly to InternalBattVolts packet field (ID: 0x16) Maps directly to VehicleBattVolts_1byte packet field (ID: 0x17) GPSOdom Maps directly to GpsLifetimeOdom packet field (ID: 0x18) Maps directly to OBDRunStates packet field (ID: 0x2c) Maps directly to OBDCommsState packet field (ID: 0x2d) Maps directly to ObdLifetimeOdom packet field (ID: 0x2f) Maps directly to WakeReason packet field (ID: 0x53) (see Wake Reason Mask for mask definition) Maps directly to ExternADC0_1byte packet field (ID: 0x66) Script Language TimerExpired(<index>) Description Evaluates to 1 when timer is expired; otherwise 0 UserEventIsActive(<index>) Range: 0 to 31 Evaluates to 1 when a user event has been injected into interpreter;
otherwise 0.Use:xrmsg <index>to inject a message into interpreter. AccelEventIsActive(<index>) Range: 0 to 255 Evaluates to 1 when an accelerometer event is detected; otherwise 0 2022 Sensata Technologies, Inc. All rights reserved. Page 110 | 194 XT6384-1 Product Manual Script Language GarminResponseReceived
(<index>) Description Range: 0 to 7 Evaluates to 1 when a non-blacklisted Garmin response is received (and Garmin is active), otherwise 0 Range: 0 to 5 Value 0 1 2 3 4 5 Description Ack (or Nak) packet (only triggered when specified inSendGarminMsg()) Unit ID (a.k.a. Garmin ESN) response Product ID response Throttle Message response Ping response Generic response; any response that isn't listed above and isn't blacklisted GarminUserPayloadReceived(0) DriverIdRead(<index>) Evaluates to 1 when a payload (destined for garmin device) has been received; evaluates to 0 otherwise. This signals that a payload has been sent to the device by a user/server. Typically used to trigger aSendGarminMsg()action. Evaluates to 1 when driver id is detected on 1-wire channel <index>, otherwise 0 SystemEventIsActive(<index>) Range: 0 to 1 Evaluates to 1 when system event <index> is active, otherwise 0 Range: 0 to 20 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 Description Reset Wakeup BootloaderUpgrade (not implemented) FWUpgrade ScriptUpgrade ParamSetUpgrade OverlayUpgrade (not implemented) ManualConfigChange CellRegistrationChange IPChange SMSReceived SMSSendOK SMSSendFailure 2022 Sensata Technologies, Inc. All rights reserved. Page 111 | 194 XT6384-1 Product Manual Script Language ObdDtcEventIsActive(0) AccelCrashEventIsActive(0) BluetoothResponseReceived(0) TpsBlockCompleteEvent
(<index>) AuxPassthruPacketReceived(0) Description UDPReceived UDPSendOK UDPSendFailure PacketStorageEmpty PacketStorageFull PdpConnectionReset (not implemented) Device Powerup OTA Reject (not implemented) Description Value 13 14 15 16 17 18 19 20 Evaluates to 1 when an OBD DTC event is detected, otherwise 0. Evaluates to 1 when an accelerometer crash event is detected, otherwise 0. Evaluates to 1 when a bluetooth message is received, otherwise 0. (Only applicable to target AAb3) Evaluates to 1 when TPS block request on the vehicle bus has completed, otherwise 0. Description Primary Bus Secondary Bus Value 1 2 Evaluates to 1 when an aux passthru packet has been received, otherwise 0. Special Functions Script Language SystemVal(<packet field id>) Description Evaluates to value stored in packet field UserVar8(<index>) UserVar16(<index>) UserVar32(<index>) FlagIsSet(<index>) Packet field ID: See Packet Recipes for available IDs Evaluates to value stored in 8bit user variable Index range: 0 to 31 Evaluates to value stored in 16bit user variable Index range: 0 to 15 Evaluates to value stored in 32bit user variable Index Range: 0 to 15 Evaluates to 1 when flag is set, otherwise 0 Index Range: 0 to 31 2022 Sensata Technologies, Inc. All rights reserved. Page 112 | 194 XT6384-1 Product Manual Script Language GeofenceState(<index>) Description Index
-1 0 1 Description
<index> is not configured Outside fence Inside fence InputState(<index>) Index range: 0 to 49 Evaluates to 1 when input is high/when condition is true, otherwise 0 Index range 0 to 7:
Index 0 1 2 3 4 5 6 7 Description Ignition Input 1 Input 2 Input 3 Input 4 Vibration Detected (via Accel) Main supply power available Accelerometer reorientation validity SystemState(<index>) 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 Powered GPS Powered Garmin Powered Motion Via Accel Motion Via GPS External Power 2022 Sensata Technologies, Inc. All rights reserved. Page 113 | 194 XT6384-1 Product Manual Script Language Description GenericConfig(<index>) Evaluates to value stored in gcv[<index>] config parameters. PacketsPending(<index>) Index range: 0 to 63 Evaluates to number of unsent packets stored in the log NoAckRxRetryCount(0) DeviceResetReason(0) Description Normal Packet Space UDRPacket Space Index 0 1 Evaluates to number of retried failed ACK packets Evaluates to most recent device reset reason as defined by the microprocessor Resolution range: 0 to 9 Resolution 0 1 2 3 4 5 6 7 8 9 Description ResetCause_PowerApplied Main supply voltage connected to device ResetCause_LowPowerMode Reset caused by the micro Hibernation module
(not utilized) ResetCause_Watchdog Reset caused by the micro Watchdog module ResetCause_Software Reset caused by our device firmware ResetCause_User Main micro reset pin toggled (not utilized) ResetCause_BrownOut Reset caused by the micro BOR module ResetCause_SupplyMonitor Not implemented ResetCause_FactoryReset Reset caused by the micro Hardware System Service Request ResetCause_SystemError Not implemented ResetCause_Unknown Catch for any other micro reset source we have not defined TpsEcusRemaining(<default value>) Evaluates to TPS number of ECUs yet to be queried for the current Block ID Default value: 0 2022 Sensata Technologies, Inc. All rights reserved. Page 114 | 194 XT6384-1 Product Manual Script Language Description GetVarPktSize(<default value>) Evaluates to generated variable packet byte count, otherwise 0. Index 0x26 0xca 0x6f 0x6b 0x28 0x2a 0xc5 Description Garmin Packet Aux Passthru Packet Crash Packet Vehicle Bus DTC Packet Bluetooth Payload Packet Command Payload Packet TPSPayload AuxPassthruScratchpadSize(0) AuxPassthruScratchpadByte
(<index>) IPAddress(0) Evaluates to aux passthru scratchpad size (in bytes). Evaluates to the byte value at index of the aux passthru scratchpad. Device IP Address Actions Script Language ResetDevice() ResetModem() ResetGPS() TurnOffGPS() TurnOnGPS() SetUserVar(<type>,
<index>, <value>) Description N/A N/A N/A N/A N/A Type range: 0 to 2 Type 0 1 2 Description 8-bit variable 16-bit variable 32-bit variable Index range:
Index 0 to 31 0 to 15 0 to 15 Description 8-bit variables 16-bit variables 32-bit variables Value range:
Value
-128 to 127 Description 8-bit variables 2022 Sensata Technologies, Inc. All rights reserved. Page 115 | 194 XT6384-1 Product Manual Script Language Description Value
-32768 to 32767
-2147483648 to 2147483647 Description 16-bit variables 32-bit variables AdjustUserVar
(<type>, <index>,
<adjust_amount>) 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:
SetFlag(<flag_ index>) ClearFlag(<flag_ index>) StartTimer(<timer_ index>) StopTimer(<timer_ index>) ResetTimer(<timer_ index>) BuildAndSendMsg
(<packet_id>,
<reason_code>,
<destination_id>,
<ack>) Adjust Amount
-128 to 127
-32768 to 32767
-2147483648 to 2147483647 Description 8bit variables 16bit variables 32bit variables NOTE: user variables are 'clamped' at min and max. Meaning no matter the size of adjustment the value will never go lower than the minimum or higher than the maximum (it will not roll over). Index range: 0 to 31 Index range: 0 to 31 Index range: 0 to 31 Index range: 0 to 31 Index range: 0 to 31 Parameter Packet_id reason_code range Range 0 to 254 0 to 255 Description Should be an ID configured with :wycfg pcr[x]
Assigns the reason_code to the index in the script. Any reason_code less than 0 or greater than 255 will wrap. 2022 Sensata Technologies, Inc. All rights reserved. Page 116 | 194 XT6384-1 Product Manual Script Language Description Parameter destination_id range Ack range Ack table:
Range 0 1 2 Range 0 to 9 0 to 2 Description Should be one of the destinations configured with :wycfg dst[x] ... See Ack table below Description No acknowledgement needed Resend until acknowledged Priority packet: no storage, no acknowledgement ClearLog() EnterDeepSleep
(<wake_mask>,
<wake_minutes>) EnterSleep(<wake_ mask>, <wake_ minutes>
SetGarminPower
(<power_state>) See footnotes 1-3 below table. Erases any messages/packets stored in flash Set the wake reason mask Value (Hex) 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 Set the wake reason mask Wake Reason Input 0 (Ignition) transitioned high Input 1 transitioned high Input 2 transitioned high Input 3 transitioned high Input 4 transitioned high Configured sleep timeout expired Vibration detected Main supply voltage exceeds configured threshold value Main supply voltage fell below 6.0VDC (device unplugged) Value (Hex) 0x0000 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 power_state range: 0 1 Wake Reason SMS or UDP command received Input 0 (Ignition) transitioned high Input 1 transitioned high Input 2 transitioned high Input 3 transitioned high Input 4 transitioned high Configured sleep timeout expired Vibration detected Main supply voltage exceeds configured threshold value Main supply voltage fell below 6.0VDC (device unplugged) 2022 Sensata Technologies, Inc. All rights reserved. Page 117 | 194 XT6384-1 Product Manual Script Language Description Range 0 1 Description Off On SendGarminMsg
(<msg_id>, <flags>) Range 1 2 4 5 6 7 8 9 Description Unit ID Request (Garmin ESN Request) Product ID Request Ping FMI Enable Set Auto Arrival to defaults (30 sec, 100 meters) Disable Status Message Disable ETA Message Send user-defined payload (should be triggered with GarminUserPayloadReceived(0)) ClearTripOdom
(<odom_index>) Flags range: 0 to 1 Range 1 Description Save ACK/NAK Index range: 0 to 2 Range 0 1 2 Description GPSTripOdom1 GPSTripOdom2 ObdDerivedTripOdom SetOutput(<output_ index>) ClearOutput
(<output_index>) PulseOutput
(<output_index>,
<seconds_on>) Index range: 0 to 2 Index range: 0 to 2 Index range: 0 to 2 seconds_on range: 1 to 65535 FlashOutput
(<output_index>,
<blink_rate>) Index range: 0 to 2 Blink_rate range: 1 to 100 Hz 2022 Sensata Technologies, Inc. All rights reserved. Page 118 | 194 XT6384-1 Product Manual Script Language ClearDriverIds() ClearDriverID
(<index>) CheckInNow() SetInput(<input_ index>) ClearInput(<input_ index>) BuzzerPlay(<song_ index> <volume>
<loops>) BuzzerStop() ResetObdHarshAccel Cnt() ResetObdHarshBrak eCnt() BluetoothSendOk() TempSenseScan() TempSenseRead() ClearObdData
(<mask>) Description N/A
<index> of 0 or 1 N/A Input_index range: 0 to 3 If input state source is not configured to script, it is ignored Input_index range: 0 to 3 If input state source is not configured to script, it is ignored Song_index range: 0 to 9 Volume range: 0 to 100 Loops clamped to range: 0 to 255; 0 is continuous play N/A N/A N/A N/A N/A N/A Mask range: 0x00000000 to 0x0001FFFF Range 0x000001 0x000002 0x000004 0x000008 0x000010 0x000020 0x000040 0x000080 0x00FFFF 0x010000 0x020000 Description Clear engine run data (e.g. rpm, speed) Clear time data (e.g. engine hours, idle time) Clear level data (e.g. fuel level, fuel used) Clear distance data (e.g. ecu odometer) Clear temperature data (e.g. coolant temp, fuel temp) Clear pressure & load data (e.g. coolant pressure, eng torque) Clear fuel economy data (e.g. mpg) Clear violations data (e.g. harsh accel count) Clear all the above Clear persisted VIN Clear DTCs SaveDataToFlash() Force a save of persistent data to NVM. TpsLoadScratchpad
(<tag>) See footnote 4 below table. Load TPS scratchpad with the requested Tag data 2022 Sensata Technologies, Inc. All rights reserved. Page 119 | 194 XT6384-1 Product Manual Description Listen for traffic on vehicle bus for <timeout_s>
Request the given TPS block on the vehicle bus Load the Aux Passthru scratchpad with the most recently-received packet Put the cellular module to sleep Put the cellular module into listen mode Wake the cellular module up Put the bluetooth module to sleep Wake the bluetooth module NOTE: Cannot be called if Bluetooth is already awake. Trigger a TPS server sync Resets the harsh accel count on the GPS. Resets the harsh brake count on the GPS. Script Language VehicleBusListen
(<timeout_s>) TpsRequestBlock
(<block_id>) AuxPassthruScratchp adLoad() GsmSleep() GsmListen() GsmWake() BluetoothSleep() BluetoothWake() TpsSync() ResetGpsHarshAccel Cnt() ResetGpsHarshBrake Cnt() Actions Table Footnotes 1. BuildAndSendMsg example: using command:wycfg pcr[0] "01050104030708". The item index0inpcr
[0]is NOT thepacket_id. This should be considered theslot_id(of which there are only 128). Thepacket_ idin this example is the first hex byte of the hex string"01", meaningpacket_id= 1. The parameter set may be coordinated so the recipe for packet_idxis stored at slot_idx. However, this limits yourpacket_ idrange to 0 - 127. 2. BuildAndSendMsg Coordinated slot_id and packet_id examples:
l :wycfg pcr[0] "00050104020708"
l :wycfg pcr[1] "01050104020708"
l ... l :wycfg pcr[127] "7f050104020708"
3. BuildAndSendMsg recommendation: Due to the design of the entire XT6300 system, it is recommended customers donot exceed a message generation rate of one every five seconds for long durations (one 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. This command is intended to augment that. This command has a progressive spam filter that does not allow 2022 Sensata Technologies, Inc. All rights reserved. Page 120 | 194 XT6384-1 Product Manual the command to be executed in quick procession. The required time to wait between saves is one second, doubling with every proceeding save; it will not extend above 60 seconds. 60 seconds after the last successful save this is reduced back to 1 second. Calling this function while the spam filter is active does not perform the save. 8.1.5. Wake Reason Masks Script Language EnterDeepSleep
(<wake_mask>,
<wake_minutes>) EnterSleep(<wake_ mask>, <wake_ minutes>
Description Set the wake reason mask Value (Hex) 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 Set the wake reason mask Wake Reason Input 0 (Ignition) transitioned high Input 1 transitioned high Input 2 transitioned high Input 3 transitioned high Input 4 transitioned high Configured sleep timeout expired Vibration detected Main supply voltage exceeds configured threshold value Main supply voltage fell below 6.0VDC (device unplugged) Value (Hex) 0x0000 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 Wake Reason SMS or UDP command received Input 0 (Ignition) transitioned high Input 1 transitioned high Input 2 transitioned high Input 3 transitioned high Input 4 transitioned high Configured sleep timeout expired Vibration detected Main supply voltage exceeds configured threshold value Main supply voltage fell below 6.0VDC (device unplugged) 8.2. INTERPRETER SCRIPTING TRIGGER BLOCK EXAMPLES 8.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. trigger when Eq(TimerExpired(0), 1) condact when Eq(FlagIsSet(0), 1) [Debounce(0, 0)]
2022 Sensata Technologies, Inc. All rights reserved. Page 121 | 194 XT6384-1 Product Manual actions run BuildAndSendMsg(1, 0, 1, 0) run ClearFlag(0) condact when Neq(FlagIsSet(0), 1) [Debounce(5, 0)]
# NOTE: debounce Hi for 5 seconds, to keep these actions from executing due to
# the previous CondAct block clearing the flag. actions run BuildAndSendMsg(0, 0, 1, 0) run SetFlag(0) condact always actions run ResetTimer(0) 8.2.2. Build and Send Message A message is created and sent when you send a user event to the interpreter. The user event can be sent via
:xrmsg <index>. NOTE: see actions[] array in src/interpreter/interpreter.c to find valid action indices and number of arguments each action should take. trigger when Eq(UserEventIsActive(0xff), 1) condact always actions run BuildAndSendMsg(4, 32, 1, 0) 2022 Sensata Technologies, Inc. All rights reserved. Page 122 | 194 XT6384-1 Product Manual 8.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. BitAnd() then takes that value ANDed with its second argument of 0x02, which isolates the bit 1 position. When bit 1 of Fld_ObdRunStatus (PTO state) is high, the BitAnd() resolves to a 1. Neq() then takes that and compares it with its second argument of 0. When they dont equal each other, the trigger is executed. The Debounce in this example is disabled. trigger when Neq(BitAnd(SystemVal(0x2c), 0x02), 0) [Debounce(0, 0)]
condact always actions run SetFlag(3) 8.2.4. Boot Status Values Value 0 1 2 3 4 5 6 7 Boot Status Device can't boot (FW won't run; all 3 LEDs illuminated) FW Invalid/Faulty (FW reverted by loading Backup FW) Backup Image Invalid/Missing (current FW stored to Backup FW) Normal Boot FW Upgrade with Invalid/Faulty current FW and Invalid/Missing Backup FW(New FW loaded, New FW stored to BackupFW) FW Upgrade with Invalid/Faulty current FW (New FW loaded) FW Upgrade with Invalid/Missing Backup (current FW stored to Backup FW, New FW loaded) Normal FW Upgrade (current FW stored to Backup FW, New FW loaded) 8.2.5. Third Party Proprietary PID Recipe Slots Field OBDPidReserved1 OBDPidReserved2 OBDPidReserved3 OBDPidReserved4 OBDPidReserved5 Assigned Data Odometer Oil Life Percent LF Tire Pressure RF Tire Pressure LR Tire Pressure 2022 Sensata Technologies, Inc. All rights reserved. Page 123 | 194 XT6384-1 Product Manual Field OBDPidReserved6 OBDPidReserved7 OBDPidReserved8 OBDPidReserved9 OBDPidReserved10 OBDPidReserved11 OBDPidReserved12 OBDPidReserved13 OBDPidReserved14 OBDPidReserved15 Assigned Data RR Tire Pressure LR Tire Pressure RRI Tire Pressure SPARE Tire Pressure Driver Seatbelt Status Passenger Seatbelt Status Airbag Lamp PRNDL Parking Brake State Parking Brake Warning Lamp 2022 Sensata Technologies, Inc. All rights reserved. Page 124 | 194 XT6384-1 Product Manual 8.3. PACKET RECIPE 8.3.1. Fields ID 0x01 Name PacketID Description Packet recipes can be labeled from 0-255, but there are only 128 recipe slots Bytes 1 Units N/A Resolution 1 Range 0 to 255 0x02 FmCustomHeader value TBD (currently zero) Bytes 1 Units N/A Resolution 1 Range 0 to 255 0x03 DeviceId Unsigned integer representing numeric ESN Bytes 4 Units N/A Resolution 1 Range 100000000 to 999999999 0x04 ReasonCode Unsigned integer (any reason code < 0 or > 255 will wrap) Bytes 1 Units N/A Resolution 1 Range 0 to 255 0x05 PacketSerialNum Unsigned integer 0x06 UnixTime 0x07 Latitude Bytes 2 Units N/A Resolution 1 Range 0 to 65535 Unsigned integer representing number of seconds since Unix Epoch Bytes 4 Units N/A Resolution 1 Range 0x0 to 0xffffffff Signed integer decimal value of 4byte hex string divided by 1000000 (useful range -90.0 to 90.0) Bytes 4 Units Degrees Resolution 1.00E-06 Range
-2147.483648 2022 Sensata Technologies, Inc. All rights reserved. Page 125 | 194 XT6384-1 Product Manual ID Name 0x08 Longitude Description Bytes Units Resolution Range to 2147.483647 Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -180.0 to 180.0) Bytes 4 Units Degrees Resolution 1.00E-06 Range
-2147.483648 to 2147.483647 0x09 Altitude Signed integer Bytes 2 Units m Resolution 0.1 Range
-3276.8 to 3276.7 0x0a Heading Signed integer (useful range 0.0 to 360.0) Bytes 2 Units Degrees Resolution 1.00E-01 Range
-3276.8 to 3276.7 0x0b GpsSpeed Unsigned integer Bytes 1 Units km/h Resolution 1 Range 0 to 255 0x0c InputStates SeeInput State Bits table. Bytes 1 Units N/A Resolution 1 Range 0x00 to 0xff 0x0d OutputStates Bitfield: seeOutput State bitstable. Bytes 1 Units N/A Resolution 1 Range 0x00 to 0x1f 0x0e DriverIdCode1 Unsigned integer representing unique iButton ID Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 2022 Sensata Technologies, Inc. All rights reserved. Page 126 | 194 XT6384-1 Product Manual ID Name Description 0x0f DriverIdCode2 Unsigned integer representing unique iButton ID Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x10 GSPTripOdom1 SeeOdometer DetailsTable. 0x11 Flags Bytes 4 Units m Resolution 1 Range 0 to 4294967295 Bitfield Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x12 Hdop Unsigned integer 0x13 NumSats Bytes 1 Bytes 1 Units DOP Units N/A Resolution 0.1 Range 0.0 to 25.5 Resolution 1 Range 0 to 255 0x14 ReceiverSigStr SeeSignal Quality MeasureTable. 0x15 CellularCarrierId Bytes 2 Bytes 2 Units dBm Units N/A Resolution 1.23 Range
-113 to -75 Resolution 1 Range 0x0 to 0xffff 0x16 InternalBattVolts Possibly using a 2-byte unsigned integer representing mV (0 to 65535) Bytes 1 Units V Resolution 0.1 Range 0.0 to 25.5 0x17 VehicleBattVolts_1byte If value is greater than 25.5v, it will cap at 25.5v 2022 Sensata Technologies, Inc. All rights reserved. Page 127 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units V Resolution 0.1 Range 0.0 to 25.5 0x18 GpsLifetimeOdom Unsigned integer; seeOdometer DetailsTable. Bytes 4 Units m Resolution 1 Range 0 to 4294967295 0x19 AccelStartDateTime Unsigned integer representing time from Unix Epoch (s) Bytes 4 Units N/A Resolution 1 Range 0x0 to 0xffffffff 0x1a AccelStartLat 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.483647 0x1b AccelStartLong Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -180.0 to 180.0) 0x1c AccelStartSpeed 0x1d AccelStartHeading 0x1e MaxAccel 0x1f AccelEventDuration Bytes 4 Units Degrees Resolution 1.00E-06 Range
-2147.483648 to 2147.483647 Bytes 1 Bytes 2 Bytes 2 Bytes 1 Units km/h Resolution 1 Range 0 to 255 Units Degrees Resolution 0.1 Range 0 to 3599 Units mG Resolution 1 Range 0 to 32767 Units Seconds Resolution 0.1 Range 0 to 255 2022 Sensata Technologies, Inc. All rights reserved. Page 128 | 194 XT6384-1 Product Manual ID Name Description 0x20 AccelEndDateTime Unsigned integer representing time from Unix Epoch (s) Bytes 4 Units N/A Resolution 1 Range 0x0 to 0xffffffff 0x21 AccelEndLat 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.483647 0x22 AccelEndLong Signed integer decimal value of 4-byte hex string divided by 1000000 (useful range -180.0 to 180.0) Bytes 4 Units Degrees Resolution 1.00E-06 Range
-2147.483648 to 2147.483647 0x23 AccelEndSpeed 0x24 AccelEndHeading Bytes 1 Bytes 2 Units km/h Resolution 1 Range 0 to 255 Units Degrees Resolution 0.1 Range 0 to 3599 0x25 0x26 Not implemented GarminPacketSize Available for future use Size of entire Garmin packet (includes
<DLE><pid><size><payload><sum><DLE><ETX> and DLE stuffing) Bytes 2 Units N/A Resolution N/A Range 6 to 516 0x27 GarminPacket Garmin Packet bytes:
<DLE><pid><size><payload><sum><DLE><ETX> and DLE stuffing Bytes Variable Units N/A Resolution N/A Range N/A 0x28 BluetoothPayloadSize *
Unsigned integer 2022 Sensata Technologies, Inc. All rights reserved. Page 129 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units N/A Resolution N/A Range N/A 0x29 BluetoothPayload *
Bytes Bytes Variable Units N/A Resolution N/A 0x2a CommandPayloadSize *
Bytes 2 Units N/A Resolution N/A 0x2b CommandPayload *
Bytes Variable Units N/A Resolution N/A 0x2c OBDRunStates Bitfield; seeOBD Run States Bits Table Range N/A Range N/A Range N/A Bytes 1 Units N/A Resolution N/A Range 0 to 7 0x2d OBDCommsState SeeOBD Comms State Table Bytes 1 Units N/A Resolution N/A Range 0 to 3 0x2e ObdDerivedTripOdom Unsigned integer; seeOdometer Details Table Bytes 4 Units m Resolution 1 Range 0 to 4294967295 0x2f ObdLifetimeOdom Unsigned integer; seeOdometer Details Table 0x30 TempSensor0 Bytes 4 Bytes 1 Units m Resolution 1 Range 0 to 4294967295 Units N/A Resolution N/A Range N/A 2022 Sensata Technologies, Inc. All rights reserved. Page 130 | 194 XT6384-1 Product Manual ID 0x31 Name TempSensor1 Description Bytes 1 Units N/A Resolution N/A Range N/A 0x32 UserVar8[0]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x33 UserVar8[1]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x34 UserVar8[2]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x35 UserVar8[3]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x36 UserVar8[4]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x37 UserVar8[5]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x38 UserVar8[6]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x39 UserVar8[7]
8-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 131 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x3a UserVar8[8]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x3b UserVar8[9]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x3c UserVar8[10]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x3d UserVar8[11]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x3e UserVar8[12]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x3f UserVar8[13]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x40 UserVar8[14]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x41 UserVar8[15]
8-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 132 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0x42 UserVar16[0]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x43 UserVar16[1]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x44 UserVar16[2]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x45 UserVar16[3]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x46 UserVar16[4]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x47 UserVar16[5]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x48 UserVar16[6]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x49 UserVar16[7]
16-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 133 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0x4a UserVar32[0]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0x4b UserVar32[1]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0x4c UserVar32[2]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0x4d UserVar32[3]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0x4e UserVar32[4]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0x4f UserVar32[5]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0x50 UserVar32[6]
32-bit signed integer Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 2022 Sensata Technologies, Inc. All rights reserved. Page 134 | 194 XT6384-1 Product Manual ID Name Description Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 0x51 UserVar32[7]
32-bit signed integer Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 0x52 SystemStates Bitfield; seeSystem State BitsTable Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x53 WakeReason Hex byte value; seeWake Reason ValuesTable Bytes 1 Units N/A Resolution 1 Range 0 to 255 0x54 ObdTrueOdometer 32-bit unsigned integer; seeOdometer DetailsTable Bytes 4 Units m Resolution 1 Range 0 to 858993459 0x55 ObdTotFuelUsed 32-bit unsigned integer Bytes 4 Units liters Resolution 1 Range 0 to 4294967295 0x56 ObdTotEngHours 32-bit unsigned integer Bytes 4 Units hours Resolution 1 Range 0 to 4294967295 0x57 ObdVehicleSpeed 16-bit unsigned integer Bytes 2 Units km/h Resolution 0.1 Range 0 to 2550 2022 Sensata Technologies, Inc. All rights reserved. Page 135 | 194 XT6384-1 Product Manual ID 0x58 Name ObdEngRpm Description 16-bit unsigned integer Bytes 2 Units rpm Resolution 1 Range 0 to 65535 0x59 ObdEngCoolantTemp 16-bit signed integer Bytes 2 Units Celsius Resolution 1 Range
-40 to 215 0x5a ObdFuelLevelPct 16-bit unsigned integer Bytes 2 Units
Resolution 0.1 Range 0 to 1000 0x5b ObdTotDrivingSec 32-bit unsigned integer Bytes 4 Units s Resolution 1 Range 0 to 4294967295 0x5c ObdTotCruiseSec 32-bit unsigned integer Bytes 4 Units s Resolution 1 Range 0 to 4294967295 0x5d ObdTotIdleSec 32-bit unsigned integer Bytes 4 Units s Resolution 1 Range 0 to 4294967295 0x5e ObdTotIdleFuel 32-bit unsigned integer Bytes 4 Units liters Resolution 1 Range 0 to 4294967295 0x5f ObdHarshBreakTotCnt 32-bit unsigned integer Bytes 4 Units Resolution 1 Range 0 to 4294967295 2022 Sensata Technologies, Inc. All rights reserved. Page 136 | 194 XT6384-1 Product Manual ID 0x60 Name ObdSpeedExceedTotCnt Description 32-bit unsigned integer Bytes 4 Units Resolution 1 Range 0 to 4294967295 0x61 ObdRPMExceedTotCnt 32-bit unsigned integer Bytes 4 Units Resolution 1 Range 0 to 4294967295 0x62 ObdHarshAccelTotCnt 32-bit unsigned integer Bytes 4 Units Resolution 1 Range 0 to 4294967295 0x63 IgnSource See Ignition Sense (ign) on p. 61 NOTE: Does not include 0x8000 (ANDMODEbit) Bytes 2 Units N/A Resolution N/A Range 0x0000 to 0xffff 0x64 BluetoothName *
0x65 ObdVIN Bytes 1 Bytes 17 Units N/A Units ascii Resolution N/A Resolution N/A Range N/A Range N/A 0x66 ExternADC0_1byte Value caps at 25.5v 0x67 Reserved *
Bytes 1 Bytes N/A Units v Units N/A Resolution 0.1 Range 0.0 to 25.5 Resolution N/A Range N/A 2022 Sensata Technologies, Inc. All rights reserved. Page 137 | 194 XT6384-1 Product Manual ID 0x68 Name Accel Metrics Description Rounded to nearest whole number Bytes 4 Units N/A Resolution N/A Range N/A 0x69 Boot Status 8-bit unsigned integer; seeBoot Status ValuesTable Bytes 1 Units N/A Resolution 1 Range 0 to 7 0x6a Apn Index 8-bit unsigned integer Bytes 1 Units N/A Resolution 1 Range 0 to 3 0x6b ObdDtcPacketSize See DTC Packet Parsing on p. 156 for more information. Bytes 2 Units N/A Resolution N/A Range N/A 0x6c ObdDtcPacket See DTC Packet Parsing on p. 156 for more information. Bytes Variable Units N/A Resolution N/A Range N/A 0x6d ObdBackoff SeeOBD Backoff ModeTable 0x6e ObdProtocols Bytes 1 Units N/A Resolution N/A Range 0 to 3 SeeOBD Protocol Table, Secondary protocol in MS word, Primary protocol in LS word. e.g. secondary J1708 + primary J1939 =
(0x00400100) Bytes 4 Units Hex Resolution N/A Range N/A 0x6f CrashPacketSize Unsigned integer Bytes 2 Units N/A Resolution N/A Range N/A 2022 Sensata Technologies, Inc. All rights reserved. Page 138 | 194 XT6384-1 Product Manual ID Name Description 0x70 CrashPacket A collection of configurable historical reoriented basic accelerometer vectors structured in little Endian 2 byte values as x, y, z in milli-G's Bytes Variable Units N/A Resolution N/A Range N/A 0x71 ObdTotPTOTime 32-bit unsigned integer Bytes 4 Units seconds Resolution 1 Range 0 to 4294967295 0x72 ObdTotPTOFuel 32-bit unsigned integer 0x73 FwRev Bytes 4 Units liters Resolution 1 Range 0 to 4294967295 16-byte null-terminated ascii string. Version string cuts off the first 9 bytes, so "AAb1-1133KB1.1-3c74751" would report as
"KB1.1-3c74751". Bytes 16 Units ascii Resolution N/A Range N/A 0x74 OBDPidReserved1 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x75 OBDPidReserved2 Signed integer decimal value of 4byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x76 OBDPidReserved3 Signed integer decimal value of 4byte hex string divided by 10 2022 Sensata Technologies, Inc. All rights reserved. Page 139 | 194 XT6384-1 Product Manual ID Name Description Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x77 OBDPidReserved4 Signed integer decimal value of 4byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x78 OBDPidReserved5 Signed integer decimal value of 4byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x79 ObdTransGear 16-bit unsigned integer Bytes 2 Units 0,1,2,3 Resolution 1 Range 0=neutral 1=forward 2=reverse 3=park 0x7A ObdFuelTemp 16-bit signed integer Bytes 2 Units Celsius Resolution 1 Range
-40 to 215 0x7B ObdOilTemp 16-bit signed integer Bytes 2 Units Celsius Resolution 1 Range
-40 to 215 0x7C ObdThottlePos 16-bit unsigned integer Bytes 2 Units
Resolution 1 Range 0 to 100 0x7D ObdMPG 16-bit unsigned integer 2022 Sensata Technologies, Inc. All rights reserved. Page 140 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units mpg Resolution 0.1 Range 0.0 to 256.0 0x7E ObdAccelPos 16-bit unsigned integer Bytes 2 Units
Resolution 1 Range 0 to 100 0x7F ObdEngLoad 16-bit unsigned integer Bytes 2 Units
Resolution 1 Range 0 to 250 0x80 ObdEngTorque 16-bit signed integer Bytes 2 Units
Resolution 1 Range
-125 to 125 0x81 ObdOilLevel 16-bit unsigned integer Bytes 2 Units
Resolution 1 Range 0 to 100 0x82 ObdOilPressure 16-bit unsigned integer Bytes 2 Units kPa Resolution 1 Range 0 to 100 0x83 ObdCoolantPressure 16-bit unsigned integer Bytes 2 Units kPa Resolution 1 Range 0 to 100 0x84 ObdIntakeAirTemp 16-bit signed integer Bytes 2 Units Celsius Resolution 1 Range
-40 to 215 0x85 ObdManifoldTemp 16-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 141 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units Celsius Resolution 1 Range
-40 to 215 0x86 ObdCoolantLevel 16-bit unsigned integer Bytes 2 Units
Resolution 1 Range 0 to 100 0x87 LinkageVer 32-bit unsigned integer; seeLinkage VersionTable Bytes 4 Units N/A Resolution 1 Range 0x0 to 0xffffffff 0x88 GSPTripOdom2 SeeOdometer DetailsTable Bytes 4 Units m Resolution 1 Range 0 to 4294967295 0x89 GenCfgVal0 Generic Configuration Value set via paramset Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x8a GenCfgVal1 Generic Configuration Value set via paramset Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x8b GenCfgVal2 Generic Configuration Value set via paramset Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x8c GenCfgVal3 Generic Configuration Value set via paramset Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x8d GenCfgVal4 Generic Configuration Value set via paramset 2022 Sensata Technologies, Inc. All rights reserved. Page 142 | 194 XT6384-1 Product Manual ID Name Description Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0x8e OBDPidReserved6 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x8f OBDPidReserved7 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x90 OBDPidReserved8 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x91 OBDPidReserved9 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x92 OBDPidReserved10 Signed integer decimal value of 4-byte hex string divided by 10 Bytes 4 Units N/A Resolution 0.1 Range
-2147483648 to 2147483647 0x93 OBDHarshAccelValue Unsigned integer decimal value of acceleration in mph/second Bytes 1 Units Mph/s Resolution 1 Range 0 to 255 0x94 OBDHarshBrakeValue Unsigned integer decimal value of deceleration in mph/second 2022 Sensata Technologies, Inc. All rights reserved. Page 143 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units Mph/s Resolution 1 Range 0 to 255 0x95 CellSerialId 24-byte null-terminated ascii string Bytes 24 Units ascii Resolution N/A Range N/A 0x96 PktChkSum Check sum for the packet, calculated so all bytes sum to 0x00 Bytes 1 Units N/A Resolution N/A Range N/A 0x97 TPSFields0 Inclusion of a configured length variable content section defined by the corresponding pct config entry 0x98 TPSFields1 0x99 TPSFields2 0x9a TPSFields3 Bytes variable Units N/A Resolution N/A Range N/A Inclusion of a configured length variable content sectiondefinedby the corresponding pct config entry Bytes variable Units N/A Resolution N/A Range N/A Inclusion of a configured length variable content sectiondefinedby the corresponding pct config entry Bytes variable Units N/A Resolution N/A Range N/A Inclusion of a configured length variable content sectiondefinedby the corresponding pct config entry Bytes variable Units N/A Resolution N/A Range N/A 0x9b TPSFields4 Inclusion of a configured length variable content sectiondefinedby the corresponding pct config entry 2022 Sensata Technologies, Inc. All rights reserved. Page 144 | 194 XT6384-1 Product Manual ID Name Description Bytes variable Units N/A Resolution N/A Range N/A 0x9c OBDPidReserved11 4-byte ascii normalization of the vehicle response Bytes 4 Units ascii Resolution N/A Range N/A 0x9d OBDPidReserved12 4-byte ascii normalization of the vehicle response Bytes 4 Units ascii Resolution N/A Range N/A 0x9e OBDPidReserved13 4-byte ascii normalization of the vehicle response Bytes 4 Units ascii Resolution N/A Range N/A 0x9f OBDPidReserved14 4-byte ascii normalization of the vehicle response Bytes 4 Units ascii Resolution N/A Range N/A 0xa0 OBDPidReserved15 4-byte ascii normalization of the vehicle response Bytes 4 Units ascii Resolution N/A Range N/A 0xa1 Debug-PacketSize Unsigned integer 0xa2 DebugPacket Bytes 2 Units N/A Resolution N/A Range N/A Payload Bytes variable Units N/A Resolution N/A Range N/A 0xa3 UserVar8[16]
8-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 145 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xa4 UserVar8[17]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xa5 UserVar8[18]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xa6 UserVar8[19]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xa7 UserVar8[20]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xa8 UserVar8[21]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xa9 UserVar8[22]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xaa UserVar8[23]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xab UserVar8[24]
8-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 146 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xac UserVar8[25]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xad UserVar8[26]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xae UserVar8[27]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xaf UserVar8[28]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xb0 UserVar8[29]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xb1 UserVar8[30]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xb2 UserVar8[31]
8-bit signed integer Bytes 1 Units N/A Resolution 1 Range
-128 to 127 0xb3 UserVar16[8]
16-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 147 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xb4 UserVar16[9]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xb5 UserVar16[10]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xb6 UserVar16[11]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xb7 UserVar16[12]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xb8 UserVar16[13]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xb9 UserVar16[14]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xba UserVar16[15]
16-bit signed integer Bytes 2 Units N/A Resolution 1 Range
-32768 to 32767 0xbb UserVar32[8]
32-bit signed integer 2022 Sensata Technologies, Inc. All rights reserved. Page 148 | 194 XT6384-1 Product Manual ID Name Description Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 0xbc UserVar32[9]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0xbd UserVar32[10]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0xbe UserVar32[11]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0xbf UserVar32[12]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0xc0 UserVar32[13]
32-bit signed integer Bytes 4 Units N/A Resolution 1 0xc1 UserVar32[14]
32-bit signed integer Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 Range
-2147483648 to 2147483647 2022 Sensata Technologies, Inc. All rights reserved. Page 149 | 194 XT6384-1 Product Manual ID 0xc2 Name UserVar32[15]
Description 32-bit signed integer Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 0xc3 OBD Start Reason 16-bit signed integer; see OBD Trip Start Reason (bit mask)table below Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 0xc4 OBD End Reason 32-bit signed integer; seeOBD Trip End Reason (bit mask) table below Bytes 4 Units N/A Resolution 1 Range
-2147483648 to 2147483647 0xc5 TpsTagPayloadSize Unsigned integer Bytes 2 Units N/A Resolution 1 Range N/A 0xc6 TpsTagPayload Payload Bytes variable Units N/A Resolution N/A 0xc7 OBD Seat Belt Status Bytes 1 Units N/A Resolution N/A Range N/A Range N/A 0xc8 VehicleBattery_2byte 2-byte representation of vehicle battery voltage Bytes 2 Units V Resolution 0.1 Range 0.0 to 6553.5 0xc9 ExtAdc[0]_2byte 2-byte representation of external ADC[0] voltage 2022 Sensata Technologies, Inc. All rights reserved. Page 150 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units V Resolution 0.1 Range 0.0 to 6553.5 0xca AuxPassthruPacketSize Size of entire aux passthru packet Bytes 2 Units N/A Resolution 1 Range 1 to 256 0xcb AuxPassthruPacket Bytes variable Units N/A Resolution N/A Range N/A 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. Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0xcd Geofence States Bitfield 2 Bitfield representing current state of active geofences 32 to 49, where 1 is inside, and 0 is outside or inactive. Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0xce Script version Version number of currently loaded script Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0xcf Paramset version Version number of currently loaded paramset Bytes 4 Units N/A Resolution 1 Range 0 to 4294967295 0xd0 Cell ICCID Cellular ICCID string Bytes 21 Units ascii Resolution N/A Range N/A 0xd1 Cell MDN Cellular MDN string 2022 Sensata Technologies, Inc. All rights reserved. Page 151 | 194 XT6384-1 Product Manual ID Name Description Bytes 20 Units ascii Resolution N/A Range N/A 0xd2 OBD debug packet size Unsigned integer Bytes 2 Units N/A Resolution 1 0xd3 OBD debug packet Bytes variable Units N/A Resolution N/A Range N/A Range N/A 0xd4 Cell Access Technology Cell Access Technology values Bytes 1 Units N/A Resolution N/A Range 0 to 7,255 Value 0 1 2 3 4 5 6 7 255 Derived engine seconds GSM GSMCompact UTRAN GSM w/EGPRS UTRAN w/HSDPA UTRAN w/HSUPA UTRANw/HSDPA and HSUPA E-UTRAN Invalid Bytes 4 Units seconds Resolution 1 0xd5 Derived Engine Seconds 0xd6 ECU Engine Seconds ECU engine seconds Bytes 4 Units seconds Resolution 1 Range 0 to 4294967295 Range 0 to 4294967295 0xd7 InputActiveStates Same as the Input States bitfield, only the reported states are determined by the IDP config settings (seeInput State Bits table) 2022 Sensata Technologies, Inc. All rights reserved. Page 152 | 194 XT6384-1 Product Manual ID Name Description Bytes 1 Units N/A Resolution 1 Range 0x0 to 0xff 0xd8 CellularEnvironment Each byte represents a different value MSB
[CSQ]
[RSRP]
[RSRQ]
LSB
[CINR]
CINR is not currently implemented (always 0xFF). RSRP & RSRQ are always 0xFF for modules that do not support AT+CESQ. Bytes 4 Units Varies Resolution 1 Range 0 to 0xff (within each byte) 0xd9 OBDHarshAccelValue Unsigned integer decimal value of acceleration in km/second Bytes 2 Units km/s Resolution 0.1 Range 0.0 to 6553.5 0xda OBDHarshBrakeValue Unsigned integer decimal value of deceleration in km/second Bytes 2 Units km/s Resolution 0.1 Range 0.0 to 6553.5 0xdb Cell Mobile Country Code Cell module country-dependent code Bytes 2 Units Resolution 1 Range 0.0 to 65535 0xdc Cell model/version strings Cell model string concatenated with cell module fw version string Bytes 58 Units ascii Resolution Range 0xdd GPSSpeed (high-
resolution) Unsigned integer. Greater range equals higher accuracy. Bytes 2 Units kph Resolution 0.01 Range 0.00 to 655.35 2022 Sensata Technologies, Inc. All rights reserved. Page 153 | 194 XT6384-1 Product Manual ID Name Description 0xde OBD MPG 5 second average Averaging synchronized with OBD derived lifetime odometer timing. 0xdf GPS Harsh Accel Violations Cnt 0xe0 GPS Harsh Accel Value 0xe1 GPS Harsh Decel Violations Cnt 0xe2 GPS Harsh Decel Value 0xe3 OBD to Fuel Used HR Bytes 2 Bytes 4 Bytes 2 Bytes 4 Units mpg Resolution 0.1 Range 0.0 to 256.0 Units Units kph/s Units Resolution 1 Range 0 to 4294967295 Resolution 0.01 Range 0.00 to 655.35 Resolution 1 Range 0 to 4294967295 Resolution Bytes 0.01 2 High resolution total fuel used. Units kph/s Bytes 4 Units liters/bit Resolution 0.5 Range 0.00 to 655.35 Range 0 to 4294967295 0xe8 ObdDieselExhaustVolume Ratio of volume of diesel exhaust fluid to the total volume of diesel exhaust fluid storage container for aftertreatment system 1
(exhaust bank 1). 0% is empty and 100% is full. Bytes 1 Units
Resolution 0.4 Range 0 to 100 0xe9 ObdDieselExhaustLow Least Significant Bit is not used. See "Diesel Exhaust Fluid Tank Low Level States" below. Bytes 1 Units N/A Resolution 1 Range 0 to 7 0xea Upper bytes of DriverId2 Unsigned integer represent of the upper two bytes of unique six byte iButton ID. 2022 Sensata Technologies, Inc. All rights reserved. Page 154 | 194 XT6384-1 Product Manual ID Name Description Bytes 2 Units N/A Resolution 1 Range 0 to 65535 0xeb Upper bytes of DriverId2 Unigned integer represent of the upper two bytes of unique six byte iButton ID. Bytes 2 Units N/A Resolution 1 Range 0 to 65535 2022 Sensata Technologies, Inc. All rights reserved. Page 155 | 194 XT6384-1 Product Manual 8.4. DTC PACKET PARSING DTC data is reported via two PCR fields: ObdDtcPacketSize (0x6b) and ObdDtcPacket (0x6c). DTC data can be included in any of the messages sent to the backend and it must include both fields. ObdDtcPacketSize is a two byte field containing the size of the DTC data packet. The size is the total number of bytes of DTC data in ObdDtcPacket. ObdDtcPacket is a variable size packet containing the DTC data. The DTC data format is as follows:
<mil_status><num_ecu_dtc><ecu_id_0><num_dtc_0><ascii_0><dtc_code_0><fmi_ 0>...<ascii_n><dtc_code_n><fmi_n>... <ecu_id_m><num_dtc_0><ascii_0><dtc_code_ 0><fmi_0>...<ascii_n><dtc_code_n><fmi_n>
Field
<mil_ status>
<num_ ecu_dtc>
<ecu_id_x>
<num_dtc_ x>
<ascii_x>
<dtc_ code_x>
<fmi_0>
8.4.1. OBDII Field
<ascii_x>
<dtc_code_x>
<fmi_0>
8.4.2. J1939 Field
<ascii_x>
<dtc_code_x>
<fmi_0>
Size 1 Description MIL/Lamp status data 1 1 1 1 4 1 Number of ECUs reporting DTCs ECU ID Number of DTCs reported by ECU DTC ASCII code. One character code indicating the type of system that experienced the failure (e.g. 'P', 'U', etc.) DTC code Failure mode information Description P', C, B, 'U or ' '
DTC 0 Description
'0'
DTC FMI reported by ECU 2022 Sensata Technologies, Inc. All rights reserved. Page 156 | 194 XT6384-1 Product Manual 8.4.3. J1708 Field
<ascii_x>
<dtc_code_x>
<fmi_0>
Description
'S' or 0'
DTC FMI reported by ECU 8.4.4. Examples Vehicle rporting no DTCs, MIL off:
ObdDtcPacketSize: 0002 ObdDtcPacket: 0000
<mil_status> - MIL off
<num_ecu_dtc> - 0 ECUs reporting DTCs Vehicle reporting two DTCs on ECU 7E8 and one DTC on ECU 7E9, MIL on:
ObdDtcPacketSize: 0018 (24 bytes) ObdDtcPacket: 8002E802500000010100500000010200E901550000100000
<mil_status> - 80 (MIL on)
<num_ecu_dtc> - 2 (2 ECUs reporting DTCs)
<ecu_id_0> - E8 (ECU 7E8)
<num_dtc_0> - 2 (2 DTCs)
<ascii_0> - 50 ('P')
<dtc_code_0> - 00000101 (code P0101)
<fmi_0> - 00
<ascii_1> - 50 ('P')
<dtc_code_1> - 00000102 (code P0102)
<fmi_1> - 00
<ecu_id_1> - E9 (ECU 7E9)
<num_dtc_1> - 1 (1 DTCs)
<ascii_0> - 55 ('U')
<dtc_code_0> - 00001000 (code U1000)
<fmi_0> - 00 2022 Sensata Technologies, Inc. All rights reserved. Page 157 | 194 XT6384-1 Product Manual Heavy-duty Vehicle reporting one DTC (J1939), Amber Warning Lamp on ObdDtcPacketSize: 000A (10 bytes) ObdDtcPacket: 2001330130000003A10C
<mil_status> - 20 (Amber Warning Lamp on)
<num_ecu_dtc> - 1 (1 ECU reporting DTC)
<ecu_id_0> - 33 (ECU 33)
<num_dtc_0> - 1 (1 DTC)
<ascii_0> - 30 ('0')
<dtc_code_0> - 000003A1 (SPN 929 - Tire location)
<fmi_0> - 0C (Bad Intelligent Device Or Component) 8.4.5. Input/Output State Bits Input Bit 0x01 0x02 0x04 0x08 0x10 0x20 0x40 0x80 output Bit 0x01 0x02 0x04 0x08 0x10 Input State Ignition Input 1 Input 2 Input 3 Input 4 Device In Motion (Accel) Main supply voltage available Accelerometer Reorientation Valid Output State Output 0 Output 1 Output 2 Onboard Buzzer Garmin Power 2022 Sensata Technologies, Inc. All rights reserved. Page 158 | 194 XT6384-1 Product Manual 8.4.6. OBD Run States Bits Bit 0 1 2 3 State Engine Running PTO On Moving Ignition On 8.4.7. 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 8.4.8. OBD Backoff Mode Value 0 1 2 3 4 5 Description OBD not in Backoff OBD Backoff Scantool Detect OBD Backoff MIL Detect OBD Backoff MIL Persisted OBD Backoff Protocol Fail Detect OBD Backoff Scantool Detectuntil Ignition Off 8.4.9. OBD Protocol Table Value (Hex) 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 0x0200 Description ISO 9141-2 (Keyword Byte 08 08) ISO 9141-2 (Keyword Byte 94 94) ISO14230 (KWP2000) (5-Baud init) ISO14230 (KWP2000) (Fast init) J1850 PWM (typically older Ford vehicles) J1850 VPW (typically older GM vehicles and some older Chrysler and Toyota) J1708/J1587 CAN protocol 11-bit CAN ids J1939 CAN protocol 29-bit CAN ids 2022 Sensata Technologies, Inc. All rights reserved. Page 159 | 194 XT6384-1 Product Manual 8.4.10. 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 8.4.11. OBD Trip End Reason (Bit Mask) Value 0x00000001 0x00000002 0x00000004 0x00000008 0x00000010 0x00000020 0x00000040 0x00000080 0x00000100 0x00000200 0x00000400 0x00000800 0x00001000 0x00002000 0x00004000 0x00008000 0x00010000 0x00020000 Description Start Trip Detect Failed Protocol detected, but no start trip conditions met Failed to enable and configureOBD communications to aprevious known protocol Failed all attempts at vehicle protocol communications Trip was active; failed tomonitor any valid messagesfor x seconds or failed all requests for mode 1, pid 0 Master Vehicle Speed ECU has stopped responding Master RPM ECU has stopped responding Three-Minute Timer expired with no changing RPM. ECO mode not enabled and RPM of 0 detected TPS Filed upload request CAN Transport is not configured J1939 No Valid Claim Address CAN Transport - transmit not ready CAN Send - CAN Controller not Active CAN Bus Off CAN Transmit Timeout CAN hardware Off CAN Invalid Transmit Length 2022 Sensata Technologies, Inc. All rights reserved. Page 160 | 194 XT6384-1 Product Manual 8.4.12. Odometer Details Odometer GPS Trip Odom 1 GPS Trip Odom 2 OBD Derived Trip Odom GPS Lifetime Odom OBD Lifetime Odom OBD True Odom Reset Reset by script Reset by script Reset by script Never resets Never resets Cannot modify vehicle odometer Description Great-circle distance between subsequent sets of GPS latitude and longitude Great-circle distance between subsequent sets of GPS latitude and longitude Distance calculated based on averaged subsequent OBD speed readings Great-circle distance between subsequent sets of GPS latitude and longitude Accumulated odometer since install, based either on ECU odometer or averaged OBD speed readings Distance acquired directly from ECU, 1m per bit 8.4.13. Linkage Version Developer Revision 4 5 Number of Defined Fields 208 151 Sum of Defined Field sizes
> 645bytes
> 588bytes 2022 Sensata Technologies, Inc. All rights reserved. Page 161 | 194 XT6384-1 Product Manual 8.4.14. BuildAndSend Message ACK Byte(s) 0-1 2-3 Value 0x8888 PacketSerialNum 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). Type N/A 16-bit unsigned int, big-endian byte order 8.4.15. Packet Creation Characteristics l A message is created from a single packet recipe and may be appended with fields from a separate append recipe. l The device can store 128 packet recipes (each containing up to 40 fields) and16 append recipes (each containing up to 16 fields). l Each packet/append recipe is assigned a packet ID (0-254; 0x0 to 0xfe). l Each append recipe is assigned a range of reason codes. Example: Its possible to create an append recipe adding fields [x, y, z] to the end of the message. The designer can assign a range, e.g. 4 to 7, to this append recipe. Any time the script callsBuildAndSendMsg()with reason code 4, 5, 6, or 7, [x, y, z] fields are appended to the message.It is up to the customer to design and group reason codes and use them in the script to append desired data in certain situations. 8.4.16. Packet Creation Recipe Configuration Command Structure:
:wycfg pcr[<slot_index>] "<recipe_hex_string>"
<slot_index> is in range of 0 to 127
"<recipe_hex_string>" is a quoted string of hexadecimal bytes (represented by two ASCII characters) String Structure:
<packet_id><num_fields><field_0><field_1>...<field_N>
8.4.17. Packet Creation Append Command Structure:
:wycfg pca[<slot_index>] "<append_hex_string>"
2022 Sensata Technologies, Inc. All rights reserved. Page 162 | 194 XT6384-1 Product Manual
<slot_index> is in range of 0 to 15
<recipe_hex_string> is a quoted string of hex bytes (represented by two ASCII characters) String Structure:
<reason_lo><reason_hi><flags><num_fields><field_0><field_1>...<field_N>
<reason_lo> to <reason_hi> is the reason code range NOTE: A single reason code assignment is possible when <reason_lo> = <reason_hi>
<flags> is in range of 0 to 1. See <flags> range table below:
<flags> range table:
Range 0 1 Description Store the appended fields with the message in non-volatile memory but do NOT send the appended fields to the backend server. Store the appended fields with the message in non-volatile memory AND send the appended fields to the backend server. 8.4.18. Examples Packet Recipe Creation The table below represents three example packet recipe configurations (one on each row). The recipes are stored in the first three recipe slots (out of 128). Packet ID 0x0 0x14 0xfe Fields PacketID, DeviceID, UnixTime PacketID, DeviceID, Latitude, Longitude, Altitude PacketID, DeviceID, Hdop,andNumSats Command
:wycfg pcr[0] "0003010306
:wycfg pcr[1] "14050103070809"
:wycfg pcr[2] "fe0401031213"
Append Recipe Creation Reason Code Range 0 to 13 30 to 38 Fields and description Do NOT Send appended fields to backend server Field:GarminPktResp Send appended fields to backend server;
Fields:MotionStatus,EngineStatus,DerivedOdometer Command
:wycfg pca[0]
"000d000127"
:wycfg pca[1]
"1e2601032c2d2e"
2022 Sensata Technologies, Inc. All rights reserved. Page 163 | 194 XT6384-1 Product Manual 8.4.19. 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.0
-75 or better not known/ not detectable 2022 Sensata Technologies, Inc. All rights reserved. Page 164 | 194 XT6384-1 Product Manual 8.4.20. System State Bits Bit 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 State Valid Registration Valid IP Valid GPS Valid Script DM Session Active Accel Oriented Bluetooth Discoverable (TBD) Bluetooth Paired (TBD) Bluetooth Authenticated (TBD) Bluetooth Connected (TBD) Bluetooth Powered (TBD) Cellular Powered GPS Powered Garmin Powered Motion Via Accel Motion Via GPS External Power 2022 Sensata Technologies, Inc. All rights reserved. Page 165 | 194 XT6384-1 Product Manual 9. COMMAND LANGUAGE 9.1. OVERVIEW The XT6384-1 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. Each command is sent to the device in ascii format, and the device responds through the same medium that the command was sent with. The syntax for a command is shown below:
:<verb><module><object>[<arg1>, <arg2>, ....<argN>]
Valid characters for verb/module and objects are as follows:
"_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
The subsequent sections illustrate the various components that comprise a command. Each of these components has a set of rules that dictate how it should be formatted and what it represents. 9.2. VERB AND MODULE The following are rules regarding the syntax of verb and module codes:
l Always single character codes l Characters MAY beseparatedby one valid separator: "[space],()[tab]"
9.3. OBJECT The following are rules regarding the syntax of object codes:
l Must be followed by a valid separator: "[space],()[tab]"
l Unquoted strings of undefined length l First character must NOT be a numerical digit 2022 Sensata Technologies, Inc. All rights reserved. Page 166 | 194 XT6384-1 Product Manual 9.4. ARGUMENTS The following are rules regarding the syntax of arguments:
l Arguments have multiple valid formats:
o Strings o Strings representing enumerated values of valid chars o Hexadecimal or decimal values l Arguments must be separated by a single valid separator: "[space],()[tab]"
l Arguments must not contain the characters: ":|[]#<>"
l Anything following the symbol '#' is considered a comment and ignored by the interpreter l Decimal values have an optional prefix of '+' or '-' to designate their sign l Hex values can be denoted by prefixing '0x' or '0X'
l Octal values can be denoted by prefixing '0'
9.4.1. Verb Codes Verb Clear Create Enable Disable Query Run Read Restore Save Send Set Toggle Upgrade Write Code c a e d q u r o v x s t g w 9.4.2. Module Codes Module ADC Code a 2022 Sensata Technologies, Inc. All rights reserved. Page 167 | 194 XT6384-1 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 9.4.3. Object Codes Object Bootloader Chipflash Config Command Debug Debug Mask DM Msg Eeprom Feature Code bl chip cfg cmd dbg dm dmmsg ee f 2022 Sensata Technologies, Inc. All rights reserved. Page 168 | 194 XT6384-1 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 9.5. DEVICE COMMANDS 9.5.1. ADC Command
:raval 9.5.2. Bluetooth Command
:qbi
:ubcmd sleep
:ubcmd wake
:ubcmd rest
:ubcmd ble_start
:ubcmd ble_end
:ubcmd <mod> <pat> <freq>
<power>
Function Read ADC values Function Query Bluetooth information RF calibration procedure start RF calibration procedure end Puts the device into single frequency test mode 2022 Sensata Technologies, Inc. All rights reserved. Page 169 | 194 XT6384-1 Product Manual Command
:ubcmd adv
:ubcmd unadv
:ubcmd authbypass 9.5.3. Accelerometer Function
<mod> Val 0x00 0x01 0x02 0x03 0x04 Definition CW (Pattern must be 0x03 or 0x04) GFSK (BR)
(pi)/4-DQPSK (2-EDR) 8DPSK (3-EDR) BLE
<pat> Val 0x00 0x01 0x02 0x03 0x04 0x05 0x06 Definition PN9 PN15 0x5555 (0101 0101 0101 0101) All 1's All 0's 0xF0F0 (1111 0000 1111 0000) 0xFF00 (1111 1111 0000 0000)
<freq> Val 0-39 40-78 Definition Freq = 2402 + 2*val Freq = 2403 + 2*(val - 40)
<power> Val 0x01 0x08 0x0F Definition BLE Output Power Min Output Power (non-BLE) Max Output Power (BLE) NOTE: Command cannot be sent via SMSor UDP Command
:rxval
:rxval coefs
:rxval rot
:wxval coefs <num_stages>
Function Read current X, Y, and Z accelerations Read current filter coefficients Read current reorientation angles (radians) Write the number of filter stages and all filter coefficients 2022 Sensata Technologies, Inc. All rights reserved. Page 170 | 194 XT6384-1 Product Manual Command
<coef1> <coef2> ... <coefX>
:wxval coef <coef_index>
<coef>
:qxi
:exm
:dxm
:ext
:dxt
:uxcmd findz
:uxcmd findxa
:uxcmd findxd
:uxcmd voidrot 9.5.4. Buzzer Command
:uscmd play <song_index>
<volume> <loops>
:uscmd stop 9.5.5. Backend Command
:ekm
:dkm
:rkval ack_timeout
:wkval ack_timeout
<timeout_val>
9.5.6. Command Language Function Write filter coefficient at index X 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 Function Play a buzzer song out of the config Stop a buzzer song that is currently playing Function Enable Backend debug channel monitoring Disable Backend debug channel monitoring Read what the current ACK timeout value is set to (ms) Set the ACK timeout value (ms) Command
:wlopt echo <0|1>
Function Write cmdlang option "echo" to on or off 2022 Sensata Technologies, Inc. All rights reserved. Page 171 | 194 XT6384-1 Product Manual 9.5.7. Third Party Command
:ejm
:djm
:djdbg
:ejdbg
:qji
:qji diag
:gjfw x <serial_port_id>
Function EnableThird Partydebug channel monitoring DisableThird Partydebug channel monitoring DisableThird PartyXVBMG debug trace EnableThird PartyXVBMG debug trace Print out parameter tag information Print out tag transaction diagnostic info UpgradeThird Partyvia xmodem
:gjscr x <serial_port_id> <flag
-optional>
Upload VIS file via xmodem (flag = 1; erases all VIS's first) NOTE: Command cannot be sent via SMSor UDP
:ujcmd tag <tag id> <ip_dst>
:ujcmd init
:ujcmd exec 9.5.8. Device Command
:rdval reset NOTE: Command cannot be sent via SMSor UDP Run XVBMG on tag id; if no VIS file found, downloads VIS first (:edm &
:ekm) InitializeThird Partyfunctions (:edm) DisplaysThird PartyFW version (:edm) Function Read device reset reason Reason codes:
Code 0 1 2 3 4 5 6 7 8 9 Reason Power applied Low Power Watchdog Software User Brownout Supply Monitor Factory Reset System Error Unknown Description Main supply voltage connected to device Reset caused by the micro Hibernation module (not utilized) Reset caused by the micro Watchdog module. Reset caused by our device firmware. Main micro reset pin toggled (not utilized) Reset caused by the micro BOR module Not implemented. Reset caused by the micro Hardware System Service Request. Not implemented. Catch for any other micro reset source we have not defined. Page 172 | 194 2022 Sensata Technologies, Inc. All rights reserved. XT6384-1 Product Manual Command
:rdval serial
:rdval uptime
:rdval wake
:wdval serial "<serial_no>"
:qdi
:qdi cell
:qdi gps
:udcmd checkin
:udcmd factory
:udcmd factory keys 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 Check-In message todst[9]
Reset device to factory state Reset device to factory state plus revert AES keys to defaults. This is the only command available outside the AES console login. NOTE: Cannot be sent via SMSor UDP
:udcmd dslp <mask>
<minutes>
Enter deep sleep with <mask> wake setting Mask Values:
Hex 0x0000 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 Description Ring (Not applicable) Wired Ignition/IN0 Input 1 Input 2 Input 3 Input 4 Time Motion External Battery (configured by wbv) Unplug
:udcmd slp <mask>
<minutes>
Enter sleep with <mask> wake setting Mask Values:
Hex 0x0000 0x0001 0x0002 0x0004 0x0008 0x0010 0x0020 0x0040 0x0080 0x0100 Description Ring Wired Ignition/IN0 Input 1 Input 2 Input 3 Input 4 Time Motion External Battery (configured by wbv) Unplug 2022 Sensata Technologies, Inc. All rights reserved. Page 173 | 194 XT6384-1 Product Manual Command
:edm
:ddm 9.5.9. Flash Function Enable device debug channel monitoring Disable device debug channel monitoring Command
:efm
:dfm
:cfmem [all | <addr> <size>]
Function Enable Flash debug channel monitoring Disable Flash debug channel monitoring all = erase entire flash chip, <addr>,<size>
:rfmem <addr> <size>
NOTE: Must be multiples of 0x1000 Read <size> bytes of flash memory at address <addr>
:wfmem <addr> "<hex_ string>"
:qfmem
:qfi
:qfrec
:rfrec
:wfrec "<hex_string>"
:qftab <x>
:sftab <x> <sz>
:ufcmd reset
:ufcmd search <match>
<size> <offset>
9.5.10. Garmin Command
:enm
:dnm
:xnmsg <pid> "<ascii_hex>"
<flags>
NOTE: <addr> is in decimal Write "<hex_string>" to address <addr>
Query flash memory layout NOTE: Only available on debug devices Query flash info (device type) Query number of pending messages (records) Read pending messages (records) Write flash message (record) Query flash table (x = 2 for packet log) Fill flash table x leaving only sz bytes available NOTE: Only available on engineering devices Erase pending messages Search flash for a match Function Enable Garmin debug channel monitoring Disable Garmin debug channel monitoring Send a payload destined for Garmin device (needs script trigger/action) 2022 Sensata Technologies, Inc. All rights reserved. Page 174 | 194 XT6384-1 Product Manual 9.5.11. Geofence Command
:eem
:dem
:redm
:wedm <mask>
9.5.12. GPIO Function Enable Geofence debug channel monitoring Disable Geofence debug channel monitoring Read GPS debug mask Write the GPS debug mask Command
:qii
:rival <pin_id>
:wival <pin_id> <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) 9.5.13. GPS Command
:rgdm
:wgdm <mask>
:egm
:dgm
:egt
:dgt
:egcmd
:dgcmd
:qgi
:ugcmd reset 9.5.14. GPS Simulator Command
:sgsim config <lat> <long>
<heading> <speed>
Function Read GPS debug mask Write the GPS debug mask Enable GPS debug channel monitoring Disable GPS debug channel monitoring Enable GPS production test Disable GPS production test Start GPS Stop GPS Query GPS info GPS module reset Function GPS simulator initialize/enable:
Value 0 1 2 3 4 Description None Unlocked Locked Sleep LockedGood 2022 Sensata Technologies, Inc. All rights reserved. Page 175 | 194 XT6384-1 Product Manual Command Function
:sgsim coord <lat> <long>
:sgsim speed <speed>
GPS simulator force coordinates GPS simulator force speed
:sgsim head <heading>
:sgsim lock <lock>
Values are in tenths (e.g. 300 = 30 mph) GPS simulator force heading Values are in tenths (e.g. 900 = 90 degrees) GPS simulator force lock state:
Value 0 1 2 3 4 Description None Unlocked Locked Sleep LockedGood
:sgsim hdop <hdop>
:sgsim clear GPS simulator force hdop Disable GPS simulator 9.5.15. Cellular Command
:rtdm
:wtdm <mask>
Function Read transport debug mask Write the transport debug mask mask Values:
Hex 0x000 0x001 0x002 0x004 0x008 0x010 0x020 0x040 0x080 0x100 0x200 Description GSMDebug_None GSMDebug_State GSMDebug_Command GSMDebug_Response GSMDebug_Parse GSMDebug_ResponseHex GSMDebug_Mux GSMDebug_Backend GSMDebug_Mno GSMDebug_URC GSMDebug_PDU 2022 Sensata Technologies, Inc. All rights reserved. Page 176 | 194 XT6384-1 Product Manual Command
:wtovrd apn ["<apn_ overrride>"]
:etm
:dtm
:ett
:ett direct
:dtt
:qti
:qti ip
:qti certmask Function
<apn_overrride>"] Override class 3 APN Only applicable to:
l XT6372, XT6374 l XT6369 l XT6383 Enable transport debug channel monitoring 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 Query cellular certification mask
:utcmd factory
:utcmd reset
:utcmd sleep
:utcmd wake
:utota ftp "<filename with extension>" <type>
:utotahttps "<host>"
"<path>" <port> <type>[[[
<index>] "<filename>"]
<rev>]
(0x0:no security certificates loaded; 0x7: all 3 security certificates loaded successfully) Set cellular module to factory default state Queue a reset for the cellular module Stop cellular module Start cellular module Request FTP file transfer (only XT6369, XT6379, XT6376) Type 12 Request HTTPS file transfer (only on AAb6 currently) Description Cell Module Firmware
"<host>" is an https server string
"<path>" is an https path to file including file extension
<port> is an https server port
<type> is an enumerated value:
Type 0 1 2 3 6 8 10 11 Description Bootloader firmware Application firmware Script binary firmware Parameter text file TPS Overlay text file Third party code Third party data
<index> only applies to overlays 2022 Sensata Technologies, Inc. All rights reserved. Page 177 | 194 XT6384-1 Product Manual Command Function
"<filename>" is arbitrary and optional name reported in :q1i response
:utota s3 "<full S3 presigned link>" <port> <type>[[[
<index>] "<filename>"]
<rev>]
<rev> is the user determined revision value Request HTTPS file transfer (only on AAb6 currently).
"<full S3 presigned link>" https server string and path including file extension
<port> is an https server port
<type> is an enumerated value:
Type 0 1 2 3 6 8 10 11 12 Description Bootloader firmware Application firmware Script binary firmware Parameter text file TPS Overlay text file Third party code Third party data Cell Module Firmware (KB1.3 or later)
<index> only applies to overlays
"<filename>" is arbitrary and optional name reported in :q1i response
<rev> is the user determined revision value See Hardware ID and MNO select Function Enable interpreter debug channel monitoring [monitor only <trigger_id>]
Disable interpreter debug channel monitoring Send a user_event to the interpreter Upgrade interpreter script via xmodem (SeeTBD; formerlyLoad a Compiled Script to a Device NOTE: Command cannot be sent via SMSor UDP
:rtval mno
:wtval mno <profile>
9.5.16. Interpreter Command
:erm [<trigger_index>]
:drm
:xrmsg <user_event_id>
:grscr x <serial_port_id>
"<name>"
:rrscr Read interpreter script 2022 Sensata Technologies, Inc. All rights reserved. Page 178 | 194 XT6384-1 Product Manual Command
:rrval odom <index>
Function Read an odometer Index 0 1 2 3 4 Description GPS Trip 1 GPS Trip 2 OBD Trip GPS Life OBD Life
:rrval flags
:rrval uservar <type> <index>
:rrval timer <index>
:rrval gfnstat
:wrval odom <index> <value>
Read user script flags Read a uservar Read remaining time Read geofence active & inside status bitfields
<value> must be larger than current value:
Index 0 1 2 3 4 Description GPS Trip 1 GPS Trip 2 OBD Trip GPS Life OBD Life
:crval tripodom <index>
:wrval flags <value>
:wrval uservar <type>
<index> <value>
:drtask
:ertask
:urcmd bs <packet id>
<reason code> <dst index>
<ack> <qty>
:rrval linkver
:rrval sysval Clear a trip odometer:
Index 0 1 2 Description GPS Trip 1 GPS Trip 2 OBD Trip Write user script flags Write a uservar Suspend interpreter task Resume interpreter task Force a build and send of a packet (any reason code less than 0 or greater than 255 will wrap) NOTE: <qty> only available on engineering devices Read linkage version information (SeeTBD; formerlyLinkage Version) Read system value (in decimal if signed value; in hex if unsigned value) NOTE:Only values 4 bytes or less are functional; greater than 4 bytes returns a 0 value 2022 Sensata Technologies, Inc. All rights reserved. Page 179 | 194 XT6384-1 Product Manual 9.5.17. Main Processor Command
:d1dbg [<lock_code>]
Function Lock-out JTAG (disable debug); two stage command:
1. Issue :d1dbg (returns<lock_code>)
:g1bl x <serial_port_id>
2. Issue:d1dbg <lock_code>
Upgrade main bootloader via xmodem
:g1fw x <serial_port_id>
Upgrade main firmware via xmodem NOTE: Command cannot be sent via SMSor UDP NOTE: Command cannot be sent via SMSor UDP
:q1fw/:q1i
:u1cmd reset Query main firmware Reset main processor 9.5.18. One-Wire Bus Command
:wwdm <mask>
:wwdm ts <mask>
:wwdm drv <mask>
:ewm
:dwm
:rwi <channel 0/1>
:rwval <channel 0/1>
9.5.19. OBD Command
:qoi info
:qoi status
:qoi persist
:qoi trip
:qoi ss 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 Function Query OBD vehicle information Query OBD status information Query OBD persisted information Query OBD trip information Query OBD snapshot parameter information NOTE: For each printed value:
2022 Sensata Technologies, Inc. All rights reserved. Page 180 | 194 XT6384-1 Product Manual Command Function The first number is the raw value from the ECU
(units vary by protocol) The second number is the converted value our device calulated The third number is the "lowest ECU" (address)that reported the value vss rpm ect fl crztime vehtime enghr engsec idle Trip current speed 1 KPH/bit 0.125 RPM/bit l OBDII and J1939:-40 + 1C x bits l J1708:1F/bit l OBDII:(100/225%)/bit l J1708 and J1939: 0.1%/bit 1 second/bit 1 second/bit 1 hour/bit 1 second/bit l J1939: 0.05L/bit l J1708:0.125Gal/bit (0.473L/bit) pto used 0.05L/bit l J1939: 0.05L/bit used_hr true_odo l J1708:0.125Gal/bit (0.473L/bit) l J1939: 0.05L/bit l J1708:0.125Gal/bit (0.473L/bit) l J1939: Supporting pid 917: 5 meters/bit Not supporting pid 917:0.125km/bit l J1708:Not supporting pid 917: 0.1 mile/bit
(0.161km/bit) idletime ptotime 1 second/bit 1 second/bit
:qoi ss2 Query OBD snapshot additional parameter information NOTE: For each printed value:
The first number is the raw value from the ECU 2022 Sensata Technologies, Inc. All rights reserved. Page 181 | 194 XT6384-1 Product Manual Command Function
(units vary by protocol) The second number is the converted value our device calulated The third number is the "lowest ECU" (address)that reported the value gear 0 = neutral 1 = forward 2 = reverse 3 = park fueltemp l J1939: -40 + 1C x bits oiltemp throttle fueleco accelpos load torque oillvl oilpress coollvl coolpress l J1708: 0.25F/bit l OBDII: -40 + 1C x bits l J1939: -273 + 0.03125C x bits l J1708: 0.25F/bit l OBII:(100/255%)/bit l J1939 and J1708:0.4%/bit l J1939: 1/512km/I/bit l J1708: 1/256mpg/bit l OBII:(100/255%)/bit l J1939 and J1708:0.4%/bit l OBII:(100/255%)/bit l J1939: 1%/bit l J1708:0.5%/bit
-125 + 1%/bit l J1939: 0.4%/bit l J1708:0.5%/bit l J1939: 4 kpa/bit l J1708:2.45 kpa/bit l J1939: 0.4%/bit l J1708:0.5%/bit l J1939: 2 kpa/bit l J1708:0.862 kpa/bit 2022 Sensata Technologies, Inc. All rights reserved. Page 182 | 194 XT6384-1 Product Manual Command Function iat l OBIIand J1939: -40 + 1C x bits mantemp brake l J1708: 0.25F/bit l OBDII and J1939: -40 + 1C x bits l J1708: 1F/bit 0 = parking brake off 3 = parking brake set NOTE: if low ECU = 0xFE, converted value is 0 if not moving 1 if moving seat 0 = invalid/not supported 1 = NOTbuckled 2 = OK Seat belt buckled
:qoval
:qoi viol
:qost
:roval dtc
:woval p <protocol> <cll>
:woval dtc <mil value> <total dtc> <total ecu count>
:wocmd debug <0/1>
:wocmd debug erase
:wocmd debug lock Query OBD calculated information Query OBD Violations Query OBD state Read OBD DTC List Set OBD protocol to a com logical link Manually write DTC data (defaults to CAN protocol); if all fields are 0, DTCs are cleared Disable/enable obd debug log Erase OBD debug log Lock OBD debug off 9.5.20. System Command
:cycfg
:cycfg recipes
:ehm
:gycfg x <serial_port_id>
"<name>"
Function Clear system configs (set all parameters to default/RAM only and use:vycfgto make permanent) Clear system configs (set all parameters to default/RAM only and use:vycfgto make permanent); clear all recipes/appends from flash Enable watchdog timer debug monitor Upgrade paramset via xmodem; "<name>" is the version of the paramset NOTE: Command cannot be sent via SMSor UDP
:rycfg ...
:wycfg ... Read system config Write system config 2022 Sensata Technologies, Inc. All rights reserved. Page 183 | 194 XT6384-1 Product Manual Command
:qycfg ...
:uycfg revert
:vycfg
:uyscr x <serial_port_id>
:ryscr
:wyscr
:wyval persist
:ryval stack
:ryval time
:qyi
:uycmd resync <new_ system_time_s>
:ryval hwid Function Query parameter information Revert all system configs in RAM (reload from FLASH; must be used before
:vycfg) Save system configuration Run system script (after upload via xmodem) Read system script (not the interpreter script) Write a new system script (script created to recreate current parameters) Force a save of persist data Print out stack high water marks Print out current network, gps, and system times Print out system information Force system time to resync with available source. If time argument is passed, use as new system time with lower priority than internal sources Print out the hardware ID value Defined HWIDs:
Hex 0x01 0x02 0x03 0xff Description Hwid_2400_A Hwid_6370_A Hwid_6374_A Hwid_6300_B
:wyval hwid <value>
Set the hardware ID value
:wyval key <key_index>
<okok> <nkok> <oknk>
:wyval ptk <key_index>
<plaintext_key>
Change AES key, where key_index:
Index 0 1 2 Description Update Customer Transport Change AES key, where key_index:
Index 0 1 2 Description Update Customer Transport The desired key value is not encrypted. This command is only available via physical connection to the device. 2022 Sensata Technologies, Inc. All rights reserved. Page 184 | 194 XT6384-1 Product Manual 9.5.21. TPS Function Enable TPS debug prints Disable TPS debug prints Set debug mask Write into the TPS simulator header Command
:ecm
:dcm
:wcdm <mask>
:wcsim hdr
:wcsim tags <protocol> <link> Write a TPS simulator tag
:rctest vin
:rctest file
:rctest hdr
:rctest tag <tag_id>
Check if the current tag VIN matches the vehicle VIN Checks if there is a valid tps file Read TPS header Read TPS tag info
:qci tag
:rctest data
:qci data
:qci block <bock_id>
:qccmd sync
:gcfw x <serial_port_id>
"<name>"
9.5.22. Aux Passthru Command
:qvi
:evm
:dvm
:wvdm <mask_base10>
:rvdm
:xvmsg <bytes>
Read TPS tag data Read TPS block Sync TPS file with AAb3 target servers Upgrade TPS file via xmodem NOTE: Command cannot be sent via SMSor UDP Function Print info Enable aux passthru debug channel monitoring Disableaux passthrudebug channel monitoring Write (configure) aux passthru debug mask Mask Values:
Description None Payload Scratchpad Value 0 1 2 Read (print out) aux passthru debug mask Send a packet to be transmitted out over the aux port If the <bytes> field begins with "0x", the message is sent in hex;
if the <bytes> field does not begin with "0x", the message is sent in ASCII 2022 Sensata Technologies, Inc. All rights reserved. Page 185 | 194 XT6384-1 Product Manual 10. ELECTRICAL CHARACTERISTICS The XT6384-1 has two electrical connectors on the body of the device which contain all necessary power and data communication lines. One of these connectors is a Molex 24-pin female header (43045-2421) and the other is a Molex 14-pin female header (43045-1421). 10.1. 24-PIN CONNECTOR Pin 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Description Vin 12/24V LED V+
GND Ignition Out IN 0 IN 1 IN 2 IN 3 IN 4 OUT 0 OUT 1 OUT 2 SW controlled Vin output RS232 interface 2 RX RS232 interface 2 TX GND RS232 interface 1 RX RS232 interface 1 TX GND 1-Wire interface 1 1-Wire interface 2 2022 Sensata Technologies, Inc. All rights reserved. Page 186 | 194 XT6384-1 Product Manual Pin 22 23 24 Description ADC IN 1 ADC IN 2(THIS IS SHUNTED TO GROUND ON ALL KNOWN XT6300 HARDWARE) GND 10.2. 14-PIN CONNECTOR Pin 1 2 3 4 5 6 7 8 9 10 11 12 13 14 Description CAN (J-2234) High J-1708 RX J-1708 TX ISO 9141-2 Low J-1850 Bus -
J-1850 Bus +
N/C CAN (J-2234) Low Vendor Option Pin 3 Vendor Option Pin 11 Vendor Option Pin 1 ISP 9141-2 K-Line GND Battery +
2022 Sensata Technologies, Inc. All rights reserved. Page 187 | 194 XT6384-1 Product Manual 11. APPENDIX 11.1. UDPC 1. Open a standardudp serverto the configuration of dst[<dst_index>]. 2. Issue the command:ukcmd tunnel cmd<dst_index>via console to the device. NOTE: This will send out a hello message to dst[<dst_index>] and open a temporary socket for an ack response to come back on a non-blocked port. 3. Reply with the intended udpc message. 11.2. DYNAMIC ALTERNATOR This feature is only available on ignition type OBD. 11.2.1. Overview Due to differences in batteries, battery age and charging systems, setting the alternator on/off thresholds to arbitrary values does not always work to capture the start of a trip. The dynamic alternator feature was developed to try to capture the missing trips by monitoring the battery voltage for jumps instead of just crossing a threshold. When the dynamic alternator is enabled, the device overrides the alternator on/off settings (ast[0]/ast[1]) with dynamically calculated values as the battery voltage changes. When a voltage change larger than a user 2022 Sensata Technologies, Inc. All rights reserved. Page 188 | 194 XT6384-1 Product Manual configured voltage delta (ast[3]) is detected, the device attempts to start vehicle communications. If successful, a trip is started. When vehicle communications stop, the trip is ended and the battery voltage is captured (End of Trip Voltage -
EOT). If the battery voltage continues to go down, EOT is adjusted accordingly. EOT is not adjusted if the voltage goes up. EOT is used to calculate the dynamic alternator on/off thresholds as follows:
Alternator on threshold = EOT + delta Alternator off threshold = EOT + delta The battery voltage continues to be monitored and EOT adjusted as long as the alternator state is off, including during sleep. The device will wake up if the alternator on threshold is crossed and vehicle communications will be attempted. The dynamic alternator overrides the Wake Battery Voltage (wbv) setting. 11.2.2. Configuring The dynamic alternator feature is enabled by setting a non-zero value in ast[3]. For ast[3] details Alternator State Threshold (ast) on p. 39. Ast[3] = 0 disables dynamic alternator. CAUTION: Setting ast[3] too low will cause the device to have too many failed communication attempts, which could affect sleep current consumption. Setting it too high could cause missed trips. Recommended settings of 0.3 - 0.5V deltas seem to work for most vehicles. EOT is captured at end the of active trip, at end of failed communication attempts, and on device re-connect events. EOT voltage range is 12-14V. While we are able to capture a larger percentage of trips using dynamic alternator, it does not work well on some hybrids, vehicles with dual batteries, or smart charging systems. For a more complete solution, dynamic alternator is used in conjunction with GPS motion detection and by listening for bus traffic under certain voltage conditions. 2022 Sensata Technologies, Inc. All rights reserved. Page 189 | 194 XT6384-1 Product Manual 11.3. J1939 AND J1708 TEST SETUP BLOCK DIAGRAM 2022 Sensata Technologies, Inc. All rights reserved. Page 190 | 194 XT6384-1 Product Manual 11.4. J1939 DUAL CAN TEST SETUP BLOCK DIAGRAM 2022 Sensata Technologies, Inc. All rights reserved. Page 191 | 194 XT6384-1 Product Manual 12. REGULATORY STATEMENTS 12.1. FCC This equipment with FCC-ID: GKM-XT6384-1 and IC-ID: 10281A-XT6384A, Model: XT6384-1 is subject to the Federal Communications Commission (FCC) and Industry Canada (IC) rules. NOTICE:
Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment. This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
1. this device may not cause harmful interference, and 2. this device must accept any interference received, including interference that may cause undesired operation. Changes or modifications made to this equipment not expressly approved by Xirgo Technologies, LLC may void the FCC authorization to operate this equipment. NOTE: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
l Reorient or relocate the receiving antenna. l Increase the separation between the equipment and receiver. l Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. l Consult the dealer or an experienced radio/TV technician for help. Radio frequency radiation exposure Information:
This equipment, XT6384-1, complies with FCC and ISED radiation exposure limits set forth for an uncontrolled environment. This equipment must be installed and operated with minimum distance of 20cm between the XT6384-1 and your body. 2022 Sensata Technologies, Inc. All rights reserved. Page 192 | 194 XT6384-1 Product Manual 12.2. IC Antenna Statement Under Industry Canada regulations, this radio transmitter may only operate using an antenna of a type and maximum (or lesser) gain approved for the transmitter by Industry Canada. To reduce potential radio interference to other users, the antenna type and its gain should be so chosen that the equivalent isotropically radiated power (e.i.r.p.) is not more than that necessary for successful communication. Conformment la rglementation d'Industrie Canada, le prsent metteur radio peut fonctionner avec une antenne d'un type et d'un gain maximal (ou infrieur) approuv pour l'metteur par Industrie Canada. Dans le but de rduire les risques de brouillage radiolectrique l'intention des autres utilisateurs, il faut choisir le type d'antenne et son gain de sorte que la puissance isotrope rayonne quivalente (p.i.r.e.) ne dpasse pas l'intensit ncessaire l'tablissement d'une communication satisfaisante. Licence Exempt This device complies with Industry Canada licence-exempt RSS standard(s). Operation is subject to the following two conditions:
1. this device may not cause interference, and 2. this device must accept any interference, including interference that may cause undesired operation of the device. Le prsent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence. L'exploitation est autorise aux deux conditions suivantes:
1. l'appareil ne doit pas produire de brouillage, et 2. l'appareil doit accepter tout brouillage radiolectrique subi, mme si le brouillage est susceptible d'en compromettre le fonctionnement. 2022 Sensata Technologies, Inc. All rights reserved. Page 193 | 194 XT6384-1 Product Manual 12.3. 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.gov 2022 Sensata Technologies, Inc. All rights reserved. Page 194 | 194
1 | Internal Photos | Internal Photos | 4.91 MiB | March 28 2023 / September 24 2023 | delayed release |
1 | External Photos | External Photos | 672.11 KiB | March 28 2023 / September 24 2023 | delayed release |
1 | Label | ID Label/Location Info | 218.33 KiB | March 28 2023 |
Label information:
Label is 3M's Thermal Transfer Polyester Label Material 7816 and is attached on the front of the device.
1 | Attestation letter | Attestation Statements | 186.05 KiB | March 28 2023 |
Letter of Authorization and Anti- Drug Statement Applicant Name: Xirgo Technologies LLC Address: 1461 Lawrence Drive, Suite #1, Thousand Oaks, CA 91320 Product Name: XT6384-1 Model Number: XT6384-1 FCC ID: GKM-XT6384-1 We authorize:
CETECOM Inc., to act on our behalf on all matters concerning the above named equipment. We declare that CETECOM Inc. is allowed to forward all information related to the approval project to the Federal Communications Commission and discuss any issues concerning the approval application. The applicant must certify that neither the applicant nor any party to the application is subject to a denial of Federal benefits, that include FCC benefits, pursuant to Section 5301 of the Anti-Drug Abuse Act of 1988, 21 U.S.C. 862 because of a conviction for possession or distribution of a controlled substance. See 47 CFR 1.2002(b) for the definition of a "party" for these purposes. Does the applicant or authorized agent so certify? Yes I certify that I am authorized to sign this application. All of the statements herein and the exhibits attached hereto, are true and correct to the best of my knowledge and belief. In accepting a Grant of Equipment Authorization as a result of the representations made in this application, the applicant is responsible for (1) labeling the equipment with the exact FCC ID specified in this application, (2) compliance statement labeling pursuant to the applicable rules, and (3) compliance of the equipment with the applicable technical rules. If the applicant is not the actual manufacturer of the equipment, appropriate arrangements have been made with the manufacturer to ensure that production units of this equipment will continue to comply with the FCC's technical requirements. Authorizing an agent to sign this application, is done solely at the applicant's discretion;
however, the applicant remains responsible for all statements in this application. If an agent has signed this application on behalf of the applicant, a written letter of authorization which includes information to enable the agent to respond to the above section 5301 (Anti-Drug Abuse) Certification statement has been provided by the applicant. It is understood that the letter of authorization must be submitted to the FCC upon request, and that the FCC reserves the right to contact the applicant directly at any time. Signature of Authorized Person Filing: Edward Gabrelian Title: Engineering Manager Date: 11/03/2022
1 | Attestation letter 2.911(D)(5) | Attestation Statements | 230.62 KiB | March 28 2023 |
Xirgo Technologies LLC 1461 Lawrence Drive, Suite 1 Thousand Oaks, CA 91320 Federal Communication Commission 7435 Oakland Mills Road Columbia, MD 21046 03/09/2023 Attestation Statement according to 2.911(d)(5)(i) and 2.911(d)(5)(ii) FCC ID: GKM-XT6384-1 TO WHOM IT MAY CONCERN:
Hereby we certify that the equipment for which authorization is sought is not covered equipment prohibited from receiving an equipment authorization pursuant to section 2.903 of the FCC rules. Further we certify that, as of the date of the filing of the application, Xirgo Technologies LLC is not identified on the Covered List as an entity producing covered equipment. Sincerely, Xirgo Technologies LLC 1461 Lawrence Drive, Suite 1, Thousand Oaks, CA 91320 Edward Gabrelian, Manager Hardware Engineering 805-568-8466 egabrelian@xirgo.com For information on Covered equipment, refer:
986446 D01 Covered Equipment v01 FCC 22-84 List of Equipment and Services Covered By Section 2 of The Secure Networks Act | Federal Communications Commission (fcc.gov)
1 | Attestation letter 2.911(D)(7) | Attestation Statements | 192.89 KiB | March 28 2023 |
Xirgo Technologies LLC 1461 Lawrence Drive, Suite 1 Thousand Oaks, CA 91320 Federal Communication Commission Authorization and Evaluation Division 7435 Oakland Mills Road Columbia, MD 21046 USA Date of filing of the application with TCB : 03/16/2023 Attestation Statement according to 2.911(d)(7) FCC ID: GKM-XT6384-1 TO WHOM IT MAY CONCERN:
Xirgo Technologies, LLC with FCC Registration Number (FRN) 0021512173 Certifies that, as of the date of this filing of the application with the TCB, Xirgo Technologies, LLC is our designated US agent for service of process for the above referenced FCC ID. Xirgo Technologies, LLC accepts to maintain an agent for no less than one year after the grantee has terminated all marketing and importation or the conclusion of any commission related proceeding involving equipment. Xirgo Technologies, LLC with FCC Registration Number (FRN) 0021512173 Accepts, as of the date of the filing of the application, the obligation of the designated US agent for service of process for the above referenced FCC ID. Sincerely _______________ Xirgo Technologies LLC 1461 Lawrence Drive, Suite 1 Thousand Oaks, CA 91320 Edward Gabrelian 805-568-8466
<Email>
(signature & company stamp)
<US agents COMPANY NAME>
<full ADDRESS (NO PO BOX allowed!)>
<Email>
1 | Confidentiality | Cover Letter(s) | 202.04 KiB | March 28 2023 |
Federal Communications Commission Equipment Authorization Division 7435 Oakland Mills Road Columbia, MD 21048 Date: 11/03/2022 Subject:
Request for Permanent Confidentiality FCC ID: GKM-XT6384-1 To Whom It May Concern:
In accordance with 0.457(d) and 0.459 of CFR 47, and KDB 726920, Xirgo Technologies LLC hereby requests permanent confidentiality for documents filed under the following exhibit types:
1. Block Diagram 2. Schematic Diagram 3. Part List 4. Operational Description These items contain detailed system and equipment description and related information about the product which Xirgo Technologies LLC considers to be proprietary, confidential and a custom design which otherwise would not be released to the general public. Since this design is a basis from which future technological products will evolve, Xirgo Technologies LLC also feels that this information would be of benefit to its competitors, and that the disclosure of the information in these exhibits would give our competitors an unfair advantage in the market. We are aware that exhibit types cover letters, attestations, label document, test reports, RF exposure information (SAR and MPE reports), cannot be requested to be classified confidential and are thus subject to publication, as will be documents of all other exhibits types for which we have not requested a confidentiality classification. Best Regards, _______________________________ Signature Name: Edward Gabrelian Title: Engineering Manager Company Name: Xirgo Technologies LLC Address: 1461 Lawrence Drive, Suite #1, Thousand Oaks, CA 91320
1 | Confidentiality short term | Cover Letter(s) | 200.28 KiB | March 28 2023 |
Federal Communications Commission Equipment Authorization Division 7435 Oakland Mills Road Columbia, MD 21048 Date: 11/03/2022 Subject:
Request for Short Term Confidentiality FCC-ID: GKM-XT6384-1 To Whom It May Concern:
In accordance with 0.457(d) and 0.459 of CFR 47, Xirgo Technologies LLC hereby requests short term confidentiality for documents filed under the following exhibit types:
1. External Photographs 2. Internal Photographs 3. User / Instruction Manual 4. Test Set-up Photographs until the product will be publicly announced. Short term confidentiality release date / period: 180 Days These items contain detailed system and equipment description and related information about the product which Xirgo Technologies LLC considers to be proprietary, confidential and a custom design which otherwise would not be released to the general public. Since this design is a basis from which future technological products will evolve, Xirgo Technologies LLC also feels that this information would be of benefit to its competitors, and that the disclosure of the information in these exhibits would give our competitors an unfair advantage in the market. We are informed and aware of our obligation that we have to inform the involved TCB in written and in due time if we intend to market the product prior to the above specified confidentiality release date so that the short term confidentiality classification can be reset prior to product launch. We are aware that exhibit types cover letters, attestations, label document, test reports, RF exposure information (SAR and MPE reports), cannot be requested to be classified confidential and are thus subject to publication, as will be documents of all other exhibits types for which we have not requested a confidentiality classification. Best Regards, ____________________________________ Signature Name: Edward Gabrelian Title: Engineering Manager Company Name: Xirgo Technologies LLC Address: 1461 Lawrence Drive, Suite #1, Thousand Oaks, CA 91320
1 | Test setup photos | Test Setup Photos | 668.38 KiB | March 28 2023 / September 24 2023 | delayed release |
frequency | equipment class | purpose | ||
---|---|---|---|---|
1 | 2023-03-28 | 2402 ~ 2480 | DTS - Digital Transmission System | Original Equipment |
app s | Applicant Information | |||||
---|---|---|---|---|---|---|
1 | Effective |
2023-03-28
|
||||
1 | Applicant's complete, legal business name |
Xirgo Technologies LLC
|
||||
1 | FCC Registration Number (FRN) |
0021512173
|
||||
1 | Physical Address |
1461 Lawrence Dr, Ste 1
|
||||
1 |
Thousand Oaks, California 91320
|
|||||
1 |
United States
|
|||||
app s | TCB Information | |||||
1 | TCB Application Email Address |
j******@cetecom.com
|
||||
1 | TCB Scope |
A4: UNII devices & low power transmitters using spread spectrum techniques
|
||||
app s | FCC ID | |||||
1 | Grantee Code |
GKM
|
||||
1 | Equipment Product Code |
XT6384-1
|
||||
app s | Person at the applicant's address to receive grant or for contact | |||||
1 | Name |
E****** G******
|
||||
1 | Title |
Engineering Manager
|
||||
1 | Telephone Number |
805-5********
|
||||
1 | Fax Number |
805-5********
|
||||
1 |
e******@xirgo.com
|
|||||
app s | Technical Contact | |||||
n/a | ||||||
app s | Non Technical Contact | |||||
n/a | ||||||
app s | Confidentiality (long or short term) | |||||
1 | Does this application include a request for confidentiality for any portion(s) of the data contained in this application pursuant to 47 CFR § 0.459 of the Commission Rules?: | Yes | ||||
1 | Long-Term Confidentiality Does this application include a request for confidentiality for any portion(s) of the data contained in this application pursuant to 47 CFR § 0.459 of the Commission Rules?: | Yes | ||||
1 | If so, specify the short-term confidentiality release date (MM/DD/YYYY format) | 09/24/2023 | ||||
if no date is supplied, the release date will be set to 45 calendar days past the date of grant. | ||||||
app s | Cognitive Radio & Software Defined Radio, Class, etc | |||||
1 | Is this application for software defined/cognitive radio authorization? | No | ||||
1 | Equipment Class | DTS - Digital Transmission System | ||||
1 | Description of product as it is marketed: (NOTE: This text will appear below the equipment class on the grant) | Vehicle tracking solutions with optional OBD to support a wide range of vehicle protocols | ||||
1 | Related OET KnowledgeDataBase Inquiry: Is there a KDB inquiry associated with this application? | No | ||||
1 | Modular Equipment Type | Does not apply | ||||
1 | Purpose / Application is for | Original Equipment | ||||
1 | Composite Equipment: Is the equipment in this application a composite device subject to an additional equipment authorization? | No | ||||
1 | Related Equipment: Is the equipment in this application part of a system that operates with, or is marketed with, another device that requires an equipment authorization? | No | ||||
1 | Grant Comments | Power out is conducted. This device contains an LTE transmitter. Only those antennas tested in this filing, or similar with equal or lesser gain may be used with the transmitter. Antennas used for this device must be installed to provide a separation distance of at least 20 cm from all persons to satisfy RF exposure compliance. End users must be provided with antenna installation instructions and transmitter operating conditions for satisfying RF exposure compliance. | ||||
1 | Is there an equipment authorization waiver associated with this application? | No | ||||
1 | If there is an equipment authorization waiver associated with this application, has the associated waiver been approved and all information uploaded? | No | ||||
app s | Test Firm Name and Contact Information | |||||
1 | Firm Name |
CETECOM Inc.
|
||||
1 | Name |
M****** G****
|
||||
1 | Telephone Number |
408-5********
|
||||
1 |
m******@cetecom.com
|
|||||
Equipment Specifications | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Line | Rule Parts | Grant Notes | Lower Frequency | Upper Frequency | Power Output | Tolerance | Emission Designator | Microprocessor Number | |||||||||||||||||||||||||||||||||
1 | 1 | 15C | 2402.00000000 | 2480.00000000 | 0.0038000 |
some individual PII (Personally Identifiable Information) available on the public forms may be redacted, original source may include additional details
This product uses the FCC Data API but is not endorsed or certified by the FCC