autouds

autouds 是一个基于 Python 的 UDS (Unified Diagnostic Services) 诊断工具，遵循 ISO 14229-1 标准，通过 autodoip (ISO 13400) 传输层与汽车 ECU 进行诊断通信。

采用生成器驱动的装饰器模式，将 Python 方法映射为 UDS 服务调用，自动处理请求构造、响应解析和负响应异常。

特性

• 覆盖 ISO 14229-1 主要诊断服务：会话控制、安全访问、DTC 读写、数据标识符读写、例行程序控制、上传下载等
• 装饰器驱动：@handler(service_name='session', sub_fn_name='default') 将方法映射到 UDS 服务
• 生成器模式：yield 发送请求，接收 Response 后继续处理，流程直观
• 智能请求构造：支持中文/英文/短键名解析服务 ID 和子功能
• 自动处理延迟响应 (NRC 0x78) 的轮询等待
• 负响应自动转换为 UdsError 异常，附带 NRC 描述
• 基于 autodoip 零依赖传输层

安装

pip install autouds

autodoip 和 pydantic 会作为依赖自动安装。要求 Python ≥ 3.14。

快速开始

from autouds import App

# 创建诊断应用：监听指定 IP，预定义 ECU 列表
app = App(
    ip='192.168.10.1',
    ecus={
        'mcu': (0x1001, '192.168.10.10', 13400),
        'soc': (0x1002, '192.168.10.20', 13400),
    },
)

# 进入默认会话，获取 P2/P2* 定时参数
p2, p2_star = app.default()
print(f'P2={p2}ms, P2*={p2_star}ms')

# 安全访问 (Level 1)
seed = app.l1()
print(f'seed: {seed.hex()}')
# ... 计算密钥 ...
app.l1_ex(key)

# 读取数据标识符
data = app.read_did(0xFF00)
print(f'DID 0xFF00: {data.hex()}')

# 切换到另一个 ECU
app.on('soc')
app.read_dtc_count()

命令行

python -m autouds

运行内置的演示流程（需先修改 __main__.py 中的连接参数）。

支持的 UDS 服务

诊断会话控制 (0x10)

ECU 复位 (0x11)

安全访问 (0x27)

数据读写

DTC 诊断故障码

通信与握手

例行程序与 I/O

上传下载

API 概览

自定义服务

通过 @handler 装饰器和 App 子类可以扩展自定义 UDS 服务：

from autouds import App, handler, Response
from typing import Generator


class MyApp(App):
    @handler(service_name='read_did')
    def read_vin(self) -> Generator[bytes, Response, bytes]:
        resp: Response = yield 0xF190.to_bytes(2, 'big')
        return resp.params

装饰器支持直接指定 service_id / sub_fn：

@handler(s_id=0x22, sub_fn=0x01)
def custom_service(self) -> Generator[bytes, Response, bytes]:
    resp: Response = yield b'\x00\x01'
    return resp.params

依赖

• autodoip — DoIP 传输层 (ISO 13400)
• pydantic — 数据验证

许可证

MIT License