Knowledge base => Managing your brewery => API and devices
My CraftBeerPi3 plug-in provides recording of current and target temperatures to the allocated Brewers Chronicle ferment log. It also provides ferment control using the ferment and cold crash schedules in Brewers Chronicle. Link an iSpindel or Tilt digital hydrometer and you can automatically control your ferment based on gravity readings. Manually record gravity readings and you get the same automatic temp control. You can also control your ferments remotely by altering your ferment schedule in the BC website. The next sync between CBPi3 and BC will transmit the new target temperature.
NB: one thing to note is that you will need to have a paid Brewers Chronicle subscription or switch to the personal-free-api subscription to use the API. This is available in the brewery details section.
Note the CBPi fermentor names and temperature devices (highlighted in green rectangles) match up to the Brewers Chronicle asset and device names. The API uses these values to match up readings during synchronisation.
Installation
I am still hoping to get my plug-in added to the standard list so it is simply a click install, but I put my request in last January and have heard nothing, so below are the instructions for installing the plug-in manually.
Set one of your fermentors to automatic. Every 15 minutes the plug-in will report details to Brewers Chronicle. On the first submission a new Brewers Chronicle brewery asset of type fermentor will be created (see first screenshot), and the temperature and target devices attached to this asset. Subsequent readings will be attached to that asset, and once you allocate the asset to a ferment log, readings will be attached to the ferment log.
Once you have installed the plug-in, you will need to go to the "Parameters" page in the "System"section. You will find a new setting "brewerschronicle_api_key". Please click on this and paste in your brewery API key. This will identify readings being submitted in and direct them to your brewery profile inside Brewers Chronicle.
Synchronisation
Every 15 minutes CBPi synchronises with Brewers Chronicle.
If you have an iSpindel or Tilt digital hydrometer, these devices record gravity readings against the allocated ferment log. If you define a ferment schedule based on gravity readings, the synchronisation process will write the calculated target temperature into the CBPi ferment target temperature.
To display gravity readings inside CBPi3, you will need to create a "BC_GravitySensor" sensor and assign it to sensor 3 on your fermentor.
The plug-in also supports the cold crash schedule feature. You can define a days-based schedule for controlled chilling of your wort once you are happy the ferment has completed and you manually activate the cold-crash schedule.