Watchdog Manager (WdgM)

Gebruik

De functie WdgM_Init initialiseert de Watchdog Manager synchroon en is niet re-entrant [SWS_WdgM_00151]. Als enige overdrachtsparameter dient ConfigPtr, die verwijst naar de post-build configuratiegegevens (WdgM_ConfigType) [SWS_WdgM_00151]. De functie heeft formeel geen retourwaarde (void) [SWS_WdgM_00151].

Foutafhandeling en randvoorwaarden

Vóór de initialisatie moet de Watchdog Manager zich in de toestand WDGM_GLOBAL_STATUS_DEACTIVATED bevinden: als de ontwikkelingsconfiguratieparameter WdgMDevErrorDetect is gedeactiveerd en de module zich niet in deze toestand bevindt, keert WdgM_Init zonder effect terug [SWS_WdgM_00390].

Indien de configuratieschakelaar WdgMOffModeEnabled niet is geactiveerd en de via ConfigPtr voorgeschreven initiële modus de watchdog zou deactiveren (WDGIF_OFF_MODE), breekt de functie zonder verdere actie af en meldt de runtimefout WDGM_E_DISABLE_NOT_ALLOWED aan de Default Error Tracer (DET) [SWS_WdgM_00030]. De in de specificatie geëiste return met E_NOT_OK moet daarbij worden begrepen als interpretatie van een interne foutafbreking, aangezien de signatuur void voorschrijft [SWS_WdgM_00151]. Vraag Q-83a164f8f4669d4d (open)

Interactie en volgorde

• Foutdiagnose vóór initialisatie: De functie WdgM_GetFirstExpiredSEID() moet reeds vóór de aanroep van WdgM_Init beschikbaar zijn om de eerder verlopen Supervised Entity ID (SEID) uit te lezen [SWS_WdgM_00348].
• RAM-opschoning: Tijdens de initialisatie wist WdgM_Init de in het niet-geïnitialiseerde RAM opgeslagen, dubbel-geïnverteerde SEID-waarde van de eerste verlopen entiteit [SWS_WdgM_00370].
• Statusmelding aan het DEM: Binnen de eerste aanroep van WdgM_MainFunction na WdgM_Init meldt de module bij gezette parameter WdgMDemStoppedSupervisionReport de status PASSED voor WDGM_E_SUPERVISION aan het DEM [SWS_WdgM_00408].

Gebruik

De synchrone functie WdgM_DeInit dient voor de de-initialisatie van de Watchdog Manager [SWS_WdgM_00261]. De interface heeft het service-ID 0x01, wordt beschikbaar gesteld via het headerbestand WdgM.h en accepteert geen invoerparameters, noch levert zij een retourwaarde op aan de aanroeper [SWS_WdgM_00261]. Als aanroepcontext is vermoedelijk de ordelijke shutdown-sequentie van de ECU voorzien, waarin actieve bewakingen voorafgaand aan het uitschakelen gecontroleerd worden beëindigd. Vraag Q-50d7e49c71d2dfd3 (open)

Functionaliteit en samenspel

In het kader van de de-initialisatie stopt de module WdgM de bewakingsfuncties (Supervision Functions) over alle geconfigureerde bewakingsalgoritmen (Supervision Algorithms) heen volledig en beëindigt tegelijkertijd de watchdog-bediening (Watchdog Handling) [SWS_WdgM_00407].

Foutafhandeling en randvoorwaarden

Bevindt de Watchdog Manager zich op het aanroeptijdstip reeds in de globale toestand WDGM_GLOBAL_STATUS_DEACTIVATED, dan is het gedrag afhankelijk van de configuratieparameter WdgMDevErrorDetect: Is deze ontwikkelingsdetectie gedeactiveerd, dan keert WdgM_DeInit onmiddellijk en zonder enig effect terug [SWS_WdgM_00388].

Wat betreft de gelijktijdigheid is vastgelegd dat de functie niet-re-entrant is [SWS_WdgM_00261]. De aanroep mag daarom onder geen beding onderbrekend of parallel vanuit meerdere contexten plaatsvinden.

Gebruik en semantiek

De functie WdgM_SetMode dient voor het synchroon omschakelen van de Watchdog Manager naar een van de geconfigureerde bedrijfsmodi ([SWS_WdgM_00154]). Als overdrachtsparameter verwacht zij Mode van het type WdgM_ModeType. De retourwaarde Std_ReturnType signaleert met E_OK de succesvolle uitvoering van de moduswijziging en met E_NOT_OK een mislukking ([SWS_WdgM_00154]).

Beperkingen en foutafhandeling

De functie is niet re-entrant (Non Reentrant) ([SWS_WdgM_00154]). De uitvoering is gebonden aan de actuele globale status van de Watchdog Manager:

• Bevindt de module zich noch in de status WDGM_GLOBAL_STATUS_OK noch in WDGM_GLOBAL_STATUS_FAILED, dan keert de functie terug zonder enige actie uit te voeren ([SWS_WdgM_00145]).
• Is de configuratieparameter WdgMDevErrorDetect gedeactiveerd, dan blijft een aanroep in de status WDGM_GLOBAL_STATUS_DEACTIVATED zonder enig effect ([SWS_WdgM_00392]).

Interactie en gevolgen

Is er sprake van een geldige globale status (WDGM_GLOBAL_STATUS_OK of WDGM_GLOBAL_STATUS_FAILED), dan actualiseert WdgM_SetMode de bewaakte entiteiten en de watchdogs:

• Voor elke in de doelmodus geactiveerde Supervised Entity wordt de actuele toestand behouden ([SWS_WdgM_00182]).
• Voor elke in de doelmodus gedeactiveerde Supervised Entity wisselt de lokale toestand naar WDGM_LOCAL_STATUS_DEACTIVATED; de resultaten van Active, Deadline en Logical Supervision worden op correct gezet en de foutcyclusteller wordt op 0 gereset ([SWS_WdgM_00315]). Door de overgang naar een modus met deactivering van de entiteit worden bovendien fouten gecorrigeerd die eerder tot WDGM_GLOBAL_STATUS_FAILED hadden geleid ([SWS_WdgM_00182]).
• Tot slot worden de geconfigureerde watchdog-modusparameters voor elke hardware-watchdog effectief geschakeld via de interface WdgIf_SetMode ([SWS_WdgM_00186]).

Gebruik en semantiek

De synchrone functie meldt aan de Watchdog Manager het bereiken van een checkpoint binnen een Supervised Entity [SWS_WdgM_00263]. Deze neemt als invoerparameters de identificatie van de bewaakte entiteit (SEID) en de identificatie van het bereikte checkpoint (CheckpointID) aan en retourneert E_OK bij succesvolle actualisering van de alive-teller of E_NOT_OK bij fouten [SWS_WdgM_00263].

Foutafhandeling en status

Als de Watchdog Manager zich in de status WDGM_GLOBAL_STATUS_DEACTIVATED bevindt, hangt het gedrag af van de configuratie van de ontwikkelingsindicator: bij geactiveerde WdgMDevErrorDetect meldt de functie de fout WDGM_E_UNINIT aan de Default Error Tracer (DET) en keert terug zonder verder effect [SWS_WdgM_00279]. Als WdgMDevErrorDetect is gedeactiveerd, vindt de terugkeer plaats zonder melding en zonder enig effect [SWS_WdgM_00394].

Concurrency en deadlines

De aanroep is gespecificeerd als re-entrant [SWS_WdgM_00263]. Voor het bepalen van tijdstempels en tijdsverschillen bij de deadline-bewaking gebruikt de functie de OS-functie GetElapsedValue met de voor de entiteit geconfigureerde CounterID [SWS_WdgM_00373]. De schaling van de tijdsverschillen naar de grenswaarden vindt plaats via de parameter OsSecondsPerTick [SWS_WdgM_00374]. Bereikt een Deadline End Checkpoint de aanroep in de actieve modus en bedraagt de tijdstempel van het bijbehorende start-checkpoint 0, dan eindigt de functie met succes zonder verschilmeting [SWS_WdgM_00354].

Gebruik en aanroepcontext

De synchrone functie WdgM_PerformReset draagt de Watchdog Manager op om het triggeren van een watchdog-reset teweeg te brengen [SWS_WdgM_00264]. De interface wordt gedeclareerd via de header WdgM.h en heeft het service-ID 0x0f [SWS_WdgM_00264]. Zij accepteert noch in- noch uitgangsparameters en levert geen retourwaarde [SWS_WdgM_00264].

Gelijktijdigheid en beperkingen

Aangezien WdgM_PerformReset als niet re-entrant (Non Reentrant) is gedefinieerd, mag er geen gelijktijdige of onderbrekende meervoudige aanroep plaatsvinden [SWS_WdgM_00264]. Aanroepers moeten daarom waarborgen dat aanroepen gesynchroniseerd of exclusief vanuit een geschikte context worden gedaan.

Toestandsafhankelijk gedrag en foutafhandeling

De uitvoering is onderworpen aan de globale toestanden van de Watchdog Manager: Is de configuratieparameter WdgMDevErrorDetect gedeactiveerd en bevindt de module zich in de globale status WDGM_GLOBAL_STATUS_DEACTIVATED, dan keert de functie zonder enig effect terug [SWS_WdgM_00401]. Een reset blijft in dit geval volledig achterwege. Het gedrag bij geactiveerde ontwikkelingsdetectie (WdgMDevErrorDetect) is in de payload niet gespecificeerd; interpretatie: in dit geval wordt in gedeactiveerde toestand vermoedelijk een overeenkomstige ontwikkelingsfout gemeld. Vraag Q-8a726bba4154540f (open)

Gebruik en cyclisch verloop

De functie WdgM_MainFunction voert de periodieke taken van de Watchdog Manager uit [SWS_WdgM_00159]. Deze heeft de signatuur void WdgM_MainFunction(void), accepteert geen parameters, levert geen retourwaarde en wordt via de header SchM_WdgM.h beschikbaar gesteld [SWS_WdgM_00159]. Bij de eerste aanroep na de initialisatie van de module start deze zowel alle bewakingsfuncties (voor alle bewakingsalgoritmen inclusief de referentiecycli) als de watchdog-afhandeling [SWS_WdgM_00406].

Deadline-bewaking en timeout-detectie

In de cyclische aanroepen voert WdgM_MainFunction de deadline-bewaking voor de detectie van timeouts uit voor alle eenheden met actieve bewaking en actualiseert het resultaat daarvan [SWS_WdgM_00404]:

• Als de detectie via WdgMEnableTimeoutDetection is geactiveerd, controleert de functie alle in de actieve modus geconfigureerde deadline-bewakingen waarbij het start-checkpoint is gemeld, maar het bijbehorende eind-checkpoint nog openstaat [SWS_WdgM_00403].
• Overschrijdt het gemeten tijdsverschil ten opzichte van de actuele tijdstempel het maximum WdgMDeadlineMax, dan stelt de functie het bewakingsresultaat van de Supervised Entity in op foutief (incorrect) [SWS_WdgM_00403].

Interactie met het besturingssysteem

Voor het bepalen van tijdstempels en verschillen roept WdgM_MainFunction de OS-functie GetElapsedValue aan met de voor de eenheid geconfigureerde teller-ID (parameter WdgMOSCounter) [SWS_WdgM_00373]. De schaling van de verschilwaarden naar de grenswaarden WdgMDeadlineMin en WdgMDeadlineMax vindt plaats aan de hand van de parameter OsSecondsPerTick [SWS_WdgM_00374].

Het type WdgM_Mode is gedefinieerd als Mode Declaration Group van categorie EXPLICIT_ORDER en dient voor de weergave van bewakingstoestanden van de module [SWS_WdgM_00334].

Gebruik en waardebereik

Als initiële modus is SUPERVISION_OK vastgelegd [SWS_WdgM_00334]. Voor de afzonderlijke modi zijn expliciete numerieke waarden voorgeschreven [SWS_WdgM_00334]:

• SUPERVISION_OK = 0
• SUPERVISION_FAILED = 1
• SUPERVISION_EXPIRED = 2
• SUPERVISION_STOPPED = 3
• SUPERVISION_DEACTIVATED = 4

Voor de overgangswaarde (on transition value) tussen modi is de waarde 255 gedefinieerd [SWS_WdgM_00334].

Samenspel

Door de indeling in categorie EXPLICIT_ORDER en de toekenning van vaste ordinale waarden is de groep vermoedelijk bestemd voor een geordende statusafbeelding binnen de Watchdog Manager [SWS_WdgM_00334]. Vraag Q-47c55c3bc2e2a23d (open)

Het type WdgM_LocalStatusType wordt gebruikt voor variabelen die de actuele lokale bewakingsstatus van een afzonderlijke bewaakte entiteit (Supervised Entity) in de Watchdog Manager weergeven [SWS_WdgM_00359]. Het datatype is afgeleid van het basistype uint8 en wordt via de header Rte_WdgM_Type.h beschikbaar gesteld [SWS_WdgM_00359].

Het waardebereik omvat vier discrete toestanden conform [SWS_WdgM_00359]:

• WDGM_LOCAL_STATUS_OK (waarde 0): De bewaking van de Supervised Entity vertoont geen fouten.
• WDGM_LOCAL_STATUS_FAILED (waarde 1): De bewaking is mislukt, maar kan nog herstellen („healed”), mits de entiteit terugkeert naar normaal gedrag. Dit geldt zolang een configureerbare foutlimiet niet is overschreden; anders wisselt de status naar WDGM_LOCAL_STATUS_EXPIRED.
• WDGM_LOCAL_STATUS_EXPIRED (waarde 2): De bewaking is permanent mislukt; deze toestand kan niet meer worden verlaten.
• WDGM_LOCAL_STATUS_DEACTIVATED (waarde 4): De lokale bewaking van de Supervised Entity is tijdelijk gedeactiveerd.

Op grond van de definitie in Rte_WdgM_Type.h is het type vermoedelijk vooral bestemd voor de softwarecomponent- en RTE-overstijgende uitwisseling van bewakingstoestanden [SWS_WdgM_00359]. Vraag Q-a9e584dc4c7cfa3b (open)

Het datatype WdgM_GlobalStatusType dient voor de definitie van variabelen die de globale bewakingsstatus van de Watchdog Manager-module representeren [SWS_WdgM_00360]. Het is afgeleid van het basistype uint8 en wordt via de header Rte_WdgM_Type.h ter beschikking gesteld [SWS_WdgM_00360].

Het waardebereik omvat vijf gedefinieerde bewakingstoestanden [SWS_WdgM_00360]:

• WDGM_GLOBAL_STATUS_OK (0): De bewaking vertoont geen enkele fout.
• WDGM_GLOBAL_STATUS_FAILED (1): De bewaking is mislukt, bevindt zich echter nog binnen de toelaatbare limiet van fouten.
• WDGM_GLOBAL_STATUS_EXPIRED (2): De bewaking is mislukt en de toelaatbare foutlimiet is overschreden, maar de watchdog-driver is nog niet geïnstrueerd om het triggeren te staken.
• WDGM_GLOBAL_STATUS_STOPPED (3): De foutlimiet is overschreden en de watchdog-driver is opgedragen om het triggeren te stoppen, zodat een watchdog-reset direct aanstaande is.
• WDGM_GLOBAL_STATUS_DEACTIVATED (4): De module WdgM is niet geïnitialiseerd en stuurt de watchdogs daarom niet aan.

Via deze toestanden geeft het type de gehele bewakingscyclus weer, beginnend bij de deactivering vóór de initialisatie via de reguliere respectievelijk fouttolerante werking tot en met de meertraps escalatie met afsluitende watchdog-reset bij aanhoudende fouten [SWS_WdgM_00360].

Het datatype WdgM_ModeType dient voor het eenduidig onderscheiden van de verschillende modi die voor de Watchdog Manager zijn geprojecteerd [SWS_WdgM_00358]. Het wordt voor softwarecomponenten en basissoftwaremodules beschikbaar gesteld via het headerbestand Rte_WdgM_Type.h [SWS_WdgM_00358].

Volgens de specificatie [SWS_WdgM_00358] vertoont het type de volgende eigenschappen:

• Basistype: WdgM_ModeType is afgeleid van het standaard-datatype uint8 [SWS_WdgM_00358].
• Waardebereik: Het waardebereik omvat 0 tot <Number of Modes> [SWS_WdgM_00358].
• Configuratieafhankelijkheid: De feitelijke bovengrens van het waardebereik is afhankelijk van het aantal voor de Watchdog Manager geconfigureerde modi [SWS_WdgM_00358].

Aangezien het om een typedefinitie gaat, bestaan er geen runtimeparameters, foutcodes of asynchronismesemantiek. Interpretatie: Op grond van de declaratie in Rte_WdgM_Type.h wordt WdgM_ModeType vermoedelijk primair gebruikt voor de uitwisseling van modusinformatie via RTE-interfaces tussen applicatiesoftware en de Watchdog Manager. Vraag Q-27975280bc68720e (open)

Het element globalmode is conform specificatie [SWS_WdgM_00150] gedefinieerd als geleverde poort (Provided Port Interface) van de Watchdog Manager (WdgM) in het AUTOSAR Classic-platform in release R20-11. Als interfacetype wordt WdgM_GlobalMode aangeduid. Het element dient in het totale systeem als formele poortinterface via welke de module zijn status exposeert aan andere softwarecomponenten.

Over het concrete gebruik, de parameters, retourwaarden of datastructuren verschaft de specificatie [SWS_WdgM_00150] geen verdere details. Als interpretatie geldt dat de poortinterface primair dient om bovenliggende instanties zoals de BswM of applicatie-SW-C's te voorzien van de actuele globale bewakingsstatus van de Watchdog Manager. Vraag Q-6a0217eb1d28c1b4 (open) Bij gebrek aan afwijkende gegevens in de bronnen wordt de modusverstrekking vermoedelijk synchroon via de RTE afgehandeld.

Met betrekking tot foutafhandeling, DET- of DEM-meldingen en specifieke foutcodes zwijgt [SWS_WdgM_00150] volledig. Evenmin zijn normatieve bepalingen over re-entrantie, prioriteiten of aanroepcontexten in de payload opgenomen; als interpretatie valt de toegang vermoedelijk onder de algemene concurrencyregels van het WdgM-statusbeheer. Vraag Q-28fa9de4b06e3b0d (open) Gerelateerde requirements zijn voor dit element niet aanwezig.