Getting your Raspberry Pi ready for openFrameworks
Install Raspbian "Stretch"
- Install the latest Raspbian (Debian Stretch) 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
Configure the Raspberry Pi
This guide assumes you are starting from a fresh Raspbian install and that you are able to connect to the Raspberry Pi and send it commands.
If you're installing Raspbian via NOOBS, SSH access is disabled by default since the 2016-11-25 release, which makes setup in headless mode difficult. If you don't have access to a keyboard and monitor and plan to set up from scratch in the headless mode, make sure you follow this guide and add the ssh file onto the boot partition.
You can enter commands on the Pi by:
- SSH into the Pi from a different computer
- Attach a keyboard and monitor to the Pi.
- With Stretch the Raspberry Pi now boots the X11 window system by default, open up LXTerminal from the shortcut on the Raspberry Pi Desktop
- Type in 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 Filesystemand hit Enter
7 Advanced Optionsand hit Enter
A3 Memory Splitand hit Enter
openFrameworks does not use the X11 Desktop for running OF applications. You can save GPU memory by disabling it. This is optional but suggested.
3 Boot Options
B2 Console Autologin
openFrameworks also needs to use the legacy GL driver instead of the hardware accelerated KMS drivers.
7 Advanced Optionsand hit Enter
G3 Legacyand hit Enter
- The prompt will show
The GL driver is disabled. Hit Ok.
Unlike Wheezy, Debian Jessie onwards does not display the IP address on boot. You may wish to get the current IP by typing
ifconfig. The IP address is under the eth0 entry for wired ethernet. This can possibly change on reboot.
- 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 openFrameworks and uncompress it into a folder. Using a Shell, The following commands will download openFrameworks and uncompress it into the folder
For the Raspberry Pi using OF for arm6
cd wget https://openframeworks.cc/versions/v0.10.0/of_v0.10.0_linuxarmv6l_release.tar.gz mkdir openFrameworks tar vxfz of_v0.10.0_linuxarmv6l_release.tar.gz -C openFrameworks --strip-components 1
Install packages and compile openFrameworks:
Make sure you didn't skip the Memory Split step in the above section Configure the Raspberry Pi or it will eventually fail.
The time for these steps will depend on whether you are on a RPI1, RPI2 or RPI3 and the speed of the Raspbian mirrors to download the packages.
Assuming openFrameworks is located at
/home/pi/openFrameworks run the following commands to install the necessary packages and compile openFrameworks.
cd /home/pi/openFrameworks/scripts/linux/debian sudo ./install_dependencies.sh
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
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:
cd /home/pi/openFrameworks/examples/graphics/polygonExample make make run
Unlike other platforms, OF Raspberry Pi projects do not make use of the projectGenerator. 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 cd /home/pi/openFrameworks/apps/myApps/myRpiApp make make run
It is critical to keep your application directory 3 levels below the openFrameworks directory.
Have fun! :)