# PiWatcher: the best watchdog for your Raspberry Pi

The PiWatcher is a small board that will automatically shut down and/or reboot your Raspberry Pi when needed.

- **Seller:** [omzlo](https://lectronz.com/stores/omzlo), Thrakomakedones, Attica, Greece
- **Price:** €7.60 (EUR, before shipping and taxes)
- **Availability:** Sold out
- **Categories:** Power management, Raspberry Pi
- **HS code:** 85423100
- **Product page:** https://lectronz.com/products/piwatcher-the-best-watchdog-for-your-raspberry-pi

## Links

- [Documentation](https://www.omzlo.com/articles/the-piwatcher)
- [Code](https://github.com/omzlo/piwatcher)
- [Design Files](https://www.omzlo.com/uploads/piwatcher.pdf)

## Images

![PiWatcher: the best watchdog for your Raspberry Pi](https://lectronz-images.b-cdn.net/lectronz/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NjEyLCJwdXIiOiJibG9iX2lkIn19--009f6ce388198b011aca4f74bca2a0867b17a873/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJqcGciLCJyZXNpemVfdG9fbGltaXQiOls5NjAsNjQwXSwic2F2ZXIiOnsic3RyaXAiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--970c165836a83091725a1a0fd4f37ce9408da1bf/2019-02-06T15-54-37.030Z-piwatcher-pizero2-2.jpg)
![PiWatcher: the best watchdog for your Raspberry Pi](https://lectronz-images.b-cdn.net/lectronz/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NjE0LCJwdXIiOiJibG9iX2lkIn19--7f181f616d0cb04f93b7f7a6e794d29fcaae94d9/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJqcGVnIiwicmVzaXplX3RvX2xpbWl0IjpbOTYwLDY0MF0sInNhdmVyIjp7InN0cmlwIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--4e27bac8cdfb621fb828f6a3a5982fe1a423b516/piwatcher-angle.jpeg)

## Description

## What is it?

The **PiWatcher (Rev. 3)** is a very small board that helps you fully shut down or reboot a Raspberry Pi, in case of an incident or simply for power saving purposes. You can even program your **PiWatcher** to shut down and automatically reboot your Pi a few minutes or hours later. 

In essence, the **PiWatcher** is a programmable watchdog circuit for the Raspberry Pi.

The board must be fitted on the first 6 pins of the Raspberry GPIO header and plugged into a micro USB power supply suitable for the Raspberry Pi in use. Based on instructions it receives through I2C, the **PiWatcher** can then be instructed to:

- power off (or reboot) the Raspberry Pi if it becomes irresponsive for more than 'X' seconds. 
- power off and reboot the Raspberry Pi after several seconds, minutes or hours for recurring tasks for example.

The board also features a miniature tact switch to allow manual control.

It has been tested to work with:

- the humble Pi Zero and Pi Zero W,
- the Raspberry Pi 2 B
- the Raspberry Pi 3 B
- the Raspberry Pi model B, with some [extra I2C configuration](https://www.omzlo.com/articles/the-piwatcher#setup-on-older-raspberry-pi-models).
- the Raspberry Pi 4 (new in Rev 2), but requires  [extra I2C configuration](https://www.omzlo.com/articles/the-piwatcher#setup-on-older-raspberry-pi-models) in some cases.

Warning: The PiWatcher may not operate correctly if the Raspberry Pi is connected to some power-hungry peripherals such as an SSD hard drive, or with peripherals that have a separate power supply.

The PiWatcher works on the Raspberry Pi 5 with recent firmware updates (November 2025). It fails with older firmware versions, due to bugs in the I2C hardware drivers on the Pi 5. 

## A solution for Raspberry Pi power management

The **PiWatcher** is designed to solve 2 problems with power management on the Raspberry Pi.

First, if you shut down a Raspberry Pi through software, for example by issuing a `shutdown` or `halt` command, 
your Raspberry Pi will cease to operate, but it does not completely shut down. Instead, it enters a quiescent state
where it continues to eat 30 to 50mA, sometimes more depending on connected peripherals. This is wasteful and can
become an issue in battery powered systems.

The **PiWatcher** can be programmed to fully cut power to the Raspberry Pi after a certain delay of inactivity. For 
example, you can tell the **PiWatcher** to cut power 10 seconds after a `shutdown` command has been issued, giving 
the Raspberry Pi enough time to cleanly power off.

The second issue with power management has to do with the ability to recover from situations where a Raspberry Pi
becomes stuck in an unrecoverable state. While in theory, this should not happen, a long-running Raspberry Pi can get 'stuck' or 'freeze', due to software or hardware failures or even environmental factors such as heat. In some cases
the least unsatisfactory approach to deal with this issue is to simply switch off and on again the Raspberry Pi,
enabling the application to continue and/or send out an alert.  

The **PiWatcher** can be programmed to automatically power cycle a Raspberry Pi if it does not receive a 'heartbeat'
from the device after a user selectable delay. This can allow some critical applications to continue to operate
without human intervention.

Furthermore, the **PiWatcher** can be programmed to wait for a certain delay, ranging from a few seconds to about 36 hours, before rebooting your Raspberry Pi after a shutdown.
The **PiWatcher** has an LED. When the Raspberry Pi is powered on, the LED is continuously on.
When the Raspberry Pi is powered off, the LED blinks slowly.

The **PiWatcher** also has a useful micro tact-switch:

* When your Raspberry Pi is running:

 * a long press (5 seconds) on the button will fully power off the Raspberry Pi.
 * a short press (half a second) on the button will send a software signal that can be exploited for user-defined purposes.

* When your Raspberry Pi is shut down, a short press on the button will restart the Raspberry Pi.

![PiWatcher connections](https://www.omzlo.com/uploads/std_piwatcher-text.png "enter image title here")

## How to use the PiWatcher

The **PiWatcher** is fully controlled with a command line utility called `piwatcher`. It is very simple to use.

For more details, including software download instructions, see our documentation [here](https://www.omzlo.com/articles/the-piwatcher). 

## What's included 

The board comes with an _unsoldered_ 2x3 female pin header. You will need to provide your own Raspberry Pi.

The board does not come with standoffs. If you need some, look for M2.5, 11mm.

**Rev 2** of the PiWatcher was released in January 2020 and offers the following enhancements over Rev 1:

* Better stability against brief under-voltage transients.
* Compatibility with the Raspberry 4.
* Easier programmability through dedicated test points.

**Rev 3** is only a minor PCB redesign.

An alternative version of the PiWatcher where the USB connector is replaced with a terminal block is also [available on Lectronz](https://lectronz.com/products/piwatcher-tb-the-other-raspberry-pi-watchdog).

This product is open-source/open-hardware.

## Shipping policy

We ship twice a week, typically on Tuesdays and Fridays. 
