Difference between revisions of "Agilla Tutorial Lesson 1: Installation"

From Cyber-Physical Systems Laboratory
Jump to navigationJump to search
(Removing all content from page)
 
(34 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
 
The following instructions assume you have a working version of [http://www.tinyos.net TinyOS] installed on your machine. 
 
  
== Step 1: Download ==
 
Download the tarball of Agilla's source code from [[Downloading Agilla|here]].
 
 
== Step 2: Extract ==
 
Extract the files using the commands below.  By default, the files go under $TOSROOT.  On a Windows XP/Cygwin system, $TOSROOT is by default /opt/tinyos-1.x.  On a Linux or OSX machine, $TOSROOT is wherever you have installed TinyOS 1.x.
 
 
<pre>
 
mv Agilla*.tar.gz $TOSROOT
 
cd $TOSROOT
 
tar zxvf Agilla*.tar.gz
 
</pre>
 
 
Once you have extracted the tarball, Agilla's source code will be located in three directories:
 
 
* $TOSROOT/contrib/wustl/apps/Agilla: Agilla's firmware
 
* $TOSROOT/contrib/wustl/tools/java: Agilla's Agent Injector Application
 
* $TOSROOT/contrib/wustl/apps/AgillaAgents: Example Mobile Agents.
 
 
== Step 3: Create Makefile.Agilla ==
 
 
Create a file called "Makefile.Agilla" that contains local settings in $TOSROOT/contrib/wustl/apps/Agilla. To do this, you can simply copy the example file that comes with Agilla.
 
 
<pre>
 
cd $TOSROOT/contrib/wustl/apps/Agilla
 
cp Example\ Makefile.Agilla Makefile.Agilla
 
</pre>
 
 
== Downloading Pre-Packaged Versions of Agilla ==
 
 
Click [[Agilla Releases|here]] to download a tarball containing Agilla's source code.  Once you have downloaded it, you need to extract the source code.  By default, the tarball should be extracted to /opt/tinyos-1.x.
 
 
 
 
== Downloading Agilla via CVS ==
 
 
The latest version of Agilla can be downloaded using CVS. It is available through the TinyOS CVS repository located on Sourceforge. Instructions for accessing TinyOS's CVS repository are available here. Checkout module tinyos-1.x/contrib/wustl using the following command:
 
 
$ cvs -d:pserver:anonymous@tinyos.cvs.sourceforge.net:/cvsroot/tinyos login
 
$ cvs -z3 -d:pserver:anonymous@tinyos.cvs.sourceforge.net:/cvsroot/tinyos co \
 
  -P tinyos-1.x/contrib/wustl
 
 
If you are TinyOS developer, you can download it using:
 
 
$ export CVS_RSH=ssh
 
$ cvs -z3 -d:ext:developername@tinyos.cvs.sourceforge.net:/cvsroot/tinyos co \
 
  -P tinyos-1.x/contrib/wustl
 
 
See [[Agilla Tutorial 1|Tutorial 1]] for more details on how to install Agilla.
 
 
== Demo Releases ==
 
 
    * IPSN SPOTS 2005 - NesC, Java
 
 
== Remote Injection using RMI ==
 
 
RMI is used to remotely inject agents into the sensor network. To do this, you need to install this java policy file in /opt/tinyos-1.x/contrib/wustl/tools/java. See the tutorial on how to remote inject agents via RMI.
 
 
== Useful Text Editing Tools ==
 
 
For Windows users, I recommend using TextPad to edit NesC and Mobile Agent files. Here are the color-syntax configurations for NesC and Agilla Agent files:
 
 
    * NesC
 
    * Mobile Agent
 
 
Install them in <Program Files>\TextPad 4\system.
 
If you are using Linux, I recommend gEdit. Here are the syntax files:
 
 
    * NesC
 
    * Mobile Agent
 
 
Install them in /usr/share/gtksourceview-1.0/language-specs/
 

Latest revision as of 22:07, 7 April 2008