1.\" $NetBSD: wi.4,v 1.38 2010/01/15 19:24:49 joerg 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.\" $Id: wi.4,v 1.38 2010/01/15 19:24:49 joerg Exp $ 34.\" 35.Dd July 6, 2005 36.Dt WI 4 37.Os 38.Sh NAME 39.Nm wi 40.Nd 41WaveLAN/IEEE and PRISM-II 802.11 wireless network driver 42.Sh SYNOPSIS 43.Cd "wi* at pcmcia? function ?" 44.Cd "wi* at pci? dev ? function ?" 45.Sh DESCRIPTION 46The 47.Nm 48driver provides support for Lucent Technologies WaveLAN/IEEE PCCARD adapters 49(also known as WaveLAN II cards) and various PCI/MiniPCI/PCCARD adapters which use 50Intersil PRISM-II and PRISM-2.5 chipsets. 51Note that while Lucent sells both ISA and PCMCIA WaveLAN/IEEE devices, 52the ISA product is actually a PCMCIA card in an ISA to PCMCIA bridge adapter. 53Consequently, the 54.Nm 55driver is required for both the ISA and PCMCIA NICs. 56Also note that some of the PRISM-II adapters works only at 3.3V, hence 57.Xr cardbus 4 58support is required for those cards to set VCC correctly, 59even though they are 16-bit cards. 60.Pp 61The core of the WaveLAN/IEEE is the Lucent Hermes controller. 62All host/device interaction is via programmed I/O with the Hermes. 63The Hermes supports 802.11 and 802.3 frames, power management, BSS, WDS 64and ad-hoc operation modes. The Silver and the Gold cards of the 65WaveLAN/IEEE also support WEP. Unlike the other IEEE 802.11 network cards, 66the WaveLAN Gold cards accept 104 bits key (13 characters) for WEP 67encryption. The Intersil PRISM-II controller supports WEP as well. 68.Pp 69The 70.Nm 71driver encapsulates all traffic as 802.11 frames, however 72it can receive either 802.11 or 802.3 frames. 73Transmit speed is selectable between 1Mbps fixed, 742Mbps fixed or 2Mbps with auto fallback. 75For WaveLAN/IEEE Turbo adapters, speeds up to 6Mbps are available. 76For WaveLAN/IEEE Turbo 11Mbps adapters and PRISM-II adapters, speeds up to 7711Mbps are available. 78.Pp 79The 80.Nm 81driver supports configuration of Lucent cards for special ad-hoc operation. 82In this mode, the nwid is ignored and stations can communicate among each 83other without the aid of an access point. Note that this mode is specific 84to Lucent chips, and not in the IEEE 802.11 specification. Due to changes 85in the implementation of this special ad-hoc mode, Lucent-based cards with 86different firmware revisions may not interoperate in this mode. This mode 87is no longer the default and must be selected using the 88.Xr ifconfig 8 89.Pq media option Dq adhoc,flag0 90utility. 91.Pp 92Recent versions of Lucent and PRISM-II firmware support IBSS creation. 93IBSS is the standard IEEE 802.11 ad-hoc mode. In this mode, the nwid 94should be specified. At least one node must be able to create IBSS. 95The IBSS mode is enabled by 96.Dq adhoc 97or 98.Dq ibss 99media option. 100IBSS creation is automatically enabled if supported. 101.Pp 102The 103.Nm 104driver defaults to infrastructure mode (i.e., using an access point). 105.Pp 106Recent versions of PRISM-II firmware support operating as an 802.11 107Access Point. In this mode, the Access Point station should set the 108nwid. This will create a standard 802.11 network, and the Access Point 109station will show up in an Access Point scan. This mode is enabled 110using the 111.Dq hostap 112media option. 113.Pp 114For more information on configuring this device, see 115.Xr ifconfig 8 116and 117.Xr ifmedia 4 . 118.Sh HARDWARE 119Cards supported by the 120.Nm 121driver include: 122.Pp 123.Bl -item -offset indent -compact 124.It 125Alvarion BreezeNET 126.It 127Lucent WaveLAN/IEEE 2.0Mb Bronze 128.It 129Lucent WaveLAN/IEEE 2.0Mb Silver 130.It 131Lucent WaveLAN/IEEE Turbo 132.It 133Lucent WaveLAN/IEEE Turbo 11Mbps 134.It 135Melco AIR CONNECT WLI-PCM-L11, WLI-PCM-L11G 136.It 137Melco AIR CONNECT WLI-CF-S11G 138.It 139Compaq WL100 11Mbps Wireless 140.It 141Corega Wireless LAN PCC-11, PCCA_11, PCCB_11 142.It 143DEC/Cabletron RoamAbout 802.11 DS High Rate 144.It 145D-Link DWL-520 11Mbps PCI Card, Revs. A1,A2,B1,B2 146.It 147D-Link DWL-520 11Mbps PCI Card, Rev. C1 148.Em not supported , 149see 150.Xr atw 4 151.It 152D-Link DWL-520 11Mbps PCI Card, Rev. D 153.Em not supported , 154see 155.Xr rtw 4 156.It 157D-Link DWL-650 11Mbps WLAN Card 158.It 159D-Link DWL-650 11Mbps WLAN Card, Rev. P 160.Em not supported 161(Prism 3 chipset) 162.It 163D-Link DCF-650W CF Card 164.It 165ELECOM Air@Hawk LD-WL11 166.It 167ELSA AirLancer MC-11 168.It 169Ericsson Wireless LAN 170.It 171Farallon Skyline 11Mbps Wireless 172.It 173Intel PRO/Wireless 2011 LAN PC Card 174.It 175ICOM SL-1100 176.It 177IO-DATA WN-B11/PCM 178.It 179Intersil PRISM Mini-PCI 180.It 181Linksys Group, Inc. Instant Wireless Network PC Card, CF Card 182.It 183Linksys Group, Inc. Instant Wireless Network WMP11 PCI Card 184.It 185Linksys Group, Inc. Instant Wireless Network WMP11v4 PCI Card 186.Em not supported 187.It 188NCR WaveLAN/IEEE 189.It 190NEC Wireless Card CMZ-RT-WP, PK-WL001, PC-WL/11C 191.It 192PLANEX GeoWave/GW-NS110 193.It 194Symbol Spectrum24 Wireless Networker PC Card, CF Card 195.It 196TDK LAK-CD011WL 197.It 198SMC EZ Connect 11M Wireless CF Card SMC2642W 199.It 200SMC EliteConnect Wireless Adapter PC Card SMC2531W-B 201.It 202Z-Com XI-626 PCI Card 203.El 204.Pp 205The original PRISM-I chipset is supported by the 206.Xr awi 4 207driver. 208.Sh DIAGNOSTICS 209.Bl -diag 210.It "wi%d: init failed" 211The WaveLAN failed to come ready after an initialization command was 212issued. 213.It "wi%d: failed to allocate %d bytes on NIC" 214The driver was unable to allocate memory for transmit frames in the 215NIC's on-board RAM. 216.It "wi%d: device timeout" 217The WaveLAN failed to generate an interrupt to acknowledge a transmit 218command. 219.El 220.Sh SEE ALSO 221.Xr arp 4 , 222.Xr ifmedia 4 , 223.Xr netintro 4 , 224.Xr pci 4 , 225.Xr pcmcia 4 , 226.Xr ifconfig 8 , 227.Xr wiconfig 8 228.Rs 229.%T HCF Light programming specification 230.%U http://www.wavelan.com 231.Re 232.Sh HISTORY 233The 234.Nm 235device driver first appeared in 236.Nx 1.5 . 237.Sh AUTHORS 238The 239.Nm 240driver was written by 241.An Bill Paul Aq wpaul@ctr.columbia.edu . 242.Sh BUGS 243The execution of 244.Xr wiconfig 8 245while the interface is down can produce some error messages. 246