klasse ara::diag::SovdConfiguration

Gebruik

De methode Offer van de klasse ara::diag::SovdConfiguration dient ertoe het doorsturen van diagnoseverzoeken door het Diagnostic Management (DM) naar de geconfigureerde handler te activeren [SWS_DM_01872]. De aanroep vindt synchroon plaats, accepteert geen parameters en meldt het resultaat terug via ara::core::Result<void> [SWS_DM_01872]. Zolang een handler niet via Offer is aangeboden, stuurt het DM geen inkomende verzoeken door, wat overeenkomt met het fundamentele aanbiedingspatroon van diagnostische interfaces (vgl. [SWS_DM_01525], [SWS_DM_00809]).

Foutafhandeling

In geval van een fout wordt een ara::core::Result met een foutcode van de enumeratie DiagOfferErrc geretourneerd, waarbij een rollback-semantiek geldt [SWS_DM_01872]:

• DiagOfferErrc::kAlreadyOffered: wordt gemeld wanneer de dienst al eerder werd aangeboden [SWS_DM_01872].
• DiagOfferErrc::kConfigurationMismatch: treedt op wanneer de configuratie niet overeenkomt met de DEXT-beschrijvingsgegevens [SWS_DM_01872].

Gelijktijdigheid en beperkingen

De operatie is gedeclareerd als noexcept en uitzonderingsveilig (exception safe), maar is gespecificeerd als niet-thread-safe (not thread-safe) [SWS_DM_01872]. Gelijktijdige aanroepen van dezelfde instantie vanuit meerdere threads moeten door de aanroepende applicatie worden voorkomen. Een hernieuwde aanroep na een reeds geslaagd aanbod zou vermoedelijk zonder toestandsverandering met een fout worden beantwoord. Vraag Q-f9b1a995dbb002ef (open)

Gebruik

De zuiver virtuele methode RequestGetConfiguration van de klasse ara::diag::SovdConfiguration wordt door de Diagnostic Server Instance aangeroepen wanneer de SOVD-methode “Read Configuration” voor een expliciet gemodelleerde SOVD-configuratie wordt uitgevoerd ([SWS_DM_01787], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 “Configuration – Explicit Configurations”). Als parameters worden de configuratie-ID van de te lezen instantie (configurationId), de meta-informatie van het verzoek (metaInfo) evenals een cancellationHandler overgedragen, die informeert over een eventuele afbreking van de lopende conversatie ([SWS_DM_01870]).

De functie werkt asynchroon en levert een ara::core::Future op, die een tuple bestaande uit een bestandsleessessie (DataTransferReadSession) en bijbehorende configuratie-meta-informatie (SovdConfigurationMetaInfo) beschikbaar stelt ([SWS_DM_01870]). De interface is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig ([SWS_DM_01870]).

Foutafhandeling en gelijktijdigheid

Als er bij de verwerking een fout optreedt, wordt er geen C++-fout geworpen, maar wordt via de Future een passende SOVD-foutcode conform ISO 17978-3 respectievelijk ASAM SOVD 1.1 geretourneerd ([SWS_DM_01870]).

Wat betreft de thread-safety geldt de specificatie “conditional”: of de concrete implementatie van de functie thread-safe of niet-thread-safe moet worden opgezet, bepaalt de aan de constructor overgedragen ConcurrencyType ([SWS_DM_01870]).

De API-methode ara::diag::SovdConfiguration::RequestPutConfiguration wordt door de Diagnostic Server aangeroepen wanneer via de SOVD-interface de methode “Write Configuration” voor een expliciet gemodelleerde configuratie moet worden uitgevoerd [SWS_DM_01788], [SWS_DM_01871].

Aanroep en parameters

De declaratie bevindt zich in de header ara/diag/sovd_configuration.h. De aanroep draagt de volgende invoerparameters over [SWS_DM_01871]:

• configurationId: ID van de te schrijven configuratie-instantie als ara::core::String.
• metaInfo: meta-informatie over het inkomende verzoek (MetaInfo const &).
• cancellationHandler: bewaakt de huidige bewerking en signaleert indien de communicatie is afgebroken.

De methode heeft een asynchrone semantiek en retourneert een ara::core::Future, die bij succes een tuple bestaande uit een schrijfsessie (DataTransferWriteSession) evenals bijbehorende metadata (SovdConfigurationMetaInfo) ter beschikking stelt [SWS_DM_01871].

Foutafhandeling en gelijktijdigheid

In het geval van een fout wordt de Future voltooid met een passende SOVD-foutcode volgens ISO 17978-3 respectievelijk ASAM SOVD 1.1 [SWS_DM_01871]. De functie is gedeclareerd als noexcept en uitzonderingsveilig (exception safe). De thread-safety is conditioneel (conditional): of de concrete implementatie thread-safe moet worden opgezet, bepaalt de in de constructor gespecificeerde ConcurrencyType [SWS_DM_01871].

Samenspel

De functie vormt de schrijvende tegenhanger van RequestGetConfiguration, die wordt gebruikt voor de SOVD-methode “Read Configuration” [SWS_DM_01787] (AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 “Configuration – Explicit Configurations”).

De methode StopOffer() van de klasse ara::diag::SovdConfiguration dient ertoe het doorsturen van verzoeken (request messages) door de Diagnostic Management Daemon (DM) naar de service-instantie te deactiveren [SWS_DM_01930]. Zij vormt de tegenhanger van de beschikbaarstelling van de service en volgt het uniforme lifecycle-patroon van diagnostische interfaces in AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

Gebruik en signatuur: De aanroep geschiedt parameterloos en synchroon via de header ara/diag/sovd_configuration.h [SWS_DM_01930]. Aangezien de methode geen retourwaarde oplevert (void) en als noexcept gedeclareerd is, geldt zij als uitzonderingsveilig (exception safe) [SWS_DM_01930]. Er worden noch foutcodes noch exceptions doorgegeven aan de aanroeper.

Concurrency en beperkingen: De functie is expliciet gespecificeerd als niet thread-safe (not thread-safe) [SWS_DM_01930]. Worden instanties van ara::diag::SovdConfiguration gebruikt in multithreading-omgevingen, dan moeten gelijktijdige toegang of wisselingen van de beschikbaarstellingstoestand door de Adaptive Application worden gesynchroniseerd.

Interactie: Het gedrag komt overeen met de deactiveringssemantiek van andere DM-services zoals ara::diag::CommunicationControl [SWS_DM_00810] of ara::diag::GenericRoutine [SWS_DM_00558]. Interpretatie: Na de aanroep van StopOffer() zullen door de DM ontvangen diagnoseverzoeken vermoedelijk worden verworpen of negatief worden beantwoord, totdat de configuratie opnieuw via een overeenkomstige aanbiedmethode wordt geactiveerd. Vraag Q-4c6212980015c119 (open)