A Python application to monitor the status of a kegerator. Runs on a Raspberry Pi that has one or more HX711 load cell amplifiers and an ST7735 LCD attached.
Hardware docs are barebones at the moment. After the reference hardware has been reworked, better documentation will be provided.
Supports:
- Monitoring beer levels via weight, using HX711 load cell amplifiers
- Monitoring CO2 tank levels, also via HX711s
- Temperature monitoring via DS18B20 1-wire bus temp sensor
- Outputting data to an attached ST7735 LCD
- A web interface that reports data and allows configuring keg names and sizes on-the-fly in a more convenient manner
THIS SOFTWARE IS NOT BEING CREATED WITH ANY SORT OF SECURITY CONSIDERATIONS IN MIND.
DO NOT EXPOSE THIS APPLICATION TO THE INTERNET, ESPECIALLY THE WEB INTERFACE.
IF YOU REALLY WANT REMOTE ACCESS, USE A VPN.
AS OF VERSION 1.2.0 PYTHON 3 IS REQUIRED.
You'll save time and skip having to install gfortran if you install the repo version of python-numpy.
sudo apt-get update
sudo apt-get install python3-numpy
I also recommend disabling CPU frequency scaling. On my system, this helped with weight updates occasionally failing, causing keg weights to fluctuate randomly.
sudo apt-get install cpufrequtils
echo "GOVERNOR=performance" | sudo tee /etc/default/cpufrequtils
sudo systemctl restart cpufrequtils
The only prerequisite that you'll need to manually install is the hx711py module.
sudo pip3 install git+https://github.com/tatobari/hx711py.git
After installing hx711py, clone this respository and run
sudo python3 setup.py install
Or use pip:
sudo pip3 install git+https://github.com/yesrod/hoplite.git
See Hardware
All configuration is done via the REST API. Hoplite will start with an empty config to allow you to customize the config to your setup.
API documentation can be found on the wiki.
After you have a roughly accurate config, stop Hoplite and tare all the connected HX711s. Make sure the load sensor platforms are empty!
python -m hoplite --tare --config /etc/hoplite/config.json
Then get a known weight of some sort (in grams) and calibrate your weight sensors:
# this example assumes a 1000 gram test weight
python -m hoplite --cal 1 A 1000 --config /etc/hoplite/config.json
# repeat for all channels defined in the config
Then start Hoplite again - weights should be accurate after tare and calibration.
For the main daemon (start this before the web interface)
python -m hoplite
Optionally, specify a config file location
python -m hoplite --config /etc/hoplite/config.json
For the web interface
python -m hoplite.web
Systemd service files are in the systemd/ folder in the repo.
These will run Hoplite as root - this isn't a requirement, however. Hoplite
will run as a non-root user, as long as the user is a member of the
gpio, i2c and spi groups.
cp systemd/hoplite*.system /etc/systemd/system/
systemctl daemon-reload
systemctl start hoplite
systemctl start hoplite-web
To start on boot, install the files as above, then
systemctl enable hoplite
systemctl enable hoplite-web