linux & Microlink ADSL

This is the initial (and probbly last until someone more knowlegeable than me get
his hands on this) release of the linux driver for the ELSA Microlink USB ADSL modem.

This is entirely based upon the SAGEM FPSxx driver, itself heavily based upon the
ADI refernce drivers, hacked to work with the ELSA.
What I did:

- Extract the EZUSB from the ELSA windows driver and replace the 8051 boot from SAGEM
with this one
- Add code to boot the XILINX microcontroller with the content of the 'FPGA.BIN' file
from the windows drivers.
- replace the '*.bnm' files (DSP) with the ones from the windows driver
- adjust 'adiusbadsl.conf' with ad-hoc params.

Stability
=========
Most instability occurs during modem boot-up. One time out of three, the modem is not
in a useable state after INSMOD. I've got nor the knowledge, nor the courage to start
debugging the stuff.
However, once the modem has booted both the USB and XILINX code, stability is perfect
as far as i'm concerned (with PPPOE). Run 'adictrl' to get the modem in sync, 
run 'adsl-start' and here you go. I've already ran it several days continuously 
without any problems. No guarantee if you disconnect, though :-(

- Christian Browet -

Information
-----------
This driver is implemented as a standard Linux ethernet network driver, 
adhering to the requirements of RFC2684 for encapsulation of ethernet packets
over ATM. Therefore, configuration of the driver with regards to the Linux
network stack is handled using the existing network driver configuration method.

Requirements and restrictions
-----------------------------
This driver has been verified with RedHat 7.2 et Mandrake 8.2
It requires the usb and hotplug components.
This driver only supports one physical USB ADSL modem attached to the computer.

Building the driver
-------------------
Because this is a kernel module, you must have the kernel source code installed.
The Makefile requires that the kernel source be located in /usr/src/linux.
If you have installed the kernel source in another directory, you can create a
symbolic link from /usr/src/linux to the real kernel source location. 
For example, if your source is in /usr/src/linux-2.4.7-10, you should make a
sybolic link by executing the command:
	ln -s /usr/src/linux-2.4.7-10 /usr/src/linux
	
Once you have extracted the driver source to a local directory, simply run "make"
from that directory to build the components required to run the driver. To
install the components on the local machine, become root and run "make install". 
This will:
	copy the driver binary adiusbadsl.o to your usb drivers directory
	copy a script to /etc/hotplug/usb
	install the helper application adictrl to /usr/local/bin
        create /etc/analog directory
        copy firmware files rtbld*.bnm & adiusbadsl.conf to /etc/analog
	
Note that in the default configuration, the driver will be built to use
the ISOCHRONOUS endpoints for incoming data. This will provide the best 
performance. If for some reason you wish to use BULK I/O only, modify the
makefile to enable the USEBULK define. Do this by uncommenting line 52 in Makefile.