README

   1 This is the firmware for the Qualcomm Atheros AR7010 and AR9271 USB
   2 802.11n NICs.
   3
   4 What is this exactly?
   5 ---------------------
   6
   7 This is the firmware which resides in RAM on the AR7010/AR9271 NICs.
   8 It is used by ath9k (Linux) and athn (OpenBSD) to provide wireless
   9 services.
  10
  11
  12 Ok, what are those NICs?
  13 ------------------------
  14
  15 The AR7010 is a USB/PCIe SoC with onboard RAM, ROM and flash.
  16 It comes with an external wireless chip connected via PCIe - typically
  17 an AR9280 or AR9285.
  18
  19 The AR9271 is a USB/Wifi SoC with onboad RAM, ROM, flash and the
  20 actual wireless chip.  The wireless core is an off-shoot of the AR9285.
  21 It is a single-chip solution.
  22
  23 How do I build it?
  24 ------------------
  25
  26 You're in for a treat.
  27
  28 * You first have to build the toolchain.
  29
  30   * Linux:
  31
  32   $ make toolchain
  33
  34   * FreeBSD:
  35
  36   $ gmake toolchain
  37
  38   (Yes, I made this work on FreeBSD as well.)
  39
  40 * Next, build the firmware.
  41
  42   * Linux:
  43
  44   $ ./build
  45
  46   * FreeBSD:
  47
  48   edit the build script, change make to gmake, and then
  49
  50   $ ./build
  51
  52 You will end up with two .fw files - one for the AR7010 and one for
  53 the AR9271.
  54
  55
  56 Then what?
  57 ----------
  58
  59 You need to then copy this into the relevant location for your operating
  60 system.  Yes, this means you need a driver.  No, there's no FreeBSD
  61 driver yet for this particular chipset, sorry.
  62
  63
  64 Where do I file bugs?
  65 ---------------------
  66
  67 Please file bugs in github - http://github.com/qca/open-ath9k-htc-firmware/issues .
  68
  69
  70 Mailing lists?
  71 --------------
  72
  73 Here you go:
  74
  75 http://lists.infradead.org/mailman/listinfo/ath9k_htc_fw
  76
  77 And
  78
  79 ath9k_htc_fw@lists.infradead.org
  80