Compiling PureData patches for BeagleRT » History » Version 5
Version 4 (Christian Heinrichs, 2015-07-17 10:49 PM) → Version 5/8 (Christian Heinrichs, 2015-07-17 11:05 PM)
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/@
*6. Create a new pd project*
* Create a new folder inside the /pd directory
* The pd patch must exist in its own folder and be named *_main.pd*. You can use abstractions if you like.
h3. Using analog ins/outs
* You can directly address the analog ins and outs from within PD (note that you have to compile and run the patch onto the BeagleBone to receive the data)
* Use the [adc~] and [dac~] objects to receive and send the data
* [adc~ 3] refers to Analog Input 0 (first two channels of [adc~] are audio inputs), likewise for [dac~]
* These inputs are sampled at audio sampling rate, so handle them as you would audio signals. (Use [snapshot~] if you want to turn them into control-rate values)
* See the example patches in the /pd folder for more information
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!*
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/@
*6. Create a new pd project*
* Create a new folder inside the /pd directory
* The pd patch must exist in its own folder and be named *_main.pd*. You can use abstractions if you like.
h3. Using analog ins/outs
* You can directly address the analog ins and outs from within PD (note that you have to compile and run the patch onto the BeagleBone to receive the data)
* Use the [adc~] and [dac~] objects to receive and send the data
* [adc~ 3] refers to Analog Input 0 (first two channels of [adc~] are audio inputs), likewise for [dac~]
* These inputs are sampled at audio sampling rate, so handle them as you would audio signals. (Use [snapshot~] if you want to turn them into control-rate values)
* See the example patches in the /pd folder for more information
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!*