Hsu.Automotive.Uds.Server 2026.7.14-preview.134711

Hsu.Automotive.Uds.Server

UDS server / ECU-side runtime package for .NET.

This package provides the ECU-side runtime for ISO 14229 request handling. It is intended for simulators, benches, validation environments, and custom ECU-side hosts that need to receive UDS requests over a transport channel and dispatch them to service handlers.

Package Information

• Package ID: Hsu.Automotive.Uds.Server
• Package scope: UDS server runtime and ECU-side hosting
• Depends on: Hsu.Automotive.Uds.Core
• Recommended for: ECU simulators, mock servers, HIL benches, regression environments, custom diagnostic services

What This Package Provides

This package centers around UdsServer, which:

• receives UDS requests from an ITransportChannel
• dispatches requests to registered IServiceHandler implementations
• maintains per-connection diagnostic state through UdsServerContext
• handles built-in session-related behavior such as S3 timeout reversion

Representative types include:

• UdsServer
• IUdsServer
• IServiceHandler
• UdsServerContext
• IsoTpEcuChannel
• DoIpServerChannel

Supported Capabilities

• serial request processing per connection
• pluggable IServiceHandler model
• per-connection session and security context
• S3 timeout with automatic return to default session
• ISO-TP ECU-side transport support
• DoIP server-side transport support

Quick Start

using Hsu.Automotive.Uds.Protocol;
using Hsu.Automotive.Uds.Server;

await using var server = new UdsServer(channel, new UdsServerOptions
{
    S3Timeout = TimeSpan.FromSeconds(5),
});

server.RegisterHandler(new VinHandler());
await server.CompletedTask;

Minimal Service Handler Example

using Hsu.Automotive.Uds.Protocol;
using Hsu.Automotive.Uds.Server;

public sealed class VinHandler : IServiceHandler
{
    public byte ServiceId => 0x22;

    public Task<UdsResponse> HandleAsync(
        UdsRequest request,
        UdsServerContext context,
        CancellationToken cancellationToken = default)
    {
        if (request.Data.Length != 2 || request.Data.Span[0] != 0xF1 || request.Data.Span[1] != 0x90)
            return Task.FromResult(UdsResponse.Negative(NegativeResponseCode.RequestOutOfRange));

        byte[] vin = "TESTVIN123456789"u8.ToArray();
        return Task.FromResult(UdsResponse.Positive(vin));
    }
}

Typical Use Cases

• ECU simulation during client development
• system integration testing
• bench validation and automated regression
• educational or exploratory service-host implementations

Session Management Notes

UdsServer keeps per-connection state in UdsServerContext, including:

• current diagnostic session
• current security level
• pending security seed exchange state
• last activity timestamp used for S3 timeout evaluation

When the configured S3 timeout expires without diagnostic activity, the server reverts the connection back to the default session and clears security state.

Install

dotnet add package Hsu.Automotive.Uds.Server

Package Relationships

• Hsu.Automotive.Uds.Core provides the shared protocol and transport infrastructure used by this package.
• Hsu.Automotive.Uds.Client is the tester-side counterpart used to drive requests into a server or simulator.
• Hsu.Automotive.Uds bundles the full integrated stack when you prefer one primary package.