A Lesson in Scaling 6LoWPAN - Minimal Fragment Forwarding in Lossy Networks

Code and documentation to reproduce our experiment results

Code

The explicit RIOT version is included as a submodule in this repository (RIOT). It is based on the 2019.07 release of RIOT but also contains all relevant changes to conduct the experiments. The PRs these changes came from are documented within the git history. For more information use

cd RIOT
git log

The apps directory contains the RIOT applications required for the experiments, one for the data sink and one for the sources sources and forwarders. Please refer to their READMEs for their usage.

The scripts directory contains both scripts for measuring the testbed as described in Section IV-A of the paper, to conduct the experiments, and to plot their results. Please also refer to their respective READMEs for their usage.

To handle the rather specific dependencies of the scripts, we recommend using virtualenv:

virtualenv -p python3 env
source env/bin/activate

Usage

You can look into all the code and its documentation to figure everything out, but the quickest way to start the experiments (given the provided network in results/ is bookable in the IoT-LAB and all requirements on the OS side are fulfilled, see scripts README's) is to just run:

rm -rf env
virtualenv -p python3 env
source env/bin/activate
pip install -r ./scripts/experiment_ctrl/requirements.txt
./scripts/experiment_ctrl/setup_exp.sh

Documentation

Paper