carl9170: Update based on commit 467556acea56f361a21b2a3761ca056b9da2d237 dated Nov...

[linux-libre-firmware.git] / carl9170fw / README.md

diff --git a/carl9170fw/README.md b/carl9170fw/README.md
new file mode 100644 (file)
index 0000000..65a3aa7
--- /dev/null
+++ b/carl9170fw/README.md
@@ -0,0 +1,56 @@
+# 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-5 GiB disk space.
+
+### Build Firmware Image
+
+The firmware configuration and build process requires the following
+tools and libraries:
+
+ * gcc 6.0+ (including library and header dependencies)
+
+ * bison/flex
+
+ * cmake 3.8+
+
+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 patches, you should write
+to <linux-wireless@vger.kernel.org> and
+include "carl9170" in the subject line.