/sensor.rpi_power

A Custom component for Home-Assistant that checks if your Raspberry Pi power supply is giving enough voltage from the kernel.

Primary LanguagePythonMIT LicenseMIT

Raspberry Pi Power Supply Checker

GitHub Release License Project Maintenance ContributorsDonate using Liberapay Discord

A sensor for Home Assistant that checks your power supply and reports back to your setup this simple sensor reports values from the kernel and if it reports anything else then 0 then there are issues with the power supply.

Breaking change: this project went from sensor to binary_sensor.

  • Manually download and install the files from the aforementioned URL into your custom_components\rpi_power
  • Modify your config.yaml and make sure that - platform: rpi_power is under binary_sensor: section (create if missing) instead of sensor: (that's the breaking change the author is referring to in the readme)
  • Restart Home Assistant
  • Replace in your lovelace cards / automations / scripts / whatever... any mention to sensor.rpi_power_status by binary_sensor.rpi_power_status

For more information about Raspberry Pi Power supplies check the following link.

Getting started

⚠️ This requires kernel 4.14 or higher.

Place the component at this location on your setup:

  • Home Assistant (former Hass.io): /custom_components/rpi_power/binary_sensor.py

  • Home Assistant Core / Hassbian / Other: <config directory>/custom_components/rpi_power/binary_sensor.py

    _init_.py and manifest.json needs to be in the same folder

and then restart Home Assistant to make sure the component loads.

Here is a list of the current values the component checks for:

Value Description
0 Everything is working as intended
1000* Under-voltage was detected, consider getting a uninterruptible power supply for your Raspberry Pi.
2000* Your Raspberry Pi is limited due to a bad power supply, replace the power supply.
3000* Your Raspberry Pi is limited due to a bad power supply, replace the power supply.
4000* Your Raspberry Pi is throttled due to a bad power supply this can lead to corruption and instability, please replace your charger and cables.
5000* Your Raspberry Pi is throttled due to a bad power supply this can lead to corruption and instability, please replace your charger and cables.
8000* Your Raspberry Pi is overheating, consider getting a fan or heat sinks.

Due to how custom_components are loaded, it is normal to see a ModuleNotFoundError error on first boot after adding this, to resolve it, restart Home Assistant.