                                   __                 
 )\/) o  _   _ _)_  _   _   )  __  )_)  )       _   _ 
(  (  ( ) ) (  (_  )   )_) (      /__) (  (_(  )_) (  
            _)        (_                      (_   _)

This repository contains the development of my joint rate & power controller Minstrel-Blues for the Linux mac80211 subsystem. The mac80211 rate control algorithms Minstrel and Minstrel_HT are extended by my transmit power control algorithm Blues. The current development is based on my dissertation about practical ressource allocation in WiFi networks at the Technical University of Berlin.

Contributions

joint rate and power control in WiFi networks to increase spacial reuse by lowering interference to the necessary level and hence increase sum-network throughput in todays WiFi networks
cross-layer algorithm Minstrel-Blues for off-the-shelf 802.11b/g/a WiFi hardware
new joint utility function to specify user preferences for lowering transmit power with respect to throughput reduction
Linux kernel implementation, validation, performance evaluation with legacy Minstrel & Minstrel_HT

Current Goals

integration of Blues into Minstrel-HT to supprt IEEE 802.11b/g/a/n/ac hardware
get a well structured set of patches to enable Linux ubstream acceptance & final kernel intregration
validate and analyse Minstrel-Blues performance in different WiFi environments

How to use Minstrel-Blues ?

(my development environment is based on Linux OpenWrt driving embedded routers with Atheros ath5k/ath9k WiFi hardware)

get the current trunk version of OpenWrt trunk (https://openwrt.org/docs/guide-developer/source-code/start)
checkout Minstrel-Blues current version
copy all patches from the src/ath folder into your local openwrt/packages/kernel/mac80211/patches/ath
rebuild mac80211 subsystem by: make package/mac80211/{clean,compile} or re-build intire OpenWrt
install new mac80211 package by using opkg or flash full image to your router

Usage instructions to control Minstrel-Blues

TBD !

Do you want to contribute ?

Everybody can participate, and any help is highly appreciated. Feel free to send pull requests or open a new issue via GitHub.

testing Minstrel-Blues and its performance in your environment
reviewing kernel patches (get your hands on QUILT to work with patch series)

Supporters and Developers

Felix Fietkau (aka nbd) from OpenWrt/LEDE
Dennis Roeper
Stefan Venz from HFT Berlin

former contributors

Alina Friedrichsen
Bastian Bittorf from Freifunk Weimar

How to reference to Minstrel-Blues ?

Just use the following bibtex :

@PhdThesis{Huehn2013,
 author      = {Thomas H{\"u}hn},
 title       = {A Measurement-Based Joint Power and Rate Controller for IEEE 802.11 Networks},
 school      = {Technische Universit{\"a}t Berlin, FG INET Prof. Anja Feldmann},
 year        = 2013,
 month       = July,
 urn         = {urn:nbn:de:kobv:83-opus4-39397},
 url         = {http://opus4.kobv.de/opus4-tuberlin/frontdoor/index/index/docId/3939}
}

thuehn/Minstrel-Blues