FreeWTP -- An Open Source CAPWAP WTP
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Moritz Rosenthal 8e34c700a6 Added definition of GPSACP message element (#10) 6 years ago
docker-build add Dockerfile for reproducable building 6 years ago
docs Added definition of GPSACP message element (#10) 6 years ago
etc remove some left over SmaretCAPWAP messages and AC pieces 6 years ago
kernel-patches split kernel and OpenWRT/LEDE patches 6 years ago
kmod remove some left over SmaretCAPWAP messages and AC pieces 6 years ago
lib use WOLFSSL_CFLAGS from pkgconfig 6 years ago
m4 Add m4 folder 10 years ago
openwrt split kernel and OpenWRT/LEDE patches 6 years ago
src split STA deletion into immediate and delayed action 6 years ago
.gitignore Add .gitignore (based on .hgignore) 8 years ago
.hgignore Fix fragment error 8 years ago
AUTHORS update README 7 years ago
COPYING remove some left over SmaretCAPWAP messages and AC pieces 6 years ago
ChangeLog The capwap data channel migrated from userspace to kernalspace 9 years ago
INSTALL split kernel and OpenWRT/LEDE patches 6 years ago
LICENSE First commit 10 years ago
LICENSING fork SmartCAWPAP as FreeWTP 7 years ago
Makefile.am fork SmartCAWPAP as FreeWTP 7 years ago
NEWS The capwap data channel migrated from userspace to kernalspace 9 years ago
NEWS.md release v1.4.1 6 years ago
README.md split kernel and OpenWRT/LEDE patches 6 years ago
configure.ac fork SmartCAWPAP as FreeWTP 7 years ago

README.md

README

RFC-5415 and RFC-5416 compliant CAPWAP WTP implementation.

This project started as a fork of SmartCAPWAP, but has since dropped the AC part on focuses on WTP functionality only (hence the new name).

STATUS

WTP tested and working features:

Only cards with cfg80211 netlink API are supported. The following devices have been tested:

  • Atheros AR9280 (Compex WLE200NX)
  • Mediatek MT7602E, MT7612E (ZBT WG2626, ALL-WR1200AC_WRT)

Planned WTP features:

  • 802.11r - BSS fast transition
  • Hybrid-MAC (RFC-7494)

INSTALLATION

Requirements

NOTE: To run WTP you must have a wireless card that has Linux driver based on the Generic IEEE 802.11 Networking Stack (mac80211).

  • Linux 4.4 or newer
  • automake 1.9 or newer
  • autoconf
  • libconfig-dev
  • libnl-dev
  • libev-dev
  • libtool
  • wolfssl 3.8 or newer

Build

Linux Kernel:

Apply the appropriate path from kernel-patches to your kernel, enable CAPWAP WTP support and rebuild you kernel.

WolfSSL:

./configure --enable-dtls --enable-ipv6 --enable-aesgcm \
            --enable-aesccm --enable-aesni --enable-poly1305 \
            --enable-ecc --enable-ecc25519 --enable-chacha \
            --enable-supportedcurves --enable-dh --enable-psk \
            --disable-des3 --disable-arc4 --prefix=/usr/
make
make install

FreeWTP:

autoreconf -f -i
./configure --disable-ac
make
make install

Debugging / Tracing

The wtp capwap kernel module defines a number of static ftrace events. For a detailed guide on how to use those, see: https://www.kernel.org/doc/Documentation/trace/ftrace.txt

A sample trace session might lock like this:

echo 1 > /sys/kernel/debug/tracing/events/capwap/enable

echo 1 > /sys/kernel/debug/tracing/tracing_on

cat /sys/kernel/debug/tracing/trace_pipe

          <...>-890   [000] ...1 12030.725012: sc_capwap_create:  session:9e04b10c75b3c6537da18d38da5bc70d
          <...>-890   [000] ...1 12030.725048: sc_capwap_sendkeepalive:  session:9e04b10c75b3c6537da18d38da5bc70d
          <...>-890   [000] ...1 12030.725052: sc_capwap_createkeepalive:  session:9e04b10c75b3c6537da18d38da5bc70d
          <...>-890   [000] ...1 12030.725053: sc_capwap_send:  session:9e04b10c75b3c6537da18d38da5bc70d
    ksoftirqd/0-3     [000] ..s1 12030.727270: sc_capwap_parsingpacket:  session:9e04b10c75b3c6537da18d38da5bc70d skb:ffff8802306c8900
            wtp-890   [001] ...1 12060.764008: sc_capwap_sendkeepalive:  session:9e04b10c75b3c6537da18d38da5bc70d
            wtp-890   [001] ...1 12060.764530: sc_capwap_createkeepalive:  session:9e04b10c75b3c6537da18d38da5bc70d
            wtp-890   [001] ...1 12060.764637: sc_capwap_send:  session:9e04b10c75b3c6537da18d38da5bc70d
         <idle>-0     [000] ..s2 12060.787527: sc_capwap_parsingpacket:  session:9e04b10c75b3c6537da18d38da5bc70d skb:ffff8800b8a85900
            wtp-890   [001] ...1 12082.953847: sc_capwap_resetsession:  session:9e04b10c75b3c6537da18d38da5bc70d
            wtp-890   [001] ...1 12082.954005: sc_capwap_close:  session:9e04b10c75b3c6537da18d38da5bc70d
            wtp-890   [001] ...1 12082.954130: sc_capwap_freesession:  session:9e04b10c75b3c6537da18d38da5bc70d

echo 0 > /sys/kernel/debug/tracing/tracing_on