Host AP driver for Intersil Prism2/2.5/3	(DEVELOPMENT VERSION!)
========================================

Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
Author: Jouni Malinen <jkmaline@cc.hut.fi>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation. See COPYING for more
details.


Note!
This development version is mainly for research use; it has not
been thoroughly tested and may contain various bugs. This is not for
production use and use of this driver may require thorough knowledge
of IEEE 802.11, pcmcia-cs, Linux, etc.

Released versions of the driver and CVS repository for latest testing
versions is available at http://hostap.epitest.fi/.

Please read README.prism2 for further information about the Host AP
driver.


Driver installation
===================

PC Cards (not in PLX9052 adapter)	hostap_cs.o
---------------------------------

Systems using kernel tree PCMCIA modules:

'Makefile' includes commands for compiling and installing Host AP
driver for systems using kernel tree PCMCIA support (i.e., kernel
modules are not compiled with external pcmcia-cs package). Edit
KERNEL_PATH in Makefile to match your system. Run 'make pccard' (this
compiles the sources; this step can be run as non-root user). After
the compilation has finished, you can install hostap_cs.o by running
'make install_pccard' (as root). You will then need to restart cardmgr
to load new configuration from /etc/pcmcia/hostap_cs.conf.


Systems using external pcmcia-cs modules:

There are two options for building and installing:

1) just like the steps for kernel tree, but also configure PCMCIA_PATH in
   Makefile (i.e., compile and install pcmcia-cs separately)

2)
Copy everything from 'driver' subdirectory on top of root pcmcia-cs
directory, i.e., so that driver/modules/hostap.c ends up in
pcmcia-cs's 'modules' directory, like so:

	cp -a driver/* /usr/src/pcmcia-cs-3.1.31

After this you should be able to build and install pcmcia-cs with this
driver (hostap_cs.o) using normal commands ('make config', 'make all',
and 'make install').

PC Cards in PLX9052 adapter	hostap_plx.o
---------------------------

'Makefile' includes commands for compiling and installing Host AP
driver for systems using PLX9052-based PCI adapters for PC Cards.
These cards do not use pcmcia-cs package and hostap_plx.o is used to
also initialize the PCI parts of such setup. Edit KERNEL_PATH in
Makefile to match your system. Run 'make plx' (this compiles the
sources; this step can be run as non-root user). After the compilation
has finished, you can install hostap_plx.o by running 'make
install_plx' (as root). You can probe PCI bus for PLX9052 adapters and
initialize the devices by loading the module ('modprobe hostap_plx.o').

PCI cards based on Prism2.5	hostap_pci.o
---------------------------

'Makefile' includes commands for compiling and installing Host AP
driver for systems using Prism2.5-based PCI cards. These cards do not
use pcmcia-cs package. Edit KERNEL_PATH in Makefile to match your
system. Run 'make pci' (this compiles the sources; this step can be
run as non-root user). After the compilation has finished, you can
install hostap_pci.o by running 'make install_pci' (as root). You can
probe PCI bus for Prism2.5 PCI cards and initialize the devices by loading
the module ('modprobe hostap_pci.o').
