Bela

h1.  Compiling PureData patches for BeagleRT

h2.  Getting everything up and running

Follow the following steps to get everything up and running on your Beaglebone Black:

*1. Download the _heavy-beaglert_ archive from https://code.soundsoftware.ac.uk/attachments/download/1543/heavy-beaglert_2015-07-17.zip*

* Extract the archive (and remember where you extracted it to)

*2. Make sure python is installed:*

* If you are on windows, you will need a tool that allows you to use ssh and some other basic shell tools. The shell scripts in this project have been tested with *mingw* (http://mingw.org) . You will want to note that in order to paste code on the terminal you have to right click on the terminal's title bar and navigate the menu to edit->paste

* If not on Windows, type `which python` in a terminal window. If not installed, follow instructions here: https://wiki.python.org/moin/BeginnersGuide/Download

* Install the most up-to-date version of the *requests* python package (version 2.7.0). You can get it from http://docs.python-requests.org/en/latest/user/install/

     or typing the following in a terminal window (make sure it is not currently installed):

     On Linux/MacOS:

@curl -OL https://github.com/kennethreitz/requests/zipball/master && unzip master && cd kenneth* && sudo python setup.py install@

     On Windows:

       @curl -OL https://github.com/kennethreitz/requests/zipball/master && unzip master && cd kenneth* && python setup.py install@

*3. Create an account on enzienaudio.com:*

* Go to http://www.enzienaudio.com

* Click *Login* on the top right corner of the page

* Create a new account

* Create a new patch and call it **bbb** _(N.B. compiling won't work if you use a different name)_

*4. Make sure the Beaglebone is plugged in to laptop and open a terminal window:*

* Navigate to the _sh_ folder inside the heavy_beaglert folder you created earlier @cd /path/to/beaglert_heavy/sh@

* If on OSX/Linux, run @./setup-ssh.sh@

* Or on Windows:  @./setup-ssh-windows.sh@

* when prompted for password enter letter 'a' (no quotation marks)

* @./send-project.sh@

*5. Compile your first project!*

* @./upload-and-compile.sh -f ../pd/hello-world/@

h2.  Important notes

* Make sure you aren't using any unsupported objects. For list of objects go to https://enzienaudio.com/docs/pdobjects.html

* In addition to these objects @[line~]@ and @[env~]@ are currently not supported in BeagleRT _(working on it!)_

* Pd patch must exist in its own folder and be named *_main.pd*. You can use abstractions if you like.

* See example pd patches for more information.

*Have fun!*