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

Hsu.Automotive.Uds.Core

Core transport, protocol, and shared runtime primitives for the UDS stack.

This package contains the lower-level building blocks used by the client and server packages. It is intended for advanced consumers who need direct access to UDS protocol types, transport implementations, shared runtime helpers, and gateway-oriented transport composition.

Package Information

• Package ID: Hsu.Automotive.Uds.Core
• Package scope: protocol primitives, transport implementations, security helpers, shared runtime infrastructure
• Depends on: Hsu.Automotive.Uds.Abstractions
• Recommended for: advanced integrators, custom transport composition, infrastructure libraries, specialized tooling

What This Package Provides

This package contains the shared core used by higher-level packages, including:

• protocol value types and message primitives
• ISO-TP segmentation and reassembly support
• LIN and FlexRay transport implementations
• gateway transport view infrastructure
• transport tracing support
• security helper implementations reused by upper layers

Representative types include:

• IsoTpChannelBase
• EcuChannelView
• TransportObserverDispatcher
• LinChannel
• FlexRayChannel
• SecurityAlgorithm

Supported Capabilities

• protocol primitives such as UdsMessage, UdsRequest, and UdsResponse
• ISO-TP transport logic over CAN / CAN FD
• per-request physical / functional addressing support at the transport level
• multi-ECU gateway transport views through IForkableTransport and EcuChannelView
• shared framing, encoding, and transport utility logic
• reusable security helpers for seed/key style flows

Gateway-Oriented Transport Design

One of the important roles of Hsu.Automotive.Uds.Core is providing the shared transport model used for gateway scenarios.

In this model:

• the main transport remains the owner of the real connection and receive loop
• lightweight ECU views are created for routed communication
• receive-side dispatch is performed by the main transport and delivered to the matching ECU view
• the design avoids global mutable ECU selection on the transport itself

This makes it suitable for multi-ECU routing scenarios where the main connection must remain active while individual routed clients operate through lightweight views.

Common Usage

Most applications consume this package through Hsu.Automotive.Uds.Client or Hsu.Automotive.Uds.Server, but advanced users can instantiate transports directly.

ICanBus canBus = new YourCanBusImplementation();
await using var channel = new IsoTpTesterChannel(canBus, physicalId: 0x7E0, responseId: 0x7E8);

When to Use This Package Directly

Use Hsu.Automotive.Uds.Core directly when you need to:

• build custom transport compositions
• work with low-level protocol types without the full client/server runtime
• embed UDS transport behavior into another framework or product
• implement infrastructure that should stay below the application-facing client or server layer

If you want a ready-to-use tester API, use Hsu.Automotive.Uds.Client. If you want a ready-to-use ECU/server runtime, use Hsu.Automotive.Uds.Server.

Install

dotnet add package Hsu.Automotive.Uds.Core

Package Relationships

• Hsu.Automotive.Uds.Client builds on this package to provide the tester-facing runtime.
• Hsu.Automotive.Uds.Server builds on this package to provide the ECU/server-facing runtime.
• Hsu.Automotive.Uds.Abstractions provides the interfaces and contracts this package implements.