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

Hsu.Automotive.Uds.Client

High-level UDS tester/client package for .NET.

This package provides the tester-side runtime for ISO 14229 diagnostic workflows. It is the package to use when you want to connect to an ECU, send diagnostic requests, and work with typed service helpers instead of manually assembling and parsing UDS PDUs.

Package Information

• Package ID: Hsu.Automotive.Uds.Client
• Package scope: high-level tester runtime and transport-oriented client helpers
• Depends on: Hsu.Automotive.Uds.Core
• Recommended for: diagnostic applications, plant tools, validation benches, automated tests, gateway-aware tooling

What This Package Provides

The package centers around UdsClient, which offers asynchronous APIs for the major UDS service groups, including:

• session control
• ECU reset
• security access
• DID read/write
• DTC operations
• routine control
• memory access
• file transfer and upload/download flows
• tester present / keepalive handling

It also includes transport-oriented client helpers such as:

• IsoTpUdsClient
• DoIpUdsClient
• IsoTpTesterChannel
• DoIpChannel
• DoIpReconnectingChannel

Supported Capabilities

• UdsClient main high-level tester API
• P2 / P2* timeout handling with ECU timing update support
• physical and functional request addressing through TransportAddressingMode
• keepalive / TesterPresent support on the main client
• gateway multi-ECU support through Fork(string ecuId)
• shared-transport forked clients for gateway routing scenarios
• connection-state observation for reconnectable DoIP flows

Addressing and Gateway Model

This package supports both direct ECU communication and gateway-based access.

Direct communication

Use the main client with the default transport route when talking to a single ECU.

Functional addressing

Send requests such as TesterPresent or discovery-style traffic with functional addressing when the underlying transport supports it.

Gateway multi-ECU

Keep the main client as the fully featured owner of the transport, then create lightweight ECU-specific clients when you need to communicate with individual routed ECUs behind a gateway.

Forked clients:

• share the same underlying transport connection
• use ECU-specific transmit and receive routing
• are intended for routed request/response exchanges
• do not replace the main client as the owner of keepalive behavior

Quick Start

The example below connects to an ECU over DoIP, enters an extended session, and reads VIN DID 0xF190.

using Hsu.Automotive.Uds.Client;
using Hsu.Automotive.Uds.Protocol;
using Hsu.Automotive.Uds.Transport;

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

await using var client = new UdsClient(channel, new UdsClientOptions
{
    P2Timeout = TimeSpan.FromMilliseconds(500),
    P2StarTimeout = TimeSpan.FromSeconds(5),
});

await client.DiagnosticSessionControlAsync(DiagnosticSessionType.ExtendedDiagnosticSession);
var vin = await client.ReadDataByIdentifierAsync(0xF190);

Functional Addressing Example

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

Gateway Example

await using var client = new UdsClient(channel, options);

await using var powertrainClient = client.Fork("powertrain");
var vin = await powertrainClient.ReadDataByIdentifierAsync(0xF190);

In this model, the main client remains available for the default route while forked clients are used only where ECU-specific routing is needed.

When to Choose This Package

Choose Hsu.Automotive.Uds.Client when you want:

• a ready-to-use tester API
• typed service operations instead of raw PDU handling
• transport-aware client helpers for ISO-TP or DoIP
• gateway multi-ECU support without redesigning your application around raw transport selection

If you only need low-level transport or protocol primitives, use Hsu.Automotive.Uds.Core instead.

Install

dotnet add package Hsu.Automotive.Uds.Client

Package Relationships

• Hsu.Automotive.Uds bundles the full integrated stack when you want one main package.
• Hsu.Automotive.Uds.Core provides the lower-level protocol and transport building blocks used by this package.
• Hsu.Automotive.Uds.Abstractions provides the shared contracts if you only need interfaces.