SNIP_CLASSIC_WDGM_SECTION_8_3_1_WdgM_Init

8.3.1 WdgM_Init [SWS_WdgM_00151] Definition of API function WdgM_Init Upstream requirements: SRS_BSW_00310, SRS_BSW_00358, SRS_ModeMgm_09107 ⌈ Service Name WdgM_Init Syntax void WdgM_Init ( const WdgM_ConfigType* ConfigPtr ) Service ID [hex] 0x00 Sync/Async Synchronous Reentrancy Non Reentrant Parameters (in) ConfigPtr Pointer to post-build configuration data Parameters (inout) None Parameters (out) None Return value None Description Initializes the Watchdog Manager. Available via WdgM.h ⌋ This function initializes the Watchdog Manager. After execution of this function, supervision is activated according to the list of Supervised Entities defined in the initial Mode. To perform a module reinitialization (e.g. after error), the caller can invoke WdgM_DeInit() and then WdgM_Init(). [SWS_WdgM_00018] Upstream requirements: SRS_BSW_00101, SRS_ModeMgm_09107 ⌈The function WdgM_Init shall initialize all module variables (global and static) of the Watchdog Manager module.⌋ [SWS_WdgM_00135] Upstream requirements: SRS_BSW_00101, SRS_ModeMgm_09107 ⌈The function WdgM_Init shall establish the initial mode of the Watchdog Manager module.⌋ Note: If a call to WdgIf_SetMode service fails during WdgM_Init, then the MCU Reset API is called directly (only if configured, see [SWS_WdgM_00133]) and the Watchdog Manager module will be in state initialized afterwards with Global Supervision Status = WDGM_GLOBAL_STATUS_STOPPED (see [SWS_WdgM_00139]). This will cause a reset, either when the first watchdog expires (if an immediate reset of the Watchdog Manager module is not configured) or immediately (if an immediate reset is configured). [SWS_WdgM_00030] Upstream requirements: SRS_BSW_00323, SRS_BSW_00452, SRS_ModeMgm_09109 ⌈If the WdgMOffModeEnabled [ECUC_WdgM_00340] switch is not enabled, and the initial mode provided by the configuration (ConfigPtr) will disable the watchdog ( WDGIF_OFF_MODE) then the function WdgM_Init shall return with E_NOT_OK without any action, and the function WdgM_Init shall report runtime error code WDGM_E_DISABLE_NOT_ALLOWED to the Default Error Tracer.⌋ There are optional checks that are executed if and only if WdgMDevErrorDetect is enabled. [SWS_WdgM_00389] Upstream requirements: SRS_BSW_00323, SRS_BSW_00350 ⌈If the configuration parameter WdgMDevErrorDetect [ECUC_WdgM_00301] is enabled: The function WdgM_Init shall report the error to default error tracer with error code WDGM_E_UNINIT, without any further effect, if the Watchdog Manager is in WDGM_GLOBAL_STATUS_DEACTIVATED.⌋ [SWS_WdgM_00390] Upstream requirements: SRS_BSW_00323, SRS_BSW_00350 ⌈If the configuration parameter WdgMDevErrorDetect [ECUC_WdgM_00301] is disabled: The function WdgM_Init shall return without any effect if the Watchdog Manager is not in WDGM_GLOBAL_STATUS_DEACTIVATED.⌋ [SWS_WdgM_00010] Upstream requirements: SRS_BSW_00323, SRS_BSW_00350 ⌈If the WdgMDevErrorDetect [ECUC_WdgM_00301] switch is enabled and the configuration variant is VARIANT-POST-BUILD, the function WdgM_Init shall check the contents of the given configuration set for being within the allowed boundaries. If the function WdgM_Init detects an error, then it shall not execute the initialization of the Watchdog Manager module and it shall report the error code WDGM_E_PARAM_CONFIG to the Det_ReportError service of the Default Error Tracer.⌋ [SWS_WdgM_00370] Upstream requirements: SRS_BSW_00101 ⌈The function WdgM_Init shall clear from the non-initialized RAM the double-inverse value storing the SEID that first reached the EXIRED state.⌋ See Section 8.3.10 for more information.