Skip to content

ETHZ-TEC/Baloo

Repository files navigation

Baloo

The Baloo code is archived on Zenodo
DOI

Baloo is a design framework for network stacks based on Synchronous Transmissions (i.e., using a flooding protocol like Glossy as underlying communication primitive). Baloo is flexible enough to implement a wide variety of network layer protocols, while introducing only limited memory and energy overhead.

Using Baloo, one can relatively easily re-implement network layer protocols like the Low-power Wireless Bus, Crystal, and Sleeping Beauty.

The general concept of Baloo and its working principles have been presented in the following paper.

Synchronous Transmissions Made Easy: Design Your Network Stack with Baloo
Romain Jacob, Jonas Bächli, Reto Da Forno, Lothar Thiele
Proceedings of the 2019 International Conference on Embedded Wireless Systems and Networks (EWSN) 2019.
Direct Link

Unless explicitly stated otherwise, all Baloo sources are distributed under the terms of the 3-clause BSD license. This license gives everyone the right to use and distribute the code, either in binary or source code format, as long as the copyright license is retained in the source code.

How to cite Baloo

To cite Baloo, please use the paper listed above. If you want to cite specifically the code, please use the Zenodo archive corresponding to the version you want to cite.

Baloo
Romain Jacob, Jonas Bächli, Reto Da Forno.
Version x.y. Zenodo.
http://doi.org/10.5281/zenodo.XXXXXXX

Online presence

Disclaimer

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

This repository contains an implementation of Baloo using the Contiki-NG operating system. Some minor modifications to the original OS code where made. The list of modified files (and rational for changes, whenever appropriate) is available here.

The Baloo source files contain detailed Doxygen comments. The Doxygen documentation can be generated with the following commands

cd /tools/doxygen/
make html

This generates the complete documentation for Contiki-NG. Documentation of Baloo files can be directly accessed /tools/doxygen/html/group__gmw.html.