This version is outdated by a newer approved version.DiffThis version (2017/07/13 09:58) is a draft.
Approvals: 0/1

This is an old revision of the document!


Raspberry Pi & BrewPi Setup Guide

Important Considerations:

This setup should take around 1 hour.

The Raspberry Pi 3 B requires a 2.5 ampere power source. Unless you have USB type C you cannot power the Raspberry Pi from your USB port. Also, do not use phone chargers because the amperage is too low. We recommend that you purchase an appropriate power supply when purchasing your Raspberry Pi.

If you can avoid it, always shut down your Raspberry Pi using the 'sudo shutdown -h now' command before unplugging it. Not doing this could damage it.

Format SD card

  1. First you will need to format your SD card, (this removes all data and is like starting from a clean slate)
  2. We reccomend you do this even if you purchase a new SD card.
  3. Download SDFormatter
  4. Use program to format your SD card, Defaults of the program will be fine.
test

Download software

  1. Click on 'Raspbian'
  2. Download .zip file called 'RASPBIAN JESSIE LITE'
test

Extract Files

  1. You will be required to write an image onto the SD card, to do this we suggest you use Etcher
  2. Download Etcher and follow the install instructions, open it when complete.
  3. It will ask you for two things, the image and the drive.
  4. For the image you need to select the 'raspbian-jessie-lite.zip' which you have just downloaded
  5. For the Disk select the formatted SD card from previous section, once both have been selected click 'Flash!' (this process may take several minutes)
  6. During this process you may have several windows pop up (mine did in any case) just ignore these or close them.
  7. Your SD card location (in my case F) will now be called 'Boot (F)'
  8. Before removing SD card you still need to follow the next step
test

Adding SSH Command

  1. Not going to bother you with too many details here, but the installation and setup of BrewPi software will be done via a SSH connection with your pc. This is done using a program (for windows users) called PuTTY
  2. In order to use PuTTY we have to enable ssh in Rasbian.
  3. To enable ssh first open the boot file on your SD card
  4. At the top click 'View' and check the box with 'File name extionsions' - this is important for the next step
  5. Now, right click and select 'New' followed by 'Text Document'
  6. Name this text document 'ssh' without the extension '.txt' (Don't worry this is meant to be an empty document)
  7. Now safely eject the SD card and place it its slot on the Raspberry Pi
test

Installing PuTTy

PuTTY will be the main way of communicating with the Raspberry Pi
  1. Download & install PuTTY
  2. You will need to know the IP adress of your Raspberry Pi, the quickest and easiest way to do this to use an app for your phone called 'fing'
  3. Make sure your Raspberry Pi is connected to your network.
  4. You should be able to see the Raspberry Pi on fing,
  5. Fill this IP into PuTTY and connect (you can leave it on port 22, make sure SSH is checked)
  6. If all is well, you will see this login screen, the default username is 'pi' and the default password is 'raspberry' (note: when typing in the password it will seem like nothing is happening, this is to be expected)
  7. Now its time to configure your Raspberri Pi
right

Configuring Raspberry Pi

From this point everything will be typed into the command box which appears when using PuTTY
  1. Type 'sudo raspi-config' - this will cause a menu to appear
  2. We suggest you change the password for security and under option 4 change time zone to you local time. (hint: use tab to quickly skip to 'ok' or 'cancel')
  3. Optional If you want to configure your network settings please refer to this link Network Configuration
  4. Now update your software using the commands, 'sudo apt-get update' and 'sudo apt-get upgrade' (this will take approximately 10 minutes), and while were at it let's update the firmware as well using 'sudo rpi-update'
  5. After you have done the above updates you will need to reboot, using 'sudo reboot' (you may need to reconnect with PuTTY after rebooting)
right

Installing BrewPi

Finally…. it is time to install the BrewPi software Luckily this is very easy with our install script
  1. Type 'sudo apt-get install git'
  2. Then type 'git clone https://github.com/BrewPi/brewpi-tools.git ~/brewpi-tools', these two steps will get the install script onto your Raspberry Pi
  3. now run the script using 'sudo ~/brewpi-tools/install.sh'
  4. It will ask you several yes or no questions during the install, if inexperienced with computed we recommend answering yes to all of them.
  5. And that was it
  6. If ever in the future you want to update your BrewPi you can do so using 'sudo ~/brewpi-tools/updater.py'
right

Connect up your BrewPi

Connecting the BrewPi to the can be done through using the WiFi connection but we suggest for now to use a USB cable first to make life a little easier.
  1. Use USB cable to connect the micro-USB port on BrewPi to the USB port on Raspberry Pi
  2. In your Internet Browser type in the IP address of your Raspberry Pi, it should show a demo brew page.
  3. In the top right of your screen you will see a button saying 'Script not running' you need to click on this to start the script.
  4. it may take a minute or two before it starts, the button should change to say 'Script running'
  5. Now all that's left before starting your Brew is to assign the sensors to the correct imputs, and any outputs to the correct port.
  6. This is done in 'maintenance panel' under the heading 'device configuration' (you may need to click 'refresh device list')
right

Title

left
right