struct ara::diag::SovdContentConcurrencyType

Het struct ara::diag::SovdContentConcurrencyType specificeert het concurrencygedrag voor poortgerelateerde SOVD-inhoud in AUTOSAR Adaptive [SWS_DM_02182]. Het regelt via drie attributen of Diagnostic Management lees- en schrijfbewerkingen op de applicatiepoort parallel mag uitvoeren of moet serialiseren. Standaard zijn alle velden defensief geïnitialiseerd op kNotConcurrent, zodat ontwikkelaars concurrency zoals bij readWrite expliciet moeten vrijgeven [SWS_DM_02185]. De configuratie moet vóór aanvang van de diagnosecommunicatie voltooid zijn om een thread-safe verwerking te waarborgen.

meer ›

Context

De datastructuur ara::diag::SovdContentConcurrencyType is gedeclareerd in header ara/diag/concurrency.h en dient voor de specificatie van het concurrencygedrag voor poorten in de context van Service-Oriented Vehicle Diagnostics (SOVD) [SWS_DM_02182]. In architecturen op basis van het AUTOSAR Adaptive Platform fungeert Diagnostic Management (DM) als centrale instantie voor de afhandeling van inkomende diagnoseverzoeken SWS Diagnostics p. 79. Wanneer externe diagnoseclients lees- of schrijftoegangen op diagnose-inhoud via SOVD initiëren, moet Diagnostic Management kunnen vaststellen of de leverende Adaptive Application respectievelijk de bijbehorende poort in staat is om meerdere verzoeken gelijktijdig en thread-safe te verwerken.

Hiertoe definieert SovdContentConcurrencyType drie configuratie-attributen voor zuivere leestoegangen, zuivere schrijftoegangen evenals gecombineerde lees- en schrijftoegangen SWS Diagnostics §8.8.3 “Struct: SovdContentConcurrencyType”. De structuur fungeert zodoende als configuratie-interface tussen de implementatie van de applicatiezijdige poort en de procesbesturing van Diagnostic Management.

Contextdiagram: samenspel tussen Diagnostic Management, SovdContentConcurrencyType en de SOVD-poort van de Adaptive Application. Bronnen: [SWS_DM_02182], [SWS_DM_02185], SWS Diagnostics §8.8.3 “Struct: SovdContentConcurrencyType”

Levenscyclus

Als zuiver gegevensoverdrachts- en configuratiestruct heeft SovdContentConcurrencyType een eenvoudige levenscyclus zonder dynamisch resourcebeheer of complexe interne statuscontroles [SWS_DM_02182].

De instantiëring vindt typisch plaats tijdens de configuratie- en initialisatiefase van de Adaptive Application, vermoedelijk op de stack of als onderdeel van een bovenliggende poortbeheerklasse vóór aanvang van de diagnosecommunicatie. Vraag Q-f78487eff58a4775 (open) Alle membervariabelen worden bij het aanmaken van het object standaard defensief geïnitialiseerd:

• read wordt standaard vooraf ingevuld met ConcurrencyType::kNotConcurrent [SWS_DM_02183].
• write wordt standaard vooraf ingevuld met ConcurrencyType::kNotConcurrent [SWS_DM_02184].
• readWrite wordt standaard vooraf ingevuld met ConcurrencyType::kNotConcurrent [SWS_DM_02185].

Wat betreft concurrency en threading geldt: het struct zelf is een passief configuratie-object zonder eigen synchronisatiemechanismen. Wijzigingen aan de velden moeten daarom voltooid zijn voordat de structuur aan Diagnostic Management wordt overgedragen of door meerdere threads wordt gelezen. Na registratie bij de poort blijft de configuratie gedurende de gehele levensduur van de betreffende diagnosepoort ongewijzigd (interpretatie: een dynamische wijziging tijdens runtime van de diagnosecommunicatie is niet voorzien door de specificatie). Vraag Q-71f96ed7cd3a6f61 (open) Het opruimen van de structuurinstantie vindt plaats na afloop van haar geldigheidsbereik volgens reguliere C++-semantiek zonder aanvullende opruimbehoefte.

Gebruikspad

Het typische gebruikspad omvat de definitie van de poortcapaciteiten door de applicatie, de beschikbaarstelling tijdens runtime en de evaluatie door Diagnostic Management:

1. Configuratie van de capaciteiten: de Adaptive Application instantieert een object van het type SovdContentConcurrencyType. Indien de implementatie van de poortmethoden thread-safe is ontworpen, worden de overeenkomstige attributen gericht op ConcurrencyType::kConcurrent gezet. Het instellen van readWrite op kConcurrent signaleert expliciet aan Diagnostic Management dat lees- en schrijf-API's gelijktijdig mogen worden aangeroepen [SWS_DM_02185].
2. Standaardgedrag behouden: voor zover een poortimplementatie niet re-entrant of intern gesynchroniseerd is, laat de ontwikkelaar de waarden op kNotConcurrent staan [SWS_DM_02183], [SWS_DM_02184]. Interpretatie: Diagnostic Management waarborgt in dit geval dat binnenkomende verzoeken voor deze poort sequentieel worden uitgevoerd om dataconflicten te voorkomen. Vraag (open)
3. Procesbesturing door het DM: tijdens bedrijf ontvangt Diagnostic Management externe SOVD-verzoeken. Aan de hand van de opgeslagen configuratie bepaalt het DM of parallelle methode-aanroepen voor read- en write-routines naar de poort kunnen worden doorgestuurd of dat serialisatie dwingend vereist is SWS Diagnostics §8.8.3.1.2 “readWrite”.