This package contains firmware images for use with the 
driver for atmel at76c50x cards in the linux 2.5/2.6 kernel.

The prefered way to load these firmware images in to use the
firmware-loading facility of the Linux hotplug system. Prerequistites
for this are a kernel compliled with CONFIG_FW_LOADER and the
Linux hotplug scripts version 2003_05_01 or later.

To install the atmel firmware for use with the hotplug system do
'make install-hotplug'
which will put the firmware images in /usr/share/firmware/atmel_at76c50x
and install a script to load them in /etc/hotplug.d/firmware.


If you do not wish to use the hotplug system, this package includes
a "push" firmware loader, atmel_fwl. You should arrange to run this 
as root from a network-startup script or PCMCIA script _before_ the 
interface is brought up. The command is simply

atmel_fwl <interface> /path/to/firmware

for instance

/sbin/atmel_fwl eth0 /usr/share/firmware/atmel_at76c50x/atmel_at76c502.bin

To install the firmware for use with the push loader, do
'make install-loader'
which will put the firmware images in /usr/share/firmware/atmel_at76c50x
and install the atmel_fwl binary in /usr/sbin.


Selecting the correct firmware image.

There are six different firmware images in this package and the correct
one must be used. If the hotplug firmware loading mechansim is in use and
the driver recognises the card in its internal database, it will automatically
select the correct firmware image. If the card is not in the database the driver
will log a message and default to the at76c502 image. If this is not correct, the
default can be overridden with the "firmware" module parameter. Since there is only
one firmware image for PCI cards (at76c506) the driver should always select the
correct one for them. If you card is not recognised, please send the result of
running the 'dump_cis' command to simon@thekelleys.org.uk so that it can be included
in future releases.

If using the "push" firmware loader there is not automatic selection of firmware 
image, you should ensure that the correct image is given in the atmel_fwl command-line.


