-
Notifications
You must be signed in to change notification settings - Fork 15
BrewTroller v2.7 Manual (develop)
This is intended to be the BrewTroller manual for the most recent develop branch of the github.com/oscsys/brewtroller repo. This is a living document that updates as features are added.
The latest develop branch of this repository is available here: https://github.com/OSCSYS/brewtroller/archive/develop.zip
The BrewTroller firmware supports several different target device types. Each target device supported has a unique HWProfile.h file that configures BrewTroller for target device. These HWProfile.h files are stored in a HWProfiles folder structure within the source code. Currently, the source code is configured for use with the OpenTroller DX1. To configure BrewTroller for another device type simply locate the HWProfile.h file for your target device in the HWProfiles folder and replace the HWProfile.h file in the root folder of the BrewTroller firmware.
The long-term goal for this project is to eliminate the need to configure and compile source code entirely. There are however a few options that are currently only available if enabled in the source prior to uploading. These options are configured in the Config.h file of the source code.
BrewTroller defaults to Imperial units (F/Gallons/Pounds). If you wish to use with Metric units you must uncomment the //#define USEMETRIC line by removing the proceeding '//':
#define USEMETRIC
This option dynamically alters the HLT setpoint based on the mash setpoint and error. Error refers to the difference between the actual temperature and setpoint.
By default, an alarm condition will cause the configured alarm output to be activated constantly. This option causes the alarm output to be modulated or pulsed instead.
Obtaining the Customized Arduino Integrated Development Environment (IDE) ~~~~~~~~~~~~~~~~~~~~~~~~~
This branch of BrewTroller is designed to be used with a customized version of the Arduino 1.0.5-R2 development environment. The official Arduino IDE has been customized to support the ATMEGA1284P microcontroller used by BrewTroller/OpenTroller devices and also includes libraries not included with Arduino that BrewTroller requires.
The custom IDE is available for both Windows and Mac systems: * https://github.com/OSCSYS/BTArduino-Win/archive/master.zip * https://github.com/OSCSYS/BTArduino-Mac/archive/master.zip
-
Make sure the target device is connected via USB to the system being used to upload the firmware.
-
Launch the customized Arduino IDE.
-
Select ATMEGA1284P Board from the Tools-Board menu
-
Select the appropriate serial port for your target device from the Tools-Serial Port menu
-
Click the upload button → or select Upload from the File menu
When you first upload the BrewTroller firmware you may receive a message stating "Configuration Not Found" followed by a menu with two choices: Initialize EEPROM, Cancel. You should select Initialize EEPROM to erase any previous settings and force default values.
BrewTroller boots to the Home Screen displaying the firmware version. An unlock icon in the upper right corner of the screen indicates that the user interface (UI) is unlocked and the encoder can be used to switch between logical screens. Clicking the encoder will lock the user interface on the active screen causing the encoder input to be sent to the screen. A click held for one second or longer will unlock the user interface.
The BrewTroller firmware must be configured for your specific brewing system once it has been loaded to the target device.
Navigate to and lock the Home Screen. Click the encoder to launch the Main Menu. Select System Setup.