Install & Compatibility
Where this runs
tested against v0.29.10 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 6.0s · import 0.896s · 56MB
58MB installed
● package 58MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Master
✓ from pyxcp import Master
✗ from pyxcp.master import Master
Master is directly exposed at package level
SlaveProperties
✓ from pyxcp import SlaveProperties
✗ from pyxcp.slave import SlaveProperties
Old internal module path removed in v0.27
types module
✓ from pyxcp import types
✗ from pyxcp.types import *
types is a submodule; wildcard import not supported
Connect to an XCP slave over CAN and read slave properties.
from pyxcp import Master, SlaveProperties
import pyxcp.transport.can as can
master = Master(can.CanCCPSlave(channel='can0', baudrate=500000))
props = master.getSlaveProperties()
print(f"Slave ID: {props.slaveId}, Protocol: {props.protocolVersion}")
master.disconnect()
Errors
Common errors & fixes
ERR_OUT_OF_RANGE when configuring DAQ with interleavedMode=True
Sequence counter byte not included in overhead calculation (fixed in v0.28.0)
fixUpgrade to pyxcp >=0.28.0 or disable interleavedMode
ImportError: cannot import name 'Master' from 'pyxcp'
Older pyxcp version or wrong installation (Master is only available from pyxcp package top-level)
fixpip install --upgrade pyxcp
pyxcp.transport.can.CanCCPSlave is deprecated: use CanCcpslaveInterface instead
Class renamed in v0.27.0; old name still works but triggers deprecation warning
fixUse CanCcpslaveInterface instead (case-sensitive)
Upgrade
Version history
0.29.10latest on PyPI · released Jun 3, 2026
Audit
Dependencies
pylibpcap (optional)optionalRaw Ethernet XCP transport (install as pyxcp[ethernet])
python-can (optional)optionalCAN transport (install as pyxcp[can])
cffi (optional)optionalUSB transport (install as pyxcp[usb])