[Tinyos-contrib-commits]
CVS: tinyos-1.x/contrib/wustl/websites/agilla/docs/tutorials
1_installation.html, 1.6, 1.7
Chien-Liang Fok
chien-liang at users.sourceforge.net
Wed Oct 11 00:36:52 PDT 2006
Update of /cvsroot/tinyos/tinyos-1.x/contrib/wustl/websites/agilla/docs/tutorials
In directory sc8-pr-cvs10.sourceforge.net:/tmp/cvs-serv14261/agilla/docs/tutorials
Modified Files:
1_installation.html
Log Message:
modified instructions to not use Agilla aliases.
Index: 1_installation.html
===================================================================
RCS file: /cvsroot/tinyos/tinyos-1.x/contrib/wustl/websites/agilla/docs/tutorials/1_installation.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** 1_installation.html 19 May 2006 20:23:00 -0000 1.6
--- 1_installation.html 11 Oct 2006 07:36:50 -0000 1.7
***************
*** 1,286 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
! <html><!-- InstanceBegin template="/Templates/Main.dwt" codeOutsideHTMLIsLocked="false" -->
! <head>
! <!-- InstanceBeginEditable name="doctitle" -->
!
! <title>Agilla</title>
!
! <!-- InstanceEndEditable -->
! <link rel="stylesheet" href="../../styles.css" type="text/css" />
! <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
! <!-- InstanceBeginEditable name="head" -->
!
! <!-- InstanceEndEditable -->
! </head>
!
! <body>
!
! <!-- InstanceBeginEditable name="MainText" -->
!
! <h1>Lesson 1: Agilla Installation</h1>
! <p><em>Last Updated on
! <!-- #BeginDate format:Am1a -->May 18, 2006 4:54 PM<!-- #EndDate -->
! .</em></p>
! <p><strong>Note:</strong> As of 11/03/2005, the latest version of Agilla
! is distributed through TinyOS's CVS repository. For instructions
! on how to install previous versions, click <a href="1_installation_pre3.html">here</a>.</p>
! <ol>
!
! <li>Install <a href="http://www.tinyos.net/">TinyOS</a> and upgrade
!
! it to the most recent version, which, as of this writing, is 1.1.15.</li>
!
! <li>Download Agilla according to the instructions <a href="../../download/index.html">here</a>.</li>
! <li>Add WUROOT and AGILLA environment variables pointing to Agilla's
! firmware and Washington University's contrib directory. <br>
! <br>
! bash:<br>
! <pre class="screen">$ export WUROOT=$TOSROOT/contrib/wustl
! $ export AGILLA=$WUROOT/apps/Agilla
! </pre>
! <br>
! csh:
! <br>
!
! <pre class="screen">$ setenv WUROOT $TOSROOT/contrib/wustl
! $ setenv AGILLA $WUROOT/apps/Agilla
! </pre>
! </li>
! <li><a name="makefile_agilla"></a>Create a <var><code>Makefile.Agilla</code></var> file
! containing local settings within <code>$TOSROOT/contrib/wustl/apps/Agilla</code>.
! Simply copy the example file
! included with Agilla:<br>
! <br>
! <pre class="screen">
! $ cd $AGILLA<br>$ cp Example\ Makefile.Agilla Makefile.Agilla</pre>
! <br>
! See <code>$TOSROOT/contrib/wustl/apps/Agilla/README</code> for details
! on how to customize Makefile.Agilla.</li>
! <li><a name="cricketbaud"></a> In order for Mica2 and
! MicaZ motes to communicate with Cricket motes, you need to change
! their UART ports to operate
! at 115.2kbps (the default is 57.6kbps). To change this,
! open <code>tinyos-1.x/tos/platforms/<platform>/HPLUART0M.nc</code> and
! change <code>outp(15, UBRR0L);</code><br>
! to <code>outp(7, UBRR0L);</code>.</li>
! <li>Install and configure a <a href="../../download/Makelocal">Makelocal</a> file
! in <code>$TOSROOT/tools/make</code>.</li>
! <li>Add the following aliases to <code>/etc/profile</code>. <a name="AgillaAliases"></a><br>
! <pre class="screen">
! # Agilla Aliases
! alias cda="cd $AGILLA"
! alias cdaj="cd $WUROOT/tools/java/edu/wustl/mobilab/agilla"
! alias ri="java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -comm COM1:57600 -d &"
! alias ri_sim="java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -comm tossim-serial -d &"
! alias ri_nc="java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -nc -d &"
! alias ri_rmi="java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -comm RMI:localhost -d &"
! alias mj="cd $WUROOT/tools/java/edu/wustl/mobilab/agilla; javac *.java"
! alias riall_m2="cd $AGILLA; gawk -f installer_m2.awk"
! alias riall_mz="cd $AGILLA; gawk -f installer_mz.awk"
! </pre>
! <p>These aliases allow you to quickly compile and install Agilla.
! Here is a brief description of each:
! <ul>
! <li>cda - change directory to Agilla's NesC code</li>
! <li>cdaj - change directory to Agilla's Java code (the agent
! injector)</li>
! <li>ri - run injector on COM1. The programming board must be
! connected to the specified serial port. <strong><font color="#FF0000">Be
! sure to set the correct COM port!</font></strong> </li>
! <li>ri_sim - run injector, simulation. Connects to the TOSSIM
! running locally. See <a href="9_debug.html">debugging</a> for
! more information on how to use this.</li>
! <li>ri_nc - runs the injector without connecting to anything.
! Allows you to compile an agent into NesC code, which can
! then be simulated. See <a href="9_debug.html">debugging</a> for
! more information on how to use this.</li>
! <li>mj - make java, recompiles the Agent Injector without re-generating
! the message files</li>
! <li>riall_m2 - reinstall all mica2 - runs the script that reinstalls
! Agilla's NesC code on all mica2 motes</li>
! <li>riall_mz - reinstall all micaz - runs the script that reinstalls
! Agilla's NesC code on all micaz motes</li>
! </ul>
! <p>These aliases allow you to quickly compile and install Agilla.
!
! Here is a brief description of each:
!
! <ul>
!
! <li>cda - change directory to Agilla's NesC code</li>
!
! <li>cdaj - change directory to Agilla's Java code (the agent injector)</li>
!
! <li>ri - run injector. The programming board must be connected to the
!
! specified serial port. <strong><font color="#FF0000">Be sure to set the
!
! correct COM port!</font></strong> </li>
!
! <li>ri_sim - run injector, simulation. Connects to the TOSSIM running
!
! locally. See <a href="9_debug.html">debugging</a> for more information
!
! on how to use this.</li>
!
! <li>ri_nc - runs the injector without connecting to anything.
!
! Allows you to compile an agent into NesC code, which can
!
! then be simulated. See <a href="9_debug.html">debugging</a> for
!
! more information on how to use this.</li>
!
! <li>mj - make java, recompiles the Agent Injector without re-generating
!
! the message files</li>
!
! <li>riall_m2 - reinstall all mica2 - runs the script that reinstalls
!
! Agilla's NesC code on all mica2 motes</li>
!
! <li>riall_mz - reinstall all micaz - runs the script that reinstalls
!
! Agilla's NesC code on all micaz motes</li>
!
! </ul>
! <p>For additional convenience, I recommend adding the following
! additional aliases to the profile file for navitgating around
! TinyOS in general: </p>
! <pre class="screen">
! alias cdj="cd $TOSROOT/tools/java"
! alias cdtos="cd $TOSROOT"
! alias cdapps="cd $TOSROOT/apps"
! alias runsf_pc="java net.tinyos.sf.SerialForwarder -comm tossim-serial &"
! alias runsf_com1="java net.tinyos.sf.SerialForwarder -comm serial at COM1:mica2 &"</pre>
! </li>
!
! <li><a href="../../download/Makelocal">Download</a> the makelocal file
! and install it in <code><tos>/tools/make</code>. Customize it
! for your local settings. </li>
!
!
!
! <li>Customize the number of rows and
!
! columns in your network (see <a href="../network_topology.html">Customizing
!
! the Network Topology</a>).</li>
! <li><strong><font color="#FF0000">Attention MicaZ users:</font></strong> As
!
! of TinyOS 1.1.14, you have go into <tos>/tos/system/Reset.h
!
! and add <font face="Courier New, Courier, mono"><br>
!
! <br>
!
! </font><code>|| defined (PLATFORM_MICAZ) </code><br>
!
! <br>
!
! to the end of line 47. This allows the user to remote reset the motes.</li>
!
! <li>Install the Agilla NesC code on every mote, including the basestation.
! Before using the installation scripts, customize <em><code><agilla>/installer_m2.awk</code></em> or <em><code><agilla>/installer_mz.awk</code></em>!
! Specifically, change the programming board and COM port settings
! on line 20 to fit your setup.<font face="Courier New, Courier, mono"><br>
! <br>
! </font>For Mica2 motes, type: <code>riall_m2</code><font face="Courier New, Courier, mono"> <br>
! </font>For MicaZ motes, type: <code>riall_mz</code><font face="Courier New, Courier, mono"><br>
! <br>
! </font>Follow the on-screen instructions. Besure to select 'y'
! when prompted to recompile for the first time. You should see something
! like:<br>
!
! <br>
!
! <img src="../install.jpg" width="748" height="847"><br><br>
! If you did not add the Agilla aliases to your profile, you can manually install
!
! agilla by typing the following:<br>
!
! <pre class="screen">$ cda
! $ make [platform] reinstall.[id][programming board],[port]</pre>
!
! <br>where <em><code>[platform]</code></em>is
!
! the target platform (e.g., mica, mica2, mica2dot, or micaz), <font face="Courier New, Courier, mono"><em><code>[id]</code></em></font> is
!
! the mote ID, <em><font face="Courier New, Courier, mono"><code>[programming
!
! board]</code></font></em> is the programming board (e.g., <code>MIB510</code>), and <em><code>[<font face="Courier New, Courier, mono">port</font>]</code></em> is
!
! the serial port the programming board is attached to (e.g., <code>COM1</code>). <br>
! </li>
! <li><a name="AgentInjector"></a>The AgillaAgentInjector is a program written
! in Java that allows users to inject mobile agents in to the wireless sensor
! network. It is located
! in $WUROOT/tools/java/edu/wustl/mobilab/agilla. The main class is <code>edu.wustl.mobilab.agilla.AgentInjector</code>.
! Before compiling the AgentInjector, make sure the base directory $WUROOT/tools/java
! is in the $CLASSPATH.<br>
! <br>
!
! <pre class="screen">$ echo $CLASSPATH</pre>
!
! If it is not in the classpath, add it to the path:
!
! <pre class="screen">export CLASSPATH=$CLASSPATH\;C:\\tinyos\\cygwin\\opt\\tinyos-1.x\\contrib\\wustl\\tools\\java</pre>
! Then go into <code>$WUROOT/tools/java/edu/wustl/mobilab/agilla,</code> copy
! the file "Example Makefile.Agilla" into "Makefile.Agilla, and
! compile the AgentInjector:<br>
! <pre class="screen">$ cd $WUROOT/tools/java/edu/wustl/mobilab/agilla
! $ cp Example\ Makefile.Agilla Makefile.Agilla
! $ make</pre>
! </li>
! <li>If you want to use RMI to remotely inject mobile
!
! agents, download <a href="../../download/java.policy">java.policy</a> and
!
! install it in <code><tos>/tools/java</code>. </li>
! <li>Test the installation by installing mote 0 on the programming
! board and launching the rmi registry and AgentInjector: <br>
! <ol>
! <li>Open a new command window, and type <em><code>rmiregistry</code></em><code> as
! shown below:</code><br>
! <br>
! <img src="../rmiregistry.jpg" width="508" height="199"><br>
! <br>
! <strong>Note</strong>: If you get a <em><code>java.rmi.RemoteException:
! failed to export: class gnu.java.rmi.dgc.DGCImpl</code> </em>error,
! be sure your path is set to point to the correct version
! of rmiregistry. On a Windows system running Cygwin, it
! is usually <code>/cygdrive/c/tinyos/jdk1.4.1_02/j2sdk1.4.1_02/bin/rmiregistry</code>.<br>
! </li>
! <li>In the original command window, type <em><code>ri</code></em>.
! You should see:<br>
! <br>
! <img src="injector.jpg" width="510" height="496"><br>
! <br>
! Note: If you do not have the aliases configured, you can start the AgentInjector
! manually by typing:<br>
! <br>
! <pre class="screen">$ java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -comm COM1:57600 -d &</pre>
! <br>
! First hit <em><code>Ctrl+r</code></em> while looking at the motes. All motes
! should blink all 3 LEDs on for 1 second indicating that they are resetting.
! If this does not occur, check to ensure mote (0,0) is correctly seated on
! the programming board and hit the programming board's reset button.<br>
! <br>
! You are now ready to inject mobile agents into the sensor network!</li>
! </ol>
! <br>
!
! </li>
!
! </ol>
!
! <!-- InstanceEndEditable -->
! <hr>This work is supported by the <a href="http://formal.cs.uiuc.edu/contessa">ONR MURI Project CONTESSA</a>
! and the <a href="http://www.nsf.gov/">NSF</a> under grant number CCR-9970939.
! </body>
! <!-- InstanceEnd --></html>
--- 1,150 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
! <html><!-- InstanceBegin template="/Templates/Main.dwt" codeOutsideHTMLIsLocked="false" -->
! <head>
! <!-- InstanceBeginEditable name="doctitle" -->
!
! <title>Agilla</title>
!
! <!-- InstanceEndEditable -->
! <link rel="stylesheet" href="../../styles.css" type="text/css" />
! <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
! <!-- InstanceBeginEditable name="head" -->
!
! <!-- InstanceEndEditable -->
! </head>
!
! <body>
!
! <!-- InstanceBeginEditable name="MainText" -->
!
! <h1>Lesson 1: Agilla Installation</h1>
! <p><em>Last Updated on
! <!-- #BeginDate format:Am1a -->October 11, 2006 2:35 AM<!-- #EndDate -->
! .</em></p>
! <p><strong>Note:</strong> As of 11/03/2005, the latest version of Agilla
! is distributed through TinyOS's CVS repository. For instructions
! on how to install previous versions, click <a href="1_installation_pre3.html">here</a>.</p>
! <ol>
!
! <li>Install TinyOS. I recommend using the CVS version of TinyOS and
! have posted instructions on how to install it <a href="http://www.cse.wustl.edu/%7Eliang/tinyos-install/">here</a>.
! If you already have TinyOS installed, be sure to grab <a href="http://www.cse.wustl.edu/%7Eliang/tinyos-install/windows/washu.sh">washu.sh</a> and put it in /opt/profile.d/</li>
!
! <li>Download Agilla according to the instructions <a href="../../download/index.html">here</a>.</li>
! <li>Create a <var><code>Makefile.Agilla</code></var> file
! containing local settings within <code>$TOSROOT/contrib/wustl/apps/Agilla</code>.
! Simply copy the example file
! included with Agilla:<br>
! <br>
! <pre class="screen">
! $ cd $TOSROOT/contrib/wustl/apps/Agilla<br>$ cp Example\ Makefile.Agilla Makefile.Agilla</pre>
! <br>
! See <code>$TOSROOT/contrib/wustl/apps/Agilla/README</code> for details
! on how to customize Makefile.Agilla.</li>
! <li><a name="cricketbaud"></a> In order for Mica2 and
! MicaZ motes to communicate with Cricket motes, you need to change
! their UART ports to operate
! at 115.2kbps (the default is 57.6kbps). To change this,
! open <code>$TOSROOT/tos/platforms/<platform>/HPLUART0M.nc</code> and
! change <code>outp(15, UBRR0L);</code><br>
! to <code>outp(7, UBRR0L);</code>.</li>
! <li>Install and configure a <a href="../../download/Makelocal">Makelocal</a> file
! in <code>$TOSROOT/tools/make</code>.</li>
! <li><a href="../../download/Makelocal">Download</a> makelocal to <code>$TOSROOT/tools/make</code>.
! Customize it to your liking, e.g., choose the appropriate radio
! frequency and group id.</li>
! <li>Install Agilla onto every mote including the
! basestation. Be sure that every mote has a unique TinyOS address.<br>
! <br>
!
! <pre class="screen">$ cd <code>$TOSROOT/contrib/wustl/apps/Agilla/</code>
! $ make [platform]
! $ make [platform] reinstall.[id][programming board],[port]</pre>
! <br>
! For example, if you have a TelosB mote on COM5 that you want
! to have TinyOS address 0, you would use the following commands:<br>
! <br>
! <pre class="screen">$ cd <code>$TOSROOT/contrib/wustl/apps/Agilla/</code>
! $ make telosb
! $ make telosb reinstall.0 bsl,4</pre>
! <br>
! As another example, if you have a Mica2 mote on COM1 that you
! want to program with Agilla and TinyOS address 1, you would use
! the
! following
! commands:<br>
! <br>
! <pre class="screen">$ cd <code>$TOSROOT/contrib/wustl/apps/Agilla/</code>
! $ make mica2
! $ make mica2 reinstall.1 mib510,/dev/ttyS0</pre>
! </li>
! <li><a name="AgentInjector"></a>Agilla's AgentInjector is Java a
! program that allows users to inject mobile agents
! in to
! a wireless sensor
! network. It is located
! in $TOSROOT/contrib/wustl/tools/java/. The main
! class is <code>edu.wustl.mobilab.agilla.AgentInjector</code>.
! Before compiling the AgentInjector, make sure the directory $TOSROOT/contrib/wustl/tools/java
! is in the $CLASSPATH. <br>
! <br>
! Then go into <code>$TOSROOT/contrib/wustl/tools/java/edu/wustl/mobilab/agilla
! and</code> copy
! the file "Example Makefile.Agilla" into "Makefile.Agilla".<br>
! <pre class="screen">$ cd $TOSROOT/contrib/wustl/tools/java/edu/wustl/mobilab/agilla
! $ cp Example\ Makefile.Agilla Makefile.Agilla
! $ make</pre>
! Finally, compile the AgentInjector: <br>
! <pre class="screen">$ make</pre>
! This will generate all of Agilla's messages using mig and compile the
! AgentInjector.</li>
! <li>If you want to use RMI to remotely inject mobile
!
! agents, download <a href="../../download/java.policy">java.policy</a> and
!
! install it in <code><tos>/tools/java</code>. </li>
! <li>Test the installation by installing mote 0 on the programming
! board and launching the AgentInjector: <br>
! <ol>
! <!-- <li>Open a new command window, and type <em><code>rmiregistry</code></em><code> as
! shown below:</code><br>
! <br>
! <img src="../rmiregistry.jpg" width="508" height="199"><br>
! <br>
! <strong>Note</strong>: If you get a <em><code>java.rmi.RemoteException:
! failed to export: class gnu.java.rmi.dgc.DGCImpl</code> </em>error,
! be sure your path is set to point to the correct version
! of rmiregistry. On a Windows system running Cygwin, it
! is usually <code>/cygdrive/c/tinyos/jdk1.4.1_02/j2sdk1.4.1_02/bin/rmiregistry</code>.<br>
! </li> -->
! <li>In the original command window, type <em><code>ri</code></em>.
! You should see:<br>
! <br> <pre class="screen">$ cd $TOSROOT/contrib/wustl/tools/java
! $ java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -comm COM1:57600 -d &</pre>
! <br><img src="injector.jpg" width="510" height="496"><br>
! <br>
! Note: If you do not have the aliases configured, you can start the AgentInjector
! manually by typing:<br>
! <br>
! <pre class="screen">$ java -Djava.security.policy=java.policy edu.wustl.mobilab.agilla.AgentInjector \
! -comm COM1:57600 -d &</pre>
! <br>
! First hit <em><code>Ctrl+r</code></em> while looking at the motes. All motes
! should blink all 3 LEDs on for 1 second indicating that they are resetting.
! If this does not occur, check to ensure mote (0,0) is correctly seated on
! the programming board and hit the programming board's reset button.<br>
! <br>
! You are now ready to inject mobile agents into the sensor network!</li>
! </ol>
! <br>
!
! </li>
!
! </ol>
!
! <!-- InstanceEndEditable -->
! <hr>This work is supported by the <a href="http://formal.cs.uiuc.edu/contessa">ONR MURI Project CONTESSA</a>
! and the <a href="http://www.nsf.gov/">NSF</a> under grant number CCR-9970939.
! </body>
! <!-- InstanceEnd --></html>
More information about the Tinyos-contrib-commits
mailing list