/PyBBIO

A Python library for Arduino-style hardware IO support on the Beaglebone

Primary LanguagePythonApache License 2.0Apache-2.0

PyBBIO v0.4

http://github.com/alexanderhiam/PyBBIO
Copyright (c) 2012 - Alexander Hiam - ahiam@marlboro.edu

PyBBIO is a Python library for Arduino-style hardware IO support on the TI Beaglebone. It currently supports supports basic digital IO through digitalRead() and digitalWrite() functions, as well as ADC support through analogRead() and an Arduino-style UART interface. PWM, SPI and I2C are on the way, so keep checking the Github page for updates.

#Installing

Installation is quite simple. It is assumed that your Beaglebone is already set up and configured on your network, and that you have already SSHed onto it.

Note that these instructions assume you want PyBBIO/ to live in your home directory. This is not a requirement and can changed as desired.

The first step is to install the dependencies:

# opkg update && opkg install python-mmap python-pyserial

Then you'll need to get the code:

# cd ~
# git clone git://github.com/alexanderhiam/PyBBIO.git

As of version 0.4, PyBBIO is contained in a standard Python package, so it is installed using the normal Python way:

# cd PyBBIO
# python setup.py install

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

# cd examples
# python blink.py

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

#Updating I am working as fast as I can to add support for many of the features that the Beablebone's AM3359 processor has to offer, so you'll want to make sure your version is up to date. Thanks to git this is a very simple process:

# cd ~/PyBBIO
# git pull
# python setup.py install

#License

PyBBIO is licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.