Skip to content

Installing PyBBIO

Alex Hiam edited this page Apr 1, 2016 · 25 revisions

It is assumed that your Beaglebone is already set up and configured on your network, and that you have already SSHed onto it. It is also assumed that you are running a Debian or Ubuntu image, as Angstrom support is no longer guaranteed. Currently, only the 3.8 kernel is supported - it is recommended to use the official Debian 7.9 image from The following steps must be run with root privileges.

The first step is to install the dependencies:

# apt-get update && apt-get install python-serial python-setuptools python-dev python-smbus python-pip

If you are using a recent Debian image with a 3.14 kernel you will need to downgrade to the 3.8 kernel to use PyBBIO. First check you're kernel version:

# uname -r

If the printed version starts with '3.8.' you can skip this step, otherwise if it starts with '3.14.' downgrade to 3.8 with:

# apt-get update && apt-get install linux-image-3.8.13-bone79
# reboot

If you didn't have to downgrade from 3.14, make sure you have the latest 3.8 build:

# cd /opt/scripts/tools/ 
# git pull 
# ./

You should also make sure you have the Device Tree compiler. Try:

# which dtc

If nothing is printed, install dtc:

# cd /tmp/
# wget -c 
# chmod +x 
# ./ 

Use pip to install the most recent stable version:

# pip install --upgrade PyBBIO

You should be ready to go!

If you want to install the latest development version you can grab the source from Github instead:

# cd ~
# git clone git://
# cd PyBBIO
# python install

PyBBIO should now be installed correctly. Run the blink example to make sure all is well:

# cd /usr/local/lib/PyBBIO/examples
# python

And confirm that the LEDs next to the Ethernet jack labelled USR2 and USR3 are blinking back and forth.

Some PyBBIO libraries may have additional dependencies, so be sure to check their documentation pages.

##Updating I am working as fast as I can to add support for many of the features that the BeableBone's AM335x processor has to offer, so you'll want to make sure your version is up to date.

To make sure you have the latest stable release:

# pip install --upgrade PyBBIO

Again, if you want to be running the latest development code you can update with git:

# cd ~/PyBBIO
# git pull
# python install

##Uninstalling PyBBIO can be uninstalled using pip, regardless of which install method you used. Simply run:

# pip uninstall PyBBIO

If you want to fully remove all traces of PyBBIO you should also run:

# rm -r /lib/firmware/PyBBIO-* /usr/local/lib/PyBBIO
You can’t perform that action at this time.