1.\" $NetBSD: wi.4,v 1.25 2002/05/07 09:56:32 onoe 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.25 2002/05/07 09:56:32 onoe Exp $ 34.\" 35.Dd January 11, 2001 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 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 they are 16bit 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 IP and ARP 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 WaveLAN card for special ad-hoc operation. 82In this mode, the nwid is ignored and 83stations can communicate among each other without the aid of an access 84point. 85Note that this mode is not in the IEEE 802.11 specification and the driver 86may interoperate with other cards. This mode is no longer the default 87and must be selected using the 88.Xr ifconfig 8 89or 90.Xr wiconfig 8 91utilities. 92.Pp 93For more information on configuring this device, see 94.Xr ifconfig 8 95and 96.Xr ifmedia 4 . 97.Sh HARDWARE 98Cards supported by the 99.Nm 100driver include: 101.Pp 102.Bl -item -offset indent -compact 103.It 104Lucent Wavelan/IEEE 2.0Mb Bronze 105.It 106Lucent Wavelan/IEEE 2.0Mb Silver 107.It 108Lucent WaveLAN/IEEE Turbo 109.It 110Lucent WaveLAN/IEEE Turbo 11Mbps 111.It 112Melco AIR CONNECT WLI-PCM-L11, WLI-PCM-L11G 113.It 114Melco AIR CONNECT WLI-CF-S11G 115.It 116Compaq WL100 11Mbps Wireless 117.It 118Corega Wireless LAN PCC-11, PCCA_11, PCCB_11 119.It 120DEC/Cabletron RoamAbout 802.11 DS High Rate 121.It 122D-Link DWL-650 11Mbps WLAN Card, DCF-650W CF Card 123.It 124ELECOM Air@Hawk LD-WL11 125.It 126ELSA AirLancer MC-11 127.It 128Ericsson Wireless LAN 129.It 130Farallon Skyline 11Mbps Wireless 131.It 132Intel PRO/Wireless 2011 LAN PC Card 133.It 134ICOM SL-1100 135.It 136IO-DATA WN-B11/PCM 137.It 138Intersil PRISM Mini-PCI 139.It 140Linksys Group, Inc. Instant Wireless Network PC Card, CF Card 141.It 142NCR WaveLAN/IEEE 143.It 144NEC Wireless Card CMZ-RT-WP, PK-WL001, PC-WL/11C 145.It 146PLANEX GeoWave/GW-NS110 147.It 148Symbol Spectrum24 Wireless Networker PC Card, CF Card 149.It 150TDK LAK-CD011WL 151.El 152.Pp 153The original PRISM-I chipset is supported by the 154.Xr awi 4 155driver. 156.Sh DIAGNOSTICS 157.Bl -diag 158.It "wi%d: init failed" 159The WaveLAN failed to come ready after an initialization command was 160issued. 161.It "wi%d: failed to allocate %d bytes on NIC" 162The driver was unable to allocate memory for transmit frames in the 163NIC's on-board RAM. 164.It "wi%d: device timeout" 165The WaveLAN failed to generate an interrupt to acknowledge a transmit 166command. 167One reason can be that the board is mis-configured, see 168.Xr wiconfig 8 . 169.El 170.Sh SEE ALSO 171.Xr arp 4 , 172.Xr ifmedia 4 , 173.Xr netintro 4 , 174.Xr pci 4 , 175.Xr pcmcia 4 , 176.Xr ifconfig 8 , 177.Xr wiconfig 8 178.Rs 179.%T HCF Light programming specification 180.%O http://www.wavelan.com 181.Re 182.Sh HISTORY 183The 184.Nm 185device driver first appeared in 186.Nx 1.5 . 187.Sh AUTHORS 188The 189.Nm 190driver was written by 191.An Bill Paul Aq wpaul@ctr.columbia.edu . 192.Sh BUGS 193The IBSS mode is not supported. 194PRISM chipset does not have IBSS mode. 195.Pp 196The execution of 197.Xr wiconfig 8 198while the interface is down can produce some error messages. 199