1 | //! Traits for interactions with a processors watchdog timer. |
2 | |
3 | /// Feeds an existing watchdog to ensure the processor isn't reset. Sometimes |
4 | /// commonly referred to as "kicking" or "refreshing". |
5 | #[cfg (feature = "unproven" )] |
6 | pub trait Watchdog { |
7 | /// Triggers the watchdog. This must be done once the watchdog is started |
8 | /// to prevent the processor being reset. |
9 | fn feed(&mut self); |
10 | } |
11 | |
12 | /// Enables A watchdog timer to reset the processor if software is frozen or |
13 | /// stalled. |
14 | #[cfg (feature = "unproven" )] |
15 | pub trait WatchdogEnable { |
16 | /// Unit of time used by the watchdog |
17 | type Time; |
18 | /// Starts the watchdog with a given period, typically once this is done |
19 | /// the watchdog needs to be kicked periodically or the processor is reset. |
20 | fn start<T>(&mut self, period: T) |
21 | where |
22 | T: Into<Self::Time>; |
23 | } |
24 | |
25 | /// Disables a running watchdog timer so the processor won't be reset. |
26 | #[cfg (feature = "unproven" )] |
27 | pub trait WatchdogDisable { |
28 | /// Disables the watchdog |
29 | fn disable(&mut self); |
30 | } |
31 | |