This package contains two utilities, dump_fw and hfwget. If placed at
the root of a wl_lkm source tree, both utilities will be built with
the following command.

make -f dump_fw.mk

In any other location only hfwget will be built.


dump_fw
-------

Program to dump the Agere FW image from a wl_lkm_718 source tree. The
firmware image is intended to be used with the orinoco_cs and
hermes_dld Linux driver.

Untar into the wl_lkm_718 directory and run:

make -f dump_fw.mk

This will generate two programs, dump_h1_fw and dump_h2_fw which dump
the firmware for Hermes I AP+STA and Hermes II AP+STA respectively.

To use the programs just do:

./dump_h1_fw <root>

Which will produce <root>_ap_fw.bin and <root>_sta_fw.bin.

If you want to use the wl_lkm_714 source tree instead, you can. See
instructions in dump_fw.mk

KNOWN BUGS
----------

N/A



hfwget
------

Program to dump Lucent Station and AP images from Windows and Apple
drivers. The firmware images are intended to be used with the
orinoco_cs and hermes_dld Linux driver.

Windows drivers:
WLLUC48.SYS  (old Lucent)
WLLUC48B.SYS (Lucent)
WLAGS48B.SYS (Agere)
WLDEL48B.SYS (Dell)

Apple Powerbook G3 AirPort firmware:
AppleAirPort.kext/Contents/PlugIns/AppleAirPortFW.kext
AppleAirPort.kext/Contents/PlugIns/AppleAirPortFWAP.kext

Compiled when building dump_fw above. Alternatively, extract into any
directory and run:

make -f dump_fw.mk hfwget

This will generate hfwget which will dump the firmware images it can
locate in the specified file. Just do:

./hfwget <path to file> <rootname>

Which will output any of:
<rootname>_sta_fw.bin Station firmware for RAM download 
<rootname>_ap_fw.bin  AP firmware for RAM download

For the Airport, you need to specify the path to the firmware image
(AppleAirPort.kext/Contents/PlugIns/AppleAirPortFW.kext/Contents/MacOS/AppleAirPortFW)

KNOWN BUGS
----------

N/A


Enjoy,

Dave Kilroy
October 2008.