en:users:drivers:ath10k:firmware
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
en:users:drivers:ath10k:firmware [2015/01/26 09:49] 127.0.0.1 external edit |
en:users:drivers:ath10k:firmware [2024/03/06 11:29] Kalle Valo Remove outdated documentation about branches and how to update the firmware, everything is now in linux-firmware anyway. |
||
|---|---|---|---|
| Line 7: | Line 7: | ||
| ===== ath10k firmware ===== | ===== ath10k firmware ===== | ||
| - | Firmware is temporalily available at [[https://github.com/kvalo/ath10k-firmware|https://github.com/kvalo/ath10k-firmware]] until it will be available from linux-firmware.git. | + | The ath10k firmware images are available from [[https://git.kernel.org/cgit/linux/kernel/git/firmware/linux-firmware.git/|linux-firmware.git]] which all common Linux distributions should install by default. Latest firmware images can be downloaded from [[https://git.codelinaro.org/clo/ath-firmware/ath10k-firmware|ath10k-firmware.git]] from which they get eventually pushed to [[https://git.kernel.org/cgit/linux/kernel/git/firmware/linux-firmware.git/|linux-firmware.git]]. |
| - | The firmware is searched from directory ath10k/QCA988X/hw2.0 under the system firmware directory, usually /lib/firmware. For example, here's a listing from an Ubuntu system where it's under /lib/firmware: | + | ===== Firmware API versions ===== |
| + | Because firmware changes between versions we have introduced firmware API concept to ath10k. This makes it possible to support different versions of ath10k. | ||
| - | <code>$ ls -l /lib/firmware/ath10k/QCA988X/hw2.0/ | ||
| - | total 508 | ||
| - | -rwxr-xr-x 1 root root 2116 Oct 22 11:01 board.bin* | ||
| - | -rw-r--r-- 1 root root 254564 Oct 22 11:01 firmware-2.bin | ||
| - | -rwxr-xr-x 1 root root 249093 Oct 22 11:01 firmware.bin* | ||
| - | -rwxr-xr-x 1 root root 5402 Oct 22 11:01 otp.bin* | ||
| - | $</code> | ||
| - | Description of the files: | ||
| - | ; board.bin : board file for the firmware | + | ==== Firmware API 1 ==== |
| - | ; firmware-2.bin : embedded firmware file (includes both firmware and otp) for ath10k versions supporting FW API 2 | + | |
| - | ; firmware.bin : firmware file for older ath10k versions supporting only FW API 1 | + | |
| - | ; otp.bin : otp file for older ath10k versions supporting only FW API 1 | + | |
| - | ===== Update firmware ===== | + | The first version. Firmware images are in separate files: firmware.bin and otp.bin. There's no FW IE support. Deprecated since March 2014 and removed on March 2016. |
| - | First download the firmware image from ath10k-firmware.git: | ||
| - | [[https://github.com/kvalo/ath10k-firmware/tree/master/|https://github.com/kvalo/ath10k-firmware/tree/master/]] | + | ==== Firmware API 2 ==== |
| - | In this example we use firmware-2.bin_10.1.467.2-1 from 10.1 directory. Then just copy that file as firmware-2.bin to the ath10k firmware directory: | + | Embedding both firmware and otp images into same file firmware-2.bin. Firmware meta data provided through FW IE. Added in commit 1a222435a dated Sep 27 2013, for Linux 3.13. Deprecated, no new firmware releases use this anymore. |
| + | ==== Firmware API 3 ==== | ||
| - | <code>cp firmware-2.bin_10.1.467.2-1 /lib/firmware/ath10k/QCA988X/hw2.0/firmware-2.bin</code> | + | Adding support for 10.2 firmware for QCA988X and ATH10K_FW_FEATURE_WMI_10_2 feature for 10.2 WMI mappings. Added in commit 24c88f7807fb7 dated Jul 27 2014. Deprecated, no new firmware releases use this anymore. |
| - | Then reload ath10k (or restart the system) and the new firmware is in use. | + | |
| - | Note: In some distributions the firmware location can be different than /lib/firmware. | + | ==== Firmware API 4 ==== |
| + | Adding support for ATH10K_FW_IE_WMI_OP_VERSION. Added in commit 4a16fbec1cd0a dated December 17th 2014. | ||
| - | ===== Firmware branches ===== | + | ==== Firmware API 5 ==== |
| - | ath10k firmware has different branches, they are described below. | + | Adding support for ATH10K_FW_IE_HTT_OP_VERSION, needed to support 10.2.4.48-2 on QCA988X. Added in commit 53513c302f35e March 25 2015. |
| + | ==== Firmware API 6 ==== | ||
| - | ==== main branch ==== | + | Workaround for board id being zero on QCA6174 hw3.0 starting from firmware release WLAN.RM.4.4-00022-QCARMSWPZ-2. Added in commit aad1fd7f7677 April 19 2017, first release v4.12-rc1. |
| - | + | ||
| - | Firmware versions 999.999.0.x. | + | |
| - | + | ||
| - | Supports AP mode, STA mode, Ad-Hoc and P2P. But AP mode is not that well tested, especially problems with DFS. | + | |
| - | + | ||
| - | + | ||
| - | ==== 10.1 branch ==== | + | |
| - | + | ||
| - | Firmware versions 10.1.x. | + | |
| - | + | ||
| - | Branch focusing on AP mode. Supports DFS. STA mode works but not well tested. No Ad-Hoc or P2P support. | + | |
| - | + | ||
| - | + | ||
| - | ===== Firmware API versions ===== | + | |
| - | + | ||
| - | Because firmware changes between versions we have introduced firmware API concept to ath10k. This makes it possible to support different versions of ath10k. | + | |
| - | + | ||
| - | + | ||
| - | ==== Firmware API 1 ==== | + | |
| - | + | ||
| - | The first version. Firmware images are in separate files: firmware.bin and otp.bin. There's no FW IE support. Deprecated since March 2014. | + | |
| - | + | ||
| - | + | ||
| - | ==== Firmware API 2 ==== | + | |
| - | Embedding both firmware and otp images into same file firmware-2.bin. Firmware meta data provided through FW IE. Added in commit 1a222435a dated Sep 27 2013, for Linux 3.13. | + | Also for QCA9377 hw1.0 fix IRAM bank compatibility starting from firmware release WLAN.TF.2.1-00014-QCARMSWP-1. Added in commit fc8b92635f79 February 2018, first release v4.17-rc1. |
en/users/drivers/ath10k/firmware.txt · Last modified: 2024/03/06 11:29 by Kalle Valo
Page Tools
