Hsu.Automotive.Uds 2026.7.14-preview.134711

Hsu.Automotive.Uds

A full-featured C# implementation of ISO 14229 Unified Diagnostic Services (UDS).

This package provides the main UDS protocol stack, including protocol models, client and server support, service dispatch infrastructure, and transport integrations used in automotive diagnostic scenarios.

Package Information

• Package ID: Hsu.Automotive.Uds
• Package scope: full protocol stack, runtime components, transports, and extension points
• Recommended for: production UDS clients, diagnostic services, simulators, and automotive tooling

Supported Capabilities

• ISO 14229 UDS client and server runtime support
• Protocol models and service dispatch infrastructure
• ISO-TP and DoIP transport integrations
• Extensible security algorithm and transport integration points
• Multi-targeted support for netstandard2.0, net6.0, net8.0, and net10.0

Supported UDS Services

The core package covers the main ISO 14229-1 service groups used in diagnostic applications.

Diagnostic Communication Management

• 0x10 DiagnosticSessionControl
• 0x11 EcuReset
• 0x27 SecurityAccess
• 0x28 CommunicationControl
• 0x29 Authentication
• 0x3E TesterPresent
• 0x87 LinkControl

Data Transmission

• 0x22 ReadDataByIdentifier
• 0x23 ReadMemoryByAddress
• 0x24 ReadScalingDataByIdentifier
• 0x2A ReadDataByPeriodicIdentifier
• 0x2C DynamicallyDefineDataIdentifier
• 0x2E WriteDataByIdentifier
• 0x2F InputOutputControlById
• 0x3D WriteMemoryByAddress

Stored Data Transmission

• 0x14 ClearDiagnosticInformation
• 0x19 ReadDtcInformation

Routine and Download/Upload Services

• 0x31 RoutineControl
• 0x34 RequestDownload
• 0x35 RequestUpload
• 0x36 TransferData
• 0x37 RequestTransferExit
• 0x38 RequestFileTransfer

Features

• ISO 14229 UDS protocol support
• Client and server runtime components
• ISO-TP and DoIP transport support
• Extensible security and transport integration points
• Multi-targeted package for modern .NET runtimes

Install

dotnet add package Hsu.Automotive.Uds

Quick Start

The quick-start example below connects to an ECU over DoIP, switches to an extended diagnostic session, and reads VIN DID 0xF190.

using System.Text;
using Hsu.Automotive.Uds.Client;
using Hsu.Automotive.Uds.Services;
using Hsu.Automotive.Uds.Transport;

var cancellationToken = CancellationToken.None;

await using var channel = await DoIpChannel.ConnectAsync(
	host: "192.168.0.10",
	port: 13400,
	sourceAddress: 0x0E00,
	targetAddress: 0x0001,
	cancellationToken: cancellationToken);

await using var client = new UdsClient(channel, new UdsClientOptions
{
	P2Timeout = TimeSpan.FromMilliseconds(500),
	TesterPresentInterval = Timeout.InfiniteTimeSpan,
});

var session = await client.DiagnosticSessionControlAsync(
	DiagnosticSessionType.ExtendedDiagnosticSession,
	cancellationToken);

var vin = await client.ReadDataByIdentifierAsync(0xF190, cancellationToken);

Console.WriteLine($"Session: {session}");
Console.WriteLine($"VIN: {Encoding.ASCII.GetString(vin.Span)}");

If your transport is not DoIP, you can provide any ITransportChannel implementation, such as IsoTpChannel, and keep the UdsClient usage unchanged.

Per-request addressing is available on the standard IUdsClient API via TransportAddressingMode:

await client.TesterPresentAsync(
    suppressPositiveResponse: true,
    addressingMode: TransportAddressingMode.Functional,
    cancellationToken: cancellationToken);

Related Package

If you only need the shared interfaces and contracts, use Hsu.Automotive.Uds.Abstractions.