Skip to content

Latest commit

 

History

History
67 lines (47 loc) · 2.35 KB

README.md

File metadata and controls

67 lines (47 loc) · 2.35 KB
Raw

PyBBIO v0.5

http://github.com/alexanderhiam/PyBBIO
Copyright (c) 2012 - Alexander Hiam - [email protected]

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

Documentation at http://github.com/alexanderhiam/PyBBIO/wiki

#Installing

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-distutils 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 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.