Go back –> Atheros Linux wireless drivers
Contents
About ath10k
ath10k is the mac80211 wireless driver for Qualcom Atheros QCA988x family of chips, which support IEEE 802.11ac.
A major difference from ath9k is that there's now a firmware and that's why we had to implement a new driver.
Subpages
News
- 2013-09-02
- Linux 3.11 released, the first kernel release with ath10k
- 2013-07-14
- ath10k merged into Linux 3.11-rc1
- 2013-06-01
review v2: http://marc.info/?l=linux-wireless&m=137008586705509&w=2
Mailing list
ath10k has it's own mailing list for discussions and patches:
http://lists.infradead.org/mailman/listinfo/ath10k
Archive for the mailing list:
http://lists.infradead.org/pipermail/ath10k/
IRC channel
For real time discussions there is #ath10k channel on Freenode.
Known bugs/limitations
firmware does not support association to the same AP from different virtual STA interfaces (driver prints "ath10k: Failed to add peer XX:XX:XX:XX:XX:XX for VDEV: X" in that case)
- monitor/promiscuous mode causes firmware crashes very often
- packet injection isn't supported yet
- applying ath9k regulatory domain hack patch from OpenWRT causes firmware crash (reason: regulatory hint function is never called and ath10k never sends scan channel list to the firmware which in turn causes firmware to crash on scan)
Configuration
Building
To build ath10k enable these kernel build configuration options, for example with make menuconfig:
- CONFIG_ATH10K
- CONFIG_ATH10K_PCI
- CONFIG_ATH10K_DEBUG (optional)
- CONFIG_ATH10K_DEBUGFS (optional)
- CONFIG_ATH10K_TRACING (optional)
The debug and tracing options are optional, but it's strongly recommended to enable to make it easier to debug issues.
ath10k options can be found from location:
-> Device Drivers -> Network device support (NETDEVICES [=y]) -> Wireless LAN (WLAN [=y]) -> Atheros Wireless Cards (ATH_CARDS [=m])
Loading the modules
The ath10k modules should be loaded automatically in most systems. If that's not happening, first load ath10k_core.ko and then ath10k_pci.ko.
hostapd
When building hostapd enable these configuration options:
- CONFIG_IEEE80211AC
- CONFIG_ACS
Example hostapd config to use 11ac VHT80 mode with ath10k:
interface=wlan0 driver=nl80211 ssid=ath10k-test hw_mode=a channel=36 ht_capab=[HT40+] ieee80211n=1 ieee80211ac=1 vht_oper_chwidth=1 vht_oper_centr_freq_seg0_idx=42
vht_oper_centr_freq_seg0_idx is calculated for VHT80 with channel + 6.
To enable ACS:
channel=0
If you get "set channel failed to set in kernel" error message, most likely your regulatory database doesn't support 80 MHz channels.
Reporting bugs
Please send bug reports to the mailing list ath10k@lists.infradead.org
Supported Devices
ath10k supports Qualcomm Atheros 802.11ac QCA98xx hw2.0 based devices, here's a list of known products:
QCA9880 Version 2 found in Compex acWave
ath10k does NOT support older QCA98xx hw1.0 chips found, for example, from these devices:
QCA9880 found in Tp-Link WDR-7500
Atheros common module
ath10k uses the common shared ath.ko module.
Statistics on contributions
Visit the ath10k contribution graphs. You can help keep this up to date if you like. If interested contact the ath10k driver maintainers.