Python / PHP software to access and store Tilt Data on a Raspberry Pi
Clone or download
Latest commit da03d98 Oct 1, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
PHP_GnuPlot.php Initial commit Oct 1, 2016
README.md updated README Oct 2, 2016
TiltPythonFind.php Initial commit Oct 1, 2016
TiltPythonMySQLcrontab.php updated README and crontab code Oct 2, 2016
blescan.py Initial commit Oct 1, 2016
header.html Initial commit Oct 1, 2016
index.html Initial commit Oct 1, 2016
menu.php Initial commit Oct 1, 2016
phpinfo.php Initial commit Oct 1, 2016
plotData.php Initial commit Oct 1, 2016
tilt.sql Initial commit Oct 1, 2016
tiltblescan.py Initial commit Oct 1, 2016

README.md

Read and Store Tilt Digital Hydrometer Readings using a Raspberry Pi

The Tilt Digital Hydrometer is a small device utilizing a PunchThrough Bean.

The tilt utilizes the on-board accelerometer on the bean to measure the tilt of the Tilt in wort and broadcasts the result as Specific Gravity (SG) as part of an iBeacon advertisement broadcast.

Tilt provides apps in iOS and Android that can read the iBeacon and display it, as well as store the data in the cloud.

This software utilizes a Raspberry Pi (RPi), or similar device, to capture the iBeacon advertisements and store the data locally in a MySQL database. It also provides code that will display a simple local webpage that has a real-time graph of the fermentation progress.

#Initial Setup

You should have some experience setting up a Linux distribution, and know how to set permissions, read logs, and troubleshoot. If you are a complete noob at these items, it may be worth your while to get a more experienced friend to assist you.

The RPi ideally should be a Model 3, as it already has Bluetooth Low Energy (BLE) hardware on the board. Other boards, such as the RPI Model 2, Odroid C2, etc., may work if a BLE dongle is added to a USB port.

The RPi should be loaded with the latest version of Raspbian. Whether you choose to use the light or GUI version is a personal choice. I recommend at least an 8GB SD card. I would also setup your visudo to allow you to run programs with elevated privileges without constantly entering a password.

The RPi should be setup as a LAMP server, as well as the latest versions of bluez, python-bluez, bluetooth and phpmyadmin.

Use phpmyadmin and tilt.sql to create the tilt database. Also make sure that privileges are set using user tilt.

Once the RPi is setup and running, download abd install the code from this github to your webserver directory. It's typically /var/www/html, but YMMV.

Next, place your Tilt in a container of water large enough to allow the Tilt to float freely. From a terminal, enter sudo php TiltPythonFind.php. You should get a response that shows the MAC address of the Tilt, the current Specfic Gravity (SG) reading, and the Temperature.

Using a text editor, copy the MAC address that was displayed, and place it into the $tiltStr variable in TiltPythonMySQLcrontab.php. You may also want to make sure that your apache website directory is correct as well by checking $htmlAddrStr in the same file.

Finally you'll create a crontab entry to run TiltPythonMySQLcrontab.php regularly. I recommend once a minute. I also recommend you run it as a root or superuser crontab to help avoid permision problems.