A2L / ASAP2 Grundlagen: CHARACTERISTIC, MEASUREMENT und COMPU_METHOD

A2L ist das Dateiformat der ASAM-ASAP2-Norm. Es beschreibt Objekte im Speicher eines Steuergeräts, damit ein Applikationswerkzeug über Protokolle wie XCP oder CCP Messgrößen lesen und Parameter verändern kann. Das ist eine andere Aufgabe als bei DBC: Eine DBC-Datei erklärt die Signale in CAN-Frames, eine A2L-Datei benannte Speicherobjekte, ihre Adressen, Datentypen und die Umrechnung von Rohzahlen in physikalische Werte. Fahrzeugprojekte liefern meist beides, und häufig muss ein CAN-Signalname mit dem erzeugenden Kalibrierobjekt verknüpft werden. Die Datei ist reiner Text mit /begin- und /end-Blöcken und wird normalerweise von einem binären Abbild der ECU-Software begleitet.

Zuoberst steht ein PROJECT mit einem oder mehreren MODULE-Blöcken. Darin finden sich CHARACTERISTIC-Einträge (les- und schreibbare Kennwerte), MEASUREMENT-Einträge (schreibgeschützte Messgrößen), COMPU_METHOD-Blöcke (Umrechnungsregeln), RECORD_LAYOUT-Definitionen für Skalare, Kennlinien und Kennfelder sowie GROUP-Blöcke, die Referenzen zu einem durchsuchbaren Baum bündeln. Ein CHARACTERISTIC verweist meist auf eine Umrechnungsmethode und ein Record-Layout und trägt eine ECU-Adresse; ein MEASUREMENT verweist ebenfalls auf eine Methode, zusätzlich auf Datentyp oder Bitmaske. Bezeichner müssen gültige Tokens sein: Viele Werkzeuge tokenisieren strikt, daher führen multibyte Zeichen in Identifiern oder Strings oft zum Abbruch des gesamten Imports und werden beim Export bereinigt oder maskiert.

Die Blöcke, die man tatsächlich sieht

/begin CHARACTERISTIC SparkAdvance "Base ignition angle"
  VALUE 0x8000 ECU_ADDRESS 0x1234
  COMPU_METHOD CM_deg
  /begin REF_MEASUREMENT EngineSpeed /end REF_MEASUREMENT
/end CHARACTERISTIC

/begin COMPU_METHOD CM_deg "" LINEAR "%.4" "deg"
  COEFFS_LINEAR 0.0625 -720
/end COMPU_METHOD

• PROJECT / MODULE — oberste Container
• CHARACTERISTIC — ein beschreibbarer Kennwert
• MEASUREMENT — ein schreibgeschütztes Messobjekt
• COMPU_METHOD — Roh-zu-physikalisch-Umrechnung, Einheit und Format
• RECORD_LAYOUT — Skalar, Kennlinie, Kennfeld oder Achsstruktur
• GROUP + REF_CHARACTERISTIC / REF_MEASUREMENT — der Baum im Betrachter

Umrechnung und Einheiten

COMPU_METHOD entspricht in A2L dem Faktor und Offset eines DBC-Signals. Eine LINEAR-Methode deklariert COEFFS_LINEAR mit Faktor und Offset sowie eine Formatangabe wie %.4 und eine Einheit wie deg, rpm oder bar. TAB_INTP, TAB_NOINTP und TAB_VERB beschreiben stattdessen stückweise Interpolation oder aufgezählte Textwerte. Deshalb kann dieselbe Rohzahl in einem Steuergerät -720 bis +720 Grad bedeuten und in einem anderen einen völlig anderen Bereich: Die Bedeutung liegt in der Umrechnungsmethode, nicht in der Speicherzelle. Zeigt ein Betrachter technische Einheiten an, ist er der Referenzkette vom Objekt zur Methode gefolgt.

Eintragstyp wählen und die zugehörigen Betrachter- und Exportspalten sehen

Von der Datei zum Export

Beim Öffnen einer A2L-Datei im Browser entstehen meist links ein Gruppenbaum und rechts eine Tabelle mit einer Zeile pro Objekt und Spalten für Gruppe, Typ, Name, Datentyp, Adresse, Umrechnung, Format, Min, Max, Einheit und Beschreibung. Der XLSX-Export behält diese Form: ein Records-Blatt mit einer Zeile pro Objekt sowie ein gekürztes Info-Blatt mit Dateistatistik und Parser-Diagnosen. Weil die Auswertung lokal läuft, werden Kalibrierdaten — oft das sensibelste Gut in der Werkzeugkette — nie hochgeladen. Auch hier ist ein toleranter Parser wichtig: Ein unbekanntes Schlüsselwort oder ein fehlerhaftes /end sollte als Diagnose gemeldet statt die gesamte Datei verworfen werden, denn reale ECU-Beschreibungen enthalten häufig herstellerspezifische Erweiterungen.