Skip to content

Home

Jump to bottom
Mehmet ASLAN edited this page May 8, 2025 · 3 revisions

UDS Tracer

This tool is designed for listening to CAN traffic and identifying UDS (Unified Diagnostic Services) packages. It provides a graphical interface to help users analyze and validate the data efficiently. It supports CAN Standard (CAN Std), CAN Flexible Data-rate (CAN FD), and replaying recorded data for detailed analysis.

Supported Devices

This tool supports the following devices for CAN communication:

  • PEAK-System USB CAN interfaces

Compilation

To compile the UDS Tracer tool, instructions can be found in the project's doxygen documentation.

Perfetto

You can drag and drop recorded files directly into the Perfetto.

Explanation of 3 items:

  1. ISOTP Packet - Displays the raw packet of the ISO-TP (ISO 15765-2)
  2. CAN Message Display - Shows the CAN raw messages which creates ISO-TP packet.
  3. Timestamp of Creation - Displays the timestamp of when the item was created. Note that this timestamp does not indicate when the CAN message was received.

Desktop Application Gui

Recording CAN Signals

There are two ways to record CAN signals for UDS packages:

  1. CAN Std - Standard CAN protocol.
  2. CAN FD - Flexible Data-rate CAN protocol.

Replaying Pre-recorded CAN Signals

You can also replay pre-recorded CAN signals to simulate and analyze UDS packages. This feature allows you to test and debug without requiring a live CAN bus connection.

Explanation of TracerTab

The TracerTab contains the following 8 items:

  1. Select how many last items should be visible - Allows you to choose the number of most recent traced items to display in the TracerTab.
  2. Select UDS Request CAN ID to Listen - Specify the CAN ID (in hexadecimal format, without the 0x prefix) to listen for UDS requests.
  3. Select UDS Response CAN ID to Listen - Specify the CAN ID (in hexadecimal format, without the 0x prefix) to listen for UDS responses.
  4. Clear the items in the list widget - Provides an option to clear all the traced items currently displayed in the TracerTab.
  5. Start Recording - Initiates the recording of CAN signals, capturing UDS request and response data for analysis.
  6. Choose File Directory to Store Recorded Data - Allows you to select a directory where the recorded CAN signal data will be saved for future reference and analysis.
    1. CAN Configuration as XML - Each recording includes a CAN configuration file in XML format, detailing the setup and parameters used during the recording session.
    2. Raw CAN Signals in COBS - The raw CAN signals are stored in a COBS (Consistent Overhead Byte Stuffing) encoded format for efficient storage and transmission.
    3. JSON File for Perfetto - A JSON file is generated for Perfetto, enabling detailed performance analysis and visualization of the recorded UDS packages.
  7. Traced Data Itself - Displays the traced UDS request and response data in real-time, allowing you to monitor and analyze the communication directly within the TracerTab.
  8. Number of UDS Packets Processed - Displays the total count of UDS packets processed during the current session, providing an overview of the communication activity.

Clone this wiki locally