No description
Find a file
Eneas U de Queiroz 6eb747b4d4 Use separate configs for 802.11g & 802.11a bands
This changes the metrics variables that invove scores to arrays.  At the
momemnt, there are two bands implemented, 802_11a and 802_11g.
Internally, they are chosen based on the frequency of the channel being
used.  Anything < 2500 MHz is 802_11g, and everything else is 802_11a.
Dawn will issue a warning if it finds a frequency greater or equal to
5925 MHz.  The upper limit of the 802.11a band, and the start of the
next band vary by country, so this will have to be reviewed.

The UCI configuration changes.  Instead of a single metric config, there
will be a global metric config, and one for each band.  The
non-band-specific configuration will only work in the global config.
Any per-band configuration present at the global config will be applied
to all bands.  Any configuration present at the specific band will
override any global values.

The following configuration options are split into bands:
 - ap_weight
 - ht_support
 - vht_support
 - no_ht_support
 - no_vht_support
 - rssi
 - rssi_val
 - low_rssi
 - low_rssi_val
 - freq
 - chan_util
 - max_chan_util
 - chan_util_val
 - max_chan_util_val

Signed-off-by: Eneas U de Queiroz <cotequeiroz@gmail.com>
2021-08-05 21:51:44 +02:00
.github/workflows github: set CONFIG_SRC_TREE_OVERRIDE in actions CI 2020-05-08 19:47:28 +02:00
src Use separate configs for 802.11g & 802.11a bands 2021-08-05 21:51:44 +02:00
CMakeLists.txt first version 2020-03-23 21:22:21 +01:00
INSTALL.md update readme and install instructions 2020-04-17 17:14:07 +02:00
LICENSE first version 2020-03-23 21:22:21 +01:00
README.md add notice that full wpad is requirement 2020-04-17 19:18:15 +02:00
TESTING.md test_storage: further refactoring, added test functionality, and TESTING.md to describe testing approach 2020-06-10 12:30:43 +02:00

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