1.\" $OpenBSD: atu.4,v 1.41 2021/10/24 12:32:42 kn 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 24 2021 $ 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 FILES 90The adapter needs some firmware files, which are loaded on demand by the 91driver when the device is attached: 92.Pp 93.Bl -tag -width Ds -offset indent -compact 94.It Pa /etc/firmware/atu-at76c503-i3863-int 95.It Pa /etc/firmware/atu-at76c503-i3863-ext 96.It Pa /etc/firmware/atu-at76c503-rfmd-acc-int 97.It Pa /etc/firmware/atu-at76c503-rfmd-acc-ext 98.It Pa /etc/firmware/atu-at76c505-rfmd-int 99.It Pa /etc/firmware/atu-at76c505-rfmd-ext 100.It Pa /etc/firmware/atu-intersil-int 101.It Pa /etc/firmware/atu-intersil-ext 102.It Pa /etc/firmware/atu-rfmd-int 103.It Pa /etc/firmware/atu-rfmd-ext 104.It Pa /etc/firmware/atu-rfmd2958-int 105.It Pa /etc/firmware/atu-rfmd2958-ext 106.It Pa /etc/firmware/atu-rfmd2958smc-int 107.It Pa /etc/firmware/atu-rfmd2958smc-ext 108.El 109.Sh HARDWARE 110The following devices are known to be supported by the 111.Nm 112driver: 113.Pp 114.Bl -tag -width Ds -offset indent -compact 115.It Tn 3Com 3CRSHEW696 116.It Tn AboCom BWU613 117.It Tn Accton 2664W 118.It Tn Acer Peripherals AWL300 119.It Tn Acer Peripherals AWL400 120.It Tn Actiontec 802UAT1 121.It Tn Addtron AWU120 122.It Tn Aincomm AWU2000B 123.It Tn Askey Computer Voyager 1010 124.It Tn Askey Computer WLL013 (Intersil Radio) 125.It Tn Askey Computer WLL013 (RFMD Radio) 126.It Tn Atmel AT76C503 (Intersil Radio) 127.It Tn Atmel AT76C503 (RFMD Radio) 128.It Tn Atmel AT76C505 (RFMD Radio) 129.It Tn Atmel AT76C505 (RFMD 2958 Radio) 130.It Tn Atmel AT76C505A (RFMD 2958 Radio) 131.It Tn Atmel AT76C505AS (RFMD 2958 Radio) 132.It Tn Belkin F5D6050 133.It Tn Bluetake BW002 134.It Tn Compaq iPAQ h54xx/h55xx Internal WLAN 135.It Tn Conceptronic C11U 136.It Tn Conceptronic WL210 137.It Tn Corega WLAN USB Stick 11 138.It Tn Dick Smith Electronics CHUSB 611G 139.It Tn Dick Smith Electronics WL200U 140.It Tn Dick Smith Electronics WL240U 141.It Tn Dick Smith Electronics XH1153 142.It Tn D-Link DWL-120 rev E 143.It Tn Geowave GW-US11S 144.It Tn Gigabyte GN-WLBM101 145.It Tn Gigaset WLAN 146.It Tn Hewlett-Packard HN210W 147.It Tn Intel AP310 AnyPoint II 148.It Tn I/O DATA USB WN-B11 149.It Tn Lexar 2662W-AR 150.It Tn Linksys WUSB11 802.11b 151.It Tn Linksys WUSB11 802.11b v2.8 152.It Tn MSI WLAN 153.It Tn Netgear MA101 154.It Tn Netgear MA101 rev B 155.It Tn OQO model 01 WiFi 156.It Tn Ovislink AirLive WL-1120USB 157.It Tn OvisLink AirLive WL-1130USB 158.It Tn Planex Communications GW-US11S 159.It Tn Samsung SWL2100W 160.It Tn Siemens WLL013 161.It Tn SMC EZ Connect 11Mbps (SMC2662w) 162.It Tn SMC EZ Connect 11Mbps v2 (SMC2662wV2) 163.It Tn Tekram U-300C 164.It Tn TRENDnet TEW-229UB 165.It Tn W-Buddie WN210 166.It Tn Z-Com M4Y-750 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 181join mynwid nwkey mywepkey 182inet autoconf 183.Ed 184.Sh SEE ALSO 185.Xr arp 4 , 186.Xr ifmedia 4 , 187.Xr intro 4 , 188.Xr netintro 4 , 189.Xr usb 4 , 190.Xr hostname.if 5 , 191.Xr ifconfig 8 192.Sh AUTHORS 193.An -nosplit 194The 195.Nm 196driver was written by 197.An Daan Vreeken 198and ported to 199.Ox 200by 201.An Theo de Raadt 202and 203.An David Gwynne . 204.Sh CAVEATS 205The 206.Nm 207driver does not support a lot of the functionality available in the hardware. 208More work is required to properly support the IBSS, power management, 209and selectable transmission rate features. 210