klasse ara::diag::OperationCycle

De klasse ara::diag::OperationCycle stelt aan de applicatie functies beschikbaar voor de besturing en bewaking van diagnose-bedrijfscycli [SWS_DM_00752]. Instanties worden via een ara::core::InstanceSpecifier aan een gemodelleerde poort gebonden, zijn noch kopieerbaar noch verplaatsbaar en mogen per identifier slechts eenmaal in het proces bestaan. Via SetNotifier kan een notificatie voor cycluswijzigingen worden ingesteld en door middel van RestartOperationCycle kan een herstart van de bedrijfscyclus worden geactiveerd [SWS_DM_01102]. Met uitzondering van de thread-safe constructor zijn alle methoden en de destructor niet thread-safe en vereisen zij bij parallelle toegang synchronisatie aan de applicatiezijde.

meer ›

Context

De klasse ara::diag::OperationCycle realiseert het DiagnosticOperationCycleInterface binnen de AUTOSAR Adaptive-diagnose en biedt functies voor de hantering en besturing van bedrijfscycli. Zij dient als interface tussen de adaptieve applicatie en Diagnostic Management om toestanden van bedrijfscycli te bewaken of gericht te resetten.

De koppeling aan het totale systeem vindt plaats via een ara::core::InstanceSpecifier, die bij de constructor-aanroep wordt meegegeven [SWS_DM_00752]. Deze identifier refereert aan een in het model gedefinieerde PortPrototype. Het model schrijft hierbij een eenduidige toewijzing voor: een door een DiagnosticOperationCyclePortMapping gereferentieerde PortPrototype moet door het DiagnosticOperationCycleInterface getypeerd zijn [SWS_DM_00752]. Naast de besturing interacteert de klasse via een callback-interface van het type ara::diag::OperationCycle::OperationCycleSetNotifier (gedefinieerd als std::function<void(void)>), waarmee notificaties bij een wijziging van de bedrijfscyclus aan de applicatie worden doorgegeven [SWS_DM_02078], [SWS_DM_00755].

Levenscyclus

De creatie van ara::diag::OperationCycle vindt expliciet plaats door specificatie van de poortinstantiespecificatie via de constructor OperationCycle(const ara::core::InstanceSpecifier &specifier) [SWS_DM_00752]. De constructor is gespecificeerd als exception-safe en thread-safe [SWS_DM_00752].

Wat betreft eigendoms- en kopieersemantiek is de klasse gemodelleerd als een strikt enkel object dat een vaste 1:1-binding met de gemodelleerde poort vormt. Kopiëren en verplaatsen zijn volledig verhinderd:

• De copy-constructor is verwijderd (delete) om duplicaties uit te sluiten [SWS_DM_01598].
• De move-constructor is verwijderd (delete) [SWS_DM_01599].
• De copy-toewijzingsoperator is verwijderd (delete) [SWS_DM_01596].
• De move-toewijzingsoperator is verwijderd (delete) [SWS_DM_01597].

Bovendien verbiedt het framework meervoudige toewijzing: een InstanceSpecifier mag binnen hetzelfde proces niet herhaaldelijk voor een instantiëring worden gebruikt [SWS_DM_00752]. De vrijgave vindt plaats in de destructor ~OperationCycle() [SWS_DM_00753]. In tegenstelling tot de constructor is de destructor niet thread-safe (not thread-safe), hoewel deze als exception-safe is gedeclareerd [SWS_DM_00753]. Ook de verdere methoden van de klasse en het callback-type zijn niet thread-safe [SWS_DM_00755], [SWS_DM_01102], [SWS_DM_02078], zodat parallelle toegangen tot dezelfde instantie aan de applicatiezijde moeten worden gesynchroniseerd.

Gebruikspad

Een typisch gebruikstraject omvat de instantiëring, de optionele registratie van een handler voor cycluswijzigingen, het herhaaldelijk triggeren van de cyclusherstart en de vrijgave:

1. Instantiëring: de applicatie creëert het object OperationCycle onder doorgifte van de bijbehorende InstanceSpecifier [SWS_DM_00752].
2. Notifier registreren: via de methode SetNotifier stelt de applicatie een callback-functie van het type OperationCycleSetNotifier in [SWS_DM_00755], [SWS_DM_02078]. Deze functie wordt aangeroepen wanneer de bedrijfscyclus verandert. Een opeenvolgende aanroep van SetNotifier overschrijft de eerder geregistreerde notifier volledig [SWS_DM_00755].
3. Bedrijfscyclus herstarten: met behulp van RestartOperationCycle() activeert de applicatie de herstart van de bedrijfscyclus [SWS_DM_01102]. Diagnostic Management actualiseert de cyclus en stelt bij statusovergangen de geregistreerde callback op de hoogte [SWS_DM_00755]. De notificatie vindt hierbij vermoedelijk asynchroon plaats in de context van Diagnostic Management. Vraag Q-7cd22debf6fa91d7 (open)
4. Vernietiging: bij het afsluiten van de softwarecomponent wordt het object via de destructor vernietigd [SWS_DM_00753].

Sequentiediagram: verloop van instantiëring, notifier-registratie en herstart van de bedrijfscyclus. Bronnen: [SWS_DM_00752], [SWS_DM_00755], [SWS_DM_01102], [SWS_DM_02078].

Foutscenario's

Fouten bij de initialisatie worden door het framework als schendingen (violations) gesignaleerd, aangezien de constructor als noexcept is gedeclareerd [SWS_DM_00752]:

• InstanceSpecifierMappingIntegrityViolation: de InstanceSpecifier kan in de context van het executable niet worden herleid of verwijst naar een element dat geen PortPrototype is [SWS_DM_00752].
• PortInterfaceMappingViolation: de door DiagnosticOperationCyclePortMapping gereferentieerde PortPrototype is niet door een DiagnosticOperationCycleInterface getypeerd [SWS_DM_00752].
• ProcessMappingViolation: er bestaat weliswaar een passende instantie-referentie, maar er is geen passend gemodelleerd proces voor het runtime-proces gevonden [SWS_DM_00752].
• InstanceSpecifierAlreadyInUseViolation: de constructor is aangeroepen met een InstanceSpecifier die binnen het huidige proces reeds wordt gebruikt [SWS_DM_00752].

Tijdens regulier bedrijf retourneren de methoden SetNotifier en RestartOperationCycle een ara::core::Result<void> [SWS_DM_00755], [SWS_DM_01102]. Voor beide functies zijn in de standaard geen specifieke foutcodes gedefinieerd (“This function does not specify any standardized errors.”) [SWS_DM_00755], [SWS_DM_01102]. Het gebruik van het type Result dient vermoedelijk primair voor een uniforme interface-opzet en biedt ruimte voor implementatiespecifieke fouttoestanden. Vraag Q-2c59a287c0d5783a (open)