Lately I have been playing a lot with UPS devices. Both using NUT and APCUPSD, but also trying to do my own work.
The result of some personal experimentation was my own tool called sups (simple ups)
Using it is as simple as extracting the executable (ideally somewhere in your path) and then running it like
sudo ./sups
sudo is probably required because more than likely the dev file is owned by root
The application looks on its own for HID compatible devices under /dev and tries to connect to the first one that it finds.
You can define your own device using the --port argument
sudo ./sups --port /dev/usb/hiddev1
If you want to shutdown the local machine below a certain battery level, you can use the --monitoring argument. The default threshold is 50% as this is the minimum safe level for cheap lead acid batteries. But you can also define your own threshold using the argument --threshold and passing the percentage. Like
sudo sups --monitoring --threshold 30
There is no daemon or service mode, so for automated shutdown the application has to be run through root’s cron using something like
* * * * * sups --monitoring --threshold 45
The application does not support any low level communication with the device drivers. This was a deliberate choice. It restricts communication with fancy UPS functions, but also allows the application to be written in a higher level language that is easier to follow and maintain.
So far the app is only tested with only a few UPS devices that I have access to
So I would appreciate any feedback or corrections
You can use the --debug argument to see more information about what data was received from the device and how it was parsed.
The reasoning behind the app was to create a tool that is functionally complete but simple to use with 0 configuration even with multiple UPS devices, while at the same time being easy to maintain.
You can find the code and the executable, along with detailed instructions about the application and HID in general, under the github repo
You could install a udev rule to change the permissions or owner of the device, and avoid running your daemon as root.
Thanks for the tip. I’ll keep it in mind. In this case, we need sudo for shutdown anyway