Figure 4.49: RTE sequence in case of invalid value

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (Interaktionsdiagramm) mit kombinierten Fragmenten (loop/opt für A New Data Received, No Transformation Errors, Value is Invalid).
• Technischer Zweck & Einordnung: Spezifikation des Fehlererkennungs- und Propagierungsmechanismus der AUTOSAR Classic RTE beim Empfang strukturierter Daten (Record/Signal Group) über den Kommunikationsstapel (Com), wenn ein einzelnes Strukturelement einen ungültigen Wert (Invalid Value) enthält.
• Architektur-Kontext: Veranschaulicht die Entkopplung zwischen der asynchronen BSW-Empfangsverarbeitung (zyklische RTE-Task, Interaktion mit Com und Transformer-Kette) und dem synchronen Lesezugriff der SWC (Application) über die RTE-API (Rte_Read), flankiert durch Diagnose-Reporting an den Diagnostic Event Manager (Dem) gemäß [SWS_Rte_03845] und [SWS_Rte_03846].

2. Komponenten, Entitäten & Schnittstellen

Akteure & Software-Module (Lifelines)

• Application: Software-Komponente (SWC / Runnable Entity), Konsument der Daten über einen R-Port.
• «module» Rte: Generierte Laufzeitumgebung (Runtime Environment), zuständig für API-Bereitstellung, Datenpufferung und Validitätsprüfung.
• «module» Rte (Cyclic Function): Zyklische BSW-Scheduler-Task / zyklische RTE-Hauptfunktion zur Datenübernahme aus den unteren Schichten.
• «module» Com: AUTOSAR Communication Stack (Signal-/Signal-Group-Empfang).
• «module» E2EXf/ComXf: Serialisierungs- und Absicherungs-Transformer (End-to-End Transformer E2EXf, COM Transformer ComXf).
• «module» Dem: Diagnostic Event Manager zur Erfassung und Entprellung von Übertragungs- und Datenfehlern.

Schnittstellen & Datenstrukturen

• API-Schnittstellen (RTE ↔ BSW):
  • Com_ReceiveSignalGroup(SignalGroupId): BSW-Signal-Interface zur Abholung empfangener Signal-Gruppen.
  • E2EXf_Inv(...) / ComXf_Inv(...): Inverse Transformations-APIs zur E2E-Prüfung und Deserialisierung empfangener Byte-Arrays.
  • Dem_SetEventStatus(EventId, DEM_EVENT_STATUS_PREFAILED): Standardisiertes BSW-Interface zur Fehlermeldung bei ungültigen Datenwerten.
• API-Schnittstellen (Application ↔ RTE):
  • Rte_Read_<p>_<o>(OUT data, OUT comErrorInfo): Standardisierte Lese-API für strukturierte Daten mit erweitertem Fehlerstatus-Rückgabeparameter.
  • Rte_IsInvalidValue_<_>_<element>(IN comErrorInfo): Spezifische Abfrage-Makros/APIs zur granularen Bitfeld-Auswertung pro Element der Datenstruktur.
• Interne Datenstrukturen & Statusvariablen:
  • transportErrorCounter: Zähler für Übertragungs-/E2E-Fehler (bleibt bei rein inhaltlicher Ungültigkeit unverändert).
  • valueErrorCount: Spezifischer Zähler für Wertebereichsverletzungen / Invalid Values.
  • invalidValueBitfield: Bitmaske innerhalb von comErrorInfo, in der jedes Bit den Validitätsstatus eines Strukturelements repräsentiert.

3. Dynamisches Verhalten & Sequenzablauf

1. Initialisierung (1): Überwachungszähler (transportErrorCounter, valueErrorCount) werden bei aktivierter Überwachung auf 0 initialisiert.
2. **BSW-Empfangspfad (A New Data Received):**
   • (2) Polling/Prüfung: Rte (Cyclic Function) prüft zyklisch, ob neue Daten anstehen (Check No New Data Received).
   • (3) Datenübernahme: Aufruf von Com_ReceiveSignalGroup() an das Com-Modul; Quittierung mit RTE_E_OK.
   • **(4) Inverse Transformation (No Transformation Errors):**
     • Aufruf von E2EXf_Inv() (E2E-Prüfung fehlerfrei, Status RTE_E_OK).
     • Aufruf von ComXf_Inv() (Deserialisierung fehlerfrei, Status RTE_E_OK).
   • (5) Transportstatus: Da keine Kommunikations- oder Transformationsfehler aufgetreten sind, wird der transportErrorCounter nicht inkrementiert.
3. Applikativer Lesezugriff & Validitätsprüfung:
   • (6) Struktur-Validierung: Die Applikation ruft synchron Rte_Read(data, comErrorInfo) auf. Die RTE führt interne Werteprüfungen für alle Strukturfelder durch (InvalidValueCheck_element_1, InvalidValueCheck_element_2).
4. **Fehlerbehandlung bei ungültigem Wert (Value is Invalid):**
   • (7) Granulare Fehlererfassung & Dem-Reporting:
     • Erkennung: element_2 entspricht dem konfigurierten invalidValue (oder verletzt den Wertebereich).
     • valueErrorCount wird inkrementiert.
     • Im Bitfeld invalidValueBitfield von comErrorInfo wird das Bit für element_2 auf 1 gesetzt.
     • Fehlermeldung an das Dem via Dem_SetEventStatus(EventId, DEM_EVENT_STATUS_PREFAILED).
   • (8) API-Rückgabe: Rte_Read() terminiert mit Rückgabewert RTE_E_INVALID.
5. Selektive Fehleranalyse durch die Applikation:
   • (9) Abfrage Element 1: Aufruf von Rte_IsInvalidValue_<_>_element_1(comErrorInfo) liefert FALSE (Wert valide).
   • (10) Abfrage Element 2: Aufruf von Rte_IsInvalidValue_<_>_element_2(comErrorInfo) liefert TRUE (Wert ungültig).

4. Normative Relevanz & Entwickler-Hinweise

• Normativer Bezug [SWS_Rte_03845] & [SWS_Rte_03846]:
  • Verpflichtet die RTE bei Konfiguration von invalidValue auf Element-Ebene zusammengesetzter Datentypen (CompositeDataType / Record), bei mindestens einem ungültigen Element den Gesamtaufruf Rte_Read mit RTE_E_INVALID abzuweisen.
  • Schreibt die Bereitstellung des Statusvektors comErrorInfo sowie der elementweisen Inspektionsfunktionen Rte_IsInvalidValue_<p>_<o>_<element>() vor, um die fehlerhafte Teilkomponente deterministisch zu isolieren.
• Auswirkung auf SWC-Entwickler:
  • Bei Empfang von RTE_E_INVALID dürfen Strukturdaten nicht unbesehen verworfen werden, falls Teilfunktionalität mit den validen Elementen (hier: element_1) noch im degradierten Modus weiterlaufen kann.
  • Das Auslesen von comErrorInfo über die typspezifischen Makros/Funktionen ist zwingend erforderlich, um zwischen Transportverlust (RTE_E_TIMEOUT / RTE_E_LOST_DATA), Absicherungsfehlern und inhaltlicher Ungültigkeit zu unterscheiden.
• Auswirkung auf RTE- & BSW-Konfiguration:
  • Com/RTE: Das Zusammenspiel erfordert die korrekte Verknüpfung von DataElement mit InvalidValueSpecification im Datentyp-Modell.
  • Dem-Konfiguration: Für die Signal-Validierung muss ein dediziertes DemEventParameter konfiguriert und der RTE-Kompilierungseinheit bekannt sein, damit Dem_SetEventStatus korrekt parametriert werden kann.
  • Zählerüberwachung: Die Trennung von transportErrorCounter und valueErrorCount verhindert Fehldiagnosen der Busverbindung, wenn lediglich Sender-seitig fehlerhafte Applikationswerte übertragen wurden.