/DAWN

Decentralized WiFi Controller

Primary LanguageCGNU General Public License v2.0GPL-2.0

DAWN PICTURE

DAWN

Decentralized WiFi Controller

Installation

You need full wpad installation and not wpad-basic.

See installation.

LuCI App

There is an luci app called luci-app-dawn.

Setting up Routers

You can find a good guide to configure your router is here. I setup the OpenWRT Router as dumb APs.

Configuration

Option Standard Meaning
ht_support '10' If AP and station support high throughput.
vht_support '100' If AP and station support very high throughput.
no_ht_support '0' If AP and station not supporting high throughput.
no_vht_support '0' If AP and station not supporting very high throughput.
rssi '10' If RSSI is greater equal rssi_val.
low_rssi '-500' If RSSI is less than low_rssi_val.
freq '100' If connection is 5Ghz.
chan_util '0' If channel utilization is lower chan_util_val.
max_chan_util '-500' If channel utilization is greater max_chan_util_val.
rssi_val '-60' Threshold for an good RSSI.
low_rssi_val '-80' Threshold for an bad RSSI.
chan_util_val '140' Threshold for an good channel utilization.
max_chan_util_val '170' Threshold for a bad channel utilization.
min_probe_count '2' Minimum number of probe requests aftrer calculating if AP is best and sending a probe response.
bandwidth_threshold '6' Threshold for the receiving bit rate indicating if a client is in an active transmission.
use_station_count '1' Use station count as metric.
max_station_diff '1' Maximal station difference that is allowed.
eval_probe_req '1' Evaluate the incoming probe requests.
eval_auth_req '1' Evaluate the incomning authentication reqeuests.
eval_assoc_req '1' Evaluate the incoming association requests.
deny_auth_reason '1' Status code for denying authentications.
deny_assoc_reason '17' Status code for denying associations.
use_driver_recog '1' Allow drivers to connect after a certain time.
min_number_to_kick '3' How often a clients needs to be evaluated as bad before kicking.
chan_util_avg_period '3' Channel Utilization Averaging
set_hostapd_nr '1' Feed Hostapd With NR-Reports
op_class '0' 802.11k beacon request parameters
duration '0' 802.11k beacon request parameters
mode '0' 802.11k beacon request parameters
scan_channel '0' 802.11k beacon request parameters

ubus interface

To get an overview of all connected Clients sorted by the SSID.

root@OpenWrt:~# ubus call dawn get_network
{
    "Free-Cookies": {
	    "00:27:19:XX:XX:XX": {
		    "78:02:F8:XX:XX:XX": {
			    "freq": 2452,
			    "ht": 1,
			    "vht": 0,
			    "collision_count": 4
		    }
	    },
	    "A4:2B:B0:XX:XX:XX": {
		    "48:27:EA:XX:XX:XX: {
			    "freq": 2412,
			    "ht": 1,
			    "vht": 0,
			    "collision_count": 4
		    },
	    }
    },
    "Free-Cookies_5G": {
		
    }
}

To get the hearing map you can use:

root@OpenWrt:~# ubus call dawn get_hearing_map
{
    "Free-Cookies": {
	    "0E:5B:DB:XX:XX:XX": {
		    "00:27:19:XX:XX:XX": {
			    "signal": -64,
			    "freq": 2452,
			    "ht_support": true,
			    "vht_support": false,
			    "channel_utilization": 12,
			    "num_sta": 1,
			    "ht": 1,
			    "vht": 0,
			    "score": 10
		    },
		    "A4:2B:B0:XX:XX:XX": {
			    "signal": -70,
			    "freq": 2412,
			    "ht_support": true,
			    "vht_support": false,
			    "channel_utilization": 71,
			    "num_sta": 3,
			    "ht": 1,
			    "vht": 0,
			    "score": 10
		    }
	    }
    }
}

OpenWrt in a Nutshell

OpenWrtInANuthshell