README.dump_fw

   1 This package contains two utilities, dump_fw and hfwget. If placed at
   2 the root of a wl_lkm source tree, both utilities will be built with
   3 the following command.
   4
   5 make -f dump_fw.mk
   6
   7 In any other location only hfwget will be built.
   8
   9 \f
  10 dump_fw
  11 -------
  12
  13 Program to dump the Agere FW image from a wl_lkm_718 source tree. The
  14 firmware image is intended to be used with the orinoco_cs and
  15 hermes_dld Linux driver.
  16
  17 Untar into the wl_lkm_718 directory and run:
  18
  19 make -f dump_fw.mk
  20
  21 This will generate two programs, dump_h1_fw and dump_h2_fw which dump
  22 the firmware for Hermes I AP+STA and Hermes II AP+STA respectively.
  23
  24 To use the programs just do:
  25
  26 ./dump_h1_fw <root>
  27
  28 Which will produce <root>_ap_fw.bin and <root>_sta_fw.bin.
  29
  30 You can use the wl_lkm_714 or wl_lkm_722 source tree instead. See
  31 instructions in dump_fw.mk
  32
  33 KNOWN BUGS
  34 ----------
  35
  36 N/A
  37
  38 \f
  39 hfwget
  40 ------
  41
  42 Program to dump Lucent Station and AP images from Windows and Apple
  43 drivers. The firmware images are intended to be used with the
  44 orinoco_cs and hermes_dld Linux driver.
  45
  46 Windows drivers:
  47 WLLUC48.SYS  (old Lucent)
  48 WLLUC48B.SYS (Lucent)
  49 WLAGS48B.SYS (Agere)
  50 WLDEL48B.SYS (Dell)
  51
  52 Apple Powerbook G3 AirPort firmware:
  53 AppleAirPort.kext/Contents/PlugIns/AppleAirPortFW.kext
  54 AppleAirPort.kext/Contents/PlugIns/AppleAirPortFWAP.kext
  55
  56 Compiled when building dump_fw above. Alternatively, extract into any
  57 directory and run:
  58
  59 make -f dump_fw.mk hfwget
  60
  61 This will generate hfwget which will dump the firmware images it can
  62 locate in the specified file. Just do:
  63
  64 ./hfwget <path to file> <rootname>
  65
  66 Which will output any of:
  67 <rootname>_sta_fw.bin Station firmware for RAM download
  68 <rootname>_ap_fw.bin  AP firmware for RAM download
  69
  70 For the Airport, you need to specify the path to the firmware image
  71 (AppleAirPort.kext/Contents/PlugIns/AppleAirPortFW.kext/Contents/MacOS/AppleAirPortFW)
  72
  73 KNOWN BUGS
  74 ----------
  75
  76 N/A
  77
  78
  79 Enjoy,
  80
  81 Dave Kilroy
  82 October 2008.