Hsu.Formats.Dataset 2026.5.7

Hsu.Formats.Dataset

Automotive dataset, calibration, and diagnostic format support for the Hsu.Formats library.

Supported Formats

Features

• AOT-compatible (IsAotCompatible=true on net8.0+)
• A2LModel implements ICalibrationDescription; DbcModel implements INetworkDescription; OdxModel implements IDiagnosticDescription; ArxmlModel implements IFormatModel
• A2LParser resolves /include directives relative to the source file (IFilePathParser)
• DbcModel exposes messages, signals, nodes, attributes, and network-level comments
• Full signal definition access: start bit, length, byte order, factor, offset, min/max, unit, value tables
• ArxmlParser supports AUTOSAR 3.x and 4.x; exposes flattened cross-package views for signals, frames, PDUs, ECUs, service interfaces, and SOME/IP deployments
• ArxmlModel.Diagnostics accumulates non-fatal parse warnings for unknown or skipped elements

Quick Start

Parse a DBC CAN database

using Hsu.Formats.Dbc;

using var stream = File.OpenRead("can_db.dbc");
var model = (DbcModel)new DbcParser().Parse(stream);

Console.WriteLine($"Nodes: {string.Join(", ", model.Nodes)}");
foreach (var msg in model.Messages)
{
    Console.WriteLine($"  [{msg.Id:X3}] {msg.Name}  DLC={msg.Dlc}  TX={msg.Transmitter}");
    foreach (var sig in msg.Signals)
        Console.WriteLine(
            $"    {sig.Name}  factor={sig.Factor}  offset={sig.Offset}  unit={sig.Unit}");
}

Parse an A2L calibration file

using Hsu.Formats.A2L;

// Use ParseFile to resolve /include directives
var model = (A2LModel)new A2LParser().ParseFile("ecu.a2l");

Console.WriteLine($"Measurements:    {model.Measurements.Count}");
Console.WriteLine($"Characteristics: {model.Characteristics.Count}");

Parse an ODX diagnostic file

using Hsu.Formats.Odx;

using var stream = File.OpenRead("ecu.odx");
var model = (OdxModel)new OdxParser().Parse(stream);

Parse an AUTOSAR ARXML file

using Hsu.Formats.Arxml;

using var stream = File.OpenRead("system.arxml");
var model = (ArxmlModel)new ArxmlParser().Parse(stream);

Console.WriteLine($"Version: {model.Version}");
Console.WriteLine($"Packages: {model.Packages.Count}");
Console.WriteLine($"System signals: {model.AllSystemSignals.Count}");
Console.WriteLine($"Frames: {model.AllFrames.Count}");
Console.WriteLine($"PDUs: {model.AllPdus.Count}");
Console.WriteLine($"ECU instances: {model.AllEcuInstances.Count}");
Console.WriteLine($"Service interfaces: {model.AllServiceInterfaces.Count}");
Console.WriteLine($"SOME/IP deployments: {model.AllSomeIpDeployments.Count}");

foreach (var frame in model.AllFrames)
    Console.WriteLine($"  Frame {frame.ShortName}  {frame.BitLength} bit");

foreach (var diag in model.Diagnostics)
    Console.WriteLine($"  [WARN] {diag.Message}");

Async parsing

All parsers implement IAsyncFormatParser and support cancellable, non-blocking parsing. All four parsers offload work to the thread pool via Task.Run(() => Parse(stream)).

using Hsu.Formats.Dbc;
using Hsu.Formats.Arxml;

// DBC — offloads parsing to thread pool
using var dbcStream = File.OpenRead("can_db.dbc");
var dbcModel = (DbcModel)await new DbcParser().ParseAsync(dbcStream);

// ARXML — offloads XML parsing to thread pool (with optional cancellation)
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(60));
using var arxmlStream = File.OpenRead("system.arxml");
var arxmlModel = (ArxmlModel)await new ArxmlParser().ParseAsync(arxmlStream, cts.Token);