X-Git-Url: https://jxself.org/git/?p=carl9170fw.git;a=blobdiff_plain;f=README.md;fp=README.md;h=1521488dd5c83329c19fcc1ae4430dc22f915903;hp=0000000000000000000000000000000000000000;hb=54fe34f34b61c6b261b90f765cc5546937ce1d74;hpb=afde8d73230109e12aff7e18fbb6bea01279a0fe

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1521488
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# Community AR9170 Linux firmware
+
+## Introduction
+
+This is the firmware for the Atheros ar9170 802.11n devices.
+The firmware, carl9170.fw, can be used with the carl9170 Linux
+driver or the tools supplied in the repository.
+
+## Build
+
+### Build Toolchain
+
+To build the firmware you will need an SH-2 toolchain.
+You can use the makefile in this repository to build
+your own toolchain:
+
+`# make -C toolchain`
+
+but be aware that this will take some time and requires
+about 3-4 GiB disk space.
+
+### Build Firmware Image
+
+The firmware configuration and build process requires the following
+tools and libraries:
+
+ * gcc 4.7+
+
+ * gperf, bison/flex
+
+ * cmake 2.8.4+
+
+to start the configuration, run:
+
+`# autogen.sh`
+
+The configuration is based on the Linux's KConfig utility CLI.
+For each configurable option, a prompt will appear. To choose
+the default/previous option simply hit `<Enter>`-key on your
+keyboard.
+
+### Install Firmware
+
+if you want to "install" your own firmware, you can either
+do this manually, or by executing:
+
+`# autogen.sh install`
+
+This will place a copy with the right filename [adds API rev]
+into /lib/firmware/[the default path on most Distributions].
+
+## Contact
+
+If you have any questions, reports or patches, you should write
+to <linux-wireless@vger.kernel.org>.