Skip to content

acmdorio/mininet-wifi

 
 

Repository files navigation

About Mininet-WiFi

Mininet-WiFi is a fork of Mininet (http://mininet.org/) which allows the using of both WiFi Stations and Access Points. Mininet-WiFi only add wifi features and you can work with it like you were working with Mininet.

Build Status

Things to keep in mind when working with Mininet-WiFi

  • You can use any wireless network tools (e.g. iw, iwconfig, wpa_supplicant, etc)
  • Please consider computer network troubleshooting steps to solve issues before making questions in the mailing list (e.g. is the station associated with ap? Is the OpenFlow rule working correctly? etc)
  • Do you need help? Be careful with questions in the mailing list and please providing as much information you can.

Mailing List

https://groups.google.com/forum/#!forum/mininet-wifi-discuss

Use Cases Catalogue

Please, let us know if you are doing research with Mininet-WiFi. A list of citations on Mininet-WiFi is available here.  

Installation

We highly recommend using Ubuntu version 16.04 or higher. Some new hostapd features might not work on Ubuntu 14.04.
step 1: $ sudo apt-get install git
step 2: $ git clone https://github.com/intrig-unicamp/mininet-wifi
step 3: $ cd mininet-wifi
step 4: $ sudo util/install.sh -Wlnfv

install.sh options:

-W: wireless dependencies
-n: mininet-wifi dependencies
-f: OpenFlow
-v: OpenvSwitch
-l: wmediumd
optional:
-P: P4 dependencies
-6: wpan tools

Building Topologies with GUI

I'm a beginner, I do not know Python and I would like to create a customized topology. In this case, both MiniEdit and VND can serve as support since they provide a GUI to generate Python scripts.

Development

For instructions about easier development check this helper file.

Pre-configured Virtual Machine

For your convenience, we provide pre-built VM images including Mininet-WiFi and other useful software. The VM images are in .ova format and should be usable with any modern x64 virtualization system.

[2.9GB Size] - Ubuntu 18.04 x64 - Mininet-WiFi (pass: wifi)
[6.8GB Size] - Ubuntu 18.04 x64 - Mininet-WiFi/ONOS/P4 (pass: wifi)

Note

Mininet-WiFi should work fine in any Ubuntu distribution from 14.04, but in some cases (only if you have problems when start it) you have to stop NetworkManager with stop network-manager (you can also use sudo systemctl stop network-manager or sudo service network-manager stop).

Book

We are glad to announce that the Mininet-WiFi book has been published!

Here is the pointer to the book:

Printed and e-Book version: https://mininet-wifi.github.io/book/ - Available in English and Portuguese

Github repository with all use cases presented in the book:
https://github.com/ramonfontes/mn-wifi-book-pt

Team

Ramon dos Reis Fontes (ramonrf@dca.fee.unicamp.br)
Christian Rodolfo Esteve Rothenberg (chesteve@dca.fee.unicamp.br)

We are members of INTRIG (Information & Networking Technologies Research & Innovation Group) at University of Campinas - Unicamp, SP, Brazil.

About

Emulator for Software-Defined Wireless Networks

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 89.3%
  • C 5.5%
  • Shell 4.9%
  • Makefile 0.3%