SUNSET

Sapienza University Networking framework for underwater Simulation, Emulation and real-life Testing

 

A Brief Description



The Sapienza University Networking framework for underwater Simulation Emulation and real-life Testing (SUNSET) is a new solution, developed by the UWSN Group, to seamlessly simulate, emulate and test in real-life novel communication protocols [1]. It is based on the open source and well known network simulator ns-2 (and its extension ns2-Miracle).
Using SUNSET, anyone willing to implement and evaluate its own solution by means of the network simulator ns-2 can use the same code in emulation mode, adopting real hardware for data transmission.
The framework code has also been successfully ported on small portable devices (Gumstix, PC104 or other ARM-based systems), allowing to save energy and space when running real-life experiments.
Having the entire protocol stack almost independent from the communications devices (some constraints maybe imposed by the specific hardware used for the transmissions in terms of maximal packet size for data or control packets) gives the possibility to implement new protocol solutions in an easy and fast way. Developers and researchers can run tests changing either the selected protocols (MAC, Routing, etc.) or some protocol parameters without any changes in the external devices code and at the same time can change the configuration parameters for the selected communication hardware without any change in the actual protocol stack.
Although the proposed framework is general enough to be used for emulation and real-life testing of any kind of networks (radio, optical, underwater, etc.), it has been widely and extensively validated in the underwater environment considering different commercial underwater modems for acoustic transmissions. Moreover, it has been successfully integrated and interfaces with environmental underwater sensors (for temperature and CO2 and methane concentrations) and the navigation system of Autonomous Underwater Vehicles (AUVs).

More details can be found HERE.

Further information can be found in the following papers:

  • A detailed description of SUNSETv2 and related at sea campaigns where it has been fully used and validated:

    C. Petrioli, R. Petroccia, J. Potter and D. Spaccini. "The SUNSET framework for simulation, emulation and at-sea testing of underwater wireless sensor networks," Elsevier Ad Hoc Networks and Physical Communication, Special Issue on Advances in Underwater Communications and Networks, 2014, Accepted for publication. - [BIB] - [PDF]

  • A description of SUNSETv2 framework and the at sea campaign (Norway) where it has been fully used and validated:

    C.Petrioli, R. Petroccia and D. Spaccini. "SUNSET version 2.0: Enhanced Framework for Simulation, Emulation and Real-life Testing of Underwater Wireless Sensor Networks," in Proceedings of ACM WUWNet 2013, (Kaohsiung, Taiwan), ACM, November 11--13, 2013. - [BIB] - [PDF]

  • A description of the SUNSET framework and the several at sea campaigns where it has been used and validated:

    Chiara Petrioli and Roberto Petroccia, "SUNSET: Simulation, Emulation and Real-life Testing of Underwater Wireless Sensor Networks," in Proceedings of IEEE UComms 2012, (Sestri Levante, Italy), IEEE Computer Society, September, 12-14 2012. - [BIB] - [PDF]

  • The use of the SUNSET framework on mobile surface and underwater robots, introducing first tests at sea and the possibility to investigates the system performance using different vehicle and modem emulators through Internet:

    N. A. Cruz, B. M. Ferreira, O. Kebkal, A. C. Matos, C. Petrioli, R. Petroccia and D. Spaccini. "Investigation of Underwater Acoustic Networking Enabling the Cooperative Operation of Multiple Heterogeneous Vehicles", Marine Technology Society Journal, Vol. 47, March/April, 2013, pp. 43-58(16). - [BIB]

  • An innovative mechanism to remotely control the entire underwater network after its deployment making use of acoustic links:

    R. Petroccia and D. Spaccini, "Implementing a Back-Seat Driver to Remotely Control the Experiments in an Underwater Acoustic Sensor Network," in Proceedings of MTS/IEEE OCEANS 2013, (Bergen, Norway), IEEE Oceanic Engineering Society, June, 10-13 2013. - [BIB] - [PDF]

  • An investigation of the SUNSET performance with respect to other open source frameworks developed for Underwater Sensor Network:

    R. Petroccia and D. Spaccini, "Comparing SUNSET and DESERT Frameworks for In Field Experiments in an Underwater Acoustic Network," in Proceedings of MTS/IEEE OCEANS 2013, (Bergen, Norway), IEEE Oceanic Engineering Society, June, 10-13 2013. - [BIB] - [PDF]



Download



To download, install and use SUNSET two different options are provided:

  • SVN repository - It allows to download the SUNSET code, scripts and examples. All the additional software (ns-2, ns-Miracle, WOSS, cross-compile environment) have to be manually installed by the user.

  • Virtual machine - A complete virtual machine which already includes SUNSET and all the required software. It is based on a light and minimal Linux Debian distribution to reduce the overall size of the virtual environment (∼ 1.5GB). This solution is strongly recommended by SUNSET developers.


Improved and enhanced modules to run SUNSET in emulation and field testing mode have been designed and implemented by SUNSET developers in collaboration with industrial third parties. Unfortunately, these solutions CANNOT be all released open to the community. To provide these enhanced and improved modules to the users, we have decided to release them as compiled libraries. This allows anyone to freely and easily use the improved version of SUNSET when running in simulation, emulation and real-life mode.

The source code for all the modules needed when running simulations and the released network solutions is instead freely available. The modules released as libraries are: Packet converter modules in Core components; the Emulation components, with the exception of the Evologics and Micro-Modem drivers and the Debug_Emulation module.
The provided libraries have been compiled using as target machine the released Virtual machine and have been also added to the SVN repository. Additional libraries to run SUNSET on different architectures can be requested to SUNSET developers.


SVN Repository



The latest version of SUNSET (distributed for UNIX-based OS) can be downloaded from the following SVN repository:

http://svnreti.di.uniroma1.it/SUNSET/

To start the download just type:

svn checkout http://svnreti.di.uniroma1.it/SUNSET

If svn is not installed on your machine you need to install it. In Debian based OS you can simply run:

sudo apt-get install subversion

To install and use SUNSET, ns-2 and ns-Miracle software have to be installed.
If the Bellhop ray tracer has to be used as channel and propagation model when running simulations also the WOSS interface has to be installed. WOSS is NOT needed when running in emulation mode.

At the moment the release does not include additional modules, listed in the framework description, to control the operations of different acoustic modems, AUV navigation system and monitoring sensors. Researches and developers interested in these additional modules and possible extensions can contact the laboratory director or Roberto Petroccia.



We kindly ask researchers and developers using SUNSET for their research activities to acknowledge this paper "SUNSET: Simulation, Emulation and Real-life Testing of Underwater Wireless Sensor Networks."

We will also be glad to any developer who wants to contribute to the SUNSET framework. Read-write accounts can be provided to developers who make repeated contributions to SUNSET.





Creative Commons License

SUNSET - Sapienza University Networking framework for underwater Simulation, Emulation and real-life Testing by Roberto Petroccia (UWSN Group of SENSES Lab) is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.


All the researchers and developers using and supporting SUNSET can ask questions, solve problems and share ideas using the SUNSET user-group. Additionally details on how to register and use the group are provided HERE.


Virtual Machine



We provide also a complete virtual machine ("SUNSET.ova") that includes all the necessary tools, scripts and software to compile and run SUNSET.
You can download it from UWSN Group website at the following URL:

http://reti.dsi.uniroma1.it/UWSN_Group/framework/download/SUNSET.ova

To login use the following credentials:

  • User: sunset
  • Password: sunset
For the root user the same password is used.

All the required software (ns-2, ns-Miracle) is provided and installed together with SUNSET for the x86 architecture.
The virtual machine includes also the WOSS interface (which is already installed). It allows to connect the Bellhop ray tracing software to model the underwater acoustic channel. The environmental files used by the Bellhop ray tracer are not provided in the ".ova" file to reduce the size of the virtual machine image, but can be downloaded following the instructions provided on the WOSS web page, which is available at http://telecom.dei.unipd.it/ns/woss/.

Using the provided virtual machine, it is very simple to compile and use SUNSET in simulation and emulation modes in a controlled environment to tune the network protocol parameters and to test and improve the protocol performance. Once this preparation and improvement phase is completed, the same code can be run in emulation mode on the PC or it can be cross-compiled for the target embedded device. The compiled libraries can be then copied to and executed (using the provided scripts) on the selected ARM device during lab tests or in field (at sea) experiments.

To install the provided virtual machine, your system must satisfy the following requirements:

  • Oracle VM Virtual Box installed (see https://www.virtualbox.org/) or other virtualization software (e.g., other virtualization software supporting the use of .ova files).

  • CPU that supports PAE/NX functionality.

  • CPU that supports VT-x/AMD-V instructions.


At the moment the release does not include additonal modules, listed in the framework description, to control the operations of different acoustic modems, AUV navigation system and monitoring sensors. Researches and developers interested in these additional modules and possible extensions can contact the laboratory director or Roberto Petroccia.



We kindly ask researchers and developers using SUNSET for their research activities to acknowledge this paper "SUNSET version 2.0: Enhanced Framework for Simulation, Emulation and Real-life Testing of Underwater Wireless Sensor Networks."





Creative Commons License

SUNSET - Sapienza University Networking framework for underwater Simulation, Emulation and real-life Testing by Roberto Petroccia (UWSN Group of SENSES Lab) is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.


All the researchers and developers using and supporting SUNSET can ask questions, solve problems and share ideas using the SUNSET user-group. Additionally details on how to register and use the group are provided HERE.



Acknowledgments



Particularly acknowledgments go to:

for their collaboration and support during the development and validation of this framework.

A special thanks go to Chiara Petrioli, director of the SENSES Lab, which has contributed to the design of SUNSET and to Daniele Spaccini, member of the SENSES Lab, which has contributed to the development of the additional components listed in the framework description and to the releasing of the current version of the framework. Daniele Spaccini is also the author of some of the modules released in the current version of the SUNSET framework.