------------------------------------------------
------------------------------------------------
Pre-requisites.

1. Version of the software recommended

  If you need cross-platform compatibility (I am using
Redhat Linux with g++), please use the following GNU version of 
autoconf: 2.59
Make: 3.80
automake: 1.8.3
g++: 3.3.3

or higher

2. You need compile and install SystemC 2.0.1

------------------------------------------------
--------------------------------------------------
Installing:

1. unzip and untar the SimIt-ARM-2.1.tar.gz in an 
empty directory

2. change directory to INSTALL_DIR/SimIt-ARM-2.1/ns_arm

3. edit the entry in Makefile.am, search for SYSTEMC
   change the pointer to the systemc you have in your
   file system.

4. change directory to INSTALL_DIR/SimIt-ARM-2.1

5. type 
  
  %aclocal
  %autoconf
  %automake -a
  %./configure
  %make 



------------------------------------------------------
------------------------------------------------------
Quick Run of a 3x3 torus network with ARM PEs
---------------------------------------------------------
-------------------------------------------------------

1. change directory to INSTALL_DIR/SimIt-ARM-2.1/ns_arm

2. run 

  ./ns_arm_sim ../app/conv++/arm_test

  it should do a distributed multiplication test, printing out 
a bunch of consecutive number, then print 
"the sum is 14". 

3. If you successfully run the above test application, you 
can go ahead do more interesting parallel programming.

------------------------------------------------------
Quick Run of a beamforming application with 4 ARM PEs
---------------------------------------------------------
-------------------------------------------------------

1. change directory to INSTALL_DIR/SimIt-ARM-2.1/ns_arm

2. run 

  ./ns_arm_sim ../app/beamform/arm_test

  it should do a parallel beamform application, then print 
out the time the application takes to run. You can compare it
with the single PE version of the application by run

  ./ns_arm_sim ../app/beamform/arm_test_single

The speedup in my execution environment is about 3.668 with 4 PEs.

------------------------------------------------------
Application Specific Simulation
---------------------------------------------------------
-------------------------------------------------------
I provide a few test binary for application specific simulation. 
The source of the simulation application are in 
$INSTALL_DIR/SimIt-ARM-2.1/app.

Since these application are multi-PE based so you need a message passing
library (provided with the toolsuite) and a crosscompiler to accomplish
that. A crosscompiler can compile machine binary (for example, an ARM 
binary) on a machine with different ISA (e.g. X86).

In this case you need a GNU toolchain for the target ARM-linux you can refer
to 
 http://kegel.com/crosstool/