Files
x728ups/README.md
2025-03-28 12:39:52 -07:00

1.1 KiB

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.