python-can & python-uds Libraries

"""python-can basics for ECU test automation."""
import can

# Supported interfaces: socketcan, vector, kvaser, pcan, ixxat, usb2can
bus = can.interface.Bus(channel="vcan0", bustype="socketcan")

# Send a raw CAN frame
msg = can.Message(
    arbitration_id=0x1A3,
    data=bytes([0x00, 0x32, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00]),
    is_extended_id=False
)
bus.send(msg)

# Receive with timeout
received = bus.recv(timeout=1.0)
if received:
    print(f"ID: 0x{received.arbitration_id:03X} data: {received.data.hex()}")

# Use cantools to decode with DBC
import cantools
db = cantools.database.load_file("vehicle.dbc")
decoded = db.decode_message(received.arbitration_id, received.data)
print(decoded)  # {"VehicleSpeed": 50.0, ...}

# Periodic sender
task = bus.send_periodic(msg, period=0.010)  # 10ms cycle
import time; time.sleep(5.0)
task.stop()
bus.shutdown()

"""python-uds for UDS diagnostic testing."""
from uds import Uds

# Connect to ECU via ISO-TP over CAN
uds_client = Uds(transportProtocol="CAN",
                  transportMedium="socketcan",
                  interface="vcan0",
                  reqId=0x7E0,
                  resId=0x7E8)

# Read ECU identification (0x22 - ReadDataByIdentifier)
response = uds_client.send([0x22, 0xF1, 0x90])  # VIN
vin = response[3:].decode("ascii")
print(f"VIN: {vin}")

# Clear DTCs (0x14 - ClearDiagnosticInformation)
uds_client.send([0x14, 0xFF, 0xFF, 0xFF])

# Read DTCs (0x19 - ReadDTCInformation)
dtcs = uds_client.send([0x19, 0x02, 0x08])  # status 0x08 = confirmed
print(f"Active DTCs: {dtcs}")

# ECU Reset (0x11)
uds_client.send([0x11, 0x01])  # hard reset
import time; time.sleep(3.0)   # wait for reboot

# Write to NVM (requires extended session 0x10 0x03 first)
uds_client.send([0x10, 0x03])  # extended session
uds_client.send([0x2E, 0x01, 0x00, 0x01])  # write DID 0x0100