Crystal is an interference-resilient ultra-low power data collection protocol for wireless sensor networks
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
apps/crystal
core
cpu/msp430
exps/example
motelab/contiki_support
platform/sky
test_tools
tools
.gitignore
LICENSE
Makefile.include
README.md

README.md

Crystal

Crystal is an interference-resilient ultra-low power data collection protocol for wireless sensor networks (WSN) especially efficient in applications generating sparse aperiodic traffic. It was shown to achieve over 99.999% packet delivery ratio in presence of Wi-Fi interference with per-mille radio duty cycle in some real-world applications. Crystal uses Glossy as underlying communication and time-synchronization primitive.

Crystal got the 2nd prize at the EWSN'18 Dependability Competition!

Publications

  • Data Prediction + Synchronous Transmissions = Ultra-low Power Wireless Sensor Networks, Timofei Istomin, Amy L. Murphy, Gian Pietro Picco, Usman Raza. In Proceedings of the 14th ACM Conference on Embedded Networked Sensor Systems (SenSys 2016), Stanford (CA, USA), November 2016, PDF
  • Interference-Resilient Ultra-Low Power Aperiodic Data Collection, Timofei Istomin, Matteo Trobinger, Amy L. Murphy, Gian Pietro Picco. In Proceedings of the International Conference on Information Processing in Sensor Networks (IPSN 2018), to appear.

Status

Currently the protocol is implemented for the TMote Sky platform only. Porting it to more modern platforms is in our near future plans.

The master branch is the main development branch of Crystal. It integrates several improvements to the protocol since the IPSN'18 submission. Please contact us in case you need the exact code we used in IPSN'18 experiments. The version we used for the EWSN'18 Dependability Competition is instead published here for reference (depcomp18 branch). It contains several competition-specific tweaks and will not be updated in the future.

Disclaimer: Although we tested the code extensively, Crystal is a research prototype that likely contains bugs. We take no responsibility for and give no warranties in respect of using the code.

Build instructions

The easiest way to build a binary (or a set of binaries) is to define parameter set(s) in params.py file and use the test_tools/simgen_ta.py script.

A good starting point for defining your parameter set can be found in the exps/example/ directory. You may copy the whole directory and edit the parameters and the list of nodes present in the testbed. After that, run ../../test_tools/simgen_ta.py. It will create one or several subdirectories (if they don't exist) named after the individual parameter sets defined in the params.py file.

To build for Cooja, go to apps/crystal, run ./make_cooja.sh and start Cooja with, e.g., mrm.csc.