python中的udsoncan包+cantools包

王夏奇

531人浏览 · 2026-03-18 09:16:54

王夏奇 · 2026-03-18 09:16:54 发布

一、整体概述

udsoncan 和 cantools 是 Python 车载开发领域的两大核心库，分工互补：

udsoncan：聚焦 UDS 应用层（ISO 14229），实现诊断指令的封装、发送和响应解析；
cantools：聚焦 CAN 总线数据解析（DBC 文件），实现 CAN 报文的编解码、信号解析，是车载 CAN 开发的基础工具。

两者结合可完整覆盖「CAN 总线通信 + UDS 诊断」的核心需求，是车载 ECU 测试、诊断工具开发的黄金组合。

二、udsoncan 深度解析（UDS 协议核心）

1. 核心定位

纯 Python 实现的 UDS（ISO 14229）协议客户端库，专注于「诊断仪侧」功能，无需从零编写 UDS 协议解析逻辑，直接调用封装好的 API 即可实现 ECU 诊断操作。

2. 核心能力（补充前文未覆盖的细节）

表格

模块 / 功能	具体说明
连接层适配	支持 `IsoTPSocketConnection`（ISO-TP）、`SocketConnection`（TCP/UDP）等，可对接物理 CAN / 虚拟 CAN
安全访问（0x27 服务）	内置通用安全访问流程，支持自定义密钥算法（如种子 - 密钥加密）
固件刷写（0x34/36/37）	封装下载请求、数据传输、传输结束等刷写核心步骤，支持分块传输
否定响应（NRC）处理	内置 100 + 种 NRC 码解析（如 0x13 = 无效数据长度、0x31 = 请求超出范围），可自定义异常逻辑
日志与调试	支持分级日志（DEBUG/INFO），可输出原始报文、解析过程，便于定位问题

3. 关键依赖与环境

基础依赖：Python 3.6+，无强制第三方依赖（仅 UDS 应用层）；
通信依赖：若需 CAN 总线通信，需搭配 python-can（底层 CAN 收发）、isotp（ISO-TP 传输层）；
运行环境：Linux（推荐，支持 SocketCAN）、Windows（需适配 CANoe/CANalyzer 驱动）。

三、cantools 深度解析（CAN 总线数据核心）

1. 核心定位

cantools 是 Python 中最主流的 CAN 总线数据解析库，核心功能是加载+解析「DBC 文件」（车载 CAN 总线的标准数据库文件），实现 CAN 报文 <-> 信号的双向转换，无需手动计算信号的字节位、端序、缩放因子。

2. 核心能力

（1）DBC 文件解析（核心）

DBC 文件是车载 CAN 开发的「字典」，定义了：

CAN 报文的 ID、名称、长度；
报文中每个信号的起始位、长度、端序（大 / 小端）、缩放因子、偏移量、物理值范围。

cantools 可直接加载 DBC 文件，一键解析报文：

python

import cantools
import can

# 加载DBC文件
db = cantools.database.load_file("vehicle.dbc")

# 示例1：解析CAN报文（原始字节→物理值）
# 假设收到CAN报文：ID=0x123，数据=[0x10, 0x20, 0x30]
msg_data = b'\x10\x20\x30'
msg = db.decode_message(0x123, msg_data)
print("解析后的信号：", msg)
# 输出示例：{'speed': 80.0, 'rpm': 2000, 'gear': 3}

# 示例2：构造CAN报文（物理值→原始字节）
# 要发送：speed=60.0, rpm=1500, gear=2
data = db.encode_message(0x123, {'speed': 60.0, 'rpm': 1500, 'gear': 2})
print("编码后的字节：", data.hex())
# 输出示例：'0c181e0000000000'

这段代码中，核心函数如下

（1）cantools .database.load_file("核心参数DBC数据地址")，实现功能加载dbc数据。该函数可以理解为返回了一个database的对象

（2）db.decode_message()，主要是原始数据和ID为实参，返回值是以信号名称=字典key，信号物理值为=字典value

（3）db.encode_meaasge(字典类型的信号名称和物理值)，功能是编码为raw类型的数据，放回的是一个原始值对象。如果要放到报文中，还需要data.hex()将数据装换为hex格式

（2）其他核心功能

表格

功能	说明
DBC 文件编辑	支持动态添加 / 修改报文、信号（如 `db.add_message()`、`db.add_signal()`）
报文过滤	按 ID、名称筛选报文，支持正则匹配
导出 / 转换	可将 DBC 导出为 JSON、CSV，或转换为其他格式（如 KCD）
兼容多种 CAN 协议	支持标准 CAN（2.0A）、扩展 CAN（2.0B），适配不同厂商的自定义 DBC 扩展
命令行工具	提供 `cantools` 终端命令，可直接解析报文、验证 DBC 文件（如 `cantools decode vehicle.dbc 0x123 102030`）

3. 安装与依赖

pip install cantools
# 可选依赖（提升性能/兼容性）：
pip install cantools[plot]  # 支持信号可视化
pip install cantools[test]  # 支持单元测试

这里的cantools[plot]和cantools[test],

（1）cantools[plot]是支持可视化的图标测试，

（2）cantools[test]是能对DBC数据进行校验(报文数量+ID检测+数据装换（物理值+原始值）)，信号起始位+长度检测都可以，一般我们先集成可视化功能即可。

四、udsoncan + cantools 组合使用示例

场景：通过 UDS 读取 ECU 的车速数据（DID=0x2100），并结合 DBC 文件解析车速信号（替代手动编解码）。

完整代码示例

python

import udsoncan
import cantools
from udsoncan.connections import IsoTPSocketConnection
from udsoncan.client import Client
from udsoncan.exceptions import NegativeResponseException

# --------------------------
# 1. 加载DBC文件（定义车速信号格式）
# --------------------------
# DBC文件中需定义：DID=0x2100对应的数据格式（如2字节、小端、缩放因子0.1）
db = cantools.database.load_file("ecu_diagnostics.dbc")
# 假设DBC中定义了名为"VehicleSpeed"的信号，对应DID=0x2100的字节数据
speed_signal = db.get_signal_by_name("VehicleSpeed")

# --------------------------
# 2. 配置UDS客户端
# --------------------------
udsoncan.setup_logging()
config = {
    'exception_on_negative_response': True,
    'tolerate_zero_padding': True
}

# 建立CAN-ISO-TP连接
tp_conn = IsoTPSocketConnection(
    interface='socketcan',
    channel='can0',
    txid=0x7DF,
    rxid=0x7E8,
    bitrate=500000
)

# --------------------------
# 3. 执行UDS读取+CAN信号解析
# --------------------------
with Client(tp_conn, config=config) as client:
    try:
        # 切换扩展会话
        client.change_session(udsoncan.Session.ExtendedDiagnosticSession)
        
        # 读取DID=0x2100的原始数据
        did_data = client.read_data_by_identifier(0x2100)
        raw_bytes = did_data.data  # 原始字节数据（如b'\x10\x27'）
        
        # 用cantools解析原始字节为物理车速值
        # 手动构造"虚拟报文"（仅用于解析信号，无需CAN ID）
        speed_value = speed_signal.decode(raw_bytes, byte_order='little')
        print(f"解析后的车速：{speed_value} km/h")  # 示例输出：50.3 km/h
        
    except NegativeResponseException as e:
        print(f"UDS否定响应：{e.response.code_name} (0x{e.response.code:02x})")
    finally:
        tp_conn.close()

五、两大库的核心差异与适配场景

表格

维度	udsoncan	cantools
核心协议	ISO 14229（UDS 应用层）	CAN 总线（DBC 解析、报文编解码）
核心目标	实现 ECU 诊断指令的收发	实现 CAN 信号与字节的双向转换
依赖关系	可依赖 python-can/isotp 实现通信	无强制依赖，独立运行
典型场景	读故障码、刷写 ECU、安全访问	解析 CAN 总线实时信号、构造 CAN 报文
与硬件交互	需对接 CAN 物理层（如 SocketCAN）	可解析离线报文，也可对接实时 CAN

六、实战注意事项

DBC 文件规范：cantools 对 DBC 文件的语法严格，需确保 DBC 中信号的起始位、长度、缩放因子与 ECU 实际定义一致；
字节序适配：UDS 数据的字节序（大 / 小端）需与 ECU 匹配，cantools 解析时需显式指定（byte_order参数）；
UDS 数据长度：若 DID 数据超过 8 字节，udsoncan 会自动触发 ISO-TP 分片，需确保底层 CAN 总线支持 ISO-TP；
性能优化：cantools 解析大量实时 CAN 报文时，可预加载 DBC 并缓存信号对象，避免重复解析；
调试技巧：
- udsoncan 开启 DEBUG 日志，查看原始 UDS 报文；
- cantools 使用 cantools dump vehicle.dbc 终端命令，验证 DBC 文件是否正确。