UPDATE 100814 - For most recent Piranha + AAP development, please follow https://forum.openwrt.org/viewtopic.php?id=26116
Community,
I'm glad to announce the immediate availability of AAP for OpenWrt Kamikaze 8.09+. AAP is ready-to-run on devices with Atheros wireless chipsets (while easily adoptable to other chipsets) and has been written for the Fonera 2100/2200. Instead of explaining AAP in detail again here, I paste the rather comprehensive README that ships with the initial release of AAP. AAP is available as of today at http://piranha.klashed.net/pub/aap
#
# Copyright (C) 2009 orange <or4n9e@gmx.de>
#
# This is free software, licensed under the GNU General Public License v2.
# See /LICENSE for more information.
#
### Definition ###
AAP is a script that enables users of OpenWrt Kamikaze 8.09+ to automatically log into different
wireless accesspoints that provide internet access. The accesspoints can be automatically
searched and/or set in a whitelist (aap_wlst). Beyond that AAP is capable in defining a blacklist
of undesired accesspoints while connecting (aap_blst). AAP supports the client connection of
your OpenWrt Kamikaze 8.09+ device to open, wep, wpa-psk and wpa2-psk encrypted accesspoints.
AAP connects to surrounding accesspoints utilizing their MAC addresses. This ensures a high level of
differentiation between accesspoints in contrast to SSID-based connecting.
### Requirements ###
AAP requires an OpenWrt Kamikaze 8.09+ device properly configured in Client Mode (sta). AAP supports
devices with an Atheros wireless chipset (while easily adoptable to other chipsets) and has been written
for the Fonera 2100/2200. It assumes a single madwifi-VAP ath0 in sta mode.
### Whitelist/Blacklist ###
aap_wlst is a newline-separated whitelist of preferred accesspoints:
00:11:22:33:44:55* for accesspoints with no encryption
00:11:22:33:44:55*key for accesspoints with wep, wpa-psk or wpa2-psk encryption
aap_blst is a newline-separated blacklist of undesired accesspoints:
00:11:22:33:44:55 for open, wep, wpa-psk and wpa2-psk encrypted accesspoints
### Configuration Variables ###
aap.sh provides configuration variables (with default values) at the top of the script:
# Internet connection check frequency in seconds
aap_checkfreq=60
# Length of time in seconds to wait for a DHCP request to succeed
aap_dhcptimeout=30
# Internet URL or IP address used to ping to ensure internet access is working
aap_ineturl=www.google.com
# Defines the search mode. Try to find all accesspoints that provide internet access. "0"=NO, "1"=YES
aap_prefonly=0
# Defines the accesspoint refresh scan delay in seconds (divisible by 5)
aap_rescandelay=43200
### Installation ###
1. Log into your device via SSH
2. # mkdir /aap
3. scp aap.sh, aap_blst, aap_wlst and scan.awk to /aap
4. scp aap to /etc/init.d
5. # chmod 755 /aap/aap.sh, /aap/scan.awk and /etc/init.d/aap
### Usage ###
To enable autostart of AAP
# /etc/init.d/aap enable
To disable autostart of AAP
# /etc/init.d/aap disable
To start AAP manually
# /etc/init.d/aap start
To stop AAP manually
# /etc/init.d/aap stop
### Known Issues ###
Both aap_wlst and aap_blst need to be non-empty files due to the behaviour of the busybox builtin grep.
Thus, please leave aap_wlst and aap_blst as provided and just append your custom newline-separated entries
if actually in use.
### Warning ###
Both aap.sh and scan.awk make use of "*" as a field separator. Thus, both SSIDs and encryption keys
that includes "*" aren't supported by AAP. Unfortunately this constraint isn't solvable currently
as the busybox ash shell doesn't support arrays and the SSID specification allows the complete ASCII
character set. Be sure to utilize aap_blst to exclude those particular accesspoints. AAP may harm your
OpenWrt Kamikaze 8.09+ /etc/config/wireless configuration permanently if you neglect this warning. Use
AAP at your own risk!
### Changelog ###
Initial release aap_090903
Testing, reporting bugs, voicing comments/suggestions and asking questions about AAP is certainly much appreciated. I hope you feel this initial release of AAP as a valuable share to the OpenWrt community.
best,
orange
(Last edited by orange on 14 Aug 2010, 18:09)