klasse ara::diag::MultipleMonitor

Gebruik

De methode ara::diag::MultipleMonitor::ConfigureMonitor initialiseert een diagnosemonitor voor de monitor-interne ontdendering [SWS_DM_01696]. Via de parameter monitorHandle wordt de te configureren monitor geadresseerd, terwijl met initMonitor een notifier-callback voor herinitialisaties en met getFaultDetectionCounter een functie voor het opvragen van de actuele fouttellerwaarde (FDC) worden geregistreerd [SWS_DM_01696]. De uitvoering verloopt synchroon en retourneert een ara::core::Result<void> AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 “ConfigureMonitor”.

Foutafhandeling en gelijktijdigheid

In geval van een fout wordt het foutresultaat DiagErrc::kInvalidArgument geretourneerd [SWS_DM_01696]. Dit zal vermoedelijk met name optreden wanneer ongeldige functiewijzers worden doorgegeven of er incompatibele toestanden bij interne ontdendering aanwezig zijn (interpretatie). Vraag Q-3de0f2b0cc427ef3 (open) De bewerking is gespecificeerd als noexcept evenals uitzonderingsveilig (exception safe), maar is uitdrukkelijk aangeduid als niet thread-veilig (not thread-safe) [SWS_DM_01696]. Aanroepen op dezelfde monitor-instantie moeten daarom aan de applicatiezijde worden gesynchroniseerd.

Volgorde en interactie

Elke overbelasting van ConfigureMonitor mag voor een monitor slechts precies één keer worden aangeroepen; de monitor is pas na deze initialisatiestap gereed voor gebruik [SWS_DM_01696]. Bij monitor-interne ontdendering verwerkt de Diagnostic-Monitor-applicatie de ontdenderingslogica zelfstandig en verzendt alleen finale resultaten naar het Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 “Monitor-internal debouncing”. Voor andere ontdenderingsmechanismen zijn alternatieve overbelastingen voor tijdsgebaseerde [SWS_DM_01697], tellergebaseerde [SWS_DM_01702] of niet-ontdenderde bewakingen [SWS_DM_01973] beschikbaar.

Gebruik

De synchrone memberfunctie ara::diag::MultipleMonitor::ConfigureMonitor uit het headerbestand ara/diag/multiple_monitor.h configureert een diagnostische monitor met tijdsgebaseerde ontdendering ([SWS_DM_01697], SWS Diagnostics §8.44.2.1.3.2 “ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased)”). Bij de aanroep worden de handle monitorHandle ter identificatie van de monitor, de callback-functie initMonitor van het type InitMonitorNotifier en de ontdenderingsparameters defaultValues van het type TimeBased meegegeven ([SWS_DM_01697]). Als retourwaarde dient ara::core::Result<void>, en de functiesignatuur is gedeclareerd als noexcept ([SWS_DM_01697]).

Aanroepvoorwaarden en gelijktijdigheid

Een monitor kan pas na voltooiing van deze initialisatiestap worden gebruikt ([SWS_DM_01697]). Elke overbelaste variant van ConfigureMonitor mag per monitorinstantie slechts precies één keer worden aangeroepen ([SWS_DM_01697]). De interface is weliswaar uitzonderingsveilig (exception safe), maar niet thread-veilig (not thread-safe), zodat parallelle aanroepen op dezelfde instantie aan de gebruikerszijde moeten worden gesynchroniseerd ([SWS_DM_01697]).

Foutafhandeling

Mislukt de configuratie, dan retourneert de aanroep een foutobject binnen ara::core::Result, in het bijzonder de foutcode DiagErrc::kInvalidArgument ([SWS_DM_01697]).

Samenspel

De methode vult de alternatieve initialisatiefuncties voor tellergebaseerde ontdendering ([SWS_DM_01702]), monitor-interne ontdendering ([SWS_DM_01696]) evenals monitoren zonder ontdendering ([SWS_DM_01973]) aan. Voor tijdsgebaseerd ontdenderde gebeurtenissen ondersteunt de Diagnostic Manager bovendien het gericht bevriezen van de ontdenderingstimer ([SWS_DM_00880]) en de latere voortzetting daarvan vanaf de bevroren stand ([SWS_DM_00038]).

De synchrone methode ConfigureMonitor van de klasse ara::diag::MultipleMonitor dient voor de initialisatie van een diagnosemonitor met tellergebaseerde ontdendering ([SWS_DM_01702], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 “ConfigureMonitor”). De declaratie wordt via het headerbestand ara/diag/multiple_monitor.h ter beschikking gesteld ([SWS_DM_01702]).

Gebruik en parameters

De functie accepteert de volgende overdrachtsparameters ([SWS_DM_01702]):

• monitorHandle (MonitorHandleType): Identificeert de te configureren diagnosemonitor.
• initMonitor (InitMonitorNotifier): Registreert een notificatie-callback-functie voor de initialisatie van de monitor.
• defaultValues (CounterBased): Geeft standaardconfiguratiewaarden voor de tellergebaseerde ontdendering door.

Als retourwaarde levert de bewerking een ara::core::Result<void> op, die uitsluitsel geeft over succes of fouten ([SWS_DM_01702]).

Foutafhandeling

Mislukt de configuratie, dan wordt er een fout in de retourwaarde gemeld. Bij ongeldige argumenten wordt de foutcode DiagErrc::kInvalidArgument geretourneerd ([SWS_DM_01702]). De functie is gedeclareerd als noexcept en waarborgt uitzonderingsveiligheid (exception safe) ([SWS_DM_01702]).

Gelijktijdigheid en beperkingen

Elke overbelasting van ConfigureMonitor mag voor een monitor verplicht slechts precies één keer worden aangeroepen; de monitor is pas na deze initialisatiestap bruikbaar ([SWS_DM_01702]). Aangezien de bewerking als niet thread-veilig (not thread-safe) is geclassificeerd ([SWS_DM_01702]), zal externe synchronisatie vermoedelijk vereist zijn wanneer aanroepen over threadgrenzen heen plaatsvinden (interpretatie). Vraag Q-fcb809ccb021dd6d (open)

Samenspel

De methode maakt deel uit van de configuratie-interface in MultipleMonitor. Zij vult verwante overbelastingen aan voor tijdsgebaseerde ontdendering met TimeBased ([SWS_DM_01697]), voor monitor-interne ontdendering met uitleesfunctie ([SWS_DM_01696]) evenals voor monitoren geheel zonder ontdenderingsmechanisme ([SWS_DM_01973]).

De synchrone methode ConfigureMonitor dient voor de initialisatie van een diagnosemonitor zonder ontdendering binnen ara::diag::MultipleMonitor ([SWS_DM_01973], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 “ConfigureMonitor(MonitorHandleType, InitMonitorNotifier)”). Zij accepteert als invoerparameters de handle van de monitor (monitorHandle) en een callback-functie (initMonitor) voor de registratie van een InitMonitorNotifier-notificatie ([SWS_DM_01973]). Pas na deze verplichte initialisatiestap kan de betreffende monitor actief worden gebruikt ([SWS_DM_01973]).

Wat betreft de aanroepcontext en de gelijktijdigheid gelden de volgende randvoorwaarden:

• Elke overbelasting van ConfigureMonitor mag voor elke afzonderlijke monitor exact één keer worden aangeroepen ([SWS_DM_01973]).
• De methode is gespecificeerd als exception safe, maar geclassificeerd als not thread-safe ([SWS_DM_01973]). Gelijktijdige toegang tot dezelfde monitor zal daarom vermoedelijk externe synchronisatie door de applicatie vereisen. Vraag Q-2272f26f380a5a11 (open)

De functie levert als resultaat een ara::core::Result<void> op ([SWS_DM_01973]). Mislukt de configuratie, dan wordt er een fout geretourneerd, bijvoorbeeld DiagErrc::kInvalidArgument ([SWS_DM_01973]). Indien voor de diagnosemonitor een ontdenderingsmethode vereist is, staan in plaats daarvan de overbelaste varianten voor monitor-interne debouncing ([SWS_DM_01696]), tijdsgebaseerde debouncing ([SWS_DM_01697]) of tellergebaseerde debouncing ([SWS_DM_01702]) ter beschikking.

De functie Offer activeert het doorsturen van inkomende diagnoseverzoeken door de Diagnostic Management Daemon (DM) naar de desbetreffende handler [SWS_DM_01699]. De synchrone aanroep is zonder parameters en gespecificeerd als noexcept met uitzonderingsveiligheid (exception safe) [SWS_DM_01699].

Bij succes retourneert de functie een lege ara::core::Result<void> [SWS_DM_01699]. Als de registratie voor de handler al eerder met succes is uitgevoerd, mislukt de aanroep en levert deze de foutcode DiagOfferErrc::kAlreadyOffered met rollback-semantiek [SWS_DM_01699]; deze fouttoestand is verankerd in het diagnose-foutdomein [SWS_DM_00514].

Met betrekking tot gelijktijdigheid is de methode gedeclareerd als not thread-safe [SWS_DM_01699]. Interpretatie: aanroepen op dezelfde handler-instantie mogen vermoedelijk niet onbeschermd vanuit verschillende threads plaatsvinden, om inconsistenties in de registratietoestand te voorkomen. Vraag Q-95f2e0895004c73b (open)

Het patroon van de Offer-methode komt overeen met het uniforme aanbiedingsmechanisme voor diagnosehandlers in Adaptive AUTOSAR, zoals dat analoog bijvoorbeeld voor generieke routines [SWS_DM_00557] of UDS-diensten [SWS_DM_00619] wordt toegepast. Hoewel de naamgeving is ontleend aan de dienstaanbieding in ara::com, betreft het een zelfstandige diagnosespecifieke implementatie AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

De functie [SWS_DM_01698] dient er in ara::diag::MultipleMonitor voor om statusinformatie en ontkoppelcommando's voor een specifieke diagnosemonitor aan de Diagnostic Manager (DM) te melden. Via de parameter monitorHandle wordt de doelmonitor geadresseerd, terwijl action het (on)gekwalificeerde testresultaat of commando's voor ontkoppeling en pre-opslag overdraagt.

Met betrekking tot het foutgedrag geldt dat aanroepen met een ongeldige monitorHandle door de DM worden genegeerd [SWS_DM_01698]. Wordt een actie meegegeven die niet door de geconfigureerde ontkoppelprocedure wordt ondersteund, dan activeert de DM een schending (violation) [SWS_DM_01988]. Bovendien kunnen niet-vervulde enable-voorwaarden ertoe leiden dat meldingen worden verworpen (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 “EnableConditions”), wat correspondeert met interne foutcodes [SWS_DM_00514].

Over concurrency en uitvoering:

• De methode is gedeclareerd als noexcept en daarmee exception-safe [SWS_DM_01698].
• De thread-safety is conditioneel: of aanroepen thread-safe moeten zijn, wordt vastgelegd via de bij de constructor meegegeven ConcurrencyType [SWS_DM_01698].
• In samenspel met de op een teller gebaseerde ontkoppeling leidt bijvoorbeeld de melding kPrefailed tot het verhogen van de interne teller [SWS_DM_00875]. Interpretatie: De voor individuele monitoren gedefinieerde ontkoppelmechanismen en enable-voorwaarden gelden vermoedelijk identiek voor de via handles aangestuurde meervoudige instantie. Vraag Q-ff29529143d35ca2 (open)

De methode StopOffer van de klasse ara::diag::MultipleMonitor dient ertoe het doorsturen van verzoekberichten vanuit het Diagnostic Management (DM) naar de handler te deactiveren [SWS_DM_01700]. Zij vormt de functionele tegenhanger van het aanbieden van de interface en stelt de applicatie in staat de verwerking van inkomende diagnoseverzoeken gericht stop te zetten.

Het gebruik is onderworpen aan de volgende kenmerken en randvoorwaarden:

• Signatuur en aanroepcontext: de functie is gedeclareerd via de header ara/diag/multiple_monitor.h en heeft de signatuur void StopOffer() noexcept; [SWS_DM_01700]. Zij accepteert geen parameters en levert geen retourwaarde op. De aanroep wordt synchroon uitgevoerd.
• Foutafhandeling: de methode is gespecificeerd als noexcept en uitzonderingsveilig (exception safe) [SWS_DM_01700]. Zij gooit geen uitzonderingen op en voorziet niet in specifieke foutcodes of foutmeldingen.
• Gelijktijdigheid: het element is expliciet geclassificeerd als niet-thread-safe (not thread-safe) [SWS_DM_01700]. Een gelijktijdige aanroep op dezelfde instantie zou door de applicatie extern moeten worden gesynchroniseerd. Vraag Q-b73ead392f8b95b2 (open)

De semantiek van StopOffer volgt het uniforme ontwerppatroon voor diagnosehandlers in Adaptive AUTOSAR, waarbij diensten via Offer en StopOffer worden bestuurd AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”. Hetzelfde principe van deactivatie van het doorsturen van verzoeken is te vinden bij verwante poorten zoals ara::diag::Monitor::StopOffer [SWS_DM_01089] evenals bij generieke routines [SWS_DM_00558] en UDS-diensten [SWS_DM_00620].