Installation

##Installation Instructions

The setup requires two things; the SmartThings Raspberry Pi Device Type and BerryIO SmartThings. It is recommended that you start off with a fresh install of Raspbian.

Known Test Setup

• SmartThings Hub v1
• SmartThings Hub firmware version 000.013.00013
• SmartThings Raspberry Pi Device Type (raspberry-pi.groovy) 10/06/2015
• Raspberry Pi Model B Revision 2.0
• Raspbian Wheezy 2015-05-05

Check your SmartThings Hub firmware version

Your firmware version needs to be greater than 000.010.00246. Has been proven to work with 000.013.00013 and not with 000.010.00246.

• Check your hub firmware version here.

Raspbian Installation Instructions

• Follow these installation instructions.

BerryIO SmartThings Installation Instructions

• Open up a terminal on your Raspberry Pi
• Download the BerryIO SmartThings installation script

$ cd ~
$ wget https://raw.githubusercontent.com/nicholaswilde/berryio-smartthings/master/scripts/berryio_install.sh

• Change the file attribute so that the installation script is executable

$ chmod +x berryio_install.sh

• Run the installation script

$ sudo ./berryio_install.sh

• Configure msmtp so it can access your mailserver

$ sudo nano /etc/msmtprc

• Test BerryIO is working

$ berryio help

• Test email is working

$ sudo berryio email_ip

• If all went well, you should now be able to log into your Pi using the web interface and the standard username and password you use at the terminal.

SmartThings Device Type Installation

Through GitHub Integration

• The SmartThings IDE now supports GitHub integration! See here for more documentation.
• Note: GitHub integration requires you to have a GitHub account.

Manually

• Create and account or log into the SmartThings Web IDE.
• Click on My Device Types from the navigation menu.
• Click on + New SmartDevice button.
• Fill in the Name field and click on the Create button. Don't worry about filling out everything else.
• Paste the code from the raspberry-pi.device.groovy file.
• Click on Save in the IDE.
• Click on Publish -> For Me in the IDE.

Raspberry Pi SmartThings Device Installation Instructions

The device type is a generic template for a specific type of device. The Raspberry Pi device itself needs to be added to SmartThings.

• Click on My Devices in the SmartThings Web IDE navigation menu.
• Click on + New Device button.
• Specify the following fields:
  • Name: Raspberry Pi
  • Device Network Id: 123 (can be anything at the moment because the Raspberry Pi device type will change it for you).
  • Type: Raspberry Pi (Name of your new device type)
  • Version: Published
  • Location: your location (e.g. Home)
  • Hub: your hub (This is a must or else the Raspberry Pi device won't work!)
  • Group: Can leave blank.
• Click on the Create button.
• Click on the Raspberry Pi display name from the My Devices list.
• Go to Preference and click edit
• Enter in your settings;
  • IP address: RPi IP address
  • Port: 80(default for BerryIO)
  • Username: pi (default for WebIOPi)
  • Password: raspberry (default for BerryIO)
• Click the Save button.