Bela

h1.  Compiling projects with BeagleRT

This document contains information on how to compile the BeagleRT software and upload it onto the BeagleBone Black.

h2. Required tools

This document assumes you have the following tools installed:

* Working Linux system, either running natively or on a virtual machine

* Mercurial version control system (http://mercurial.selenic.com). Available as a package in most Linux distributions.

* arm-gcc hardfp compiler toolchain (i.e. @arm-linux-gnueabihf-gcc@ and similar. On Ubuntu, these can be installed from packages:

<pre>

sudo apt-get install gcc-arm-linux-gnueabihf

sudo apt-get install g++-arm-linux-gnueabihf

</pre>

* Eclipse IDE (http://www.eclipse.org), including the C/C++ development tools

* Xenomai libraries compiled for ARM hardfp _(details to come)_

h2. Getting started

# Clone the BeagleRT files from the repository:

<pre>

hg clone https://code.soundsoftware.ac.uk/hg/beaglert

</pre>

# Launch Eclipse and select a workspace (creating one if necessary).

# In the Eclipse menu bar, choose _File -> Import..._. Within the dialog box that appears, choose _General -> Existing Projects into Workspace_. Click _Next_.

# Click the button _Select root directory_ and choose the path to the BeagleRT repository you just cloned.

# Make sure the @BeagleRT@ project is selected, and under Options, untick _Copy projects into workspace_. Click _Finish_ to complete the project import.

h2. Compiling the BeagleRT project

# In Eclipse, right-click on the @BeagleRT@ project folder in the left-hand column, and choose _Build Project_. (If you don't see the list of projects, make sure the C/C++ Perspective is active in Eclipse, and choose _Window -> Show View -> Project Explorer_.)

# The project should compile without errors, and the results should be visible in the Console tab (typically in the bottom pane of the window)

# If any errors arise, check that you have all the dependencies installed, both header files and libraries.

h2. Copying BeagleRT projects to the BeagleBone Black

# Once the project has compiled, open a terminal window and @cd@ to the directory where the binary was compiled. For example, if you installed BeagleRT in your home directory: @cd ~/BeagleRT/Release@

# Copy the BeagleRT executable to the BeagleBone Black using @scp@ (entering your BeagleBone Black password when prompted; you may need to create the @beaglert@ directory first):

<pre>

scp BeagleRT root@192.168.7.2:~/beaglert/

</pre>

# The first time you install BeagleRT, you also need to copy the @pru_rtaudio.bin@ file to the BeagleBone Black. This can be found at the top level of the BeagleRT repository, and it should be copied to the same directory on the BeagleBone where the BeagleRT executable is located:

<pre>

scp pru_rtaudio.bin root@192.168.7.2:~/beaglert/

</pre>