Skip to content

Latest commit

 

History

History
99 lines (76 loc) · 4.33 KB

README.md

File metadata and controls

99 lines (76 loc) · 4.33 KB
Raw

parse_dtc_from_asc

Description: Parse J1939 Diagnostics Trouble Code (DTC) from CANalyzer ASC logging file.

image

Overview

This script processes J1939 Diagnostic Trouble Code (DTC) messages from a CANalyzer ASC logging file, specifically focusing on messages with PGN 0xFECA (DM1). It can handle both single-frame and multi-frame (BAM) messages. The GUI provides a real-time display of active faults, their status, and an adjustable debounce setting.

Features

  • Parse single-frame DM1 messages.
  • Parse multi-frame DM1 messages using BAM (Broadcast Announce Message).
  • Maintain a list of active faults, adding new faults and marking those that are inactive for a specified period (debounce inactive).
  • Emulate real-time processing based on timestamps in the log file.
  • Display complete timeline of active/inactive status transitions
  • GUI display of active faults (green) , inactive faults (gray), and candidate faults (white), with dynamic updates.
  • GUI adjustable debounce time setting for a fault to become 'active' or 'inactive' .

Usage

  1. Set the file_path variable to the path of your ASC log file.
  2. Adjust the print control variables as needed to debug in Terminal:
    • PRINT_DM1_SINGLE_FRAME: Print on single-frame DM1 messages.
    • PRINT_TP_CM: Print TP.DT messages.
    • PRINT_TP_DT: Print TP.DT messages.
    • PRINT_J1939TP_FECAp: Print concatenated J1939TP FECA messages.
    • PRINT_TP_DM1_MULTI_FRAME: Print multi-frame DM1 messages.
    • PRINT_INCORRET_ORDER: Print a message when packet order is incorrect.
    • PRINT_DM1_PARSED: Print parsed DM1 messages.
    • PRINT_ACTIVE_DTCs: Print active DTCs list.
    • PRINT_NEW_ACTIVE_DTCs: Print new active DTCs.
    • PRINT_REMOVED_ACTIVE_DTCs: Print removed DTCs that was active before.
    • PRINT_REMOVED_CANDIDATE_DTCs: Print removed DTCs that was a candidate before.
  3. Run the script.

GUI Display

The GUI displays the following columns for each active fault:

  • Last Seen: Timestamp of the last occurrence
  • Status: Fault status (acive, inactive or candidate)
  • SRC: Source Address
  • SPN: Suspect Parameter Number
  • FMI: Failure Mode Identifier
  • CM: SPN Conversion Method
  • OC: Occurrence Count
  • MIL: Malfunction Indicator Lamp status
  • RSL: Red Stop Lamp status
  • AWL: Amber Warning Lamp status
  • PL: Protect Lamp status

GUI Elements

  • Start Time Emulation: Emulate real-time execution.
  • Show Complete Timeline: Show a complete timeline of every status transitions (active/inactive).
  • Timestamp Display: Shows the current emulated time in seconds.
  • Debounce Inactive Fault: An entry field to adjust the debounce duration for a fault to change from 'active' to 'inactive'.
  • Debounce Active Fault: An entry field to adjust the debounce active window for a fault to change from 'candidate' to 'active'.
  • Debounce Active Count: An entry field to adjust how many times a fault code must be read in order to change from 'candidate' to 'active' within the debounce active window.

Output Format

When only PRINT_DM1_PARSED is active:

DM1 -> Time: 110.945338, SRC: 0x03 (3), MIL: 3, RSL: 1, AWL: 1, PL: 0
        DTC[1] -> SPN: 0xBE (190), FMI: 8, CM: 0, OC: 2
        DTC[2] -> SPN: 0x201 (513), FMI: 8, CM: 0, OC: 2
        DTC[3] -> SPN: 0xBD2 (3026), FMI: 4, CM: 0, OC: 7
        DTC[4] -> SPN: 0xD1D (3357), FMI: 8, CM: 0, OC: 2
        DTC[5] -> SPN: 0x5C (92), FMI: 8, CM: 0, OC: 2
        DTC[6] -> SPN: 0x208 (520), FMI: 8, CM: 0, OC: 2
        DTC[7] -> SPN: 0x6E (110), FMI: 8, CM: 0, OC: 2
        DTC[8] -> SPN: 0x6C (108), FMI: 8, CM: 0, OC: 2

When EMULATE_TIME and PRINT_ACTIVE_DTCs is active:

  • New faults are printed as:

    {timestamp} new fault SRC: 0x{src} ({int(src, 16)}), SPN: 0x{format(spn, 'X')} ({spn}), FMI: {fmi}

  • Removed faults are printed as:

    {timestamp} removed fault SRC: 0x{fault['src']} ({int(fault['src'], 16)}), SPN: 0x{format(fault['spn'], 'X')} ({fault['spn']}), FMI: {fault['fmi']}

  • Active faults list is printed as:

    Active Faults:
      SRC: 0x{fault['src']} ({int(fault['src'], 16)}), SPN: 0x{format(fault['spn'], 'X')} ({fault['spn']}), FMI: {fault['fmi']}