struct ara::diag::SovdContentConcurrencyType

Das Struct ara::diag::SovdContentConcurrencyType spezifiziert das Nebenläufigkeitsverhalten für portbezogene SOVD-Inhalte in AUTOSAR Adaptive [SWS_DM_02182]. Es steuert über drei Attribute, ob das Diagnostic Management Lese- und Schreiboperationen auf den Anwendungs-Port parallel ausführen darf oder serialisieren muss. Standardmäßig sind alle Felder defensiv auf kNotConcurrent initialisiert, sodass Entwickler Nebenläufigkeit wie bei readWrite explizit freigeben müssen [SWS_DM_02185]. Die Konfiguration sollte vor Beginn der Diagnosekommunikation abgeschlossen sein, um eine threadsichere Abarbeitung zu gewährleisten.

mehr ›

Kontext

Die Datenstruktur ara::diag::SovdContentConcurrencyType ist im Header ara/diag/concurrency.h deklariert und dient der Spezifikation des Nebenläufigkeitsverhaltens für Ports im Kontext von Service-Oriented Vehicle Diagnostics (SOVD) [SWS_DM_02182]. In Architekturen auf Basis der AUTOSAR Adaptive Platform fungiert das Diagnostic Management (DM) als zentrale Instanz für die Abwicklung eingehender Diagnoseanfragen SWS Diagnostics S. 79. Wenn externe Diagnose-Clients Lese- oder Schreibzugriffe auf Diagnoseinhalte über SOVD initiieren, muss das Diagnostic Management ermitteln können, ob die bereitstellende Adaptive Application beziehungsweise der zugehörige Port fähig ist, mehrere Anfragen nebenläufig und threadsicher zu verarbeiten.

Hierzu definiert SovdContentConcurrencyType drei Konfigurationsattribute für reine Lesezugriffe, reine Schreibzugriffe sowie kombinierte Lese- und Schreibzugriffe SWS Diagnostics §8.8.3 „Struct: SovdContentConcurrencyType“. Die Struktur fungiert somit als Konfigurationsschnittstelle zwischen der Implementierung des anwendungsseitigen Ports und der Ablaufsteuerung des Diagnostic Managements.

Kontextdiagramm: Zusammenspiel zwischen Diagnostic Management, SovdContentConcurrencyType und dem SOVD-Port der Adaptive Application. Quellen: [SWS_DM_02182], [SWS_DM_02185], SWS Diagnostics §8.8.3 „Struct: SovdContentConcurrencyType“

Lebenszyklus

Als reines Datenübertragungs- und Konfigurations-Struct besitzt SovdContentConcurrencyType einen einfachen Lebenszyklus ohne dynamische Ressourcenverwaltung oder komplexe interne Zustandskontrollen [SWS_DM_02182].

Die Instanziierung erfolgt typischerweise während der Konfigurations- und Initialisierungsphase der Adaptive Application, vermutlich auf dem Stack oder als Bestandteil einer übergeordneten Port-Verwaltungsklasse vor Beginn der Diagnosekommunikation. Frage Q-f78487eff58a4775 (offen) Alle Member-Variablen werden bei der Objekterzeugung standardmäßig defensiv initialisiert:

• read wird standardmäßig mit ConcurrencyType::kNotConcurrent vorbelegt [SWS_DM_02183].
• write wird standardmäßig mit ConcurrencyType::kNotConcurrent vorbelegt [SWS_DM_02184].
• readWrite wird standardmäßig mit ConcurrencyType::kNotConcurrent vorbelegt [SWS_DM_02185].

Hinsichtlich Nebenläufigkeit und Threading gilt: Das Struct selbst ist ein passives Konfigurationsobjekt ohne eigene Synchronisationsmechanismen. Modifikationen an den Feldern sollten daher abgeschlossen sein, bevor die Struktur an das Diagnostic Management übergeben oder von mehreren Threads gelesen wird. Nach der Registrierung am Port verbleibt die Konfiguration über die gesamte Lebensdauer des betreffenden Diagnose-Ports unverändert (Interpretation: Eine dynamische Modifikation zur Laufzeit der Diagnosekommunikation ist von der Spezifikation nicht vorgesehen). Frage Q-71f96ed7cd3a6f61 (offen) Das Bereinigen der Strukturinstanz erfolgt nach dem Ende ihres Gültigkeitsbereichs gemäß regulärer C++-Semantik ohne zusätzlichen Bereinigungsbedarf.

Nutzungspfad

Der typische Nutzungspfad umfasst die Definition der Port-Fähigkeiten durch die Anwendung, die Bereitstellung zur Laufzeit und die Auswertung durch das Diagnostic Management:

1. Konfiguration der Fähigkeiten: Die Adaptive Application instanziiert ein Objekt vom Typ SovdContentConcurrencyType. Falls die Implementierung der Port-Methoden threadsicher ausgelegt ist, werden die entsprechenden Attribute gezielt auf ConcurrencyType::kConcurrent gesetzt. Das Setzen von readWrite auf kConcurrent signalisiert dem Diagnostic Management explizit, dass Lese- und Schreib-APIs gleichzeitig aufgerufen werden dürfen [SWS_DM_02185].
2. Standardverhalten wahren: Sofern eine Port-Implementierung nicht reentrant oder intern synchronisiert ist, belässt der Entwickler die Werte auf kNotConcurrent [SWS_DM_02183], [SWS_DM_02184]. Interpretation: Das Diagnostic Management stellt in diesem Fall sicher, dass anfallende Anfragen für diesen Port sequenziell ausgeführt werden, um Datenkonflikte zu verhindern. Frage (offen)
3. Ablaufsteuerung durch das DM: Während des Betriebs empfängt das Diagnostic Management externe SOVD-Anfragen. Anhand der hinterlegten Konfiguration ermittelt das DM, ob parallele Methodenaufrufe für Read- und Write-Routinen an den Port weitergeleitet werden können oder ob eine Serialisierung zwingend erforderlich ist SWS Diagnostics §8.8.3.1.2 „readWrite“.