XCP Driver¶

jumpstarter-driver-xcp provides XCP (Universal Measurement and Calibration Protocol) support for Jumpstarter, enabling remote measurement, calibration, DAQ (data acquisition), and programming of XCP-enabled ECUs.

It wraps the pyXCP library and supports Ethernet (TCP/UDP), CAN, USB, and Serial (SxI) transports.

Installation¶

pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ jumpstarter-driver-xcp

Configuration¶

Ethernet (TCP)¶

export:
  xcp:
    type: jumpstarter_driver_xcp.driver.Xcp
    config:
      transport: ETH
      host: "192.168.1.100"
      port: 5555
      protocol: TCP

Ethernet (UDP)¶

export:
  xcp:
    type: jumpstarter_driver_xcp.driver.Xcp
    config:
      transport: ETH
      host: "192.168.1.100"
      port: 5555
      protocol: UDP

CAN¶

export:
  xcp:
    type: jumpstarter_driver_xcp.driver.Xcp
    config:
      transport: CAN
      can_interface: vector
      channel: 0
      bitrate: 500000
      can_id_master: 0x7E0
      can_id_slave: 0x7E1

Using a pyXCP Config File¶

For advanced configuration (seed & key, DAQ policies, etc.), provide a pyXCP configuration file:

export:
  xcp:
    type: jumpstarter_driver_xcp.driver.Xcp
    config:
      transport: ETH
      config_file: /path/to/xcp_config.py

Configuration Parameters¶

Parameter	Type	Default	Description
`transport`	`str`	`ETH`	Transport layer: `ETH`, `CAN`, `USB`, `SXI`
`host`	`str`	`localhost`	IP address or hostname (Ethernet only)
`port`	`int`	`5555`	Port number (Ethernet only)
`protocol`	`str`	`TCP`	`TCP` or `UDP` (Ethernet only)
`can_interface`	`str`	`None`	python-can interface name (CAN only)
`channel`	`str\|int`	`None`	CAN channel (CAN only)
`bitrate`	`int`	`None`	CAN bitrate in bits/s (CAN only)
`can_id_master`	`int`	`None`	CAN ID for master -> slave (CAN only)
`can_id_slave`	`int`	`None`	CAN ID for slave -> master (CAN only)
`config_file`	`str`	`None`	Path to a pyXCP config file (overrides individual params)

Usage¶

from jumpstarter.common.utils import env

with env() as client:
    xcp = client.xcp

    info = xcp.connect()
    print(f"Max CTO: {info.max_cto}, Max DTO: {info.max_dto}")

    xcp.unlock()

    data = xcp.upload(4, 0x1000)
    print(f"Memory at 0x1000: {data.hex()}")

    xcp.download(0x2000, b"\x42\x00\x00\x00")

    xcp.disconnect()

API Reference¶

class jumpstarter_driver_xcp.driver.Xcp¶

XCP (Universal Measurement and Calibration Protocol) driver.

Wraps the pyXCP library to provide remote access to XCP-enabled devices (ECUs) for measurement, calibration, DAQ, and programming.