Recent Changes - Search:

TMON

TMON (Testbed MONitor) is a JAVA GUI developed by the University of Surrey for supporting an experimenter that wants to run experiments in one of the SmartSantander testbed sites. The GUI provides the following functions:

  • Authentication to SmartSantander testbeds;
  • Possibility to browse all the available testbed resources and selectively visualize them based on specific properties (i.e., location, type, availability for experiments, etc) by querying the underlying resource model, developed by extending the existing SSN ontology with features required from an experimenter point of view;
  • Visualize the topology information showing the relation among resources (such as link characteristics and presence of sources of interference);
  • Select the resources fulfilling the semantic and topology requirements of the experimenters;
  • Reserve the desired resources, flash them with an image to test, reset nodes and send command to them;
  • Provide a real-time visualization of the received data through the implementation of plugins that manipulate the incoming data;
  • Persistently store the data/result generated by an experiment in the SmartSantander Experiment Repository;
  • Download the log and the configuration file.

Other advanced features consist in the possibility to replay an experiment visualizing the same data collected during the original experiment using different speeds for a deeper analysis and understanding of what happened during the experiment and to repeat an experiment, using the same experiment configuration (i.e., nodes, test image, sequence of sent commands, etc).

Following, an overview of the TMON GUI and how to use it in order to run experiment on the Guildford testbed is provided.

Configuration:

Attach:tmon-config.png Δ | Figure 1: TMON Configuration

In order to configure the TMON GUI to connect to the desired SmartSantander testbed endpoint, the following steps are required:

  • Select Edit -> Preferences;
  • Use the Smart Campus tab in order to insert the desired configuration parameters, such as testbed endpoints, Experiment and Resource Repositories information.

Configuration information for each SmartSantander sites and the latest version of the TMON GUI can be requested via email to Guildford testbed administrator.

General:

Attach:tmon-config.png Δ | Figure 1: TMON GUI

For an overview of the current testbed deployment, the maps of the different available floors can be visualized. In order to do this you will need to:

  • Select File -> Connect -> Smart Campus -> then select the desired floor. In the Guildford testbed three floors are available: ground, first and second. A floor named BA Building will provide you with the overall picture of the testbed deployment with all the nodes merged in just one map.

Resource Selection:

In order to exploit the provided visual query tool for selecting resource and analyze relations (links and sources of interference between them, the "Resource Selector" needs to be enabled. This is possible through the Resource Selector button, highlighted in Figure 1.

Using the provided input box the desired resources can be selected based on type (different IoT nodes type, gateways, etc), availability for experiments, location and minimum number. Once a set of suitable resources has been identified through the Link Characteristics tab of the Resource Selector (Figure 2) the exploration of their relations in terms of link among them and characterized by a given Packet Error Rate (PER) for a specific channel and transmission power and in terms of relations between resources and environment expressed by source of interference coming from WiFi access point can be performed.

Attach:tmon-rs.png Δ | Figure 2: Resource Selector

The output of this selection will be a set of suitable resources with their relations visualized in the main panel of the GUI. The graphical conventions used in the case are the following:

  • The node shape change to a triangle in case of interference affecting the corresponding node;
  • The link color intensity depends on the link PER with darker color indicating stronger link, affected by a smaller PER value;
  • Arrows indicate the directionality of each link.

Running a simple experiment:

Attach:tmon-plugin.png Δ | Figure 3: Plug-in Selection

Once a set of suitable resources has been identified, then an experiment can be directly run by selecting all the identified resources and reserving them. The following steps are required:

  1. Log-in into the system before running experiment, just selecting the button highlighted in Figure 1 and confirm it.
  2. Select a desired nodes by simply clicking on it. Multiple nodes can be also selected at once by just dragging an area around them.
  3. Select the reservation button that allows to confirm the selected resources, specify the required time for experimentation, then through a wizard procedure configure the experiment using a set of user defined plug-in (see Figure 3).
  4. Each different plug-in relates to a different set of properties characterizing the experiment that the user can configure and it can also lead to a different way to visualize the received data. A plugin mechanism is provided in order to facilitate the basic testbed interaction operations (such as reprogramming and resetting nodes) and to also provide the user with some primitive for more advanced usage, such as interaction with the nodes through the ability to send command at run-time, parse the received messages, interact with the topology (coloring nodes, changing their shape etc etc), plot received data. Additional plug-in can be also defined by the user.

Replay of an experiment:

In case the user wants to replay an experiment, the corresponding function needs to be enabled (Green Button in the TMON GUI for Replay).

Attach:tmon-replay.png Δ | Figure 4: Experiment Replay

For replaying an experiment the following steps are required:

  1. Select the green button for opening the list of currently stored experiment. During an experiment this button can be also used for checking the status of a running experiment: an additional lines shows the experiment currently running and its status (i.e., RUNNING). Through the same tool, previously generated experiment can also be removed from the SmartSantander Experiment Repository;
  2. Select the experiment to replay and the desired replay speed;
  3. Terminate before end the replayed experiment using the Replay Stop button (Red button);

Additional info:

  • Before running specific plug-in that interact with the topology drawing tools provided by the TMON GUI, specific plug-ins for the visualization tools need to be enabled. This can be done the through the Edit menu, selecting Preferences and then toggling the desired plugin in the plugin window.
  • An example code of a plug-in reprogramming selected nodes with a specific image and visualizing on the topology specific information for each received packet can be found at the following link EnergyMeterPlugin.java Δ and described here.
Edit - History - Print - Recent Changes - Search
Page last modified on November 29, 2012, at 01:09 AM