DEENESPTFRRUARHIKOZHNL
AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes FIG-aff388e80d427843 808 × 145 px 5 Release(s)

Figure 1.2: Methodology: Generic Language Binding generation

SHA-256 Inhalts-Fingerabdruck: aff388e80d427843420a86ba5197890167ea9fef351aeea2d442f42f999a72ba
✦ KI-generierte Bildanalyse & technische Beschreibung Modell: gemini-3.8-flash (via agy) · Rezept figure-description@2 · erstellt am 2026-10-07

1. Diagrammtyp & Architektur-Kontext

  • Klassifikation: AUTOSAR Methodology Workflow- / Toolketten-Transformationsdiagramm (Black-Box-Generierungsschritt).
  • Architektonische Einordnung: Design- und Build-Time-Phase der AUTOSAR Adaptive Platform (AP). Es spezifiziert den Übergang von der technologieagnostischen, formalen Systemspezifikation (Metamodell-Ebene) zur konkreten Zielsprachen-Projektion (C++ Source-/Header-Ebene) für Adaptive Applications und Plattformmodule.
  • Funktionaler Zweck: Visualisierung des durch [SWS_LBAP_00037] (Upstream-Requirement RS_AP_00111) normierten Grundprinzips des ARA Language Binding Generators. Dieser transformiert abstrakte Schnittstellen- und Datentyp-Modelle in standardisierte, zielsprachenspezifische Deklarationen und Serialisierungsstrukturen.

2. Komponenten, Entitäten & Schnittstellen

  • Eingangsartefakt: Adaptive Platform Interface (.arxml)
    • Formales ARXML-Dokument gemäß AUTOSAR AP Metamodell.
    • Enthält u. a. ServiceInterface-Definitionen (Events, Methods, Fields) und referenzierte Typ-Deskriptoren (insbesondere AbstractImplementationDataType, StdCppImplementationDataType, Primitive, Arrays, Records/Structs).
  • Verarbeitungseinheit: ARA Language Binding Generator
    • Deterministisches Tooling der AP-Entwicklungsumgebung.
    • Enthält die Abbildungslogik für Datentypprojektionen, Namespace-Auflösungen und Serialisierungs-/Deserialisierungsvorschriften gemäß der Spezifikation AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes.
  • Ausgangsartefakt: (Pre-)compilable generated code / Language specific output
    • Generierte Quellcode-Dateien (z. B. C++-Header .h/.hpp und Übersetzungseinheiten .cpp).
    • Umfasst vollständige C++-Typdefinitionen (z. B. struct, enum class, ara::core::Vector, ara::core::Array, ara::core::Optional, Type-Aliases), Namespace-Hierarchien sowie typspezifische Meta-/Serialisierungstrakte für ara::com.
  • Kardinalität & Datenfluss:
    • 1:n-Projektion: Ein ARXML-Schnittstellenmodell generiert typischerweise mehrere Header und Modulspezifische Bindings.
    • Unidirektionaler Datenfluss von der formalen Modellspezifikation zur Build-Kette.

3. Dynamisches Verhalten & Sequenzablauf

  • Phasen-Klassifikation: Reine Build-Time / Design-Time. Keine Ausführung von Laufzeitdynamik, Callbacks oder Dem/Det-Fehlermeldungen im Zielsystem.
  • Sequenzschritte der Codegenerierung:
    1. Model Ingestion & Metamodell-Validierung: Einlesen der .arxml-Dateien, syntaktische Prüfung und Auflösung der typisierten Referenzen (AbstractImplementationDataType).
    2. Typ-Mapping & Namensraum-Ableitung: Projektion der ARXML-Package-Hierarchien auf Zielsprachen-Namespaces. Abbildung der modellierten Datentypen auf primitive C++-Typen (std::uint32_t, bool etc.) oder Typen der AUTOSAR Adaptive Core Library (ara::core::*).
    3. Code-Emission: Synthetisieren der C++-Header mit Include-Guards, Struct-Definitionen und sprachspezifischen Typmerkmalen (Type Traits / Serialization Hooks).
  • Abbruchkriterien: Nicht auflösbare Typ-Referenzen, verletzte Metamodell-Constraints, zirkuläre Datentypstrukturen ohne Zeigersemantik oder unzulässige Wertebereichsgrenzen im ARXML führen zum sofortigen Fehlerabbruch des Generators im Build-System.

4. Normative Relevanz & Entwickler-Hinweise

  • API-Vertrag & Unidirektionalität:
    • Der generierte Code ist Read-Only. Manuelle Modifikationen sind unzulässig, da jede Modelländerung die Artefakte überschreibt.
    • Applikationsentwickler binden ausschließlich die generierten Header ein; Typänderungen müssen auf ARXML-Ebene initiiert werden.
  • Typgarantien nach [SWS_LBAP_00037]:
    • Der Generator muss sicherstellen, dass die generierten Typen unmittelbar (pre-)kompilierbar sind, ohne dass nachgelagerte manuelle Eingriffe oder Dritt-Header (außerhalb der standardisierten Laufzeitumgebung wie ara::core) erforderlich sind.
  • Konformität & Build-Integration:
    • Integratoren müssen den Generator deterministisch vor der Compiler-Phase (z. B. in CMake/Meson) einbinden.
    • Tool-Hersteller müssen gewährleisten, dass der emittierte C++-Code den AUTOSAR C++14/C++17 Coding Guidelines und MISRA C++ entspricht.

Zugeordnete Anforderungen

Diese Angaben zeigt der Versions-Explorer.

Erkannte Spezifikationsbelege & Anforderungen auf dieser Seite

Aus dem Dokument extrahierter Text & Kontext

Begleitender Spezifikationstext:

Specification of Language Binding for modeled AP data types AUTOSAR AP R25-11 The general workflow step is described in "Adaptive Software Generated Item" in [5]; Figure 1.2 shows a very general workflow step for generation of data types from an Adaptive Platform Interface. Each "language specific" binding will have a "language specific" approach, and thus a respective chapter in this specification. Figure 1.2: Methodology: Generic Language Binding generation This specification is not concerned with the implementation details of an ARA Language Binding Generator, rather, the rules which an ARA Language Binding Generator must observe during generation/serialization. [SWS_LBAP_00037] Principle of an ARA Language Binding Generator Upstream requirements: RS_AP_00111 ⌈The ARA Language Binding Generator is responsible for generating the Language Binding artifacts. These include data type declarations derived from the referenced AbstractImplementationDataTypes of the Adaptive Platform Interfaces.⌋ 8 of 80 Document ID 994: AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes

Vorkommen in AUTOSAR-Releases (7)

Release Dokument Seite Nr. Bildunterschrift im Dokument
R21-11 AUTOSAR_SWS_LanguageBindingForModeledAPdatatypes S. 7 1.2 Figure 1.2: Methodology: Generic Language Binding generation
R21-11 AUTOSAR_SWS_LanguageBindingForModeledAPdatatypes S. 7 1.2 Figure 1.2: Methodology: Generic Language Binding generation
R22-11 AUTOSAR_SWS_LanguageBindingForModeledAPdatatypes S. 7 1.2 Figure 1.2: Methodology: Generic Language Binding generation
R23-11 AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes S. 7 1.2 Figure 1.2: Methodology: Generic Language Binding generation
R23-11 AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes S. 7 1.2 Figure 1.2: Methodology: Generic Language Binding generation
R24-11 AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes S. 8 1.2 Figure 1.2: Methodology: Generic Language Binding generation
R25-11 AUTOSAR_AP_SWS_LanguageBindingForModeledAPdatatypes S. 8 1.2 Figure 1.2: Methodology: Generic Language Binding generation