###############################################################################
Advanced RTI System, ARTÌS			http://pads.cs.unibo.it
###############################################################################

©Copyright 2002-2013                      Gabriele D'Angelo, Michele Bracuto

University of Bologna	      Department of Computer Science and Engineering

http://pads.cs.unibo.it                                 <g.dangelo@unibo.it>

----------------------------------------------------------------------------
			Migration Wireless (wireless)
----------------------------------------------------------------------------

In this directory you can find a complete simulation model example. 
The wireless.c example models a set of wireless devices moving in a 
toroidal 2D space. The interactions between them are based on proximity.
The used synchronization algorithm is based on time-steps (timestepped).
The simulation model uses the APIs provided by GAIA/GAIA+, in this way
a migration-based adaptive PADS is implemented.

-------------------------------------------------------------------------------
SOURCE CODE COMPILATION:

Fist of all, it is necessary to compile the example source code, this can
be done using the provided Makefile (execute the "make" command in the 
WIRELESS directory). In case of errors, please check carefully the missing
libraries or version incompatibilities.
-------------------------------------------------------------------------------

EXECUTION:

A single main script is provided for the simulator's execution. This script
is a wrapper for other specialized scripts.

run	
	executes a single run of the simulation, it blocks until
	all LPs have finished 

	mandatory input parameters = #TOT_LP #LP #SMH
	#TOT_LP         total number of LPs in the simulation
	#LP             number of Logical Processes to execute in this host
	#SMH            total number of wireless devices (nodes) to simulate
			(e.g. each LP will simulate #SMH / #TOT_LP devices)

	example: ./run 4 4 1000
		it runs a parallel simulation composed of 4 LPs
		in which each LP models 250 nodes
		all the LPs will be executed in this host
