DAWN/README.md

![DAWN PICTURE](https://image.ibb.co/nbmNfJ/dawn_bla.png)

# DAWN
Decentralized WiFi Controller

## Related

|Repro             |Content                   |
|------------------|--------------------------|
|[patches-pending](https://github.com/berlin-open-wireless-lab/patches-pending)|Pending OpenWrt Patches DAWN is depending on|
|[bowl-feed](https://github.com/berlin-open-wireless-lab/bowl-feed)|Feed for DAWN|

## Installation

See [installation](INSTALL.md).

## LuCI App
There is an luci app called [luci-app-dawn](https://github.com/berlin-open-wireless-lab/bowl-feed).

## Setting up Routers

You can find a good guide to configure your router is [here](https://gist.github.com/braian87b/bba9da3a7ac23c35b7f1eecafecdd47d).
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.|
|bandwith_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.|


## 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](https://raw.githubusercontent.com/PolynomialDivision/upload_stuff/master/dawn_pictures/openwrt_in_a_nutshell_dawn.png)