OLA Raspberry Pi

This tutorial describes how to get OLA running on the Raspberry Pi. The procedure described here is designed to get OLA up and running as fast as possible. If you don't trust the images below, or want to build everything from scratch, you can install an image from the Raspberry Pi Site and use the generic instructions for Installing OLA on Linux.

There is plenty of information at the Raspberry Pi Wiki. The Raspberry Pi Forum is a good place to ask for help on Raspberry Pi specific issues.

Getting Started

You'll need the following:

• A Raspberry Pi board. See the Buying Guide for how to purchase one.
• An SD card. Check the SD Card Compatibility List but don't worry too much if your card isn't listed there. A 4GB card should be more than sufficient.
• An SD card reader. Make sure it supports the SDHC (high capacity) cards.
• A microUSB cable to provide power
• A CAT5 network cable.
• A Composite or HDMI monitor / TV to debug if things go wrong.
• A computer with a SSH Client and (optionally) Web Browser. You can use the Pi locally with a USB keyboard, but many people find it easier to access it from another machine.
• A powered USB Hub, if you plan on using a USB DMX/RDM device. Many devices draw more current than the Raspberry Pi can support. See the discussion on the Open Lighting Group for more details.

Select your Image

At this point you need to decide what image you want to use. The GIT image allows you to track the latest changes, but requires you to build the software yourself (which takes time). The release image contains the pre-built binary packages for each release. The images are here.

GIT Repo

This tracks the Git Repo, which means you can always use the very latest version of the code. The downside of using this option is that you have the build the code yourself (which takes time) and sometimes the code can break.

Download the latest ola-git-NNNNNNNN.zip image.

Raspbian Binary Package Image

Raspbian is an armhf port of Debian specifically built for the Raspberry Pi. It offers slightly better performance than the stock Debian arm port.

Use this option if you prefer a more stable system. The pre-compiled packages are usually updated once a month and you don't need to spend time building OLA from source.

Download the latest raspbian-ola-X.Y.Z.zip image.

Copying the Image

Once you have selected an image, unzip it, and then you need to copy it to your SD card. The Raspberry Pi Wiki page has detailed instructions for each platform.

This can take a while if you have a slow SD Card (see SDHC Speeds). On my Linux machine with a Class 2 card it took 14 minutes to write the 3.9G image, a Class 4 card took 11 minutes. On Mrpacketheads Macbook Pro, using the onboard SD-Card slot it took 153 seconds to write the image using dd to a Class 4 card. Your speeds are likely to vary between machines.

Starting Up

Insert the card into the Raspberry Pi, make sure it's connected to a network which has a DHCP server running, and apply power. If you have a monitor attached you should see it booting. You'll then need to determine the IP address of your Pi. If you have a screen attached it should be shown just before the login prompt. Otherwise you can check your DHCP server logs and see which address was assigned. This example assumes an IP address of 192.168.1.200.

Login using SSH

From your other machine, start your SSH client and SSH to your Pi. On Linux or Mac you can use the Terminal application and type:

ssh [email protected]

The password is 'openlighting' (no quotes).

If you're on Windows you can download PuTTY and use that.

You should see the login message and get a shell prompt. If that doesn't work, you may need to restart (pull the power and plug it in again). Sometimes the Pi gets into a weird state on the first boot.

Security

By default, the image comes with a SSH Key installed for Simon to access the system. If you trust me (and your probably do since you're running my code) you can leave this on. Otherwise you can delete my key by running:

rm .ssh/authorized_keys

Next change the password:

passwd
Changing password for ola.
(current) UNIX password: 
Enter new UNIX password: 
Retype new UNIX password: 

Resizing the Root Partition

If you're using a Raspbian based image (which you should be) there is a script raspi-config which you can use manage your system. This script can resize the partitions on the SD card so if you're using a card more than 2G you can make use of all the space. To run it type:

sudo raspi-config

and then choose the 'expand_rootfs' option.

Updating

It's best to always use the latest version of OLA. To update your install follow one of the methods below, depending on what image you used.

Git Repo

Once you're logged in, run:

cd ola
git pull
autoreconf
./configure --enable-rdm-tests
make
sudo make install

This can take a while.

Raspbian Packages

Run this:

sudo apt-get update
sudo apt-get upgrade

Differences from the default Raspbian Image

See Building a Custom Raspbian Image