Differences between revisions 15 and 16
Revision 15 as of 2013-01-06 19:26:33
Size: 8559
Comment: added link to it translation
Revision 16 as of 2013-04-29 09:20:44
Size: 0
Editor: GeoffSimmons
Comment: Driver in mainline since Linux 3.8, build procedures are obsolete; will reinstate when 3.8 is in jessie and wheezy-backports.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#language en
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[fr/ar5523|Français]] - [[it/ar5523|Italiano]]-~
----
= Atheros AR5523 devices =

This page describes how to enable support for !WiFi devices based on Atheros AR5005UG and AR5005UX chipsets on Debian systems.

<<TableOfContents(3)>>

ar5523 is an out-of-tree Linux kernel driver currently in development, for the Atheros AR5005UG (802.11b/g) and AR5005UX (802.11a/b/g) USB wireless LAN chipsets. [[#supported|Supported devices]] are listed at the end of this page.

Firmware from userspace is required for device operation.

{i} Atheros AR5007UG 802.11g USB devices are supported by the [[zd1211rw]] driver.

{i} Atheros 802.11n USB devices are supported by the [[ar9170usb]], [[carl9170]] and [[ath9k_htc]] drivers.

== Installation ==
<<Anchor(squeeze)>>
=== Squeeze ===

 1. Add the [[Backports|Debian Backports]] repository to {{{/etc/apt/sources.list}}}, for example: {{{
# Backported packages for Debian Squeeze/6.0
deb http://backports.debian.org/debian-backports squeeze-backports main
}}}
 1. Update the list of available packages: {{{
# aptitude update
}}}
 1. Install the DebianPkg:build-essential, DebianPkg:fakeroot, DebianPkg:module-assistant, DebianPkg:quilt, DebianPkg:subversion and DebianPkg:wget packages, along with the DebianPkg:debhelper package from squeeze-backports: {{{
# aptitude -t squeeze-backports install build-essential debhelper fakeroot module-assistant quilt subversion wget && exit
}}}
 1. Acquire the driver source and device firmware: {{{
$ svn co svn://svn.berlios.de/fullstory/ar5523/trunk/ ar5523
$ wget http://verein.lst.de/~hch/ar5523.tgz
$ tar xf ar5523.tgz ar5523/uath-ar5523.bin --strip 1
}}}
 1. Build and install a driver source package: {{{
$ cd ar5523
$ export QUILT_PATCHES="debian/patches"
$ quilt delete kcompat-3.5 && quilt delete kcompat-2.6.34
$ dpkg-buildpackage -us -uc
$ su
# dpkg -i ../ar5523-source*deb
}}}
 1. Build and install an ar5523-modules-* package for your system, using [[ModuleAssistant|Module-Assistant]]: {{{
# m-a a-i ar5523
}}}
 1. Install the device firmware: {{{
# mkdir /usr/local/lib/firmware
# mv ../uath-ar5523.bin /usr/local/lib/firmware
}}}
 1. Connect the device to your system. The ar5523 kernel module is [[Modules|automatically loaded]] for supported devices.
 1. [[WiFi/HowToUse|Configure]] your interface as appropriate.

<<Anchor(wheezy)>>
=== Wheezy ===

 1. Install the DebianPkg:build-essential, DebianPkg:debhelper, DebianPkg:fakeroot, DebianPkg:module-assistant, DebianPkg:quilt, DebianPkg:subversion and DebianPkg:wget packages: {{{
# aptitude install build-essential debhelper fakeroot module-assistant quilt subversion wget && exit
}}}
 1. Acquire the driver source and device firmware: {{{
$ svn co svn://svn.berlios.de/fullstory/ar5523/trunk/ ar5523
$ wget http://verein.lst.de/~hch/ar5523.tgz
$ tar xf ar5523.tgz ar5523/uath-ar5523.bin --strip 1
}}}
 1. Build and install a driver source package: {{{
$ cd ar5523
$ QUILT_PATCHES="debian/patches" quilt delete kcompat-3.5
$ dpkg-buildpackage -us -uc
$ su
# dpkg -i ../ar5523-source*deb
}}}
 1. Build and install an ar5523-modules-* package for your system, using [[ModuleAssistant|Module-Assistant]]: {{{
# m-a a-i ar5523
}}}
 1. Install the device firmware: {{{
# mkdir /usr/local/lib/firmware
# mv ../uath-ar5523.bin /usr/local/lib/firmware
}}}
 1. Connect the device to your system. The ar5523 kernel module is [[Modules|automatically loaded]] for supported devices.
 1. [[WiFi/HowToUse|Configure]] your interface as appropriate.

<<Anchor(troubleshoot)>>
== Troubleshooting ==
 * Examine the kernel ring buffer ([[DebianMan:1/dmesg|dmesg(1)]]) to verify the required firmware is found: {{{
[ 8084.710715] usb 2-1: new full speed USB device using ohci_hcd and address 10
[ 8084.875861] usb 2-1: configuration #1 chosen from 1 choice
[ 8084.892602] usb 2-1: New USB device found, idVendor=2001, idProduct=3a03
[ 8084.898149] usb 2-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 8084.903447] usb 2-1: Product: USB WLAN Device
[ 8084.908639] usb 2-1: Manufacturer: Atheros Communications Inc
[ 8084.913807] usb 2-1: SerialNumber: 1.0
[ 8085.410164] firmware: requesting uath-ar5523.bin
[ 8085.906863] usb 2-1: no firmware found
[ 8085.912293] ar5523: probe of 2-1:1.0 failed with error -2
[ 8085.917628] usbcore: registered new interface driver ar5523
}}}
  * Ensure the firmware is installed, then reload the kernel module: {{{
modprobe -r ar5523 ; modprobe ar5523
}}}

<<Anchor(supported)>>
== Supported Devices ==
## DO NOT REMOVE : this paragraph is required for search-engines !
The page [[HowToIdentifyADevice/USB]] explains how to identify a USB device.

The following list is based on the ''alias'' fields of {{{modinfo ar5523}}} as at Subversion revision 31327.
## list generated with: http://www.klabs.be/~fpiat/linux/hardware/modinfo-devnames/
##TAG:LIST_1_START
 ~- {{{
USB: 0846:4250 NetGear, Inc. WG111T 802.11g Wireless Adapter [Atheros AR5523]
USB: 0846:4251 NetGear, Inc. (Device name unknown)
USB: 0846:4300 NetGear, Inc. WG111U Double 108 Mbps Wireless [Atheros AR5004X / AR5005UX]
USB: 0846:4301 NetGear, Inc. WG111U (no firmware) Double 108 Mbps Wireless [Atheros AR5004X / AR5005UX]
USB: 0846:5F00 NetGear, Inc. WPN111 802.11g Wireless Adapter [Atheros AR5523]
USB: 0846:5F01 NetGear, Inc. (Device name unknown)
USB: 0CDE:0012 Z-Com AR5523
USB: 0CDE:0013 Z-Com AR5523 driver (no firmware)
USB: 0CF3:0001 Atheros Communications, Inc. AR5523
USB: 0CF3:0002 Atheros Communications, Inc. AR5523 (no firmware)
USB: 0CF3:0003 Atheros Communications, Inc. AR5523
USB: 0CF3:0004 Atheros Communications, Inc. AR5523 (no firmware)
USB: 0CF3:0005 Atheros Communications, Inc. AR5523
USB: 0CF3:0006 Atheros Communications, Inc. AR5523 (no firmware)
USB: 0D8E:7801 Global Sun Technology, Inc. AR5523
USB: 0D8E:7802 Global Sun Technology, Inc. AR5523 (no firmware)
USB: 0D8E:7803 Global Sun Technology, Inc. (Device name unknown)
USB: 0D8E:7811 Global Sun Technology, Inc. AR5523
USB: 0D8E:7812 Global Sun Technology, Inc. AR5523 (no firmware)
USB: 129B:160C CyberTAN Technology Siemens S30853-S1038-R351 802.11g Wireless Adapter [Atheros AR5523]
USB: 129B:160D CyberTAN Technology (Device name unknown)
USB: 1385:4250 Netgear, Inc WG111T
USB: 1385:4251 Netgear, Inc WG111T (no firmware)
USB: 1385:5F00 Netgear, Inc WPN111 RangeMax(TM) Wireless USB 2.0 Adapter
USB: 1385:5F01 Netgear, Inc WPN111 (no firmware)
USB: 1435:0826 Wistron NeWeb AR5523
USB: 1435:0827 Wistron NeWeb AR5523 (no firmware)
USB: 1435:0828 Wistron NeWeb AR5523
USB: 1435:0829 Wistron NeWeb AR5523 (no firmware)
USB: 157E:3006 TRENDnet TEW-444UB EU
USB: 157E:3007 TRENDnet TEW-444UB EU (no firmware)
USB: 157E:3205 TRENDnet Allnet ALL0283 [AR5523]
USB: 157E:3206 TRENDnet Allnet ALL0283 [AR5523](no firmware)
USB: 168C:0001 Atheros Communications AR5523
USB: 168C:0002 Atheros Communications AR5523 (no firmware)
USB: 1690:0710 Askey Computer Corp. [hex] SMCWUSBT-G
USB: 1690:0711 Askey Computer Corp. [hex] SMCWUSBT-G (no firmware)
USB: 1690:0712 Askey Computer Corp. [hex] AR5523
USB: 1690:0713 Askey Computer Corp. [hex] AR5523 (no firmware)
USB: 16AB:7801 Global Sun Technology AR5523
USB: 16AB:7802 Global Sun Technology AR5523 (no firmware)
USB: 16AB:7811 Global Sun Technology AR5523
USB: 16AB:7812 Global Sun Technology AR5523 (no firmware)
USB: 2001:3A00 D-Link Corp. DWL-AG132 [Atheros AR5523]
USB: 2001:3A01 D-Link Corp. DWL-AG132 (no firmware) [Atheros AR5523]
USB: 2001:3A02 D-Link Corp. DWL-G132 [Atheros AR5523]
USB: 2001:3A03 D-Link Corp. DWL-G132 (no firmware) [Atheros AR5523]
USB: 2001:3A04 D-Link Corp. DWL-AG122 [Atheros AR5523]
USB: 2001:3A05 D-Link Corp. DWL-AG122 (no firmware) [Atheros AR5523]
}}} -~
##TAG:LIST_1_END

== See Also ==

 * [[ar9170usb]] - Atheros AR9170 devices
 * [[ath9k_htc]] - Atheros AR9271, AR7010 devices
 * [[carl9170]] - Atheros AR9170 devices
 * [[zd1211rw]] - Atheros AR5007UG devices
 * [[WiFi/HowToUse|How to use a WiFi interface]]

== External Links ==

 * http://wireless.kernel.org/en/users/Drivers/ar5523 - Driver page on Linux Wireless
 * http://web.archive.org/web/20080421050039/http://www.atheros.com/pt/AR5005UG.htm - AR5005UG product page
 * http://web.archive.org/web/20080731095622/http://www.atheros.com/pt/AR5005UX.htm - AR5005UX product page

----
CategoryHardware | CategoryWireless