WDOG - Watchdog#

WDOG_PeriodSel_TypeDef#

WDOG_PeriodSel_TypeDef

Watchdog clock selection.

Watchdog period selection.

WDOG_WarnSel_TypeDef#

WDOG_WarnSel_TypeDef

Select Watchdog warning timeout period as percentage of timeout.

WDOG_WinSel_TypeDef#

WDOG_WinSel_TypeDef

Select Watchdog illegal window limit.

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_IntClear#

void WDOGn_IntClear (WDOG_TypeDef * wdog, uint32_t flags)

Clear one or more pending WDOG interrupts.

WDOGn_IntDisable#

void WDOGn_IntDisable (WDOG_TypeDef * wdog, uint32_t flags)

Disable one or more WDOG interrupts.

WDOGn_IntEnable#

void WDOGn_IntEnable (WDOG_TypeDef * wdog, uint32_t flags)

Enable one or more WDOG interrupts.

Note

• Depending on the use, a pending interrupt may already be set prior to enabling the interrupt. To ignore a pending interrupt, consider using WDOG_IntClear() prior to enabling the interrupt.

WDOGn_IntGet#

uint32_t WDOGn_IntGet (WDOG_TypeDef * wdog)

Get pending WDOG interrupt flags.

Note

• The event bits are not cleared by the use of this function.

Returns

• Pending WDOG interrupt sources. Returns a set of interrupt flags OR-ed together for the interrupt sources set.

WDOGn_IntGetEnabled#

uint32_t WDOGn_IntGetEnabled (WDOG_TypeDef * wdog)

Get enabled and pending WDOG interrupt flags.

Useful for handling more interrupt sources in the same interrupt handler.

Returns

• Pending and enabled WDOG interrupt sources. Returns a set of interrupt flags OR-ed together for the interrupt sources set.

WDOGn_IntSet#

void WDOGn_IntSet (WDOG_TypeDef * wdog, uint32_t flags)

Set one or more pending WDOG interrupts from SW.

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.

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.

DEFAULT_WDOG#

#define DEFAULT_WDOG

WDOG0

Default WDOG instance for deprecated functions.

WDOG_INIT_DEFAULT#

#define WDOG_INIT_DEFAULT

Suggested default configuration for WDOG initialization structure.