fwcutter: Bump version
[b43-tools.git] / fwcutter / README
1                         BCM43XX Linux Driver Project
2                         ============================
3
4
5 About this software
6 -------------------
7
8 http://wireless.kernel.org/en/users/Drivers/b43
9
10 b43-fwcutter is a tool to extract firmware from binary Broadcom 43xx driver files.
11
12
13 Usage
14 -----
15
16 b43-fwcutter FILE               extracts the firmware from a source FILE to
17                                 the current directory, creating a directory
18                                 "b43" or "b43legacy" with files in it.
19 b43-fwcutter -i FILE            identify the driver file; print information
20                                 but don't extract.
21 b43-fwcutter -w /tmp FILE       extract and write firmware to /tmp.
22 b43-fwcutter -l                 prints a list of supported driver source files.
23
24 After extraction, copy the "b43" or "b43legacy" directory to your firmware
25 directory (usually /lib/firmware or similar, see below). Alternatively you
26 can use the -w option to b43-fwcutter.
27
28 Different distributions use different directories to load firmware from.
29 If the driver complains about missing firmware files look for the correct
30 directory. For some distributions you have to use /lib/hotplug/firmware
31 or /usr/lib/hotplug/firmware but other directories are also possible.
32
33 Because firmware file are stored in big endian, extraction doesn't depend
34 on the system you're using. You can use extracted firmware from any driver
35 on any system and also copy the extracted files to any other system (e.g.
36 if extraction on the target system isn't feasible.)
37
38
39 Where can I find some driver source files?
40 ------------------------------------------
41
42 Please check the references at
43 http://www.linuxwireless.org/en/users/Drivers/bcm43xx#devicefirmware
44
45 It is recommended that you extract firmware for both b43 and b43legacy in
46 order to support both types of cards on your system.