struct ara::diag::CounterBased

De structuur ara::diag::CounterBased definieert de drempelwaarden, stapgroottes en sprongparameters voor de tellergebaseerde ontdendering van diagnostische gebeurtenissen [SWS_DM_00538]. Deze wordt door de applicatie geïnstantieerd en meegegeven aan de constructor van ara::diag::Monitor om de criteria voor fout- en goed-kwalificatie vast te leggen [SWS_DM_00549]. Diagnostic Management gebruikt deze parameters voor het bijwerken van de teller, voor zover er in het Diagnostic Extract (DEXT) geen voorranghebbende ontdendergegevens zijn vastgelegd.

meer ›

Context

De structuur ara::diag::CounterBased representeert de configuratieparameters voor de tellergebaseerde ontdendering van diagnostische gebeurtenissen [SWS_DM_00538] conform de specificatie van het AUTOSAR Adaptive Platform SWS Diagnostics §7.3.4.1.5.1 “Counter-based debouncing”. Binnen het diagnosesubsysteem dient deze voor de uitwisseling van ontdenderparameters tussen de toepassende monitorimplementatie en Diagnostic Management (DM).

De interactie verloopt in wezen via vier interfacepartners:

• De diagnose-applicatie instantieert en vult CounterBased met gebeurtenisgrenswaarden.
• De monitorconstructor van ara::diag::Monitor neemt de structuur aan als configuratieargument [SWS_DM_00549] om monitorinterne ontdendering in te richten SWS Diagnostics §8.40.1.1.2.2 “Monitor constructor for Monitors with Monitor-internal debouncing”.
• Het Diagnostic Extract (DEXT) definieert vooraf vastgelegde ontdenderparameters; bestaan er in het DEXT passende parameters, dan hebben deze dwingend voorrang en worden de via de constructor doorgegeven waarden door DM genegeerd [SWS_DM_01099].
• Diagnostic Management evalueert bij ontbrekende DEXT-configuratie de waarden uit CounterBased [SWS_DM_01101] en houdt de gebeurtenisspecifieke teller tijdens runtime bij SWS Diagnostics §7.3.4.1.5.1 “Internal debounce counter incrementation”.

Contextdiagram: samenspel van applicatie, monitor, CounterBased, Diagnostic Management en DEXT. Bronnen: [SWS_DM_00538], [SWS_DM_00549], [SWS_DM_01099], [SWS_DM_01101].

Levenscyclus

Als C++-datastructuur (struct) SWS Diagnostics §8.41.2 “Struct: CounterBased” wordt CounterBased als pure waardecontainer door de toepassende softwarecomponent op de stack of heap gecreëerd. De levenscyclus ervan is typisch beperkt tot de configuratie- en initialisatiefase vóór het creëren van de ara::diag::Monitor.

Nadat de attributen zijn gedefinieerd, wordt de structuur op waarde doorgegeven aan de constructor van Monitor [SWS_DM_00549]. De structuur zelf houdt geen interne dynamische toestand bij en bezit geen toestandsmachine; het doorlopende tellerbeheer berust uitsluitend bij Diagnostic Management. Aangezien CounterBased is ontworpen als passieve datastructuur en geen interne synchronisatiemechanismen bezit, dient de configuratie naar interpretatie vóór de overdracht aan de monitor thread-lokaal of gesynchroniseerd plaats te vinden.

Gebruikspad

Het typische gebruik valt uiteen in het definiëren van de ontdenderparameters, de overdracht aan de monitor en de tellerevaluatie tijdens runtime:

1. De applicatie creëert een instantie van CounterBased en vult de grenswaarden in: failedThreshold voor de foutkwalificatie [SWS_DM_00621] en passedThreshold voor de goed-detectie [SWS_DM_00622].
2. De stapgroottes worden via failedStepsize voor gemelde fouttoestanden [SWS_DM_00623] en passedStepsize voor goedmeldingen [SWS_DM_00624] gedefinieerd.
3. Optioneel worden sprongsgewijze aanpassingen geconfigureerd: via useJumpToFailed [SWS_DM_00627] en failedJumpValue [SWS_DM_00625] wordt het springen naar een minimale foutwaarde geactiveerd. Analoog sturen useJumpToPassed [SWS_DM_00628] en passedJumpValue [SWS_DM_00626] sprongen in de richting van de goed-toestand aan.
4. De gevulde structuur wordt doorgegeven aan de constructor van Monitor [SWS_DM_00549]. Voor zover er geen DEXT-definities aanwezig zijn, gebruikt DM deze waarden [SWS_DM_01101].
5. Tijdens runtime meldt de bewaking monitoracties via ReportMonitorAction SWS Diagnostics §7.3.4.1.5.1 “Internal debounce counter incrementation”. Bij kPrefailed controleert DM eventuele sprongvoorwaarden [SWS_DM_00022] en verhoogt deze de teller met failedStepsize [SWS_DM_00875].
6. Bereikt de teller failedThreshold, dan classificeert DM de gebeurtenis als kFinallyDefective [SWS_DM_00024]. Overeenkomstigs geldt voor goedmeldingen middels passedStepsize [SWS_DM_00876].

Sequentiediagram: verloop van parameterconfiguratie en monitorinitialisatie tot aan de tellerkwalificatie. Bronnen: [SWS_DM_00549], [SWS_DM_00875], [SWS_DM_00022], [SWS_DM_00024].

Foutscenario's

Bij het gebruik van CounterBased moet rekening worden gehouden met diverse randvoorwaarden en voorrangsregels:

• DEXT-voorrangsconflict: Wanneer er in het DEXT ontdenderparameters aanwezig zijn, negeert DM de in CounterBased gedefinieerde parameters volledig [SWS_DM_01099]. Een misconfiguratie ontstaat wanneer applicatieontwikkelaars een dynamische parameterwijziging via de constructor verwachten, hoewel statische DEXT-waarden actief zijn.
• Ontbrekende DEXT-waarden: Ontbreken gegevens in het DEXT, dan is DM er dwingend op aangewezen dat de constructor een geldige CounterBased-instantie ter beschikking stelt [SWS_DM_01101].
• Drempeloverschrijding: Stijgt de interne ontdenderteller door de optelling van failedStepsize boven de drempelwaarde failedThreshold, dan zet DM de teller exact terug op deze drempelwaarde en kwalificeert deze het defect [SWS_DM_00024], [SWS_DM_00875].
• Voorwaardelijke spronglogica: Is useJumpToFailed ingesteld, dan wordt de sprong naar failedJumpValue alleen uitgevoerd wanneer de tellerstand vóór de verhoging strikt kleiner is dan failedJumpValue [SWS_DM_00022]. Voor useJumpToPassed geldt analoog dat de teller groter moet zijn dan passedJumpValue [SWS_DM_00023].