UPS software for Geekworm X728

Install prerequisites:

sudo apt update && sudo apt install -y python3 python3-smbus python3-pip && sudo pip3 install --break-system-packages rpi-lgpio

Install the software:

sudo cp x728ups x728off /usr/local/bin && sudo cp x728ups.service /lib/systemd/system && sudo systemctl daemon-reload

Enable the software:

sudo systemctl enable x728ups.service && sudo systemctl start x728ups.service

Monitor the daemon while it's running:

journalctl -fu x728ups

Ways to do a clean shutdown

• sudo x728off (don't use shutdown -h now)
• send SIGUSR1 (this is what x728off does)
• hold down the button for 4 seconds
• unplug power and wait for the battery to get to 20% remaining

Ways to reboot

• the old standby: shutdown -r now
• hold down the button for 1 second

Kill the buzzer when on battery

• send SIGUSR2: sudo pkill -USR2 -u root -f x728ups

Notes

Tested on a Raspberry Pi 4B running Armbian Bookworm, with a Geekworm X728 v2.5.