1.\" $OpenBSD: atu.4,v 1.37 2013/10/19 16:53:14 schwarze Exp $ 2.\" 3.\" Copyright (c) 1997, 1998, 1999 4.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Bill Paul. 17.\" 4. Neither the name of the author nor the names of any co-contributors 18.\" may be used to endorse or promote products derived from this software 19.\" without specific prior written permission. 20.\" 21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 31.\" THE POSSIBILITY OF SUCH DAMAGE. 32.\" 33.Dd $Mdocdate: October 19 2013 $ 34.Dt ATU 4 35.Os 36.Sh NAME 37.Nm atu 38.Nd Atmel AT76C50x USB IEEE 802.11b wireless network device 39.Sh SYNOPSIS 40.Cd "atu* at uhub? port ?" 41.Sh DESCRIPTION 42The 43.Nm 44driver provides support for wireless network adapters based around 45the Atmel AT76C503, AT76C503A, AT76C505, and AT76C505A USB chipsets and four 46companion radio chipsets. 47.Pp 48The 49.Nm 50driver encapsulates all IP and ARP traffic as 802.11 frames, 51though it can receive either 802.11 or 802.3 frames. 52.Pp 53These are the modes the 54.Nm 55driver can operate in: 56.Bl -tag -width "IBSS-masterXX" 57.It BSS mode 58Also known as 59.Em infrastructure 60mode, this is used when associating with an access point, through 61which all traffic passes. 62This mode is the default. 63.It IBSS mode 64Also known as 65.Em IEEE ad-hoc 66mode or 67.Em peer-to-peer 68mode. 69This is the standardized method of operating without an access point. 70Stations associate with a service set. 71However, actual connections between stations are peer-to-peer. 72.El 73.Pp 74The 75.Nm 76driver can be configured to use hardware 77Wired Equivalent Privacy (WEP). 78It is strongly recommended that WEP 79not be used as the sole mechanism 80to secure wireless communication, 81due to serious weaknesses in it. 82.Pp 83The 84.Nm 85driver can be configured at runtime with 86.Xr ifconfig 8 87or on boot with 88.Xr hostname.if 5 . 89.Sh HARDWARE 90The following devices are known to be supported by the 91.Nm 92driver: 93.Pp 94.Bl -tag -width Ds -offset indent -compact 95.It Tn 3Com 3CRSHEW696 96.It Tn AboCom BWU613 97.It Tn Accton 2664W 98.It Tn Acer Peripherals AWL300 99.It Tn Acer Peripherals AWL400 100.It Tn Actiontec 802UAT1 101.It Tn Addtron AWU120 102.It Tn Aincomm AWU2000B 103.It Tn Askey Computer Voyager 1010 104.It Tn Askey Computer WLL013 (Intersil Radio) 105.It Tn Askey Computer WLL013 (RFMD Radio) 106.It Tn Atmel AT76C503 (Intersil Radio) 107.It Tn Atmel AT76C503 (RFMD Radio) 108.It Tn Atmel AT76C505 (RFMD Radio) 109.It Tn Atmel AT76C505 (RFMD 2958 Radio) 110.It Tn Atmel AT76C505A (RFMD 2958 Radio) 111.It Tn Atmel AT76C505AS (RFMD 2958 Radio) 112.It Tn Belkin F5D6050 113.It Tn Bluetake BW002 114.It Tn Compaq iPAQ h54xx/h55xx Internal WLAN 115.It Tn Conceptronic C11U 116.It Tn Conceptronic WL210 117.It Tn Corega WLAN USB Stick 11 118.It Tn Dick Smith Electronics CHUSB 611G 119.It Tn Dick Smith Electronics WL200U 120.It Tn Dick Smith Electronics WL240U 121.It Tn Dick Smith Electronics XH1153 122.It Tn D-Link DWL-120 rev E 123.It Tn Geowave GW-US11S 124.It Tn Gigabyte GN-WLBM101 125.It Tn Gigaset WLAN 126.It Tn Hewlett-Packard HN210W 127.It Tn Intel AP310 AnyPoint II 128.It Tn I/O DATA USB WN-B11 129.It Tn Lexar 2662W-AR 130.It Tn Linksys WUSB11 802.11b 131.It Tn Linksys WUSB11 802.11b v2.8 132.It Tn MSI WLAN 133.It Tn Netgear MA101 134.It Tn Netgear MA101 rev B 135.It Tn OQO model 01 WiFi 136.It Tn Ovislink AirLive WL-1120USB 137.It Tn OvisLink AirLive WL-1130USB 138.It Tn Planex Communications GW-US11S 139.It Tn Samsung SWL2100W 140.It Tn Siemens WLL013 141.It Tn SMC EZ Connect 11Mbps (SMC2662w) 142.It Tn SMC EZ Connect 11Mbps v2 (SMC2662wV2) 143.It Tn Tekram U-300C 144.It Tn TRENDnet TEW-229UB 145.It Tn W-Buddie WN210 146.It Tn Z-Com M4Y-750 147.El 148.Sh FILES 149The adapter needs some firmware files, which are loaded on demand by the 150driver when the device is attached: 151.Pp 152.Bl -tag -width Ds -offset indent -compact 153.It Pa /etc/firmware/atu-at76c503-i3863-int 154.It Pa /etc/firmware/atu-at76c503-i3863-ext 155.It Pa /etc/firmware/atu-at76c503-rfmd-acc-int 156.It Pa /etc/firmware/atu-at76c503-rfmd-acc-ext 157.It Pa /etc/firmware/atu-at76c505-rfmd-int 158.It Pa /etc/firmware/atu-at76c505-rfmd-ext 159.It Pa /etc/firmware/atu-intersil-int 160.It Pa /etc/firmware/atu-intersil-ext 161.It Pa /etc/firmware/atu-rfmd-int 162.It Pa /etc/firmware/atu-rfmd-ext 163.It Pa /etc/firmware/atu-rfmd2958-int 164.It Pa /etc/firmware/atu-rfmd2958-ext 165.It Pa /etc/firmware/atu-rfmd2958smc-int 166.It Pa /etc/firmware/atu-rfmd2958smc-ext 167.El 168.Sh EXAMPLES 169The following example scans for available networks: 170.Pp 171.Dl # ifconfig atu0 scan 172.Pp 173The following 174.Xr hostname.if 5 175example configures atu0 to join network 176.Dq mynwid , 177using WEP key 178.Dq mywepkey , 179obtaining an IP address using DHCP: 180.Bd -literal -offset indent 181nwid mynwid 182nwkey mywepkey 183dhcp 184.Ed 185.Sh SEE ALSO 186.Xr arp 4 , 187.Xr ifmedia 4 , 188.Xr intro 4 , 189.Xr netintro 4 , 190.Xr usb 4 , 191.Xr hostname.if 5 , 192.Xr ifconfig 8 193.Sh AUTHORS 194.An -nosplit 195The 196.Nm 197driver was written by 198.An Daan Vreeken 199and ported to 200.Ox 201by 202.An Theo de Raadt 203and 204.An David Gwynne . 205.Sh CAVEATS 206The 207.Nm 208driver does not support a lot of the functionality available in the hardware. 209More work is required to properly support the IBSS, power management, 210and selectable transmission rate features. 211