Jump to content

Device Configuration Packet: Difference between revisions

From Transight Wiki
← Older edit
No edit summary
Tag: Manual revert
 
(11 intermediate revisions by the same user not shown)
Line 6: Line 6:
! style="background-color:#680022; color:white;" | Breakdown
! style="background-color:#680022; color:white;" | Breakdown
|-
|-
! colspan="5" style="background:#D3D3D3;" | Header
! colspan="5" style="background:#D3D3D3;" | Header (10 Bytes)
|-
|-
| Start byte
| Start byte
Line 39: Line 39:
| 75 - 79
| 75 - 79
| Type of packet
| Type of packet
| 02 - OTA Packet
| 04 - Device configuration packet
|-
|-
! colspan="5" style="background:#D3D3D3;" | Data
! colspan="5" style="background:#D3D3D3;" | Data  
|-
|-
| Time
| Time
| 32
| 32
|  
| 80-111
| UTC Timestamp
| UTC Timestamp
| UTC time in seconds
| UTC time in seconds
Line 52: Line 52:
| Timezone
| Timezone
| 8
| 8
|  
| 112-119
| Timezone in quarter-hours
| Timezone in quarter-hours
| 22 = +5:30 (22 × 15min = 330min = 5.5hr)
| 22 = +5:30 (22 × 15min = 330min = 5.5hr)
Line 59: Line 59:
| IGN Source
| IGN Source
| 2
| 2
|  
| 120-121
| Source of ignition detection
| Source of ignition detection
| 0 - IGN PIN, 1 – Vibration, 2 - Voltage, 3 - GPS
| 0 - IGN PIN, 1 – Vibration, 2 - Voltage, 3 - GPS
Line 66: Line 66:
| Cell Operator
| Cell Operator
| 4
| 4
|  
| 122-125
|  
| Operator name
|  
|  


Line 73: Line 73:
| Fuel Sensor Count
| Fuel Sensor Count
| 2
| 2
|  
| 126-127
| Number of fuel sensors
| Number of fuel sensors
|  
|  
Line 80: Line 80:
| Fuel Sensor Name
| Fuel Sensor Name
| 4
| 4
|  
| 128-131
| Refer sheet Enums
| Fuel Sensor Name
|  
|  


Line 87: Line 87:
| Fuel Sensor Baudrate
| Fuel Sensor Baudrate
| 12
| 12
|  
| 132-143
|  
|  
| up to 115200
| up to 115200
Line 94: Line 94:
| Fuel Sensor Mode
| Fuel Sensor Mode
| 2
| 2
|  
| 144-145
|  
| Request/ Passive
|  
|  


Line 101: Line 101:
| Onewire Status
| Onewire Status
| 1
| 1
|  
| 146
| Enable or disable
| Enable or disable
|  
|  
Line 108: Line 108:
| Onewire Sensor Type
| Onewire Sensor Type
| 3
| 3
|  
| 147-149
|  
| Name of the sensor
|  
|  


Line 115: Line 115:
| Onewire Sensor Count
| Onewire Sensor Count
| 3
| 3
|  
| 150-152
|  
| Number of onewire sensors
|  
| 1,2 or 3


|-
|-
| Odometer Mode
| Odometer Mode
| 1
| 1
|  
| 153
|  
|  
| 0 or 1 (Accumulated or Differential)
| 0 or 1 (Accumulated or Differential)
Line 129: Line 129:
| Speed Threshold
| Speed Threshold
| 9
| 9
|  
| 154-162
|  
| Configured Speed limit in km/h
| 0–360
| 0–360


Line 136: Line 136:
| HAT
| HAT
| 12
| 12
|  
| 163-174
|  
| Configured Harsh acceleration Threshold
| 50–3500
| 50–3500


Line 143: Line 143:
| HBT
| HBT
| 12
| 12
|  
| 175-186
|  
| Configured Harsh Breaking Threshold
| 50–3500
| 50–3500


Line 150: Line 150:
| RTT
| RTT
| 9
| 9
|  
| 187-195
|  
| Configured Rash Turn Threshold
| 5–480
| 5–480


Line 157: Line 157:
| Tilt Angle Threshold
| Tilt Angle Threshold
| 9
| 9
|  
| 196-204
|  
| Configured Tilt Angle  Threshold
| 5–359
| 5–359


Line 164: Line 164:
| Immobilizer Status
| Immobilizer Status
| 1
| 1
|  
| 205
|  
| ON/OFF Status
|  
| 0 - OFF, 1 - ON


|-
|-
| Immobilizer Speed
| Immobilizer Speed
| 9
| 9
|  
| 206-214
|  
|  
|  
|  
Line 178: Line 178:
| Digital Input Status
| Digital Input Status
| 4
| 4
|  
| 215-218
|  
|  
| 3
| 3
Line 185: Line 185:
| Digital Output Status
| Digital Output Status
| 2
| 2
|  
| 219-220
|  
|  
| 0–3
| 0–3
Line 192: Line 192:
| Analog Input Status
| Analog Input Status
| 2
| 2
|  
| 221-222
|  
|  
| 0 or 1
| 0 or 1
Line 199: Line 199:
| SMS M1
| SMS M1
| 51
| 51
|  
| 223-273
| MSB 1 - country code included, MSB 0 - no country code
| MSB 1 - country code included, MSB 0 - no country code
| Remaining 50 bits = mobile number
| Remaining 50 bits = mobile number
Line 206: Line 206:
| SMS M2
| SMS M2
| 51
| 51
|  
| 274-324
| Same format as SMS M1
| Same format as SMS M1
|  
|  
Line 213: Line 213:
| Number of IPs
| Number of IPs
| 3
| 3
|  
| 325-327
|  
|  
| 0–5
| 0–5
Line 220: Line 220:
| IMOBSRC
| IMOBSRC
| 3
| 3
|  
| 328-330
|  
| Immobilizer source
|  
|  


Line 227: Line 227:
| APN Length
| APN Length
| 5
| 5
|  
| 331-335
| Length in bytes
| Length in bytes
|  
|  
Line 234: Line 234:
| APN
| APN
| Variable
| Variable
|  
| 336 (336+N*8-1)
| Access Point Name
| Access Point Name
| Length defined by APN length
| Length defined by APN length
|-
|-
! colspan="5" style="background:#D3D3D3;" | Tail
! colspan="5" style="background:#D3D3D3;" | Tail (2 Bytes)
|-
|-
| End Character
| End Character
Line 253: Line 253:
| Excludes $ and *
| Excludes $ and *
|}
|}
== OTA Packet (Type 4) ==
== Sample Packet ==


<pre>
<pre>
{
{HEX : "2402e0e21aeb7abfd58468ac2cec160400002408c03203c1e168280100357c8b0712a00000000000020e61697274656c677072732e636f6d2aea" "imei": 862942074896044, "packet_type": 4, "no_packets": 1, "dateTime": 1756114156, "timezone": 22, "dateTime_tz": "2025-08-25 14:59:16", "ign_source": 0, "cell_op": 1, "fs_count": 0, "fs_name": 0, "fs_baudrate": 0, "fs_mode": 0, "onewire_status": 1, "onewire_type": 1, "onewire_count": 0, "odometer_mode": 0, "speed_threshold": 70, "hat": 25, "hbt": 30, "rtt": 30, "tilt_angle_threshold": 45, "imbz_status": 0, "immobilizer_speed": 20, "di_status": 0, "do_status": 0, "ai_status": 0, "sms_m1": "+918891011146", "sms_m2": "+0", "no_ips": 2, "imobsrc": 0, "apn_length": 14, "apn": "airtelgprs.com", "error_code": 0}
  "HEX": "240280e1cabd09208ca46822dde6160c00000006400400002168280000357c8b071280000000000002084d324d49534146452a6a",
</pre>
  "ai_status": 0,
 
  "apn": 77,
 
  "apn_length": 8,
<html lang="en">
  "cell_op": 3,
<head>
  "dateTime": 1747115494,
   <meta charset="UTF-8">
  "dateTime_tz": "2025-05-13 11:21:34.000",
  <style>
  "di_status": 0,
    body { font-family: Arial, sans-serif; }
  "do_status": 0,
    textarea { width: 100%; height: 100px; font-family: monospace; }
  "fs_baudrate": 0,
    button {
  "fs_count": 0,
      padding: 10px 20px;
  "fs_mode": 0,
      border-radius: 20px;
  "fs_name": 0,
      font-weight: bold;
  "hat": 1,
      background-color: #680022;
  "hbt": 0,
      color: white;
  "ign_source": 0,
      border: none;
  "imbz_status": 2,
      cursor: pointer;
  "imei": 860187062240357,
    }
  "immobilizer_speed": 20,
    button:hover {
  "imobsrc": 0,
      background-color: #4c0019;
  "insert_time": "Tue, 13 May 2025 05:51:37 GMT",
    }
  "no_ips": 2,
    table { width: 100%; border-collapse: collapse; margin-top: 20px; }
  "odometer_mode": 0,
    th, td { border: 1px solid #ccc; padding: 8px; text-align: left; }
  "onewire_count": 0,
    th { background-color: #680022; color: white; }
  "onewire_status": 0,
   </style>
  "onewire_type": 0,
</head>
  "packetType": 4,
<body>
   "rtt": 1,
 
  "send_time": "2025-05-13 11:21:34",
<h2>Device Configuration Packet Parser</h2>
   "sms_m1": 918891011146,
<textarea id="packetInput" placeholder="Paste Device Configuration hex packet here..."></textarea><br>
  "sms_m2": 0,
<button onclick="parsePacket()">Parse Packet</button>
   "speed_threshold": 25,
 
   "tilt_angle_threshold": 22,
<h3>Parsed Output:</h3>
   "timezone": 22
<table id="resultTable">
  <thead><tr><th>Field</th><th>Value</th></tr></thead>
  <tbody></tbody>
</table>
 
<script>
function hexToBits(hex) {
  return hex.match(/.{1,2}/g).map(b => parseInt(b, 16).toString(2).padStart(8, '0')).join('');
}
 
function bitsToInt(bits) {
  return parseInt(bits, 2);
}
 
function bitsToSignedInt(bits) {
   const val = parseInt(bits, 2);
   const max = 1 << bits.length;
  return val >= max / 2 ? val - max : val;
}
 
function bitsToAscii(bits) {
   return bits.match(/.{8}/g).map(b => String.fromCharCode(parseInt(b, 2))).join('').replace(/\0/g, '').trim();
}
}
</pre>
 
function parseMobile(bits) {
  const isWithCountryCode = bits[0] === '1';
  const number = BigInt('0b' + bits.slice(1)).toString();
  return isWithCountryCode ? `+${number}` : number;
}
 
function parsePacket() {
  const hex = document.getElementById('packetInput').value.trim().toLowerCase();
  const resultBody = document.querySelector("#resultTable tbody");
  resultBody.innerHTML = "";
 
  if (!hex.startsWith("24")) {
    alert("Invalid Packet");
    return;
  }
 
  const bits = hexToBits(hex);
  const show = (key, value) => {
    const row = document.createElement("tr");
    row.innerHTML = `<td>${key}</td><td>${value}</td>`;
    resultBody.appendChild(row);
  };
 
  show("Start Byte", hex.slice(0, 2));
  show("Packet Type", bitsToInt(bits.slice(75, 80)));
 
  const imei = BigInt('0b' + bits.slice(25, 75)).toString();
  show("IMEI", imei);
 
  const timestamp = bitsToInt(bits.slice(80, 112));
  const timezoneRaw = bitsToSignedInt(bits.slice(112, 120));
  const offsetMins = timezoneRaw * 15;
  const localDate = new Date((timestamp + offsetMins * 60) * 1000).toISOString().replace("T", " ").replace(".000Z", "");
  show("DateTime", timestamp);
  show("TimeZone", `UTC${offsetMins >= 0 ? '+' : ''}${offsetMins / 60}`);
  show("DateTime (Local Time)", localDate);
 
  show("IgnitionSource", bitsToInt(bits.slice(120, 122)));
  show("CellOperator", bitsToInt(bits.slice(122, 126)));
  show("FuelSensorCount", bitsToInt(bits.slice(126, 128)));
  show("FuelSensorName", bitsToInt(bits.slice(128, 132)));
  show("FuelSensorBaudrate", bitsToInt(bits.slice(132, 144)));
  show("FuelSensorMode", bitsToInt(bits.slice(144, 146)));
  show("OneWireStatus", bitsToInt(bits.slice(146, 147)));
  show("OneWireType", bitsToInt(bits.slice(147, 150)));
  show("OneWireSensorCount", bitsToInt(bits.slice(150, 153)));
  show("OdometerMode", bitsToInt(bits.slice(153, 154)));
  show("SpeedThreshold", bitsToInt(bits.slice(154, 163)));
  show("HAT", bitsToInt(bits.slice(163, 175)));
  show("HBT", bitsToInt(bits.slice(175, 187)));
  show("RTT", bitsToInt(bits.slice(187, 196)));
  show("TAT", bitsToInt(bits.slice(196, 205)));
  show("ImmobilizerStatus", bitsToInt(bits.slice(205, 206)));
  show("ImmobilizerSpeed", bitsToInt(bits.slice(206, 215)));
  show("DigitalInStatus", bitsToInt(bits.slice(215, 219)));
  show("DigitalOutStatus", bitsToInt(bits.slice(219, 221)));
  show("AnalogInStatus", bitsToInt(bits.slice(221, 223)));
 
  show("SMS M1", parseMobile(bits.slice(223, 274)));
  show("SMS M2", parseMobile(bits.slice(274, 325)));
 
  show("No.of IP", bitsToInt(bits.slice(325, 328)));
  show("IMMOB Src", bitsToInt(bits.slice(328, 331)));
 
  const apnLen = bitsToInt(bits.slice(331, 336));
  const apnBits = bits.slice(336, 336 + apnLen * 8);
  show("APN", bitsToAscii(apnBits));
 
  // End Byte and CRC (last 2 bytes)
  const endByte = hex.slice(-4, -2);
  const crc = hex.slice(-2);
  show("End Byte", String.fromCharCode(parseInt(endByte, 16)));
  show("CRC", `0x${crc}`);
  show("CRC Status", "Valid"); // CRC logic can be added
}
</script>
</body>
</html>

Latest revision as of 15:28, 21 November 2025

Field Size (bits) Bit Range Description Breakdown
Header (10 Bytes)
Start byte 8 0 - 7 Starting character $ ASCII value 36
Data length 12 8 - 19 2-byte length of the data following the header
Number of data packets 5 20 - 24 Number of packets 0–32
IMEI 50 25 - 74 Unique device identifier
Packet Type 5 75 - 79 Type of packet 04 - Device configuration packet
Data
Time 32 80-111 UTC Timestamp UTC time in seconds
Timezone 8 112-119 Timezone in quarter-hours 22 = +5:30 (22 × 15min = 330min = 5.5hr)
IGN Source 2 120-121 Source of ignition detection 0 - IGN PIN, 1 – Vibration, 2 - Voltage, 3 - GPS
Cell Operator 4 122-125 Operator name
Fuel Sensor Count 2 126-127 Number of fuel sensors
Fuel Sensor Name 4 128-131 Fuel Sensor Name
Fuel Sensor Baudrate 12 132-143 up to 115200
Fuel Sensor Mode 2 144-145 Request/ Passive
Onewire Status 1 146 Enable or disable
Onewire Sensor Type 3 147-149 Name of the sensor
Onewire Sensor Count 3 150-152 Number of onewire sensors 1,2 or 3
Odometer Mode 1 153 0 or 1 (Accumulated or Differential)
Speed Threshold 9 154-162 Configured Speed limit in km/h 0–360
HAT 12 163-174 Configured Harsh acceleration Threshold 50–3500
HBT 12 175-186 Configured Harsh Breaking Threshold 50–3500
RTT 9 187-195 Configured Rash Turn Threshold 5–480
Tilt Angle Threshold 9 196-204 Configured Tilt Angle Threshold 5–359
Immobilizer Status 1 205 ON/OFF Status 0 - OFF, 1 - ON
Immobilizer Speed 9 206-214
Digital Input Status 4 215-218 3
Digital Output Status 2 219-220 0–3
Analog Input Status 2 221-222 0 or 1
SMS M1 51 223-273 MSB 1 - country code included, MSB 0 - no country code Remaining 50 bits = mobile number
SMS M2 51 274-324 Same format as SMS M1
Number of IPs 3 325-327 0–5
IMOBSRC 3 328-330 Immobilizer source
APN Length 5 331-335 Length in bytes
APN Variable 336 (336+N*8-1) Access Point Name Length defined by APN length
Tail (2 Bytes)
End Character 8 0 - 7 Ending character * ASCII value 42
CRC 8 8 - 15 XOR CRC from $ to * Excludes $ and *

Sample Packet

{HEX : "2402e0e21aeb7abfd58468ac2cec160400002408c03203c1e168280100357c8b0712a00000000000020e61697274656c677072732e636f6d2aea" "imei": 862942074896044, "packet_type": 4, "no_packets": 1, "dateTime": 1756114156, "timezone": 22, "dateTime_tz": "2025-08-25 14:59:16", "ign_source": 0, "cell_op": 1, "fs_count": 0, "fs_name": 0, "fs_baudrate": 0, "fs_mode": 0, "onewire_status": 1, "onewire_type": 1, "onewire_count": 0, "odometer_mode": 0, "speed_threshold": 70, "hat": 25, "hbt": 30, "rtt": 30, "tilt_angle_threshold": 45, "imbz_status": 0, "immobilizer_speed": 20, "di_status": 0, "do_status": 0, "ai_status": 0, "sms_m1": "+918891011146", "sms_m2": "+0", "no_ips": 2, "imobsrc": 0, "apn_length": 14, "apn": "airtelgprs.com", "error_code": 0}


Device Configuration Packet Parser


Parsed Output:

FieldValue

Retrieved from "https://telematics.transight.com/index.php?title=Device_Configuration_Packet&oldid=1327"