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.