1.\" $NetBSD: wi.4,v 1.13 2000/11/12 20:47:44 hubertf 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.13 2000/11/12 20:47:44 hubertf Exp $ 34.\" 35.Dd November 12, 2000 36.Dt WI 4 37.Os 38.Sh NAME 39.Nm wi 40.Nd 41WaveLAN/IEEE and PRISM-II 802.11 PCMCIA wireless network driver 42.Sh SYNOPSIS 43.Cd "wi* at pcmcia? function ?" 44.Sh DESCRIPTION 45The 46.Nm 47driver provides support for Lucent Technologies WaveLAN/IEEE PCCARD adapters 48(also known as WaveLAN II cards) and various PCCARD adapters which use 49Intersil PRISM-II chipsets. 50Note that while Lucent sells both ISA and PCMCIA WaveLAN/IEEE devices, 51the ISA product is actually a PCMCIA card in an ISA to PCMCIA bridge adapter. 52Consequently, the 53.Nm 54driver is required for both the ISA and PCMCIA NICs. 55Also note that some of the PRISM-II adapters works only at 3.3V, hence 56.Xr cardbus 4 57support is required for those cards to set VCC correctly, 58even they are 16bit cards. 59.Pp 60The core of the WaveLAN/IEEE is the Lucent Hermes controller. 61All host/device interaction is via programmed I/O with the Hermes. 62The Hermes supports 802.11 and 802.3 frames, power management, BSS, WDS 63and ad-hoc operation modes. The Silver and the Gold cards of the 64WaveLAN/IEEE also support WEP. Unlike the other IEEE 802.11 network cards, 65the WaveLAN Gold cards accept 104 bits key (13 characters) for WEP 66encryption. The Intersil PRISM-II controller supports WEP as well. 67.Pp 68The 69.Nm 70driver encapsulates all IP and ARP traffic as 802.11 frames, however 71it can receive either 802.11 or 802.3 frames. 72Transmit speed is selectable between 1Mbps fixed, 732Mbps fixed or 2Mbps with auto fallback. 74For WaveLAN/IEEE Turbo adapters, speeds up to 6Mbps are available. 75For WaveLAN/IEEE Turbo 11Mbps adapters and PRISM-II adapters, speeds up to 7611Mbps are available. 77.Pp 78By default, the 79.Nm 80driver configures the WaveLAN card for special ad-hoc operation. 81In this mode, the nwid is ignored and 82stations can communicate among each other without the aid of an access 83point. 84Note that this mode is out of IEEE 802.11 specification and the driver 85cannot interoperate with other cards. 86To join a service set, the driver must be set for BSS mode using the 87.Xr ifconfig 8 88or 89.Xr wiconfig 8 90utility. 91.Pp 92For more information on configuring this device, see 93.Xr ifconfig 8 94and 95.Xr ifmedia 4 . 96.Sh HARDWARE 97Cards supported by the 98.Nm 99driver include: 100.Pp 101.Bl -item -offset indent 102.It 103Lucent Wavelan/IEEE 2.0Mb Bronze 104.It 105Lucent Wavelan/IEEE 2.0Mb Silver 106.It 107Lucent WaveLAN/IEEE Turbo 108.It 109Lucent WaveLAN/IEEE Turbo 11Mbps 110.It 111Melco AIR CONNECT WLI-PCM-L11 112.It 113DEC/Cabletron RoamAbout 802.11 DS High Rate 114.It 115Corega Wireless LAN PCC-11 116.It 117Melco AIR CONNECT WLI-PCM-L11 cards [*] [+] 118.It 119DEC/Cabletron RoamAbout 802.11 DS High Rate cards [*] [+] 120.It 121Corega Wireless LAN PCC-11 cards [*] [+] 122.It 123ELSA AirLancer MC-11 124.El 125.Pp 126The original PRISM-I chipset is supported by the 127.Xr awi 4 128driver. 129.Sh DIAGNOSTICS 130.Bl -diag 131.It "wi%d: init failed" 132The WaveLAN failed to come ready after an initialization command was 133issued. 134.It "wi%d: failed to allocate %d bytes on NIC" 135The driver was unable to allocate memory for transmit frames in the 136NIC's on-board RAM. 137.It "wi%d: device timeout" 138The WaveLAN failed to generate an interrupt to acknowledge a transmit 139command. 140One reason can be that the board is mis-configured, see 141.Xr wiconfig 8 . 142.El 143.Sh BUGS 144The IBSS mode is not supported. 145The execution of 146.Xr wiconfig 8 147during the interface is down produces some error messages. 148.Sh SEE ALSO 149.Xr arp 4 , 150.Xr ifmedia 4 , 151.Xr netintro 4 , 152.Xr ifconfig 8 , 153.Xr wiconfig 8 154.Rs 155.%T HCF Light programming specification 156.%O http://www.wavelan.com 157.Re 158.Sh HISTORY 159The 160.Nm 161device driver first appeared in 162.Nx 1.5 . 163.Sh AUTHOR 164The 165.Nm 166driver was written by 167.An Bill Paul Aq wpaul@ctr.columbia.edu . 168