Hsu.Formats.Dataset 2026.7.13

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+)
• Marker model coverage aligned with the shared abstractions:
  • A2LModel → ICalibrationDescription
  • DbcModel → INetworkDescription
  • OdxModel → IDiagnosticDescription
  • ArxmlModel → IFormatModel
• A2LParser supports /include resolution through IFilePathParser
• DbcModel exposes messages, signals, nodes, value tables, attributes, and comments
• ArxmlParser supports AUTOSAR 3.x and 4.x and exposes flattened cross-package views for high-value entities
• ArxmlModel.Diagnostics accumulates non-fatal parse diagnostics for unknown or skipped content
• All parsers implement IAsyncFormatParser

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 relative to the source file.
var model = (A2LModel)new A2LParser().ParseFile("ecu.a2l");

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

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($"Signals: {model.AllSystemSignals.Count}");
Console.WriteLine($"Frames: {model.AllFrames.Count}");
Console.WriteLine($"PDUs: {model.AllPdus.Count}");
Console.WriteLine($"Service interfaces: {model.AllServiceInterfaces.Count}");

Async Parsing

All dataset parsers implement IAsyncFormatParser.

• Text or XML-heavy parsers expose async entry points for callers
• Current implementations are CPU-oriented and use Task.Run(() => Parse(...)) rather than line-by-line async streaming

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

using var dbcStream = File.OpenRead("can_db.dbc");
var dbcModel = (DbcModel)await new DbcParser().ParseAsync(dbcStream);

using var arxmlStream = File.OpenRead("system.arxml");
var arxmlModel = (ArxmlModel)await new ArxmlParser().ParseAsync(arxmlStream);

Documentation

• Standard format specifications, when present, are documented in the project repository.
• Project-level architecture and feature design notes are documented in the project repository.