DEENESPTFRRUARHIKOZHNL
AUTOSAR_AP_SWS_LogAndTrace FIG-6b8e0a14adb6d799 860 × 499 px 1 Release(s)

Figure 5.1: Interfaces provided by Log and Trace to other Functional Clusters

SHA-256 Inhalts-Fingerabdruck: 6b8e0a14adb6d79906e42462b7e927af076d068cd938134c9b4a8dfd96dfa39d

Im Versions-Explorer öffnen

Kanonischer Bildausschnitt (144 DPI WebP, gerendert aus Original-Vektorgrafik) · nicht öffentlich, nur mit Anmeldung und Freigabe
✦ KI-generierte Bildanalyse & technische Beschreibung Modell: gemini-3.8-flash (via agy) · Rezept figure-series@1 · erstellt am 2026-10-08

1. Diagrammtyp & Architektur-Kontext

  • Diagrammtyp: UML-Klassendiagramm / Architektur-Abhängigkeitsdiagramm (Component & Interface Dependency Diagram) gemäß AUTOSAR-Metamodell für die Adaptive Platform (AP).
  • Technischer Zweck: Spezifikation der durch den Functional Cluster (FC) Log and Trace bereitgestellten nativen Programmierschnittstelle (Logger) und deren querschnittlicher Abhängigkeiten («use») zu allen übrigen Standard-Functional-Clustern der AUTOSAR Adaptive Platform (Release R23-11, Kapitel 5.1).
  • Systemeinordnung: Log and Trace stellt das fundamentale Diagnose-, Tracing- und Protokollierungs-Rückgrat (ara::log) für Plattform-Daemons und Bibliotheken bereit, typischerweise mit Anbindung an das DLT-Protokoll (Diagnostic Log and Trace).

2. Komponenten, Entitäten & Schnittstellen

  • Bereitgestellte Schnittstelle:
    • «aapAPI, aapNativeInterface» Logger: Zentrale C++ Abstraktion (ara::log::Logger) zur strukturierten und unstrukturierten Protokollierung.
      • + IsEnabled(): bool: Abfrage des aktiven Log-Zustands zur Vermeidung unnötiger Formatierungs-Overheads mit explizit spezifiziertem booleschen Rückgabetyp.
      • + Log(MsgId, Params): Direktes, ID-basiertes Logging für formatfreie oder vorkompilierte DLT-Nachrichten.
      • + LogDebug(): LogStream, + LogError(): LogStream, + LogFatal(): LogStream, + LogInfo(): LogStream, + LogVerbose(): LogStream, + LogWarn(): LogStream: Severity-spezifische Factory-Methoden zur Erzeugung typsicherer Streaming-Objekte (ara::log::LogStream).
      • + WithLevel(): LogStream: Dynamische Festlegung des Log-Levels zur Laufzeit.
  • Realisierende Komponente:
    • «aapFunctionalCluster» Log and Trace: Implementiert das Logger-Interface (Realization-Pfeil mit geschlossener, nicht ausgefüllter Spitze).
  • Konsumierende Functional Clusters («use»-Beziehung):
    • Daemon-basierte Cluster (daemon-based):
      • Execution Management (Prozesslebenszyklus, POSIX-Initialisierung)
      • State Management (Systemzustandssteuerung)
      • Diagnostic Management (UDS/DoIP-Stack)
      • Platform Health Management (Watchdog, Alive-/Deadline-Supervision)
      • Time Synchronization (gPTP / IEEE 802.1AS)
      • Intrusion Detection System Manager (Security Event Logging)
      • Communication Management (Service-Oriented Communication via SOME/IP, IPC)
      • Vehicle Update and Configuration Management (Fahrzeugweite Update-Orchestrierung)
      • Update and Configuration Management (Lokales Software-Package-Handling)
      • Network Management (Partielle Netzwerke, State Handling; nun explizit als prozess-/daemon-basiert deklariert)
    • Bibliotheks-/Nicht-Daemon-basierte Cluster:
      • Persistency (Flash/EEPROM File & Key-Value Storage)

3. Dynamisches Verhalten & Sequenzablauf

  • Synchroner Aufrufkontext: Der aufrufende Functional Cluster instanziiert oder referenziert thread-lokal ein Logger-Objekt (gebunden an Application-ID/Context-ID).
  • Filterung & Stream-Generierung:
    1. Interner oder expliziter Check via IsEnabled() gegen den aktuell konfigurierten Log-Level.
    2. Bei Freigabe Erzeugung des temporären LogStream-Objekts (Stack-basiert).
    3. Formatierung/Serialisierung der Parameter über den überladenen Shift-Operator operator<<.
  • Asynchroner Flush & IPC:
    • Mit Zerstörung des temporären LogStream-Objekts am Ende des Full-Expressions (RAII) erfolgt die Commit-Operation.
    • Übergabe der Nachricht an den lokalen Puffer bzw. Shared-Memory-Ringpuffer.
    • Der Log and Trace-Hintergrund-Daemon holt die Daten asynchron ab und routet sie über Netzwerk (DLT over IP) oder UART, ohne den Aufrufer-Thread zu blockieren.

4. Normative Relevanz & Entwickler-Hinweise

  • Nicht-blockierendes Verhalten (Real-Time Safety): Da echtzeitkritische Cluster wie Platform Health Management und Time Synchronization denselben Logger nutzen, darf das Logging unter keinen Umständen blockieren (Zero-Allocation-Policy im Hot-Path, strikte Trennung von Erfassung und serialisiertem I/O-Transport).
  • Bootstrap-Dilemma & Early Logging:
    • Execution Management startet als erster Plattform-Daemon und muss bereits loggen können, bevor der Log and Trace-Daemon betriebsbereit ist.
    • Treiber- und Stack-Entwickler müssen einen Ringpuffer-Fallback (Local Buffer) für Plattform-Starts vorsehen, der nach Initialisierung von Log and Trace geleert wird.
  • Reentrancy & Thread-Safety: Alle Methoden der Logger-Schnittstelle müssen reentrant und threadsicher implementiert sein, da Cluster wie Communication Management massiv nebenläufig agieren.
  • Traceability & ASIL-Einstufung: Wenn Security- (IDSM) oder Safety-relevante (PHM) Cluster über Logger auditieren, müssen Datenverluste bei Pufferüberläufen (Buffer Overflow / Message Drop Counters) normativ erfasst und meldbar sein.

Versionsvergleich KI-generiert · gemini-3.8-flash (via agy)

R24-11 → R25-11 normative Änderung Vorgänger: FIG-d7bf0075ebd9cd51
  • Logger: Rückgabetyp bei Methode + IsEnabled(): bool explizit ergänzt (zuvor + IsEnabled()).
  • Network Management: Eigenschaftsauszeichnung daemon-based hinzugefügt (zuvor ohne Kennzeichnung als rein bibliotheksbasierter Cluster geführt).
  • Vehicle Update and Configuration Management: Redaktioneller Zeilenumbruch des Namens im Klassenrahmen geändert (Vehicle Update and / Configuration Management statt Vehicle Update and Configuration / Management).

Zugeordnete Anforderungen

Diese Angaben zeigt der Versions-Explorer.

Aus dem Dokument extrahierter Text & Kontext

Beschriftungen im Schaubild:

«aapFunctionalClust... | Log and Trace | «aapAPI,aapNativeInterface» | Logger | + IsEnabled(): bool + Log(MsgId, Params) + LogDebug(): LogStream + LogError(): LogStream + LogFatal(): LogStream + LogInfo(): LogStream + LogVerbose(): LogStream + LogWarn(): LogStream + WithLevel(): LogStream | «aapFunctionalClust... Execution Management daemon-based | «aapFunctionalClust... Diagnostic Management | daemon-based | «aapFunctionalCluster» | Communication | Management daemon-based | «aapFunctionalCluster» Update and Configuration | Management daemon-based | «aapFunctionalClust... | Persistency | «aapFunctionalCluster» Intrusion Detection System | Manager daemon-based | «aapFunctionalClust... | Time Synchronization daemon-based | «aapFunctionalClust... | State Management daemon-based | «aapFunctionalClust... | Network Management daemon-based | «aapFunctionalClust... | Platform Health | Management daemon-based | «aapFunctionalCluster» | Vehicle Update and Configuration Management daemon-based | «use» | «use» | «use» | «use» | «use» «use» «use» «use» «use» «use» «use»

Begleitender Spezifikationstext:

Specification of Log and Trace AUTOSAR AP R25-11 5 Dependencies to other Functional Clusters This chapter defines the dependencies of this functional cluster to other functional clusters. AUTOSAR decided not to standardize interfaces which are exclusively used between functional clusters to allow efficient implementations which might depend e.g., on the used operating system. The goal of this chapter is to provide an informative guideline for the interactions between functional clusters without specifying syntactical details. This ensures compatibility between documents specifying different functional clusters and supports parallel implementation of different functional clusters. Details of internal interfaces are up to the platform provider. Additional internal interfaces, parameters, and return values can be added. A detailed technical architecture documentation of the overall AUTOSAR Adaptive Platform is provided in [5]. 5.1 Provided Interfaces This section provides an overview of the public interfaces provided by this functional cluster towards other functional clusters. «aapFunctionalClust... Log and Trace «aapAPI,aapNativeInterface» Logger + IsEnabled(): bool + Log(MsgId, Params) + LogDebug(): LogStream + LogError(): LogStream + LogFatal(): LogStream + LogInfo(): LogStream + LogVerbose(): LogStream + LogWarn(): LogStream + WithLevel(): LogStream «aapFunctionalClust... Execution Management daemon-based «aapFunctionalClust... Diagnostic Management daemon-based «aapFunctio

Vorkommen in AUTOSAR-Releases (1)

Release Dokument Seite Nr. Bildunterschrift im Dokument
R25-11 AUTOSAR_AP_SWS_LogAndTrace S. 13 5.1 Figure 5.1: Interfaces provided by Log and Trace to other Functional Clusters