A versatile watchdog and heartbeat traits for various monitoring purposes in mission-critical systems (processes, single threads etc).
Generates and analyses pulses (edges) to detect errors in the monitored system.
The crate is a part of the RoboPLC project and works on Linux only. No other platforms support is planned, except bare-metal.
The crate provides out-of-the-box:
-
UDP
socket heartbeat/watchdog -
GPIO
heartbeat/watchdog (requiresgpio
feature)
More communication methods can be added by implementing io::WatchdogIo
and
Heart
traits.
For high-level communication (e.g. TCP/IP) the edges are encoded as "+" for rising and "." for falling to simplify sniffing/debugging purposes.
The crate has got integration with embassy for no_std
targets. Requires disabling defaults and enabling embassy
feature.
The following heartbeat errors are detected:
-
Timeout
- no heartbeat edge change has been detected within the specified time -
Window
- heartbeat edge change has been detected out of the time window -
OutOfOrder
- heartbeat edge change has been detected out of order (e.g. for TCP/IP communication)