Skip to content
This repository has been archived by the owner on Dec 26, 2020. It is now read-only.

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

License

Notifications You must be signed in to change notification settings

custom-components/sensor.rpi_power

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.