DiagKit.Uds

A self-contained .NET 10 library implementing UDS (ISO 14229) over DoCAN (ISO 15765) and DoIP (ISO 13400) for automotive ECU diagnostics. Zero external NuGet dependencies.

中文文档

Highlights

• No external NuGet dependencies — pure .NET 10, single assembly
• Layered protocol stack — CAN frame → DoCAN / DoIP transport → UDS client/server → service helpers
• Async-first API — sync/async variants for DoCAN; DoIP and services are async-first
• CAN-FD ready — DLC mapping for classic CAN and CAN-FD with configurable mixing modes
• Robust NRC handling — automatic state machines for RC 0x78 (ResponsePending) and RC 0x21 (BusyRepeatRequest)
• Pluggable transport — accepts delegates, Channel<T>, BlockingCollection<T>, or custom transmitters
• Server side included — AsyncUdsServer dispatcher and UdsEcuSimulator for testing
• Helpers for common services — SessionControl, TesterPresent, SecurityAccess, ReadDataByIdentifier, RoutineControl, ReadDtcInformation, RequestDownload, TransferData, RequestTransferExit

Installation

dotnet add package DiagKit.Uds

Optional CanHub bridge:

dotnet add package DiagKit.Uds.CanHub

Quick start

using DiagKit.Uds.DoCan;
using DiagKit.Uds.UdsLayer;
using System.Threading.Channels;

var sendChannel    = Channel.CreateUnbounded<CanFrame>();
var receiveChannel = Channel.CreateUnbounded<CanFrame>();

var transport = new AsyncDoCanTransmitter(sendChannel, receiveChannel,
    new DoCanOptions { RequestId = 0x7E0, ResponseId = 0x7E8 });

var client = new AsyncUdsClient(transport);
byte[] response = await client.SendRequestAsync(new byte[] { 0x10, 0x03 });

CanHub users can create the DoCAN transport directly from an opened bus:

using DiagKit.Uds.CanHub;

await using ICanBus bus = await registry.OpenAsync("vector://VN16XX?channelIndex=0");
await using var transport = bus.CreateDoCanTransport(new DoCanOptions
{
    RequestId = 0x7E0,
    ResponseId = 0x7E8,
});

See the package README for detailed API documentation, server-side usage, DoIP transport, and full configuration reference.

Build

dotnet restore "DiagKit.Uds.slnx"
dotnet build "DiagKit.Uds.slnx" -c Release --no-restore
dotnet test tests\DiagKit.Uds.Tests\DiagKit.Uds.Tests.csproj
dotnet test tests\DiagKit.Uds.CanHub.Tests\DiagKit.Uds.CanHub.Tests.csproj
dotnet pack src\DiagKit.Uds\DiagKit.Uds.csproj -c Release --no-build -o artifacts\packages
dotnet pack src\DiagKit.Uds.CanHub\DiagKit.Uds.CanHub.csproj -c Release --no-build -o artifacts\packages

License

MIT — see LICENSE.