		wifichoice
		----------

	'wifichoice' is another mapping script sent to me by a Debian
user. It allow to automatically select the proper wireless
configuration for your wireless LAN interface based on existing
networks. It's Debian specific, and it integrates pretty nicely in the
existing Debian config environment, however you will need to edit
config files...
	Stefan Tomanek <stefan@pico.ruhr.de> is the author of
'wifichoice', and has a pretty nice page about it. He explitely asked
me to package his script.
		http://localhost.ruhr.de/~stefan/interfaces/
	Note that it's similar to essidscan, but the author claim it's
more powerful, because it has a more fine grained configuration. I did
not try it...

	Jean

------------------------------------------------------------------

							Wifichoice

Although I am using guessnet myself for my LAN interface, I was not
satisfied with its support for wireless interfaces; I did not find
another program that fit my needs. That's why I wrote my own mapping
script. After cleaning it up a bit, it became a flexible (shell)
program that could cope with many scenarios, so I decided to publish
it under the name wifichoice.

							Configuration

Wifichoice selects the proper configuration profile for your WLAN
interface by scanning for the right environment. To achieve this, it
can either scan for the correct access point or ESSID, or try to
associate with the configured network.

Configuration is done in a central way via /etc/network/interfaces:
-------------------------------
mapping wlan0
   script /usr/local/sbin/ifichoice.sh
   map default: none
   map timeout: 2
-------------------------------

Timeout is the number of seconds the script waits after a test
association for the device to settle, and default is the profile that
shoud be loaded is if no known surrounding is detected.

The test parameters are defined in the profiles themselves:
-------------------------------
iface home inet dhcp
   wireless yes
   wireless_mode managed
   wireless_key open 1234567890ABCDEF1234567890
   wireless_essid mywifinet
   wifichoice ap 00:12:34:56:78:9A
-------------------------------

Since your access point does not not broadcast its ESSID, and/or your
card does not support "iwlist scan", wifichoice tries to associate
with the network, using the supplied config, and then checks whether
the network is managed by the right access point.

If you can identify the network by its broadcasted ESSID or AP, you
can also try to scan for it. Just add a line like this to your
profile:
-------------------------------
wifichoice scan essid mywifinet
-------------------------------

Wifichoice then invokes a scan for neighbouring access points, and
identifies those that serve the requested ESSID. It is also possible
to scan for a specific access point address, this is useful if the AP
does not transmit its ESSID:
-------------------------------
wifichoice scan ap 00:12:34:56:78:9A
-------------------------------
