WDOG - Watchdog#

WDOG_ClkSel_TypeDef#

WDOG_ClkSel_TypeDef

Watchdog clock selection.

WDOG_PeriodSel_TypeDef#

WDOG_PeriodSel_TypeDef

Watchdog period selection.

WDOGn_Enable#

void WDOGn_Enable (WDOG_TypeDef * wdog, bool enable)

Enable/disable the watchdog timer.

Note

• This function modifies the WDOG CTRL register which requires synchronization into the low-frequency domain. If this register is modified before a previous update to the same register has completed, this function will stall until the previous synchronization has completed.

WDOGn_Feed#

void WDOGn_Feed (WDOG_TypeDef * wdog)

Feed WDOG.

When WDOG is activated, it must be fed (i.e., clearing the counter) before it reaches the defined timeout period. Otherwise, WDOG will generate a reset.

Note

• Note that WDOG is an asynchronous peripheral and when calling the WDOGn_Feed() function the hardware starts the process of clearing the counter. This process takes some time before it completes depending on the selected oscillator (up to 4 peripheral clock cycles). When using the ULFRCO for instance as the oscillator the watchdog runs on a 1 kHz clock and a watchdog clear operation might take up to 4 ms.

If the device enters EM2 or EM3 while a command is in progress then that command will be aborted. An application can use WDOGn_SyncWait() to wait for a command to complete.

WDOGn_Init#

void WDOGn_Init (WDOG_TypeDef * wdog, const WDOG_Init_TypeDef * init)

Initialize WDOG (assuming the WDOG configuration has not been locked).

Note

• This function modifies the WDOG CTRL register which requires synchronization into the low-frequency domain. If this register is modified before a previous update to the same register has completed, this function will stall until the previous synchronization has completed.

WDOGn_Lock#

void WDOGn_Lock (WDOG_TypeDef * wdog)

Lock the WDOG configuration.

This prevents errors from overwriting the WDOG configuration, possibly disabling it. Only a reset can unlock the WDOG configuration once locked.

If the LFRCO or LFXO clocks are used to clock WDOG, consider using the option of inhibiting those clocks to be disabled. See the WDOG_Enable() initialization structure.

Note

• This function modifies the WDOG CTRL register which requires synchronization into the low-frequency domain. If this register is modified before a previous update to the same register has completed, this function will stall until the previous synchronization has completed.

WDOGn_SyncWait#

void WDOGn_SyncWait (WDOG_TypeDef * wdog)

Wait for the WDOG to complete all synchronization of register changes and commands.

WDOGn_Unlock#

void WDOGn_Unlock (WDOG_TypeDef * wdog)

Unlock the WDOG configuration.

Note that this function will have no effect on devices where a reset is the only way to unlock the watchdog.

WDOGn_IsEnabled#

bool WDOGn_IsEnabled (WDOG_TypeDef * wdog)

Get enabled status of the Watchdog.

Returns

• True if Watchdog is enabled.

WDOGn_IsLocked#

bool WDOGn_IsLocked (WDOG_TypeDef * wdog)

Get locked status of the Watchdog.

Returns

• True if Watchdog is locked.

DEFAULT_WDOG#

#define DEFAULT_WDOG

WDOG

Default WDOG instance for deprecated functions.

WDOG_INIT_DEFAULT#

#define WDOG_INIT_DEFAULT

Suggested default configuration for WDOG initialization structure.

WDOG_SYNC_TIMEOUT#

#define WDOG_SYNC_TIMEOUT

30000

In some scenarioes when the watchdog is disabled the synchronization register might be set and not be cleared until the watchdog is enabled again.

This will happen when for instance some watchdog register is modified while the watchdog clock is disabled. In these scenarioes we need to make sure that the software does not wait forever.