Rohan-Kadam / WLANController

Extending the openCAPWAP v2.0 and hostapd project. Modifications are intended to make it more suitable for SDN paradigm.

WLANController

===================================================================================

-- Extending the openCAPWAP v2.0 and hostapd project

-- Modifications are intended to make it more suitable for SDN paradigm.

===================================================================================

A] About openCAPWAP v2.0 project:

Base Project link: https://github.com/vollero/openCAPWAP

Open source implementation of the CAPWAP protocol according to RFC 4515 and RFC 4516. It supports both SplitMAC and LocalMAC operational architectures.

For further informations please refer to:
"OpenCAPWAP v2.0: the new open-source implementation of the CAPWAP protocol", E. Agostini, M. Bernaschi, M. Vellucci, L. Vollero International Journal of Network Management 2016, Volume 26, Issue 6, Pages 537–552

Wiley Online Library
ResearchGate

Requirements

This version has been tested on Linux Debian distro 32-bit. You need to install the following libraries:

libnl-3-dev
libnl-3-genl-dev
libssl-dev

In order to run the WTP software, you must have a wireless card with AP mode available (check with iw)

Installing

Within the capwap folder, type:

cd 5GTB-Wifi-Management-master/capwap
make clean
make

Running

For further info, please refer to the INSTALL file in capwap folder. This file explains how to build and run WTP and AC executables.

Quick commands to run the program after successful compilation (Recommended to follow INSTALL file):

cd 5GTB-Wifi-Management-master
sudo ./clean.sh
cd capwap
sudo ./AC .
sudo ./WTP .

The WTP and AC logs are created at "/var/log". You can open up the logs in separate terminal windows using:

tail -f /var/log/ac.log.txt
tail -f /var/log/wtp1.txt

Notes

OpenCAPWAP doesn't provide any type of DHCP service or IP assignation to associated stations, that is you must have a DHCP server active. When a client station associates with the WTP's AP interface, it starts to send DHCP Discovery messages. If you are using the SPLIT MAC mode, you must create a bridge between AC's network interface (ethernet or wireless) and the AC's tap interface. If you are using the LOCAL MAC mode, you must create a bridge between the WTP's AP interface and the ethernet interface. The DHCP server must be reachable from WTP's ethernet (LOCAL MAC) or AC's ethernet (SPLIT MAC).

B] About hostapd project:

Base project link: https://w1.fi/hostapd/