Figure 8.1: Layout of Std_Return_Type

1. Diagrammtyp & Architektur-Kontext

• Diagrammtyp: Bitfeld- und Speicherlayout (8-Bit-Datenstruktur-Repräsentation).
• Technischer Zweck: Spezifikation der normativen Bitbelegung des fundamentalen Datentyps Std_ReturnType (uint8) gemäß SWS_Std_00015.
• Funktionale Einordnung: Plattformweiter Standard für API-Rückgabewerte in der AUTOSAR Classic Platform. Er dient als einheitliche Statusschnittstelle zwischen Basissoftware-Modulen (BSW), der Laufzeitumgebung (RTE) und Applikations-Software-Components (SWCs) für synchrone und asynchrone Funktionsaufrufe.

2. Komponenten, Entitäten & Schnittstellen

• Entität: Typdefinition Std_ReturnType (abgebildet auf Basis-Typ uint8).
• Bitfeld-Gliederung (1-basierte Zählung im Diagramm / 0-basierte C-Bit-Indizes):
  • Bit 1 bis Bit 6 (LSB-Bereich, Bits [0..5]): 6 Bits für standardisierte und anwenderspezifische Fehlercodes (Wertebereich 0x00 bis 0x3F bzw. 0 bis 63 dezimal).
    • 0x00: E_OK (Erfolgreiche Ausführung).
    • 0x01: E_NOT_OK (Generischer Einzelfehler).
    • 0x02 – 0x3F (2–63): Frei verfügbar für BSW-spezifische Fehler und in ARXML definierte ApplicationError-Codes von Client/Server-Operationen.
  • Bit 7 und Bit 8 (MSB-Bereich, Bits [6..7]): 2 Bits exklusiv reserviert für die RTE (Reserved by RTE, Wertebereich 0x40, 0x80, 0xC0).
• Schnittstellen-Bezug: Trennung zwischen anwendungsbezogenen Fehlerzuständen (ApplicationError) und infrastrukturellen RTE-Übertragungs- bzw. Statusfehlern.

3. Dynamisches Verhalten & Sequenzablauf (falls zutreffend)

• Status-Rückgabe im API-Call (Rte_Call_<p>_<o>):
  • Normaler / Anwendungsfehler-Pfad: Der Server liefert E_OK oder einen ApplicationError ([0..63]) in Bits 0..5 zurück; Bits 6 und 7 bleiben 0.
  • RTE-Infrastrukturfehler-Pfad: Erkennt die RTE einen Kommunikations- oder Laufzeitfehler (z. B. Timeout RTE_E_TIMEOUT, Datenverlust, nicht verbundener Port oder unerlaubter Exclusive-Area-Zugriff), setzt sie Status-Flags in den reservierten Bits 6 und 7 (bzw. liefert vordefinierte RTE-Fehlerwerte wie 0x80).
  • Überlagerung (Overlayed Errors): Die RTE kann infrastrukturelle Zustände überlagern, ohne den definierten Anwendungsfehler-Nummernraum von 0 bis 63 zu kollidieren.

4. Normative Relevanz & Entwickler-Hinweise

• Einschränkung für Modul- und SWC-Entwickler: Eigene Fehlercodes in BSW-Modulen oder ARXML-Modellierungen (ApplicationError) dürfen strikt nur Werte zwischen 2 und 63 (0x02 bis 0x3F) annehmen. Werte ≥ 64 (0x40) verletzen die Spezifikation und kollidieren mit RTE-Infrastruktur-Flags.
• Bitmaskierung bei der Fehlerbehandlung:
  • Zur Auswertung des reinen Anwendungsfehlers muss gegen 0x3F gemaskt werden: app_error = return_value & 0x3F;.
  • Zur Erkennung von RTE-Infrastrukturfehlern muss der MSB-Bereich geprüft werden: is_rte_error = (return_value & 0xC0) != 0;.
• Typsicherheit & Portabilität (SRS_BSW_00004): Std_ReturnType muss auf allen Mikrocontroller-Architekturen exakt 8 Bit (uint8) umfassen; Bitshift- und Maskierungsoperationen setzen dieses statische Layout deterministisch voraus.