ReadDTCInformation (0x19) - All Sub-Functions

#!/usr/bin/env python3
# 0x19 0x02: Read all active DTCs with status mask

# Status mask meanings:
# 0x08 = confirmed DTC only (bit 3)
# 0x01 = currently failing (bit 0)
# 0xFF = any status bit set
# 0x09 = confirmed OR currently failing

import udsoncan
from udsoncan.client import Client

def read_active_dtcs(client):
    # Read all confirmed DTCs (most common workshop scan)
    resp = client.get_dtc_by_status_mask(0x08)
    if resp.positive:
        confirmed = [(dtc.id, dtc.status.byte) for dtc in resp.service_data.dtcs]
        print(f"Confirmed DTCs ({len(confirmed)}):")
        for dtc_id, status in confirmed:
            print(f"  P{dtc_id:04X}  Status: 0b{status:08b}")
            print(f"    Confirmed: {bool(status & 0x08)}  "
                  f"CurrentlyFailing: {bool(status & 0x01)}  "
                  f"Pending: {bool(status & 0x04)}")

    # Read pending DTCs (failing but not yet confirmed — development use)
    resp = client.get_dtc_by_status_mask(0x04)  # bit 2 = pending
    if resp.positive:
        print(f"Pending DTCs (not yet confirmed): {len(resp.service_data.dtcs)}")

    # Count DTCs first (efficient: no DTC list transfer)
    resp = client.get_number_of_dtc_by_status_mask(0x08)
    if resp.positive:
        print(f"Total confirmed DTCs (count only): {resp.service_data.dtc_count}")

#!/usr/bin/env python3
# 0x19 0x06: Read extended data (occurrence counter, aging counter) for a DTC

import struct, udsoncan
from udsoncan.client import Client

def read_dtc_extended(client, dtc_id: int):
    resp = client.get_dtc_extended_data_record_by_dtc_number(
        dtc_id, extended_data_record_number=0xFF)  # 0xFF = all records
    if not resp.positive:
        print(f"No extended data for P{dtc_id:04X}")
        return

    for record in resp.service_data.extended_data:
        rnum = record.record_number
        data = record.raw_data
        if rnum == 0x01:
            print(f"  Occurrence counter: {data[0]} times")
        elif rnum == 0x02:
            print(f"  Aging counter:      {data[0]}/40 drive cycles")
        elif rnum == 0x03:
            odometer = struct.unpack(">I", data[:4])[0]
            print(f"  First occurrence:   {odometer} km")
        else:
            print(f"  Record 0x{rnum:02X}: {data.hex()}")