Jump to content

Telemetry Packet: Difference between revisions

From Transight Wiki
← Older editNewer edit →
No edit summary
No edit summary
Line 129: Line 129:
| CRC || 8 || 8–15 || 8-bit XOR CRC of data starting from $ to * (excluding $ and *) ||  
| CRC || 8 || 8–15 || 8-bit XOR CRC of data starting from $ to * (excluding $ and *) ||  
|}
|}
==Sample Packet==
==Sample Packet==
<pre>
<pre>
HEX "240370e2400e60e3ad81801b0cfaca0be02541c2000000000000000000000000000000009800000000000000000000000000000000000000000000006875e9e5162a05"
HEX "240370e2400e60e3ad81801b0cfaca0be02541c2000000000000000000000000000000009800000000000000000000000000000000000000000000006875e9e5162a05"
Line 155: Line 155:
"speed": 0.0,  
"speed": 0.0,  
"altitude": 0.0,
"altitude": 0.0,
"power": 0,  
"power": 0,  
"ignition": 0,  
"ignition": 0,  
"immobilizer": 0,  
"immobilizer": 0,  
Line 186: Line 186:
"dateTime": 1752558053,  
"dateTime": 1752558053,  
"timezone": 22,  
"timezone": 22,  
"dateTime_tz":  
"dateTime_tz": "2025-07-15 11:10:53",  
"2025-07-15 11:10:53",  
"error_code": 0  
"error_code": 0  
}
}
<\pre>
</pre>
 
==Parser==
<!-- You can place this below the main MediaWiki content or include it using <html> tag inside MediaWiki -->
 
<html>
<h3>Telemetry Packet Parser</h3>
<textarea id="hexInput" placeholder="Paste telemetry hex here..."></textarea><br>
<button onclick="parseTelemetry()">Parse Packet</button>
<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){let v=parseInt(bits,2),m=Math.pow(2,bits.length);return v>=m/2?v-m:v}
function formatIMEI(bits){return BigInt('0b'+bits).toString()}
function parseTelemetry(){
  const hex = document.getElementById("hexInput").value.trim().toLowerCase();
  const table = document.querySelector("#resultTable tbody");
  if(!hex.startsWith("24")) return alert("Invalid packet");
  const b = hexToBits(hex); let i=0; table.innerHTML = "";
  const n = l => { const d=b.slice(i,i+l); i+=l; return d };
  const f = (k,v) => table.innerHTML += `<tr><td>${k}</td><td>${v}</td></tr>`;
  f("Start Byte",bitsToInt(n(8)));
  f("Data Length",bitsToInt(n(12)));
  f("No. of Packets",bitsToInt(n(5)));
  f("IMEI",formatIMEI(n(50)));
  f("Packet Type",bitsToInt(n(5)));
  f("Packet Status",bitsToInt(n(1)));
  f("Frame Number",bitsToInt(n(16)));
  f("Alert ID",bitsToInt(n(8)));
  f("Operator",bitsToInt(n(4)));
  f("Signal Strength",bitsToInt(n(5)));
  f("MCC",bitsToInt(n(10)));
  f("MNC",bitsToInt(n(6)));
  f("Cell ID",bitsToInt(n(16)));
  f("LAC",bitsToInt(n(16)));
  f("Fix Status",bitsToInt(n(1)));
  f("Latitude",bitsToInt(n(32))/1e6);
  f("NS Indication",bitsToInt(n(1))==0?"N":"S");
  f("Longitude",bitsToInt(n(29))/1e6);
  f("EW Indication",bitsToInt(n(1))==0?"E":"W");
  f("HDOP",bitsToInt(n(10))/10);
  f("PDOP",bitsToInt(n(10))/10);
  f("Speed",bitsToInt(n(10))/10);
  f("Altitude",bitsToInt(n(15))/10);
  f("Power Status",bitsToInt(n(1)));
  f("Ignition Status",bitsToInt(n(1)));
  f("Immobilizer Status",bitsToInt(n(1)));
  f("Tamper",bitsToInt(n(1)));
  f("Supply Voltage",bitsToInt(n(6))/10);
  f("Internal Battery Voltage",bitsToInt(n(6))/10);
  f("Fuel Sensor Value 1",bitsToInt(n(16))/10);
  f("Fuel Percentage 1",bitsToInt(n(16))/10);
  f("Fuel Sensor Value 2",bitsToInt(n(16))/10);
  f("Fuel Percentage 2",bitsToInt(n(16))/10);
  f("Fuel Sensor Value 3",bitsToInt(n(16))/10);
  f("Fuel Percentage 3",bitsToInt(n(16))/10);
  f("Analog Input",bitsToInt(n(10))/10);
  f("Analog Input 1",bitsToInt(n(10))/10);
  f("Digital Input 1",bitsToInt(n(1)));
  f("Digital Input 2",bitsToInt(n(1)));
  f("Digital Output 1",bitsToInt(n(1)));
  f("Digital Output 2",bitsToInt(n(1)));
  f("Temperature Sensor Status 1",bitsToInt(n(1)));
  f("Temperature 1",bitsToSignedInt(n(12))/10);
  f("Temperature Sensor Status 2",bitsToInt(n(1)));
  f("Temperature 2",bitsToSignedInt(n(12))/10);
  f("Temperature Sensor Status 3",bitsToInt(n(1)));
  f("Temperature 3",bitsToSignedInt(n(12))/10);
  f("Humidity",bitsToInt(n(8)));
  f("Odometer",bitsToInt(n(35)));
  const dt = bitsToInt(n(32));
  f("DateTime UTC",new Date(dt*1000).toISOString());
  const tz = bitsToSignedInt(n(8));
  f("Timezone",`${tz*15} min (UTC${tz>=0?"+":""}${Math.floor(tz*15/60)}:${String(tz*15%60).padStart(2,"0")})`);
}
</script>
</html>

Revision as of 11:26, 15 July 2025

Field Size (bits) Bit Range Description Breakdown
Header (10 bytes)
Start byte 8 0–7 Starting character $ (ASCII value 36) $
Data length 12 08–19 2-byte length of the data following the header
Num of data packets 5 20–24 Number of packets (0–32) 0–32
IMEI 50 25–74 Unique device identifier e.g., 887744556677882
packet type 5 75–79 Integer type:
  • 00 - Device Info Packet
  • 01 - Alert Packet
  • 02 - OTA Packet
  • 03 - Error Packet
  • 04 - Device Configuration Packet
  • 05 - IP Configuration Packet
  • 06 - Live ||
Data (= 55 bytes × number of packets)
Packet Status 1 — Type of packet
Frame Number 16 — Frame number
AlertID 8 — Alert identifier
Operator 4 — Network operator 00-Airtel, 01-BSNL, 02-VI, 04-JIO
Signal Strength 5 — Signal strength Integer (0–31)
MCC 10 — Mobile country code Integer
MNC 6 — Mobile network code Integer
Cell Id 16 — Cell tower ID Integer
Location Area Code 16 — Location area code Integer
Fix_status 1 — GPS fix status 0: No fix, 1: Valid Fix
Start byte 1 — Latitude coordinate Divide by 1,000,000 for float value
NS_Indication 1 — N or S 0: N, 1: S
Longitude 29 — Longitude coordinate Divide by 1,000,000 for float value
EW_Indication 1 — East/West Indication 0: E, 1: W
HDOP 10 — Horizontal dilution Divide by 10 for float value
PDOP 10 — Position dilution Divide by 10 for float value
Speed 10 — Speed in km/h Divide by 10 for float value
Altitude 15 — Altitude in meters Divide by 10 for float value
Power Status 1 — Power connection status 0: Power disconnected, 1: Power connected
Ignition Status 1 — Ignition status 0: OFF, 1: ON
Immobilizer Status 1 — Immobilizer status 0: OFF, 1: ON
Tamper 1 — Wire Tamper detection 0: Tamper clear, 1: Tamper alert ON
Supply Voltage 6 — External battery voltage Divide by 10 for float value
Internal Battery Voltage 6 — Internal battery voltage Divide by 10 for float value
Fuel SensorValue 1 16 — Fuel sensor value Divide by 10 if float
Fuel Percentage 1 16 — Fuel level percentage Divide by 10 for float value
Fuel SensorValue 2 16 — Fuel sensor value Divide by 10 if float
Fuel Percentage 2 16 — Fuel level percentage Divide by 10 for float value
Fuel SensorValue 3 16 — Fuel sensor value Divide by 10 if float
Fuel Percentage 3 16 — Fuel level percentage Divide by 10 for float value
Analog Input 10 — Analog input Divide by 10 for float value
Analog Input 1 10 — Analog input 1 Divide by 10 for float value
Digital Input 1 1 — Digital input 1 0 or 1
Digital Input 2 1 — Digital input 2 0 or 1
Digital Output 1 1 — Digital output 1 0 or 1
Digital Output 2 1 — Digital output 2 0 or 1
Temperature sensor status 1 1 — Status of temperature sensor 1 1 if connected, 0 if not connected
Temperature 1 12 — Temperature in °C Signed, divide by 10
Temperature sensor status 2 1 — Status of temperature sensor 2 1 if connected, 0 if not connected
Temperature 2 12 — Temperature in °C Signed, divide by 10
Temperature sensor status 3 1 — Status of temperature sensor 3 1 if connected, 0 if not connected
Temperature 3 12 — Temperature in °C Signed, divide by 10
Humidity 8 — Humidity percentage
Odometer 35 — Odometer value in meters
DateTime UTC 32 — Timestamp UTC time in seconds
TimeZone 8 —

Timezone in quarter-hours (e.g., 22 = +5:30). Each unit = 15 mins. Value 22 = 22 × 15 mins = 330 mins = +5:30 Range: -48 to 56, 2's complement ||

Tail
End Character 8 0–7 Starting character * (ASCII value 42) *
CRC 8 8–15 8-bit XOR CRC of data starting from $ to * (excluding $ and *)

Sample Packet

HEX "240370e2400e60e3ad81801b0cfaca0be02541c2000000000000000000000000000000009800000000000000000000000000000000000000000000006875e9e5162a05"

{
"imei": 864218069278060, 
"packet_type": 1,
"no_packets": 1,
"packet_status": 1, 
"frame_number": 54, 
"alert_id": 3, 
"operator": 3, 
"signal_strength": 29, 
"mcc": 404, "mnc": 95, 
"cell_id": 298, 
"lac": 3600, 
"fix_status": 0, 
"latitude": 0.0, 
"latitude_dir": 0, 
"longitude": 0.0, 
"longitude_dir": 0, 
"hdop": 0.0, 
"pdop": 0.0, 
"speed": 0.0, 
"altitude": 0.0,
"power": 0, 
"ignition": 0, 
"immobilizer": 0, 
"tamper": 0, 
"supply_volatge": 0.0, 
"internal_battery_volatge": 3.8, 
"fuel_sensor_status_1": 0, 
"fuel_percentage_1": 0.0, 
"fuel_value_sensor_1": 0, 
"fuel_sensor_status_2": 0, 
"fuel_percentage_2": 0.0, 
"fuel_value_sensor_2": 0, 
"fuel_sensor_status_3": 0, 
"fuel_percentage_3": 0.0, 
"fuel_value_sensor_3": 0, 
"analog_input1": 0.0, 
"analog_input2": 0.0, 
"digital_input1": 0, 
"digital_input2": 0, 
"digital_output1": 0, 
"digital_output2": 0, 
"temp_sensor_status_1": 0, 
"temperature_1": 0.0, 
"temp_sensor_status_2": 0, 
"temperature_2": 0.0, 
"temp_sensor_status_3": 0, 
"temperature_3": 0.0, 
"humidity": 0, 
"odometer": 0, 
"dateTime": 1752558053, 
"timezone": 22, 
"dateTime_tz": "2025-07-15 11:10:53", 
"error_code": 0 
}

Parser

Telemetry Packet Parser


FieldValue

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