roamguide: add package
This commit is contained in:
parent
6c38a5dd63
commit
0da60862c5
|
@ -0,0 +1,33 @@
|
|||
include $(TOPDIR)/rules.mk
|
||||
|
||||
PKG_NAME:=roamguide
|
||||
PKG_VERSION:=0.0.4
|
||||
PKG_RELEASE:=$(GLUON_BRANCH)
|
||||
|
||||
PKG_BUILD_DIR := $(BUILD_DIR)/$(PKG_NAME)
|
||||
|
||||
include $(TOPDIR)/../package/gluon.mk
|
||||
|
||||
define Package/roamguide
|
||||
SECTION:=net
|
||||
CATEGORY:=Network
|
||||
DEPENDS:=+micrond
|
||||
TITLE:=Helps your client to search for a better AP and have a nice roam experience.
|
||||
endef
|
||||
|
||||
define Package/roamguide/description
|
||||
Helps your client to search for a better AP and have a nice roam experience.
|
||||
endef
|
||||
|
||||
define Build/Prepare
|
||||
mkdir -p $(PKG_BUILD_DIR)
|
||||
endef
|
||||
|
||||
define Build/Compile
|
||||
endef
|
||||
|
||||
define Package/roamguide/install
|
||||
$(CP) ./files/* $(1)
|
||||
endef
|
||||
|
||||
$(eval $(call BuildPackage,roamguide))
|
|
@ -0,0 +1,47 @@
|
|||
ROAM-Guide
|
||||
----------
|
||||
|
||||
Helps your clients to search for a better AP and to have a nice roaming experience.
|
||||
|
||||
The roaming guide runs as a cronjob every minute on your ap and verifies that clients
|
||||
have an acceptable TQ towards the AP. If that isn't the case it will deauth the client
|
||||
by stating that the AP is full, enabling the client to look for an alternative AP.
|
||||
|
||||
This is happening in three definable stages depending on the TQ of the client.
|
||||
When a client has decided to come back after the ban-time it will not be bothered
|
||||
again unless it depletes to the next TQ level or it has been kicked $stage times.
|
||||
For every stage the client is guided, the ban time will be increased. So by default
|
||||
the first stage has a bantime of 500ms, the second 2775ms and the third 10000ms.
|
||||
|
||||
When a client is away for some definable time or is below the first stages TQ,
|
||||
it will be forgotten, and the guiding will be re-enable.
|
||||
|
||||
Configuration
|
||||
-------------
|
||||
|
||||
In '/etc/config/roamguide' the following default configuration is available,
|
||||
to activate it you need to set enabled to '1'.
|
||||
|
||||
config roamguide
|
||||
option device "client0" # wireless AP device we like to guide
|
||||
list signal '-60' # first penality level, in dBm
|
||||
list signal '-77' # second penality level, in dBm
|
||||
list signal '-85' # final penality level. in dBm
|
||||
option bantime_base '500' # on the first level ban for 500ms
|
||||
option bantime_factor '2375' # on the second one for 2775ms,
|
||||
# and in the final 10000ms
|
||||
option forget_time '600' # Forget about a client after 10s
|
||||
option enabled '0' # set to '1' to enable this profile
|
||||
|
||||
This module creates a cronjob calling /usr/bin/roamguide once a minute.
|
||||
If you want to make roamguide more reactive (but also stress your device) you can add some more cron jobs with sleep timers in /usr/lib/micron.d/root:
|
||||
|
||||
* * * * * sleep 20 & /usr/bin/roamguide
|
||||
* * * * * sleep 40 & /usr/bin/roamguide
|
||||
|
||||
### Testing tools
|
||||
|
||||
This will show you the stats, where you are connected to on your client:
|
||||
|
||||
watch -d -n0,5 iw dev $(ip -o -4 route show to default | awk '{print $5}') station dump
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# repeat the following for every wireless AP device you like to guide.
|
||||
config roamguide
|
||||
option device "client0" # wireless AP device we like to guide
|
||||
list signal '-60' # first penality level
|
||||
list signal '-77' # second penality level
|
||||
list signal '-85' # final penality level
|
||||
option bantime_base '500' # on the first level ban for 500ms
|
||||
option bantime_factor '2375' # on the second one for 2775ms,
|
||||
# and in the final 10000ms
|
||||
option forget_time '600' # Forget about a client after 10s
|
||||
option enabled '1' # set to '0' to disable this profile
|
|
@ -0,0 +1,106 @@
|
|||
#!/bin/sh
|
||||
|
||||
. /lib/functions.
|
||||
|
||||
LOCK="/tmp/ide.lock"
|
||||
|
||||
try_lock(){
|
||||
mkdir "$LOCK" || echo "Already running!"
|
||||
trap "ir $LOCK" EXIT
|
||||
}
|
||||
|
||||
wifi_kick(){
|
||||
local dev="$1" ; shift
|
||||
local mac="$1" ; shift
|
||||
local bantime="$1" ; shift
|
||||
ubus call hostapd.${dev} del_client '{ "addr" : "'${mac}'", "reason" : "assoc toomany", "ban_time" : '${bantime}' }'
|
||||
}
|
||||
|
||||
count_file(){
|
||||
echo "/tmp/roam-${1}-${2}"
|
||||
}
|
||||
|
||||
count_get(){
|
||||
local fn=$(count_file $@)
|
||||
if [ -e "$fn" ] ; then
|
||||
touch "$fn"
|
||||
cat $fn
|
||||
else
|
||||
echo 0
|
||||
fi
|
||||
}
|
||||
|
||||
count_inc(){
|
||||
expr $(count_get $@) + 1 > $(count_file $@)
|
||||
}
|
||||
|
||||
count_dec(){
|
||||
$(expr $(count_get $@) - 1) > $(count_file $@)
|
||||
}
|
||||
|
||||
count_rm(){
|
||||
local fn=$(count_file $@)
|
||||
if [ -e $fn ] ; then
|
||||
logger -s -t roamguide "forget" $@
|
||||
rm $fn
|
||||
fi
|
||||
}
|
||||
|
||||
count_cleanup() {
|
||||
local device="$1" ; shift
|
||||
local current_time=$(date +%s)
|
||||
for file in $(find /tmp -maxdepth 1 -name "roam-${device}-*" -type f ); do
|
||||
[ "$(expr "$current_time" - $(date +%s -r $file))" -gt "$forget_time" ] && rm $file
|
||||
done
|
||||
}
|
||||
|
||||
client_macs() {
|
||||
local dev="$1"
|
||||
iw dev "${dev}" station dump | grep Station | sed -e 's/^[^ ]\+ \([0-9a-z:]*\) .*/\1/'
|
||||
}
|
||||
|
||||
client_tq() {
|
||||
local dev="$1"
|
||||
local mac="$2"
|
||||
iw dev "${dev}" station get "${mac}" | grep "signal avg" | xargs | cut -d' ' -f 3
|
||||
}
|
||||
|
||||
roamguide() {
|
||||
local s="$1"
|
||||
config_get_bool enabled "$s" 'enabled' 0
|
||||
[ $enabled -ne 0 ] || return 0
|
||||
|
||||
config_get device "$s" device
|
||||
config_get forget_time "$s" forget_time 600
|
||||
config_get bantime_base "$s" bantime_base 500
|
||||
config_get bantime_factor "$s" bantime_factor 2375
|
||||
|
||||
for mac in $(client_macs "${device}") ; do
|
||||
tq=$(client_tq "${device}" "${mac}")
|
||||
level=1
|
||||
config_list_foreach "$s" signal roamlevel "${tq}" "${device}" "${mac}"
|
||||
done
|
||||
count_cleanup ${device}
|
||||
}
|
||||
|
||||
roamlevel(){
|
||||
local roam_tq="$1" ; shift
|
||||
local tq="$1" ; shift
|
||||
local device="$1" ; shift
|
||||
local mac="$1" ; shift
|
||||
if [ ${tq} -le ${roam_tq} ]; then
|
||||
mac_count=$(count_get "${device}" "${mac}")
|
||||
if [ $mac_count -lt $level ] ; then
|
||||
count_inc ${device} ${mac}
|
||||
local bantime=$(expr $bantime_base + $(expr $mac_count \* $mac_count) \* $bantime_factor)
|
||||
logger -s -t roamguide "${device}: ban ${mac} ${tq}dBm for ${bantime}ms"
|
||||
wifi_kick "${device}" "${mac}" "${bantime}"
|
||||
break # quits config_list_foreach
|
||||
fi
|
||||
fi
|
||||
level=$(expr $level + 1)
|
||||
}
|
||||
|
||||
try_lock
|
||||
config_load 'roamguide'
|
||||
config_foreach roamguide 'roamguide'
|
|
@ -0,0 +1,13 @@
|
|||
#!/bin/sh
|
||||
|
||||
LOCK="/tmp/roamguide-loop.lock"
|
||||
|
||||
try_lock(){
|
||||
mkdir "$LOCK" || echo "Already running!"
|
||||
trap "rmdir $LOCK" EXIT
|
||||
}
|
||||
|
||||
/sbin/logread -f -e '\<hostapd\>.*\<associated\>' |\
|
||||
while read line ; do
|
||||
/usr/bin/roamguide
|
||||
done
|
|
@ -0,0 +1 @@
|
|||
* * * * * /usr/bin/roamguide
|
Loading…
Reference in New Issue