pycan

A Python module for implementing a UDS (Unified Diagnostic Services) + ISO-TP (ISO 15765-2) stack for automotive diagnostics.

Installation

You can install the module using pip:

pip install pycan

Usage

example.py

from pycan import ISOTP, UDS

def bytearray2hex(d):
    return " ".join("{:02X}".format(x) for x in d)

def recv(id):
    ret = None

    # Peripheral logic here

    return ret

def send(id, extended, fd, data):
    print("CAN TX    {:02X}|{}|{}|{}".format(id,
                                             "EXT" if extended else "NOEXT",
                                             "FD" if fd else "NOFD",
                                             bytearray2hex(data)))
    # Peripheral logic here

    return len(data)

def main():
    isotp = ISOTP(recv=recv,
                  send=send, 
                  fd=True)

    uds = UDS(rxid=0x718,       # Default configuration (can be changed on each function if supported)
              txid=0x710,       # Default configuration (can be changed on each function if supported)
              extended=False,   # Default configuration (can be changed on each function if supported) 
              recv=isotp.recv,  # Select here the lower layer in the stack
              send=isotp.send,  # Select here the lower layer in the stack
              fd=True)          # Default configuration (can be changed on each function if supported)

    print('Start routine')
    ret, data = uds.routineStart(0xaabb)
›    if ret:
        print("Positive response with value: {}".format(bytearray2hex(data)))

    print('Stop routine')
    ret, data = uds.routineStop(0xaabb)
    if ret:
        print("Positive response with value: {}".format(bytearray2hex(data)))

    print('Results routine')
    ret, data = uds.routineResult(0xaabb)
    if ret:
        print("Positive response with value: {}".format(bytearray2hex(data)))

if __name__ == '__main__':
    main()

Roadmap

Phase 1: Initial Setup

Step 1: Project Structure

Create the initial project structure.

pycan/
├── pycan/
│   ├── __init__.py
│   ├── pyisotp.py
│   ├── pyuds.py
│   └── utility.py
├── setup.py
└── README.md

Step 2: Implement CAN Interface

Write can_interface.py to handle basic CAN communication.

Step 3: Implement ISO-TP Layer

Write pyisotp.py to manage ISO-TP message fragmentation and reassembly.

Step 4: Implement UDS Protocol

Write pyuds.py to implement UDS over ISO-TP.

Step 5: Create Setup Script

Write setup.py for module packaging and installation.

Step 6: Write README

Create a comprehensive README.md with installation and usage instructions.

Phase 2: Development and Testing

Step 7: Develop Core Features

Step 8: Unit Testing

Write unit tests for pyisotp.py.
Write unit tests for pyuds.py.

Step 9: Integration Testing

Perform integration tests to ensure all components work together.