Figure 5.2: Interfaces required by Network Management from other Functional Clusters

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Komponenten- und Schnittstellendiagramm (AUTOSAR Adaptive Platform Metamodellierung).
• Technischer Zweck & Einordnung: Spezifikation der ausgehenden Abhängigkeiten und Dienstschnittstellen, die der funktionale Cluster Network Management (NM) der AUTOSAR Adaptive Platform als Daemon zur Laufzeit von Nachbarclustern bzw. der Plattformbasis anfordert (required interfaces). NM wird als eigenständiger Prozess (daemon-based) architektonisch an Execution Management zur Lebenszyklusverwaltung, Log and Trace für strukturierte Diagnosprotokollierung sowie das Operating System (TCP/IP Stack) für den Netzwerktransport angebunden.

2. Komponenten, Entitäten & Schnittstellen

• Komponenten / Functional Clusters:
  • «aapFunctionalCluster» Network Management daemon-based: Konsument der Schnittstellen; zuständig für die Verwaltung des Netzwerkzustands (z. B. UDP-basiertes NM) als eigenständiger Plattform-Daemon.
  • «aapFunctionalCluster» Log and Trace: Bereitstellender Cluster für plattformweites Logging und Tracing (ara::log).
  • «aapFunctionalCluster» Execution Management daemon-based: Bereitstellender Cluster für Prozessinitialisierung, Überwachung und Ausführungszustände (ara::exec).
  • Operating System: Bereitstellende Plattform-Entität für Low-Level-Netzwerktreiber und Socket-Infrastruktur.
• Schnittstellen & Entitäten:
  • «aapAPI, aapNativeInterface» Log and Trace::Logger:
    • Native C++-Programmierschnittstelle des Log-Clusters.
    • Operationen:
      • + IsEnabled(): bool
      • + Log(MsgId, Params)
      • + LogDebug(): LogStream
      • + LogError(): LogStream
      • + LogFatal(): LogStream
      • + LogInfo(): LogStream
      • + LogVerbose(): LogStream
      • + LogWarn(): LogStream
      • + WithLevel(): LogStream
  • «aapAPI, aapNativeInterface» Execution Management::ExecutionClient:
    • Native C++-Programmierschnittstelle für die Interaktion mit dem Execution Management.
    • Operationen:
      • + Create() (statische Fabrikmethode)
      • + ReportExecutionState(ExecutionState)
  • «aapInternal» TCP/IP Stack:
    • Plattforminterne Netzwerkschnittstelle/Stack (typischerweise POSIX-Sockets oder proprietäre OS-Sockets).
• Beziehungen & Abhängigkeiten:
  • Network Management besitzt eine gerichtete Nutzungsbeziehung («use») auf Log and Trace::Logger.
  • Network Management besitzt eine gerichtete Nutzungsbeziehung («use») auf Execution Management::ExecutionClient.
  • Network Management besitzt eine gerichtete Nutzungsbeziehung («use») auf TCP/IP Stack.
  • Log and Trace realisiert/implementiert (interface realization, gestrichelte Linie mit geschlossener Pfeilspitze) die Schnittstelle Log and Trace::Logger.
  • Execution Management realisiert/implementiert die Schnittstelle Execution Management::ExecutionClient.
  • Operating System realisiert/implementiert die Schnittstelle TCP/IP Stack.

3. Dynamisches Verhalten & Sequenzablauf

• Lebenszyklus- und Zustandsmeldung (Execution Management):
  • Beim Startup instanziiert der NM-Daemon den Client via statischer Methode ExecutionClient::Create() und meldet nach vollständiger Initialisierung seinen Prozesszustand (ExecutionState, z. B. kRunning) über ReportExecutionState(...) an das Execution Management.
• Zyklisches / Ereignisgesteuertes Senden & Empfangen (TCP/IP):
  • NM nutzt den TCP/IP Stack synchron oder asynchron (z. B. über BSD/POSIX-Sockets via UDP) zum Senden periodischer NM-Botschaften (NM-PDUs) sowie zum Abhören eingehender NM-Pakete zur koordinierten Netzwerkhaltung (Network Request vs. Network Release).
• Logging & Tracing:
  • Synchroner Aufruf von Log and Trace::Logger bei Zustandswechseln, Timeout-Ereignissen oder Netzwerk-/Socketfehlern.
  • Effiziente Vorabprüfung über IsEnabled(): bool vor der Meldungsaufbereitung sowie Erzeugung von Logs über den Streaming-Operator (LogStream) auf definierten Severitätsstufen.

4. Normative Relevanz & Entwickler-Hinweise

• API-Verträge & Standardisierung:
  • ara::exec: Die Einbindung von ExecutionClient ist zwingend durch die Einstufung von Network Management als daemon-based Functional Cluster bedingt. Der NM-Daemon muss den standardisierten Lebenszyklusvertrag via ara::exec::ExecutionClient einhalten.
  • ara::log: Die Schnittstelle Log and Trace::Logger schreibt nun explizit den Rückgabetyp bool für IsEnabled() vor, was normativ die Prüfung vor Log-Operationen typisiert.
  • TCP/IP Stack: Das Stereotyp «aapInternal» indiziert unverändert, dass der Netzwerkzugriff über plattform-/betriebssysteminterne Mechanismen (z. B. POSIX-Sockets) statt über eine standardisierte ARA-API erfolgt.