Cloud Service Setup

Once your tilt has completed the Initial Setup process it is ready to begin scanning for Tilt Hydrometers and relay their gravity readings to the cloud. At the moment, TiltBridge supports three cloud service targets for this data:

Setting up TiltBridge for Fermentrack

The TiltBridge was designed by the primary author of Fermentrack and is designed with Fermentrack support in mind. In most cases, your TiltBridge can be linked to a single Fermentrack installation from directly within the Fermentrack app as part of the “Add Gravity Sensor” workflow

Adding the TiltBridge to Fermentrack

  1. Connect to your Fermentrack installation and log in (if necessary)
  2. From the Device menu choose Add Gravity Sensor
  3. On the resulting page, choose Tilt Hydrometer and then select the connection type TiltBridge
  4. Click the Add New TiltBridge link. Fermentrack will automatically scan for TiltBridge devices on your network.
  5. If your TiltBridge device appears, click the “Add” button. Fermentrack will attempt to complete the remaining setup steps automatically. Proceed to Adding Tiltbridge-connected Tilts to Fermentrack
  6. If your TiltBridge device is not in the list you will need to add it manually. In the form at the bottom of the page, enter the mDNS ID you selected during Initial Setup and enter a name by which Fermentrack will identify your TiltBridge.
  7. Click the Create TiltBridge button. Fermentrack now knows to expect your TiltBridge, but you will need to finish the setup on the TiltBridge manually.

If you need to manually configure the TiltBridge

If Fermentrack was not able to automatically configure your TiltBridge (either because the automatic configuration failed or because you created the TiltBridge manually) you will need to manually set the Fermentrack URL on the TiltBridge settings page.

  1. Identify the IP address of your Fermentrack installation
  2. On a device connected to the same network as the TiltBridge, navigate to http://tiltbridge.local/ (replace tiltbridge in this URL with the mDNS name you set during initial setup)
  3. Click the Settings link at the top of the dashboard
  4. In the Fermentrack URL field enter http://<fermentrack_ip_address>/tiltbridge/ and click Update

Fermentrack and TiltBridge are now configured to properly communicate. You can now set up Tilts connected using TiltBridge in Fermentrack.

Adding TiltBridge-connected Tilts to Fermentrack

Once the TiltBridge and Fermentrack are configured to communicate, you can add the Tilt hydrometers to Fermentrack that will be pushed via the TiltBridge.

  1. Connect to your Fermentrack installation and log in (if necessary)
  2. From the Device menu choose Add Gravity Sensor
  3. On the resulting page, choose Tilt Hydrometer and then select the connection type TiltBridge
  4. Select the TiltBridge you just set up
  5. Enter the name, temp format, and color, and click Create Sensor

Congratulations - your Tilt will now send gravity readings to Fermentrack.

Setting up TiltBridge for Brewers Friend

With a premium Brewers Friend account, you can store temperature and gravity readings from your Tilt Hydrometer as part of your brew logs. After you set up your TiltBridge to push to Brewers Friend, it will create stream devices for each of the detected Tilts which can then be subsequently attached to your brew logs. To comply with rate limits placed by Brewer’s Friend, data is first sent about 1 minute after startup, and subsequently no more than once every 15 minutes.

Note

Due to ESP32 hardware limitations, all connections to Brewers Friend are done over HTTP

Configuring the TiltBridge for Brewers Friend

To configure TiltBridge to use Brewer’s Friend, you will need to obtain your Brewer’s Friend API key and provide it to TiltBridge.

  1. Go to Brewers Friend and log in to your account
  2. Click the Profile button in the upper right, and click Account
  3. Copy the API key (not one of the URLs) to your clipboard
  4. On a device connected to the same network as the TiltBridge, navigate to http://tiltbridge.local/ (replace tiltbridge in this URL with the mDNS name you set during initial setup)
  5. Click the Settings link at the top of the dashboard
  6. In the Brewers Friend API Key field paste the API key you copied earlier and click Update

Testing Brewers Friend

Once the Brewer’s Friend API key is provided, the TiltBridge will begin transmitting gravity data once every 15 minutes. Following the first data transmission, you can easily check in Brewer’s Friend to see if the data was received.

  1. Go to Brewers Friend and log in to your account
  2. Click the Profile button in the upper right, and click Account
  3. Click the Device Settings button on the right
  4. In the Device Settings pane click Show All (to the right of All Brew Sessions)
  5. All Tilt devices should appear in the list as Stream devices and will be identified by their color

Note

Per Brewer’s Friend guidelines, data is only pushed once every 15 minutes. As a result, it may take up to 15 minutes for the device to be created or for the first points to appear.

Setting up TiltBridge for Google Sheets

Similar to TiltPi or the Tilt Hydrometer app, TiltBridge supports logging to Google Sheets. Setting up Google Sheets is more involved than either Fermentrack or Brewers Friend, but provides a free, easily accessible cloud data service.

Due to hardware constraints, TiltBridge cannot communicate via HTTPS, and must rely upon a proxy service hosted at tiltbridge.com to translate between HTTP and HTTPS. If these constraints are removed in the future, HTTPS support may be readded to allow the TiltBridge to directly communicate with Google Sheets. As a result of the proxy requirement, TiltBridge will not transmit data to Google Sheets more than once every 15 minutes.

Preparing Google Sheets to Receive Data

The first step in Google Sheets integration is preparing Google Sheets to receive the data. Google Sheets requires the use of a Gmail or Google Apps for Domains account. This preparation step only needs to be done once per Google Account and once complete can be used with multiple Tilts, TiltBridges, and beer logs.

  1. Open the TiltBridge Master Sheet on Google Sheets. If prompted to login, log into your Gmail or Google Apps for Domains account.
  2. As prompted, go to the File Menu, and select Make a Copy
  3. Enter a name for this sheet (it will be the master sheet to coordinate all your beer logs) and click OK
  4. The copy you just made will open in a new window. Go to the Tools menu and select Script Editor

This will then open the Google Script editor. Before you can begin logging to Google Sheets, you need to “publish” the script that will receive the incoming data. To do so, you can follow these instructions (which are the same as those at the top of the window that appears):

  1. Go to the Publish menu and select Deploy as web app...
  2. In the dialog box that appears, set Who has access to the app: to Anyone, even anonymous and click Deploy
  3. A dialog box will appear. Select Review Permissions. Another dialog box will appear. Select your Google Account.
  4. A dialog box with This app isn't verified will appear. Select Advanced then select Go to Tilt Cloud Template for TiltBridge (unsafe)
  5. A dialog box with permission requests will appear. Select “Allow”.
  6. A dialog box confirming the app has been published will appear. Click OK, then Close Script Editor and return to the Google Sheet.
  7. Use the new “Tilt” menu in the Google Sheet to view the cloud URL or email it to yourself.

Configuring the TiltBridge for Google Sheets

Once you have prepared Google Sheets to receive data pushed by the TiltBridge, you will need to update a handful of settings on the TiltBridge itself so that it knows where to send the data.

  1. On a device connected to the same network as the TiltBridge, navigate to http://tiltbridge.local/ (replace tiltbridge in this URL with the mDNS name you set during initial setup)
  2. Click the Settings link at the top of the dashboard
  3. In the Google Script URL field paste the Google Script URL you made note of during the preparation step above and click Update
  4. After the URL is updated, enter your Gmail (or Google Apps) email address in the Google Script Email field and click Update

Your TiltBridge should now be configured to send data to Google Sheets. To begin logging a Tilt you will need to enter a sheet name for the data to be logged to.

Logging a Beer with TiltBridge and Google Sheets

After configuring the TiltBridge each Tilt your TiltBridge detects can be individually logged to its own sheet on Google Sheets. To enable logging, you will need to specify a sheet name in TiltBridge. If this sheet does not exist on Google Sheets it will be created. If the sheet does exist, new data points will be appended to it.

  1. On a device connected to the same network as the TiltBridge, navigate to http://tiltbridge.local/ (replace tiltbridge in this URL with the mDNS name you set during initial setup)
  2. Click the Settings link at the top of the dashboard
  3. Type a name for the Google Sheet to which you want to log data points in the appropriate Tilt Sheet Name field and click Update

Once this is complete, your Tilt will begin logging data points to the sheet name you specified. If the sheet does not exist, it will automatically be created.

Note

Points are only pushed to Google Sheets once every 15 minutes. As a result, it may take up to 15 minutes for the sheet to be created or for the first points to appear.