mirror of
https://source.denx.de/u-boot/u-boot.git
synced 2025-12-19 16:31:27 +01:00
091303c788
The watchdog could have been already started by a previous boot stage (e.g. bootrom or secure OS). U-Boot has to start and kick the watchdog even when CONFIG_WATCHDOG_AUTOSTART is not enabled or when the DT property u-boot,noautostart is present. Add the helper wdt_set_force_autostart() that can be called by the driver's probe() when it detects that the watchdog has already been started and is running. Co-developed-by: Patrice Chotard <patrice.chotard@foss.st.com> Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com> Signed-off-by: Antonio Borneo <antonio.borneo@foss.st.com> Reviewed-by: Patrice Chotard <patrice.chotard@foss.st.com>
128 lines
3.4 KiB
C
128 lines
3.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* Copyright 2017 Google, Inc
|
|
*/
|
|
|
|
#ifndef _WDT_H_
|
|
#define _WDT_H_
|
|
|
|
struct udevice;
|
|
|
|
/*
|
|
* Implement a simple watchdog uclass. Watchdog is basically a timer that
|
|
* is used to detect or recover from malfunction. During normal operation
|
|
* the watchdog would be regularly reset to prevent it from timing out.
|
|
* If, due to a hardware fault or program error, the computer fails to reset
|
|
* the watchdog, the timer will elapse and generate a timeout signal.
|
|
* The timeout signal is used to initiate corrective action or actions,
|
|
* which typically include placing the system in a safe, known state.
|
|
*/
|
|
|
|
/*
|
|
* Force watchdog start during init. Called by driver's probe when the watchdog
|
|
* is detected as already started.
|
|
*
|
|
* @dev: WDT Device
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int wdt_set_force_autostart(struct udevice *dev);
|
|
|
|
/*
|
|
* Start the timer
|
|
*
|
|
* @dev: WDT Device
|
|
* @timeout_ms: Number of ticks (milliseconds) before timer expires
|
|
* @flags: Driver specific flags. This might be used to specify
|
|
* which action needs to be executed when the timer expires
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int wdt_start(struct udevice *dev, u64 timeout_ms, ulong flags);
|
|
|
|
/*
|
|
* Stop the timer, thus disabling the Watchdog. Use wdt_start to start it again.
|
|
*
|
|
* @dev: WDT Device
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int wdt_stop(struct udevice *dev);
|
|
|
|
/*
|
|
* Stop all registered watchdog devices.
|
|
*
|
|
* @return: 0 if ok, first error encountered otherwise (but wdt_stop()
|
|
* is still called on following devices)
|
|
*/
|
|
int wdt_stop_all(void);
|
|
|
|
/*
|
|
* Reset the timer, typically restoring the counter to
|
|
* the value configured by start()
|
|
*
|
|
* @dev: WDT Device
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int wdt_reset(struct udevice *dev);
|
|
|
|
/*
|
|
* Expire the timer, thus executing its action immediately.
|
|
* This is typically used to reset the board or peripherals.
|
|
*
|
|
* @dev: WDT Device
|
|
* @flags: Driver specific flags
|
|
* Return: 0 if OK -ve on error. If wdt action is system reset,
|
|
* this function may never return.
|
|
*/
|
|
int wdt_expire_now(struct udevice *dev, ulong flags);
|
|
|
|
/*
|
|
* struct wdt_ops - Driver model wdt operations
|
|
*
|
|
* The uclass interface is implemented by all wdt devices which use
|
|
* driver model.
|
|
*/
|
|
struct wdt_ops {
|
|
/*
|
|
* Start the timer
|
|
*
|
|
* @dev: WDT Device
|
|
* @timeout_ms: Number of ticks (milliseconds) before the timer expires
|
|
* @flags: Driver specific flags. This might be used to specify
|
|
* which action needs to be executed when the timer expires
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int (*start)(struct udevice *dev, u64 timeout_ms, ulong flags);
|
|
/*
|
|
* Stop the timer
|
|
*
|
|
* @dev: WDT Device
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int (*stop)(struct udevice *dev);
|
|
/*
|
|
* Reset the timer, typically restoring the counter to
|
|
* the value configured by start()
|
|
*
|
|
* @dev: WDT Device
|
|
* @return: 0 if OK, -ve on error
|
|
*/
|
|
int (*reset)(struct udevice *dev);
|
|
/*
|
|
* Expire the timer, thus executing the action immediately (optional)
|
|
*
|
|
* If this function is not provided, a default implementation
|
|
* will be used, which sets the counter to 1
|
|
* and waits forever. This is good enough for system level
|
|
* reset, where the function is not expected to return, but might not be
|
|
* good enough for other use cases.
|
|
*
|
|
* @dev: WDT Device
|
|
* @flags: Driver specific flags
|
|
* @return 0 if OK -ve on error. May not return.
|
|
*/
|
|
int (*expire_now)(struct udevice *dev, ulong flags);
|
|
};
|
|
|
|
int initr_watchdog(void);
|
|
|
|
#endif /* _WDT_H_ */
|