3 .\" Damien Bergamini <damien.bergamini@free.fr>
5 .\" Permission to use, copy, modify, and distribute this software for any
6 .\" purpose with or without fee is hereby granted, provided that the above
7 .\" copyright notice and this permission notice appear in all copies.
9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
24 .Nd Atheros USB IEEE 802.11a/b/g wireless network device
26 To compile this driver into the kernel,
27 place the following lines in your
28 kernel configuration file:
29 .Bd -ragged -offset indent
38 Alternatively, to load the driver as a
39 module at boot time, place the following line in
41 .Bd -literal -offset indent
47 driver supports USB 2.0 wireless network devices based on Atheros
48 Communications fifth generation AR5005UG and AR5005UX chipsets.
50 The AR5005UG chipset is made of an AR5523 multiprotocol MAC/baseband processor
51 and an AR2112 Radio-on-a-Chip that can operate between 2300 and 2500 MHz
54 The AR5005UX chipset is made of an AR5523 multiprotocol MAC/baseband processor
55 and an AR5112 dual band Radio-on-a-Chip that can operate between 2300 and
56 2500 MHz (802.11b/g) or 4900 and 5850 MHz (802.11a).
58 The AR5005UG and AR5005UX chipsets both have an integrated 32-bit MIPS
59 R4000-class processor that runs a firmware and manages, among other things,
60 the automatic control of the transmit rate and the calibration of the radio.
68 Only one virtual interface may be configured at any time.
69 For more information on configuring this device, see
73 requires firmware that is downloaded to the device.
74 This is normally done by the
76 utility that is launched by
78 when the device is inserted.
80 includes the firmware in the binary program.
81 This firmware is licensed for general use and is included in the base system.
85 driver should work with the following adapters:
87 .Bl -column -compact "TRENDware International TEW-444UB" "AR5005UX" -offset 6n
88 .It Em "Adapter Chipset"
89 .\".It Belkin F6D3050 AR5005UX
90 .It Li "Compex WLU108AG" Ta AR5005UX
91 .It Li "Compex WLU108G" Ta AR5005UG
92 .\".It Li "D-Link DWL-AG132" Ta AR5005UX
93 .It Li "D-Link DWL-G132" Ta AR5005UG
94 .\".It Li "Edimax EW-7315Ug" Ta AR5005UG (AR2414???)
95 .\".It Li "Lancom USB-54ag" Ta AR5005UX
96 .\".It Li "NEC WL54TU" Ta AR5005UX
97 .It Li "IODATA WN-G54/US" Ta AR5005UG
98 .It Li "MELCO WLI-U2-KAMG54" Ta AR5005UX
99 .It Li "Netgear WG111T" Ta AR5005UG
100 .It Li "Netgear WG111U" Ta AR5005UX
101 .It Li "Netgear WPN111" Ta AR5005UG
102 .It Li "Olitec 000544" Ta AR5005UG
103 .It Li "PLANET WDL-U357" Ta AR5005UX
104 .\".It Li "Senao WUB-8004" Ta AR5005UX
105 .It Li "Siemens Gigaset 108" Ta AR5005UG
106 .It Li "SMC SMCWUSBT-G" Ta AR5005UG
107 .It Li "SMC SMCWUSBT-G2" Ta AR5005UG
108 .\".It Li "SparkLAN WL-685GS" Ta AR5005UG
109 .It Li "SparkLAN WL-785A" Ta AR5005UX
110 .It Li "TP-Link TL-WN620G" Ta AR5005UG
111 .It Li "TRENDware International TEW-444UB" Ta AR5005UG
112 .It Li "TRENDware International TEW-504UB" Ta AR5005UX
113 .It Li "Unex Technology UR054ag" Ta AR5005UX
114 .\".It Li "Wistron NeWeb DCUA-81" Ta AR5005UX
115 .\".It Li "Wistron NeWeb DRUA-81" Ta AR5005UG
116 .\".It Li "Wistron NeWeb DRUA-82" Ta AR5005UX
117 .\".It Li "ZyXEL G-200 v2" Ta AR5005UG
118 .It Li "ZyXEL XtremeMIMO M-202" Ta AR5005UX
121 An up to date list can be found at
122 .Pa http://customerproducts.atheros.com/customerproducts/default.asp .
124 Join an existing BSS network (i.e., connect to an access point):
126 .Bd -literal -offset indent
127 ifconfig wlan create wlandev uath0 inet 192.168.0.20 \e
131 Join a specific BSS network with network name
134 .Dl "ifconfig wlan create wlandev uath0 ssid my_net up"
136 Join a specific BSS network with 64-bit WEP encryption:
137 .Bd -literal -offset indent
138 ifconfig wlan create wlandev uath0 ssid my_net \e
139 wepmode on wepkey 0x1234567890 weptxkey 1 up
142 Join a specific BSS network with 128-bit WEP encryption:
143 .Bd -literal -offset indent
144 ifconfig wlan create wlandev uath0 wlanmode adhoc ssid my_net \e
145 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
149 .It "uath%d: could not send command (error=%s)"
150 An attempt to send a command to the firmware failed.
151 .It "uath%d: timeout waiting for command reply"
152 A read command was sent to the firmware but the firmware failed to reply in
154 .It "uath%d: device timeout"
155 A frame dispatched to the hardware for transmission did not complete in time.
156 The driver will reset the hardware.
157 This should not happen.
173 driver first appeared in
179 driver was written by
180 .An Weongyo Jeong Aq weongyo@freebsd.org
182 .An Sam Leffler Aq sam@freebsd.org .
183 It is distantly related to a driver written by
184 .An Damien Bergamini Aq damien@openbsd.org .
186 Atheros proprietary 108 Mbps mode (aka Super AG mode) is not supported.
188 Dual-band adapters are presently not working;
189 to workaround, restriction operation to 2.4GHz channels.