kconfig: don't silently ignore unhandled characters
[carl9170fw.git] / README.md
1 # Community AR9170 Linux firmware
2
3 ## Introduction
4
5 This is the firmware for the Atheros ar9170 802.11n devices.
6 The firmware, carl9170.fw, can be used with the carl9170 Linux
7 driver or the tools supplied in the repository.
8
9 ## Build
10
11 ### Build Toolchain
12
13 To build the firmware you will need an SH-2 toolchain.
14 You can use the makefile in this repository to build
15 your own toolchain:
16
17 `# make -C toolchain`
18
19 but be aware that this will take some time and requires
20 about 3-4 GiB disk space.
21
22 ### Build Firmware Image
23
24 The firmware configuration and build process requires the following
25 tools and libraries:
26
27  * gcc 4.8
28
29  * gperf, bison/flex
30
31  * cmake 2.8.4+
32
33 to start the configuration, run:
34
35 `# autogen.sh`
36
37 The configuration is based on the Linux's KConfig utility CLI.
38 For each configurable option, a prompt will appear. To choose
39 the default/previous option simply hit `<Enter>`-key on your
40 keyboard.
41
42 ### Install Firmware
43
44 if you want to "install" your own firmware, you can either
45 do this manually, or by executing:
46
47 `# autogen.sh install`
48
49 This will place a copy with the right filename [adds API rev]
50 into /lib/firmware/[the default path on most Distributions].
51
52 ## Contact
53
54 If you have any questions, reports or patches, you should write
55 to <linux-wireless@vger.kernel.org> and include "carl9170" in
56 the subject line.