ALOE Quick Start Guide

This page describes how to download, install and run an example waveform for ALOE for Linux OS.

Supported processors are:

• x86_32
• x86_64
• ARM (tested in MARVELL processors from SheevaPlug)
• PPC440 comming soon...

Downloading & Installing

Download source from http://flexnets.upc.edu/downloads/source/aloe-1.4.1.tar.gz or check last svn tag releases at: http://flexnets.upc.edu/svn/phal/tags/

Alternatively, but not recommended, you can also download the latest developing trunk version:

svn co http://flexnets.upc.edu/svn/trunk

Before installing, make sure you have the following libraries in your system:

• readline (4.0 should be fine)
  • ftp://ftp.gnu.org/gnu/readline/
• termcap
  • ftp://ftp.gnu.org/gnu/termcap/
• jack

For debian users, just type:

sudo apt-get install libreadline5-dev
sudo apt-get install libjack-dev qjackctl libjack0 jack jackd jack-tools

In a fedora distribution, use yum to install the libraries:

sudo yum install readline-devel

Untar, compile and install:

tar xzvf aloe-1.4.1.tar.gz
cd aloe-1.4.1
./configure
make
sudo make install

Before running ALOE, we must tune some kernel parameters to enable large messages buffers. You can use sysctl to make changes permanently, add the following lines to /etc/sysctl.conf

kernel.msgmnb=1048576
kernel.msgmax=10485760
kernel.msgmni=128

And run sysctl with root permissions:

sudo /sbin/sysctl -p

Running an example

From the same directory where the source is (aloe-1.4.1):

runph

To run ALOE in real-time you must launch it with root permissions:

sudo runph

Note that since ALOE executables are installed in /usr/local/bin, make sure this path is accessible from sudo (visudo command).

And in the runph prompt:

runph$: phload example
runph$: phinit example
runph$: phrun example

And your waveform is running!

You can now view information about execution time:

runph$: execinfo example

You can list available statistics and view/modify them:

runph$: statlist example
runph$: statget example source numbits
runph$: statset example source numbits 512

aloeUI

To run the aloeUI start runph as a daemon and then run aloeui.run command from the aloe-1.4 directory

sudo runph --daemon
./aloeui.run

Remember to kill background ALOE processes when you finish. After closing the GUI, type:

sudo killph

[Back to ALOE]