The "msg-dtc-decoder" plugin-type allows you to decode source DTC codes like “P0068” into a human-readable form, for example “MAP/MAF - Throttle Position Correlation”.
The plugin automatically analyzes tracker messages for trouble codes and, if there is such a code in the plugin's database, adds a description to it. If the device sends error codes they will be parsed as an array:
can.dtc: ["P0068", "P0507"]
description of the parameters will be added as a separate parameter for each element.
can.dtc.P0068.description: "MAP/MAF - Throttle Position Correlation"
can.dtc.P0507.description: "Idle Air Control System RPM Higher Than Expected"
If the description is not found, the parameter value will be Unknown, for example:
can.dtc.P0507.description: "Unknown"
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 on May 8, 2025.
For reference, two additional parameters have been temporarily added:
- can.dtc.strings - contains errors in the current format
- can.dtc.objects - contains errors in the new format
Both temporary parameters will be removed on May 24, 2025.
How to use
Click on the "+" button in the Telematics Hub -> Plugins section to create a new plugin:
Pick “msg-dtc-decoder” in the configuration drop-down.
When you assign device to this plugin, you'll see new parameters in device messages:
If you analyze intervals data (e.g. vehicle trips) with calculators you can use a counter of type="parameter", method="distinct" with parameter="can.dtc" to add to the interval an array with all distinct DTC codes that were reported by the vehicle during that interval (trip).
Change log
Subscribe to the DTC decoder plugin change log to stay in sync with any updates.
More plugin types
Find a comprehensive list of available plugins types here.