Getting your Raspberry Pi ready for openFrameworks
Install Raspbian "wheezy"
- Install the latest Raspbian "wheezy" image from the Raspberry Pi downloads page
- Follow the instructions at Raspberry Pi Preparing Your SD Card to get Raspbian installed onto your SD Card
- Make sure you are working with the the "hard float" version of Raspbian "wheezy", not the soft-float version (aka "Soft-float Debian "wheezy").
Configure the Raspberry Pi
This guide assumes you are starting from a fresh Raspian install and that you are able to connect to the Raspberry Pi to give it commands.
Options to give commands are:
- SSH into the Pi from a different computer
- Attach a keyboard and monitor to the Pi.
- If the Pi boots to the command prompt you are ready to go
- If the Pi boots the X11 window system, open up LXTerminal from the shortcut on the Raspberry Pi Desktop
With a fresh install the Raspberry Pi configuration is presented at the first boot. Otherwise, you can re-configure with the command
We need to make sure the CPU has 192MB of RAM in order to compile openFrameworks. Once you have compiled openFrameworks you may want to repeat this step with 128
1 Expand Filesystem and hit Enter
8 Advanced Options and hit Enter
A3 Memory Split and hit Enter
64 and Hit
- Reboot when prompted or type
- Assuming you have internet access run these commands to update the software to the latest packages.
sudo apt-get clean
sudo apt-get update
sudo apt-get upgrade
- Note: The above steps may take a little while.
You now can download the Linux armv6 version of openFrameworks and uncompress it into a folder. Using a Shell, The following commands will download openFrameworks and uncompress it into the folder
curl -O http://www.openframeworks.cc/versions/v0.8.1/of_v0.8.1_linuxarmv6l_release.tar.gz
tar vxfz of_v0.8.1_linuxarmv6l_release.tar.gz -C openFrameworks --strip-components 1
This step will take approximately 1 hour when compiling on the Raspberry Pi, Make sure you didn't skip the Memory Split step in the above section Configure the Raspberry Pi or it will eventually fail.
Assuming openFrameworks is located at
/home/pi/openFrameworks run the following commands to install the necessary packages and compile openFrameworks.
You are now ready to compile openFrameworks!
make Release -C /home/pi/openFrameworks/libs/openFrameworksCompiled/project
Speeding up compiling
Compiling natively on the Raspberry Pi takes a long time. openFrameworks applications typically take much less time than the core library. Taking the time to set up a cross-compiling solution will save you enormous amounts of time.
Compile your first app
Like on other platforms, openFrameworks ships with a bunch of examples located in the
openFrameworks/examples folder. Inside examples the projects are sorted by the categories:
Inside each category folder are a few examples of each. To run them you need to go into the folder, build and run.
For example, here is how you build and run the polygonExample:
To create your own project from scratch, copy
apps/myApps/yourProjectName folder and start from there
cp -R /home/pi/openFrameworks/examples/empty/emptyExample /home/pi/openFrameworks/apps/myApps/myRpiApp
It is critical to keep your application directory 3 levels below the openFrameworks directory.
Have fun! :)