=======================================================================
	ATMEL PCMCIA PCI USB linux driver
=======================================================================

+---------------------+
|PART A. Instructions.|
+---------------------+
0. 
--
	This is the first release of ATMEL's open source linux drivers and
	configuration and monitor utilities.
	Due to a reconstruction of the directory structure; the use of 
	new Makefile and new configuration scripts this is an untested 
	version. We will test it and any bug fixes will be committed in
	the CVS in atmelwlandriver.sourceforge.net .

1. Configuration.
--
	You can either run make config or bash scripts/Config.sh.
	You have to answer a few questions and a .config file will be created.

2. Build and installation
--
	If a .config file exists then you need the following step:

	# make install

	to build and install the drivers you need.
	Remember to login as root before installing the drivers.

3. RF Board Type?
--
	There are several Atmel chips for PCMCIA and USB which can be combined with
	a bunch of RF boards.
	If you don't know what is the exact type of the board:
	a. Just build and install everything.
	b. Plug you PCMCIA or USB board in and look in /var/log/messages for more info
	   Then consult the following table.

		USB (the product IDs below are Atmel's ones only !):

	   	PID       | Atmel chip | RF board | driver
		----------+------------+----------+--------
		7603      |       503A |     3861 | usbvnet.o
		7604      |       503A |     3863 | usbvnet3.o
		7605      |       503A |     RFMD | usbvnetr.o
		7606      |       505  |     RFMD | usbvnet5.o

		( The 505 is currently not supported due to missing firmware.)

		If no driver is loaded on plugging your USB adapter, check if the (vendor ID,product ID)
		pair is already contained in any of the *_DEVICES defines in src/includes/usb/config.h.
		If yes, build a driver for this RF board and try again.
		If no, try to find out which RF board your adapter contains (look inside, check the FCC
		pictures of the device, or try out all RF boards). Add your product / vendor ID pair in 
		the appropriate *_DEVICES define in the config.h file. Build and install again.
		On success, please notify the developers at sourceforge to include the new IDs.

		PCMCIA :

	    	ID           | DRIVER
		-------------+---------------
	    	AT76C502     | PCMCIA Intersil
		AT76C502AR   | PCMCIA RFMD
		AT76C502AR_D | PCMCIA RFMD revision D
		AT76C502AR_E | PCMCIA RFMD revision E
		AT76C504     | PCMCIA RFMD 504

	 c. If you cannot find your device's ID in the above table's than try to get the 
	 	required information from the Manufacturer....

4. TOOLS
--
	In order to use the ncurses based command line (lvnet) and the X windows (xvnet) applications
	you must enable the 
		Wireless LAN (non-hamradio)
	option inside the kernel (and of course if it was disabled to rebuild your kernel).
	For help regarding the two tools try the corresponding man pages.

	Alternatively: Get the wireless tools (iwconfig et al) and use them.
	
5. Support.
--
	For any questions use the sourceforge project's mailing list:
	atmelwlandriver-users@lists.sourceforge.net

+--------------------+
|PART B. Known Issues|
+--------------------+
	USB drivers:(START)
	------------
	The URB's going to the device are using the 
	Adapter->devreq->length field which on some platforms can cause 
	serious problems. This will be fixed very soon.

	There is also a report for a deadlock in the initialization routine. We cannot
	reproduce it so far. 

	There is a serious "conflict" with the usb-uhci driver and atmel's board which
	leads to one problem. The system hangs   :(   ..... 
	This never happens with the uhci driver.

	USB drivers:(END)
	-----------------

+------------+
|PART C. TODO|
+------------+

	Add support for different product and vendor ID's....















