About ath10k#
ath10k is the mac80211 wireless driver for Qualcom Atheros QCA988xfamily of chips, which supportIEEE 802.11ac. It was first includedin Linux 3.11-rc1 released on 2013-07-14.
The ath10k driver is located underdrivers/net/wireless/ath/ath10kdirectory. For more information seeen/users/drivers/ath10k/sources.
- Support and reporting bugs
- Sources
- Submitting Patches
- Board Files
- FAQ
- Q:If ath10k support ad-hoc mode?
- Why I cannot start an AP in an 80 MHz channel / in 11ac mode?
- Why my MAC address is 00:03:07:12:34:56?
- How can I run latest ath10k on older kernels?
- How do I update the firmware?
- Why the TX rate reported to user space is wrong?
- Can I use ath10k as a 802.11ac sniffer?
- How do I get the best possible throughput with ath10k?
- Backports
- Architecture
- Debug
- Calibration
- Firmware
- Configuration
- Coding Style
- Spectral Scan
- Monitor Mode
- Mesh Mode
- TODO
- Private Support
Supported Devices#
ath10k supports Qualcomm Atheros 802.11ac QCA98xx hw2.0 and QCA6174based devices, here’s a list of known products:
QCA9880/QCA9882 Version 2 found inAIRETOS E98 Class by VOXMICRO MPNs: AEX-QCA9880 & AEX-QCA9882
QCA9890/QCA9892 Version 2 found inAIRETOS E98 Class by VOXMICRO MPNs: AEX-QCA9890 & AEX-QCA9892
QCA9888 found in2x2 MU-MIMO 802.11ac Wave 2 Wireless Module - Compex WLE650V5-18A
QCA9890 found inSparkLan WPEA-352ACNRBI - supports 802.11ac radio
QCA9890 Version 2 found inA family of Dual band/Single band/high powered/extended temp radio modules from Doodle Labs
QCA9882-BR4A found inSparkLan WPEQ-256ACN
QCA9882-BR4A found inSparkLan WPEQ-257ACN
QCA9892-BR4B found inSparkLan WPEQ-256ACNI
QCA9892 Version 2 found inA family of Dual band/Single band/high powered/extended temp radio modules from Doodle Labs
QCA9882 Version 2 found inCompex WLE600V5-27 11ac 2x2 miniPCIe Wireless Module
QCA9880 Version 2 found inSparkLan WPEA-352ACNRB - supports 802.11ac radio
QCA9880 Version 2 found inCompex acWave: WPJ344 - supports 802.11ac radio
QCA9880 Version 2 found inCompex WLE900V5-18
QCA9880 Version 2 found inCompex WLE900V5-27
QCA9880 Version 2 found inCompex WLE900VX [1]
QCA9880 Version 2 found inUnex: DAXA-O1
QCA9882 Version 2 found inCompex WLE600V5-18
QCA9882 Version 2 found inCompex WLE600V5-27
QCA9882 Version 2 found inCompex WLE600VX
QCA9880 Version 2 found inTP-Link : Archer C7 v2.x
QCA9880 Version 2 found inTP-Link : WDR7500 v3.0
QCA9880/QCA9890 found injjPlus JWX6052 andjjPlus JWX6053
QCA9882/QCA9892 found injjPlus JWX6055 andjjPlus JWX6056
QCA9880/QCA9890 found inEmWicon JWX6052(3x3) andEmWicon JWX6053(3x3 Industrial Grade)
QCA9882/QCA9892 found inEmWicon JWX6055(2x2) andEmWicon JWX6056(2x2 Industrial Grade)
QCA9377-5 found inSparkLan WNFQ-158ACN(BT)
QCA9886 found inWLE650V5-18
QCA6174A-5 found inAIRETOS E61 Class by VOXMICRO MPNs: AFX-QCA6174
QCA6174 / QCA6174A found inCompex WLT674 andBointec DPE109A
QCA6174A-5 found inSparkLan WPEA-251ACNI(BT)
QCA6174A-5 found inSparkLan WPEQ-261ACNI(BT)
QCA6174A-5 found inSparkLan WPEQ-262ACNI(BT) high power
QCA6174A-5 found inSparkLan WPEQ-261ACNI(BT)
QCA6174A-5 found inSparkLan WNFQ-261ACNI(BT)
QCA6174A-5 found inSparkLan WNFQ-262ACNI(BT)
QCA6174A-5 found inSparkLan WNFQ-258ACN(BT)
QCA6174A-5 found inSparkLan WNSQ-261ACN(BT)
QCA6174A-5 found inSparkLan WPEQ-261ACN(BT)
QCA6174A-5 found injjPlus JWX6058 andjjPlus JWW6051
QCA6174A-5 found inEmWicon JWX6058(mPCIe) andEmWicon JWW6051(M.2)
QCA9984 /QCA9994 found inCompex WLE1216V5-20
QCA9984 /QCA9994 found inEmWicon WMX6401/WMX6402
IPQ4018 found in8Devices Jalapeno module
[1] The Compex WLE900VX card enumerates as PCI device on some PCs butnot for some other PCs. The reason could possibly be PC hardware orkernel version. Detailed info:https://bugzilla.kernel.org/show_bug.cgi?id=84821. The Chaos Calmerwpj344a_150827_vCC.img provided byhttp://www.compex.com.sg/downloads/can detect and enable the WLE900VX card with ath10k.
Not supported#
ath10k does NOT support older QCA98xx hw1.0 chips found, for example,from these devices:
QCA9880 Version 1 found inTP-Link WDR-7500 v2 and Archer C7 v1.x
Any SDIO or USB devices are not supported, but work is ongoing to add that.
Known bugs/limitations#
firmware does not support association to the same AP from differentvirtual STA interfaces (driver prints “ath10k: Failed to add peerXX:XX:XX:XX:XX:XX for VDEV: X” in that case)
packet injection isn’t supported yet
applying ath9k regulatory domain hack patch from OpenWRT causesfirmware crash (reason: regulatory hint function is never called andath10k never sends scan channel list to the firmware which in turncauses firmware to crash on scan)
tx rate is reported as 6mbps due to firmware limitation (no tx rateinformation in tx completions); instead see/sys/kernel/debug/ieee80211/phyX/ath10k/fw_stats
WEP doesn’t work with AP_VLANs - frames are sent unencrypted(observed on: 999.999.0.636, 10.2.4.20-1, 10.1.467.2-1)
TX speeds are extremely poor on certain chips (QCA6174 is one). Apatchsolves the issue in most cases (source)