User Tools

Site Tools


en:users:drivers:ath10k:firmware

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:users:drivers:ath10k:firmware [2015/04/23 05:45]
Michał Kazior People seem to be confused with firmware versioning so add a comprehensive table for quick reference.
en:users:drivers:ath10k:firmware [2024/03/06 11:29] (current)
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 +
  
-==== Overview =====+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.
  
  
-^ Hardware ​ ^ Firmware ​major version/​branch ​ ^ Latest firmware revision ​        ^ Intended use  ^ Kernel version required* ​ ^ Git commit ​                 ^ +==== Firmware ​API ====
-| QCA988X ​  | main                           | 999.999.0.636 ​                   | STA           | 3.11                      | 5e3dd157d7e7 ​               | +
-| QCA988X ​  | 10.1                           | 10.1.467.2-1                     | AP            | 3.13                      | 8acd3c97ff9e ​               | +
-| QCA988X ​  | 10.2                           | 10.2-00082-4-2 ​                  | AP            | 3.18                      | 24c88f7807fb ​               | +
-| QCA988X ​  | 10.2.4 ​                        | 10.2.4.48 ​                       | AP            | 4.0                       | 4a16fbec1cd0 ​               | +
-| QCA61X4 ​  | wmi-tlv ​                       | WLAN.RM.2.0-00073-QCARMSWPZ-1-1 ​ | AP/​STA ​       | 4.0                       | d63955b33b3b,​ ca996ec56608 ​ |+
  
-* Note: It is possible to use newer ath10k driver on an older kernel with backports project: https://​backports.wiki.kernel.org+Embedding both firmware and otp images into same file firmware-2.binFirmware 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.
  
-===== Update firmware =====+==== Firmware API 3 ====
  
-First download the firmware ​image from ath10k-firmware.git: +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.
  
-[[https://​github.com/​kvalo/​ath10k-firmware/​tree/​master/​|https://​github.com/​kvalo/​ath10k-firmware/​tree/​master/​]] ​+==== Firmware API 4 ====
  
-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: ​+Adding support for ATH10K_FW_IE_WMI_OP_VERSIONAdded in commit 4a16fbec1cd0a dated December 17th 2014.
  
 +==== Firmware API 5 ====
  
-<​code>​cp firmware-2.bin_10.1.467.2-1 /​lib/​firmware/​ath10k/​QCA988X/​hw2.0/​firmware-2.bin</​code>​ +Adding support for ATH10K_FW_IE_HTT_OP_VERSION,​ needed to support 10.2.4.48-on QCA988X. ​Added in commit 53513c302f35e March 25 2015.
-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 6 ====
  
 +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 branches ===== +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.
- +
-ath10k firmware has different branches, they are described below.  +
- +
- +
-==== main branch ==== +
- +
-Firmware versions 999.999.0.x +
- +
-Supports AP mode, STA mode, Ad-Hoc and P2PBut AP mode is not that well tested, especially problems with DFS.  +
- +
- +
-==== 10.x branch ==== +
- +
-Firmware versions 10.x.y.  +
- +
-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 ==== +
- +
-The first versionFirmware 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.  
en/users/drivers/ath10k/firmware.1429767930.txt.gz · Last modified: 2015/04/23 05:45 by Michał Kazior