Mirror of ath9k_htc firmware source repository.

Adrian Chadd e888634a85 Merge pull request #163 from cloudswei/ctlframe_injection 4 months ago
docs 9df0754a38 docs: remove *png files 7 years ago
local 98373807cb update to gcc 9.2.0 4 years ago
sboot ff66305a04 move sboot to the root directory 10 years ago
scripts 3fff59bc90 add scripts/checkpatch.pl 11 years ago
target_firmware e888634a85 Merge pull request #163 from cloudswei/ctlframe_injection 4 months ago
.editorconfig b2f3ee13e8 Adding a file for EditorConfig 7 years ago
.gitignore 41a4053fed add .gitignore 11 years ago
.travis.yml 5c85db69d2 Adding a file for Travis CI 7 years ago
LICENCE.TXT cc765de490 Update to clearbsd/isc licence; this is what it should've been. 11 years ago
Makefile e7fa85ac94 update to gcc 10.2 3 years ago
NOTICE.TXT db976731b2 Convert NOTICE.TXT to UTF-8 from WINDOWS-1252. 3 years ago
README e0eccbb290 Update build instructions for FreeBSD. 9 years ago

README

This is the firmware for the Qualcomm Atheros AR7010 and AR9271 USB
802.11n NICs.

What is this exactly?
---------------------

This is the firmware which resides in RAM on the AR7010/AR9271 NICs.
It is used by ath9k (Linux) and athn (OpenBSD) to provide wireless
services.

What licence is this covered by?
--------------------------------

The Qualcomm Atheros owned code is under the ClearBSD licence.

The NOTICES.TXT file contains copyright notices for software which
this firmware release leverages.

There is some code that is based off of work done under contract
but is owned by Qualcomm Atheros; the original copyright statements
from that work are in NOTICES.TXT.

The Tensilica code (xtos/xtensa) is distributed with permission from
Tensilica, Inc., under the MIT licence.

There are three ECOS source files distributed under the terms of
the GPLv2, with a caveat that linking or using the source files does
not bring the rest of the binary under the GPLv2. Please read the
ECOS caveats in more detail.


Ok, what are those NICs?
------------------------

The AR7010 is a USB/PCIe SoC with onboard RAM, ROM and flash.
It comes with an external wireless chip connected via PCIe - typically
an AR9280 or AR9287.

The AR9271 is a USB/Wifi SoC with onboad RAM, ROM, flash and the
actual wireless chip. The wireless core is an off-shoot of the AR9285.
It is a single-chip solution.

How do I build it?
------------------

You're in for a treat.

* Install the cmake build tool (http://www.cmake.org/).
Major distributions have packages for this.

* For FreeBSD - install gmake and wget.

* You first have to build the toolchain.

* Linux:

$ make toolchain

* FreeBSD:

$ gmake toolchain

(Yes, I made this work on FreeBSD as well.)

* Next, build the firmware.

* Linux:

$ make -C target_firmware

* FreeBSD:

$ gmake -C target_firmware

You will end up with two .fw files - one for the AR7010 and one for
the AR9271 in the target_firmware directory.

You can clean the firmware build (when you wish to force a rebuild)
by doing:

* Linux:

$ make -C target_firmware clean

* FreeBSD:

$ gmake -C target_firmware clean

Then what?
----------

You need to then copy this into the relevant location for your operating
system. Yes, this means you need a driver. No, there's no FreeBSD
driver yet for this particular chipset, sorry.


Where do I file bugs?
---------------------

Please file bugs in github - http://github.com/qca/open-ath9k-htc-firmware/issues .


Mailing lists?
--------------

Here you go:

http://lists.infradead.org/mailman/listinfo/ath9k_htc_fw

And

ath9k_htc_fw@lists.infradead.org