Skip to content
maniacchallenge edited this page Jul 29, 2013 · 4 revisions

API for the MANIAC Challenge 2013

This repository contains code for the 2013 Maniac Challenge (API and Strategies) held at the Free University of Berlin.

What is the ManiacChallenge?

The MANIAC Challenge is a competition to better understand cooperation and interoperability in ad-hoc networks. Competing teams students/researchers come together to form a wireless ad-hoc network, while simultaneously connected to a backbone of access points. The organizers generate traffic coming from the backbone, destined to somewhere in the network. A hop-by-hop bidding contest decides the path of each data packet towards its destination.

Rules of the 2013 MANIAC Challenge

The specific focus of the MANIAC Challenge 2013 is on developing and comparatively evaluating strategies to offload infrastructure access points via customer ad hoc forwarding using handhelds (e.g., smartphones, tablets). The incentive for customers is discounted monthly fees, and the incentive for operators is decreased infrastructure costs. The idea is to demonstrate scenarios/strategies that do not degrade user experience while offering significant mobile offloading on the infrastructure.

Hardware

  • For the Backbones, we used between 8 and 23 nodes of the DES-testbed. All Backbone routers were connected to one central server, the Master. Tha Master tols the Backbones to announce traffic and logged every packet the Backbones picked up.
  • As Clients, we used Google's Nexus 7 tablets running Android 4.2.1.

software and programming languages

We used Google's ProtocolBuffer to serialize the data that is sent between Backbones and Clients.
The actual routing was done by OLSRd, the daemon for the Optimized Link State Routing Protocol.

Clients

The API for the tablets was entirely written in Java (since there's Android running on them). The Eclipse project contains a file called protoPackets.proto in its /srcfolder which specifies our protobuf message format, as well as the .java files compiled from it.

Setting up your Tablets

(TODO: gab es da nciht etwas detaillierteres von Fabian?)

To get the ad-hoc mode running on the Nexus 7, you first have to install CyanogenMod, then build your own Kernel and finally install the ManetManager, written by the SPAN-Team, but you have to root your device to use it. And finally, you have to write an App which uses the API. We provided a very simple dummy app, so can get an idea of how it can look like/work.

Backbones

The code that ran on the backbones was written in Python 2.7, and we used Twisted, an "event driven networking engine" which does a lot of magic for you.
In the backbonefolder, you'll also find a file called protoPackets_pb2.py, which is the python code complied from the .proto file mentioned in Clients. Do not touch this, as this is machine generated code. If you want to learn how to write and compile your own protobuf messages, read (TODO).

A quick note about the routers from some people who learned it the hard way: Check the version of your Wifi driver. You do not want to mess with a 4 year old implementation of Ad Hoc mode.

Master

The Code for the Master-Server was written in Go

LiveLog

We built a LiveLog so can see live what the state of the handhelds is. This was written in every language you can imagine when it comes to creating a webpage.

We hope this will help you to get started. If you have any questions, do not hesitate to contact us via (TODO)
Happy Hacking!

Clone this wiki locally