ath5k
ath5k is a completely FOSS wireless driver for Atheros WLAN based chipsets. It is now part of John's wireless-2.6 git repository.
Contents
Hacking ath5k
ath5k is currently available through different places.
The everything branch of wireless-2.6 git repository
The mm tree
Developers are encouraged to work using the git repository. If you are not familiar with git please check out our Linux wireless git-guide. Alternatively you can use the Linux wireless compatibility package but please be sure to post patches in unified diff format (diff -u). To learn how to submit patches please read our Submitting patches guideline.
Enabling ath5k
To enable ath5k, you must first enable mac80211:
Networking ---> Wireless ---> <M> Improved wireless configuration API <M> Generic IEEE 802.11 Networking Stack (mac80211)
Please note that there is another 802.11 networking stack:
<M> Generic IEEE 802.11 Networking Stack
You do not need this. This option enables the old SoftMAC stack we hope to kill one of these days. You can still safely enable this though.
You can then enable ath5k in the kernel configuration under
Device Drivers ---> [*] Network device support ---> Wireless LAN ---> <M> Atheros 5xxx wireless cards support
caveats
This driver is VERY new and under HEAVY development. Some users have reported success, some others have haven't had luck
supported chips
ath5k is designed with support in mind for any AR5210, AR5211 and AR5212 devices.
AR5210 - 802.11a AR5211 - 802.11ab AR5212 - 802.11abg
To do basic-testing of the driver you can do this:
modprobe ath5k sudo ip link set wlan%d up sudo iwconfig wlan%d essid any # Make sure you get auth'd and then assoc'd # Then either set an IP manually or get it via DHCP ping gw
You'll probably see an immediate rate drop to 1M, this is because of how we currently handle rate control. You should be able to keep at least at 11M but for now set this manually:
iwconfig wlan%d rate 11M
Currently supported PCI ID list with respective status report on basic-testing as defined above.
Vendor:device Type Basic-testing 168c:0207 AR5210 ? 168c:0007 AR5210 ? 168c:0011 AR5211 ? 168c:0012 AR5211 OK 168c:0013 AR5212 OK a727:0013 AR5212 ? 10b7:0013 AR5212 ? 168c:0014 AR5212 ? 168c:0015 AR5212 ? 168c:0016 AR5212 ? 168c:0017 AR5212 ? 168c:0018 AR5212 ? 168c:0019 AR5212 ? 168c:001a AR5212 ? 168c:001b AR5212 ? 168c:001c AR5212 Loads, but no rx
Notes on supported devices
Please note that 001c is an 802.11bg device. As you can see from above the current driver design is for 802.11a, 802.11ab, or 802.11abg. We'll probably need a new device type in the driver for this device to pass only bg initial register writes and baseband gain settings.
available devices
Please visit http://madwifi.org/wiki/Compatibility for a complete list of supported devices
features
Supports 802.11abg, depending on the chipset, and some vendor extensions such as Atheros XR and Turbo. This driver requires no firmware!
working
Station Mode
not working yet
Access Point mode
Turbo
XR
Get driver
This driver is currently only in the everything branch of wireless-2.6.git.
ath5k kerneldoc
We have kerneldocs available for ath5k:
- General driver structure:
- Main PCI and mac80211 driver interface:
- Debug utilities:
- Hardware access:
- Initialization and PHY control:
initvals.c (warnings) (TODO)
- Regulatory:
- Hardware registers: