Agilla Tutorial Lesson 2: Injecting an Agent - Revision history

Liangfok: /* Step 1: Run the Agent Injector */

2007-12-10T20:01:37Z

Step 1: Run the Agent Injector

Liangfok: /* Step 1: Run the Agent Injector */

2007-12-10T19:21:33Z

Step 1: Run the Agent Injector

Liangfok: /* Step 2: Open an Agent */

2007-12-10T19:19:22Z

Step 2: Open an Agent

Liangfok: /* Step 1: Run the Agent Injector */

2007-12-10T19:18:53Z

Step 1: Run the Agent Injector

Liangfok: /* Injecting an Agent */

2007-12-10T19:18:16Z

Injecting an Agent

Liangfok at 19:09, 10 December 2007

2007-12-10T19:09:39Z

Liangfok at 16:35, 10 December 2007

2007-12-10T16:35:55Z

Liangfok: /* Step 1: Run the Agent Injector */

2007-12-10T08:08:35Z

Step 1: Run the Agent Injector

Liangfok: /* Injecting an Agent */

2007-12-10T08:07:34Z

Injecting an Agent

Liangfok: New page: Example Agilla agents can be found in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent. == Configuring the AgentInjecto...

2007-12-10T08:06:13Z

New page: Example Agilla agents can be found in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent. == Configuring the AgentInjecto...

New page

Example Agilla agents can be found in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent.

== Configuring the AgentInjector ==

The AgentInjector searches for an agilla.properties file in the directory from which you launched it. This file may contain the following properties:

<pre>
initDir=../../apps/AgillaAgents
defaultAgent=3Blink.ma
runTest=false
</pre>

* initDir specifies the directory that the open dialog should be at when it is opened for the first time.
* defaultAgent specifies the agent that should be opened when the AgentInjector starts. This agent must be located in the initDir.
* runTest specifies whether an experiment should be run. This is only used for debugging and evaluation purposes and should remain off in normal use.

== Injecting an Agent ==

To inject an agent into the network, you have open them using the AgentInjector, and select the destination location.

1. Run the Agent Injector:

@@ Line 31: / Line 31: @@
 The following GUI should appear:
-[[image:agent-injector.jpg|center|thumb|702px|The Agilla Agent Injector GUI.]]
+[[image:agent-injector-init.jpg|center|thumb|702px|The Agilla Agent Injector GUI.]]
 The main area of the GUI is a text area that contains the code of the agent that is being injected into the WSN.  Above this text area is a status bar that displays whether RMI is enabled and which port the Agent Injector is connected to.  In this case, RMI is disabled meaning agents cannot be remotely injected, and the WSN is attached to COM1.

@@ Line 33: / Line 33: @@
 [[image:agent-injector.jpg|center|thumb|702px|The Agilla Agent Injector GUI.]]
-The main area of the GUI is a text area that contains the code of the agent that is being injected into the WSN.  Above this text area is a status bar that displays whether RMI is enabled and which port the Agent Injector is connected to.  Below the text area are text boxes that allow you to specify the destination location of the agent, and displays the number of columns in the network's grid topology.  The inject button is located at the bottom of the GUI.  When this button is pressed, the Agent Injector will compile the agent and inject it into the WSN.
+The main area of the GUI is a text area that contains the code of the agent that is being injected into the WSN.  Above this text area is a status bar that displays whether RMI is enabled and which port the Agent Injector is connected to.  In this case, RMI is disabled meaning agents cannot be remotely injected, and the WSN is attached to COM1.
 === Step 2: Open an Agent ===

← Older revision		Revision as of 19:19, 10 December 2007
Line 42:		Line 42:


−	If you select this window and type Ctrl+r, all of the motes will reset themselves. This is indicated by them blinking all three LEDs. If this does not occur, ensure that a mote is correctly attached to the PC. Refer to the [[Troubleshooting Agilla\|troubleshooting section]] if you continue to have problems injecting agents.	+



	Type the address of the mote attached to the PC in the TOS Address box, and then click on the Inject Agent!! button. The 3Blink agent will then be compiled and injected into the network. Watch the mote attached to the PC. It should blink its LEDs 3 times each time you inject this agent.		Type the address of the mote attached to the PC in the TOS Address box, and then click on the Inject Agent!! button. The 3Blink agent will then be compiled and injected into the network. Watch the mote attached to the PC. It should blink its LEDs 3 times each time you inject this agent.

@@ Line 31: / Line 31: @@
 The following GUI should appear:
-[[image:agent-injector.jpg|center|thumb|702px|The Agilla AgentInjector with agent 3Blink.ma opened.]]
+[[image:agent-injector.jpg|center|thumb|702px|The Agilla Agent Injector GUI.]]
 The main area of the GUI is a text area that contains the code of the agent that is being injected into the WSN.  Above this text area is a status bar that displays whether RMI is enabled and which port the Agent Injector is connected to.  Below the text area are text boxes that allow you to specify the destination location of the agent, and displays the number of columns in the network's grid topology.  The inject button is located at the bottom of the GUI.  When this button is pressed, the Agent Injector will compile the agent and inject it into the WSN.

@@ Line 17: / Line 17: @@
 == Injecting an Agent ==
-To inject an agent into the network, you have open them using the AgentInjector, and select the destination location.
+Agents are injected into the WSN using the Agent Injector.  The following instructions describe how this is done using agent 3Blink.ma as an example.
 === Step 1: Run the Agent Injector ===
-Attach a mote to the PC and launch the AgentInjector using the appropriate COM port.  The following example assumes the mote is attached to COM1.
+Attach a mote to the PC and launch the Agent Injector using the appropriate COM port.  The following example assumes the mote is attached to COM1.
 <pre>
@@ Line 29: / Line 29: @@
 </pre>
-You should see the following GUI:
+The following GUI should appear:
 [[image:agent-injector.jpg|center|thumb|702px|The Agilla AgentInjector with agent 3Blink.ma opened.]]
-Type Ctrl+r while looking at the motes. They should all turn on all 3 LEDs on for 1 second indicating that they are resetting. If this does not occur, ensure that a mote is correctly attached to the PC. Refer to the [[Troubleshooting Agilla|troubleshooting section]] if you continue to have problems injecting agents.
+The main area of the GUI is a text area that contains the code of the agent that is being injected into the WSN.  Above this text area is a status bar that displays whether RMI is enabled and which port the Agent Injector is connected to.  Below the text area are text boxes that allow you to specify the destination location of the agent, and displays the number of columns in the network's grid topology.  The inject button is located at the bottom of the GUI.  When this button is pressed, the Agent Injector will compile the agent and inject it into the WSN.
 Type the address of the mote attached to the PC in the TOS Address box, and then click on the Inject Agent!! button. The 3Blink agent will then be compiled and injected into the network. Watch the mote attached to the PC. It should blink its LEDs 3 times each time you inject this agent.

← Older revision		Revision as of 19:09, 10 December 2007
Line 1:		Line 1:
−	Example agents ~~can be found~~ in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent.	+	Example agents are in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent.

	== Configuring the AgentInjector ==		== Configuring the AgentInjector ==

← Older revision		Revision as of 16:35, 10 December 2007
Line 1:		Line 1:
−	Example ~~Agilla~~ agents can be found in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent.	+	Example agents can be found in $TOSROOT/contrib/wustl/apps/AgillaAgents. Read the README file within this directory for a description of each agent.

	== Configuring the AgentInjector ==		== Configuring the AgentInjector ==

@@ Line 20: / Line 20: @@
 === Step 1: Run the Agent Injector ===
 <pre>
-$ java edu.wustl.mobilab.agilla.AgentInjector -comm COM1:115200 -d
+cd $TOSROOT/contrib/wustl/tools/java
 </pre>

← Older revision		Revision as of 08:07, 10 December 2007
Line 19:		Line 19:
	To inject an agent into the network, you have open them using the AgentInjector, and select the destination location.		To inject an agent into the network, you have open them using the AgentInjector, and select the destination location.

−	1. Run the Agent Injector:	+	=== Step 1: Run the Agent Injector ===
		+
		+	<pre>
		+	$ java edu.wustl.mobilab.agilla.AgentInjector -comm COM1:115200 -d
		+	</pre>