heartbeat-watchdog 0.2.0

A versatile heartbeat watchdog
Documentation

A versatile watchdog and heartbeat traits for various monitoring purposes in mission-critical systems (processes, single threads etc).

The crate is a part of the RoboPLC project and works on Linux only. No other platforms support is planned, except bare-metal.

Communication

The crate provides out-of-the-box:

  • UDP socket heartbeat/watchdog

  • GPIO heartbeat/watchdog (requires gpio 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.

Bare-metal

The crate has got integration with embassy for no_std targets. Requires disabling defaults and enabling embassy feature.

Error detection

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)