An uninterruptible power supply for Raspberry Pi that can provide more than an hour of backup power and can shutdown the Pi safely. This UPS can be used to power any 5V device with up to 3A continuous current. It is based on Texas Instruments BQ25895 power management IC and TPS61236P boost converter IC.

This UPS can power a Raspberry Pi through the GPIO header by using it as a hat. When used as a hat, the GPIO pins 2, 3 and 4 will be utilized for I2C and interrupt signals.

Note:

• Do not connect two input sources together!

• The device does not have reverse polarity protection, be sure to observe the polarity marked in the battery holder while inserting the battery.

• UPS script was tested on a Raspberry Pi 3B+ running Raspbian Buster.

• Input: 4.5V - 14V DC, 2A - 5A

• Input Ports: Screw Terminal, micro USB

• Output: 5V, up to 3A

• Output Ports: Screw Terminal, USB A, 40 pin GPIO header for Raspberry Pi

• Battery: Not included (Samsung INR18650-29E recommended, other 18650 size li-Ion batteries can be used)

• Communication: I2C

• IN: Input connected or not

• STATUS: ON- Charging, OFF- Charging done, Blinking- Error

• OUT: Output on or off

• Make sure the switch of the Power Pi is turned off and no power input is connected to the Power Pi.

• Insert the battery into the battery holder of the Power Pi following the correct polarity.

• Connect Power Pi to Raspberry Pi by inserting it into the GPIO pins.

• Connect a USB power cable into the Raspberry Pi's USB input as usual to turn the Pi on. (This is to set up Power Pi. After the setup, power cable can be connected to Power Pi's input.)

Update the system (optional):

sudo apt update && sudo apt upgrade -y

Enable I2C:

sudo raspi-config

Choose Interfacing Options, then I2C and then select enable to enable I2C in the Raspberry Pi.

Install smbus by running the following command:

sudo apt-get install -y python-smbus

For more information, checkout the link

Clone the Power Pi repository:

cd ~
git clone https://github.com/tjohn327/raspberry_pi_ups.git
cd raspberry_pi_ups/src/

Edit the file ups.py or ups_with_timeout between lines 45 and 66 if you are not using Samsung INR18650-29E battery. It is recommended to keep the VBAT_LOW at 3.2V for Li-Ion batteries.

Power PI uses GPIO4 for interrupts from the Power Management IC. 1-Wire interface uses the same pin. If you are not using 1-Wire interface, disable it before proceeding. Power Pi can still function fully without the interrupt. So if you want to use 1-Wire interface it is advised to remove the resistor R12 from Power Pi, otherwise it will cause interference with 1-Wire interface.

Run the install.sh script to install a service for the ups.

chmod +x install.sh
./install.sh

This creates a service named ups.service that will run on startup. If there are no errors, you will see this as the output:

Checking Python
Python found
Initializing Power Pi
INFO:root:UPS initialized
Creating ups service
Enabling ups service to run on startup
ups service enabled
Power Pi configured successfully

Don't panic - since the Power is not connected to Power Pi this message will appear.

Broadcast message from user@raspberry (somewhere) (Sat Aug 15 18:40:10 2020):

Power Disconnected, system will shutdown in 72 minutes!

Now turn off the Raspberry Pi and remove the power cable form it. Connect the power cable to Power Pi and turn the switch to ON position. This will power up the Raspberry Pi through Power Pi.

When the Pi is powered back up, check the status of the ups service by running:

sudo systemctl status ups.service

If everything is running correctly, you will see a status similar to this:

● ups.service - UPS Service
   Loaded: loaded (/lib/systemd/system/ups.service; enabled; vendor preset: enabled)
   Active: active (running) since Tue 2020-06-09 06:44:15 UTC; 34s ago
 Main PID: 542 (python)
    Tasks: 2 (limit: 2200)
   Memory: 6.9M
   CGroup: /system.slice/ups.service
           └─542 /usr/bin/python /home/pi/code/raspberry_pi_ups/src/ups.py

Jun 09 06:44:15 raspberrypi systemd[1]: Started UPS Service.
Jun 09 06:44:17 raspberrypi python[542]: INFO:root:UPS initialized

Your Power Pi is now ready.

When powering the Raspberry Pi through Power Pi, always connect the power cable to the input of the Power Pi. Use the switch of Power Pi to turn the devices ON and OFF.