1. 工具库简介
1.1 python-can
定位：通用的 CAN 总线通信库，支持多种硬件接口（SocketCAN、PCAN、Kvaser 等）。
核心功能：
连接物理 CAN 设备或虚拟接口。
发送/接收 CAN 报文（标准帧、扩展帧）。
支持 CAN FD（灵活数据速率）。
适用场景：快速搭建 CAN 通信原型，兼容性强。
1.2 canard（CAN 协议栈）
定位：专注于 UDS（ISO 14229） 和 J1939 等高层协议解析的库。
核心功能：
解析 DBC 文件，自动化生成信号值。
支持 UDS 诊断服务（如 0x22 读数据、0x2E 写数据）。
处理多帧传输（如 ISO-TP 协议）。
适用场景：需要与 ECU 进行诊断交互的自动化测试。
2. 环境准备
2.1 安装库
|
1 2 3 4 5 |
# 安装通用 CAN 库 pip install python-can
# 安装 canard（UDS 协议支持） pip install canard |
2.2 硬件准备
物理设备：PCAN-USB、Kvaser、Vector 设备（需安装对应驱动）。
虚拟测试：使用 socketcan（Linux 虚拟 CAN 接口）或 CANoe 模拟总线。
3. 核心功能实现示例
3.1 使用 python-can 收发 CAN 报文
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
import can
# 连接 CAN 接口（以 socketcan 为例） bus = can.interface.Bus(channel='vcan0', bustype='socketcan')
# 发送单帧数据 msg = can.Message( arbitration_id=0x123, # CAN ID data=[0x01, 0x02, 0x03, 0x04], is_extended_id=False # 标准帧 ) bus.send(msg)
# 接收数据 for msg in bus: print(f"Received: ID={hex(msg.arbitration_id)}, Data={msg.data}")
# 关闭连接 bus.shutdown() |
3.2 使用 canard 解析 DBC 文件
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
from canard import Canard from canard.hw import socketcan
# 加载 DBC 文件 dbc = Canard() dbc.load_dbc('vehicle.dbc')
# 创建虚拟 CAN 接口 dev = socketcan.SocketCanDev('vcan0') dev.start()
# 解析接收到的报文 def on_message(msg): decoded = dbc.decode_message(msg.arbitration_id, msg.data) print(f"信号值: {decoded}")
dev.add_listener(on_message) |
3.3 实现 UDS 诊断服务（基于 canard）
|
1 2 3 4 5 6 7 8 9 10 11 |
from canard.proto.uds import UdsClient
# 创建 UDS 客户端 uds = UdsClient(transport=can.Bus(bustype='socketcan', channel='vcan0'))
# 发送诊断请求：读取 ECU 序列号（服务 0x22，参数 0xF189） response = uds.request([0x22, 0xF1, 0x89]) if response: print(f"ECU 序列号: {bytes(response.data[2:]).decode()}") else: print("请求超时") |
4. 自动化测试脚本设计
4.1 测试场景示例：车门状态验证
|
1 2 3 4 5 6 7 8 9 10 11 12 |
def test_door_status(): bus = can.interface.Bus(channel='vcan0', bustype='socketcan')
# 发送车门控制命令（ID=0x200，数据=[0x01] 表示开门） bus.send(can.Message(arbitration_id=0x200, data=[0x01]))
# 等待并验证车门状态反馈（预期 ID=0x201，数据[0]=0x01） for msg in bus: if msg.arbitration_id == 0x201: assert msg.data[0] == 0x01, "车门未正确打开" break bus.shutdown() |
4.2 集成测试框架（如 pytest）
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
import pytest
@pytest.fixture def can_bus(): bus = can.interface.Bus(channel='vcan0', bustype='socketcan') yield bus bus.shutdown()
def test_engine_rpm(can_bus): # 发送转速请求命令 can_bus.send(can.Message(arbitration_id=0x700, data=[0x03]))
# 验证响应是否在合理范围（如 800-5000 RPM） for msg in can_bus: if msg.arbitration_id == 0x701: rpm = int.from_bytes(msg.data[2:4], byteorder='big') assert 800 <= rpm <= 5000, "转速异常" break |
5. 高级应用技巧
5.1 CAN FD 支持
|
1 2 3 4 5 6 7 8 |
# 使用 python-can 发送 CAN FD 报文 msg = can.Message( arbitration_id=0x123, data=[i % 256 for i in range(64)], # 64 字节数据 is_fd=True, bitrate_switch=True # 启用比特率切换 ) bus.send(msg) |
5.2 与 HIL 系统集成
|
1 2 3 4 5 6 7 8 9 10 |
# 连接 Vector 硬件（需安装 XL Driver） bus = can.interface.Bus( bustype='vector', channel=1, app_name='Python_HIL_Test' )
# 发送同步周期性报文 task = bus.send_periodic(msgs=[msg1, msg2], period=0.1) task.stop() # 停止发送 |
5.3 自动化测试报告生成
|
1 2 |
# 使用 pytest-html 生成测试报告 pytest.main(["--html=report.html"]) |
6. 常见问题与调试
6.1 硬件连接失败
现象：CanError: Error sending message
解决：
检查设备驱动是否安装（如 PCAN 需安装 PCAN-Basic API）。
确认通道权限（Linux 需 sudo ip link set vcan0 up）。
6.2 DBC 解析错误
现象：KeyError: 'Unknown frame ID'
解决：确保 DBC 文件中包含目标 CAN ID 的定义。
6.3 多帧传输处理
|
1 2 3 4 5 |
# 使用 canard 处理 ISO-TP 多帧传输 from canard.proto.iso_tp import IsoTpTransport
tp = IsoTpTransport(can_bus, tx_id=0x7E0, rx_id=0x7E8) data = tp.recv() # 接收长数据（自动重组） |
