[Changelog] xirgo protocol

baja

Xirgo Technologies is a US-based manufacturer of high-quality GPS tracking devices.

Xirgo

This topic will be used to post changes in xirgo protocol implementation used by the following devices:
Xirgo XT-2000
Xirgo XT-2050
Xirgo XT-2060
Xirgo XT-2150
Xirgo XT-2160
Xirgo XT-2400
Xirgo XT-4000
Xirgo XT-4550
Xirgo XT-4560
Xirgo XT-4750
Xirgo XT-4850
Xirgo XT-4860
Xirgo XT-4970
Xirgo XT-6300

baja

Added device type XT-4970 of Xirgo 4900 series

namo

xirgo protocol updated:
parameter engine.oil.level is renamed to can.engine.oil.level
Currently both parameters are registered for backward compatibility. The old parameter engine.oil.level will be removed 19 Nov 2019.

namo

namo
Parameter engine.oil.level is removed from xirgo protocol.

namo

The following parameters are renamed in xirgo protocol:

engine.coolant.level is renamed to can.engine.coolant.level
engine.coolant.pressure is renamed to can.engine.coolant.pressure

Currently both parameters are registered for backward compatibility. The old parameters will be removed in a week 15 Dec 2020.

namo

namo
Xirgo protocol updated: old parameters remove after renaming.

EvgenyShatilo

Major protocol update.
Added implementation for the binary part of the Xirgo protocol.
Added 2 NEW models that support the binary protocol: XT2400 and XT6300. Implemented for about 200 configurable parameters. Only default device configurations are supported::

# Generic Alerts (23)
# <PID><UID><CellSerialId><RSN><DandT><LT><LN><AL><SP><AC><DC><HD><RP><SV><HP><MI><MG><BV><CQ><GS><GT><FL><SEQ>
:wycfg pcr[0] 001701039504060708095793940a5813122e7dc814324a5a05

# Geofence Crossing Alerts (18)
# <PID><UID><CellSerialId><RSN><GFN><DandT><LT><LN><AL><SP><HD><SV><HP><MI><BV><CQ><SEQ>
:wycfg pcr[1] 0112010395044106070809570a13122e171405

# Accelerometer Alerts (23)
# <PID><UID><CellSerialId><RSN><SDT><SLT><SLN><SSP><SHD><MA><AED><EDT><ELT><ELN><ESP><EHD><RP><SV><HP><MI><BV><CQ><SEQ>
:wycfg pcr[2] 021701039504191a1b1c1d1e1f20212223245813122e171405

# Ignition On Periodic Report with Maximum Speed Reporting (15)
# <PID><UID><CellSerialId><RSN><DandT><MDT><MLT><MLN><MSP><RP><SV><HP><MI><BV><CQ><SEQ>
:wycfg pcr[3] 030f010395044a4b4c445813122e171405

# Power-up/Reset/Wake-up Alert (18)
# <PID><UID><CellSerialId><RSN><DandT><LT><LN><AL><SP><HD><SV><HP><MI><BV><CQ><WRN><BS><SEQ>
:wycfg pcr[15] 0f120103950406070809570a13122e1714536905

# Device Diagnostic Alert (18)
# <PID><UID><CellSerialId><RSN><DandT><LT><LN><SV><HP><CQ><CI><APN><BV><IBV><WRN><LO><VIN><SEQ>
:wycfg pcr[127] 7f1201039504060708131214156a171653186505

#DTC Alerts (11)
:wycfg pcr[4] 040b01039504060708096b6c05

EvgenyShatilo

The ability to send custom commands via SMS has been added.

YuryAheichyk

The protocol will be affected by the change in parameter can.dtc to be installed in 2 weeks - Mar 15th, 2024: the parameter can.dtc is currently of string type and will be converted to type array with separate DTC codes.

Added parameter can.dtc.array as an example of future implementation of can.dtc

YuryAheichyk

YuryAheichyk changes have been applied, the can.dtc parameter type changed to array

YuryAheichyk

The OBDII DTC codes registration is planned to be changed. Currently, error codes are stored in the can.dtc parameter as an array of strings. To unify with other diagnostic protocol types, errors will be stored as an array of objects.

The changes will be applied in 2 weeks, on May 8, 2025.

For reference, two additional parameters have been added:

can.dtc.strings - contains errors in the current format (will be removed in 1 month, on May 24, 2025)
can.dtc.objects - contains errors in the new format (will be removed in 2 weeks, on May 8, 2025)

can.dtc.strings example:
["P0020","U0001"]
can.dtc.objects example:
[{"standard":"OBDII","code":"P0020"},{"standard":"OBDII","code":"U001"}]

YuryAheichyk

YuryAheichyk changes applied, can.dtc array contain objects now.

For reference, two additional parameters added:

can.dtc.strings - contains errors in the old format (will be removed on May 24, 2025)
can.dtc.objects - contains errors in the new format (will be removed on May 24, 2025)

can.dtc.strings example:
["P0020","U0001"]
can.dtc.objects example:
[{"standard":"OBDII","code":"P0020"},{"standard":"OBDII","code":"U001"}]