= 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
 * ARM (tested in MARVELL processors from [http://www.plugcomputer.org/ SheevaPlug])
 * PPC440 comming soon... 

== Downloading & Installing ==

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

The latest unstable development trunk can be found at: http://flexnets.upc.edu/svn/phal/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/      

For debian users, just type:
{{{
sudo apt-get install libreadline5-dev
}}}

Untar, compile and install: 

{{{
tar xzvf aloe-1.3.tar.gz
cd aloe-1.3
./configure
make
sudo make install
}}}


== Running an example ==

From the same directory where the source is (aloe-1.3):
{{{
runph
}}}

To run ALOE in real-time you must launch it with root permissions:
{{{
sudo runph
}}}

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
}}}

Visit [wiki:ALOELinuxGuide ALOE User Guide] for more advanced commands

[[BR]]
[[BR]]
[wiki:ALOE "[Back to ALOE]"]