Symbol Spectrum24 Linux driver Alpha 2

In order to get this driver up and running you must have the pcmcia package
installed. This driver was compiled against and tested with version 3.0.9 of
David Hinds' pcmcia package.

This driver also requires version 2.2.x of the Linux kernel. I may get
around to porting it backwards at some point, but with all the advantages to
driver writers that the 2.2 kernel offers, it made sense to start there.

In order to do things like set the ESSID dynamically, you need wireless
extensions turned on in your kernel, you can do this by saying yes to the
CONFIG_NET_RADIO option or, using make menuconfig you have to select the
option under net drivers that says "wireless LAN (non-hamradio)"

The following parameters are currently modifiable with insmod:

essid="Essid string"
map_mode="0=Mobile Unit, 1=MicroAP"
map_dtim="time between DTIM packets"
map_hop_set="number of hop set you wish to use, 1-3"
map_hop_pattern="number of hopping pattern, or 255 for random"
force_io_mode="Card defaults to trying to use the memory mapped mode, if for
	some reason, you would prefer it didn't, you can set this to one to force io
	mode operation, most people will want to leave it untouched, I put it in
	there mostly to test my io mode code :) "

Installation instructions:

Untar this in the pcmcia root directory, and run make all and make install

Then add the following lines to /etc/pcmcia/config:

device "spectrum24_cs"
  class "network" module "spectrum24_cs"

card "Symbol Spectrum24 WLAN Adapter"
  version "Symbol", "Spectrum24 WLAN Adapter"
  bind "spectrum24_cs"

Then you should be able to start card services (or restart them, if they
were already going.)

If for some reason, you decide to rerun make install, it will recreate
/etc/pcmcia/config, and you will have to add those lines again.

Assuming things are in the right place, you should be able to put the card
in and it should come up. You can then configure its ESSID using iwconfig
(the syntax would be 'iwconfig <interface> essid <new essid>' you must be
root to do this of course. From there on, it should behave like a normal
network card and you set it up using ifconfig as you would normally.

Bugs:
	(none that I know of ... yet :)
	please send all bug reports to lkeyser@wpi.edu

Todo:
	So I still haven't implemented mutilcast yet ... :( I'll get to it
	Real Soon Now

	I also have yet to set up all that statistics reporting ... I really
	should have done that by now, but I got distracted, if any body wants
	to do it, feel free. Just e-mail me before, to make sure you have
	the latest copy, and then e-mail me the diff.

	Anything else you feel is important ... e-mail me. I promise I'll
	read the e-mail, I can't promise I'll do it.

	I'm also going to write a suite of tools, so that it is more
	modifiable dynamically and you can get run-time info from the card.
	If you have anything that you'd like to see happen in those, drop me
	a line.

Disclaimer:
	This is Alpha software (it's stable enough to be beta, but it's
	still missing some semi-important things (like statistics.)) If it
	blows up your machine, I want to hear about it, but I'm not
	responsible. It's your job to make multiple backups of you machine
	*before* you lose everything.

Everything here is (c) 1999 Symbol technologies, Symbol makes no guarentees
as to the marketability of this product, if it blows up, it's not their
problem.