klasse ara::diag::SovdOperationExecution

De interface dient voor de applicatiespecifieke besturing en monitoring van een lopende SOVD-operatie in Diagnostic Management [SWS_DM_02197]. Via beschermde methoden verwerkt ze statusopvragingen evenals verzoeken tot het uitvoeren van speciale capaciteiten of tot het afbreken van de operatie. Alle retouren vinden asynchroon plaats via futures, waarbij fouten dwingend als gestandaardiseerde SOVD-foutcodes volgens ISO 17978-3 worden overgedragen [SWS_DM_02384]. Bovendien moeten implementaties thread-safe zijn en doorgegeven cancellation-handlers strikt aan de levensduur van de operatie binden.

meer ›

Context

De klasse ara::diag::SovdOperationExecution definieert de programmeerinterface voor het besturen en monitoren van lopende SOVD-operatie-uitvoeringen (Service-Oriented Vehicle Diagnostics) binnen de module diag van het AUTOSAR Adaptive Platform [SWS_DM_02197], SWS Diagnostics §8.62.5 “Class: SovdOperationExecution”. Ze fungeert als schakel tussen het Diagnostic Management (DM) en de uitvoerende applicatielogica voor diagnosegerelateerde routines volgens ASAM SOVD en ISO 17978-3.

Wanneer een externe SOVD-client het starten van een operatie initieert [SWS_DM_01396] en de optionele validatie van de proximity challenge met succes is doorlopen [SWS_DM_02174], instantieert resp. bindt het DM de uitvoering aan een unieke identificator (execution-id) [SWS_DM_02177]. Alle opvolgende methode-aanroepen voor deze lopende operatie – in het bijzonder statusopvragingen en afbreekcommando's – stuurt het DM door naar die instantie van ara::diag::SovdOperationExecution die aan deze identificator is toegewezen [SWS_DM_02180].

Contextdiagram: inpassing van SovdOperationExecution tussen SOVD-client, Diagnostic Management en applicatiespecifieke operatielogica. Bronnen: [SWS_DM_01396], [SWS_DM_02180], [SWS_DM_02197].

Levenscyclus

De klasse bezit een als noexcept=default gedeclareerde standaardconstructor [SWS_DM_02198] evenals een virtuele destructor die eveneens als noexcept=default is gedefinieerd [SWS_DM_02199]. Aangezien alle functionele methoden – ExecuteCapability [SWS_DM_02384], GetStatus [SWS_DM_02201] en Terminate [SWS_DM_02202] – zuiver virtueel (= 0) en beschermd (protected) zijn, kan de klasse niet direct worden geïnstantieerd. Interpretatie: applicatieontwikkelaars leiden eigen klassen af van SovdOperationExecution om de applicatiespecifieke routines te implementeren. Vraag Q-c1d622c7aa17382d (open)

Elke actieve operatie-uitvoering wordt in het DM toegewezen aan een execution-id [SWS_DM_02177], [SWS_DM_02180]. De specificatie benadrukt dat operaties in veel gevallen slechts één enkele gelijktijdige instantie toestaan SWS Diagnostics §7.3.3.5.5.6 “Operations – Terminate execution of an operation”. Alle interfacemethoden zijn gespecificeerd als thread-safe (thread-safe) en uitzonderingsveilig (exception safe) [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Wat betreft geheugenbeheer en levensduren gelden strikte voorschriften: de parameter sovd_content_data blijft geldig totdat de bijbehorende promise is vervuld of de verwerking via de cancellation_handler is afgebroken [SWS_DM_02384]. Het object cancellation_handler zelf mag onder geen enkel beding buiten de levensduur van de desbetreffende operatie worden opgeslagen of aangeroepen [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Gebruikspad

Het typische verloop ter begeleiding van een SOVD-operatie is onderverdeeld in de volgende stappen:

• Capaciteiten aanvragen: Het DM kan voor een lopende operatie via de methode ExecuteCapability acties zoals uitvoeren, bevriezen of resetten aanvragen [SWS_DM_02384].
• Status opvragen: Ontvangt het DM de SOVD-aanroep „Read the Status of an operation” en slaagt de vereiste proximity-validatie [SWS_DM_02173], dan roept het GetStatus van de toegewezen SovdOperationExecution-instantie aan [SWS_DM_02180], [SWS_DM_02201]. Na succesvolle terugkeer antwoordt het DM de client met de attributen status (uit GetStatusResponse.status), capability (waarde execute) en parameters (afgeleid uit GetStatusResponse.Parameters) [SWS_DM_02181].
• Operatie beëindigen: Komt bij de Diagnostic Server de SOVD-methode „Terminate execution of an Operation” binnen [SWS_DM_01392], dan wordt na validatie van het proximity-antwoord [SWS_DM_01391] de methode Terminate onder opgave van de reden (TerminateOperationExecutionReason) op de instantie aangeroepen [SWS_DM_02179], [SWS_DM_02202].

Sequentiediagram: interactiereeks tussen Diagnostic Management en SovdOperationExecution bij statusopvragingen en gecontroleerde beëindiging. Bronnen: [SWS_DM_02180], [SWS_DM_02181], [SWS_DM_02179], [SWS_DM_02202].

Foutscenario's

Alle uit te voeren methoden (ExecuteCapability, GetStatus, Terminate) werken asynchroon en retourneren een ara::core::Future [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202]. Faalt de verwerking binnen de applicatie, dan moet de future worden vervuld met een toepasselijke SOVD-foutcode conform ISO 17978-3 resp. ASAM SOVD 1.1 [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Wordt een lopend verzoek vanuit het diagnose-framework geannuleerd, dan signaleert het DM dit via het meegegeven object ara::diag::CancellationHandler [SWS_DM_02384]. De implementatie moet rekening houden met de afbreekstatus van deze handler en de verwerking onmiddellijk beëindigen om blokkerende toestanden te voorkomen.