1.\" $NetBSD: wi.4,v 1.10 2000/03/21 19:59:16 drochner 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.10 2000/03/21 19:59:16 drochner Exp $ 34.\" 35.Dd April 21, 1999 36.Dt WI 4 37.Os 38.Sh NAME 39.Nm wi 40.Nd 41Lucent Technologies WaveLAN/IEEE 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 WaveLAN/IEEE PCCARD adapters (also known 48as WaveLAN II cards). 49Note that while Lucent sells both ISA and PCMCIA WaveLAN/IEEE devices, 50the ISA product is actually a PCMCIA card in an ISA to PCMCIA bridge adapter. 51Consequently, the 52.Nm 53driver is required for both the ISA and PCMCIA NICs. 54Both the original 2Mbps WaveLAN/IEEE cards and 55the newer 6Mbps WaveLAN/IEEE Turbo adapters are supported. 56.Pp 57The core of the WaveLAN/IEEE is the Lucent Hermes controller. 58All host/device interaction is via programmed I/O with the Hermes. 59The Hermes supports 802.11 and 802.3 frames, power management, BSS, WDS 60and ad-hoc operation modes. 61The 62.Nm 63driver encapsulates all IP and ARP traffic as 802.11 frames, however 64it can receive either 802.11 or 802.3 frames. 65Transmit speed is selectable between 1Mbps fixed, 662Mbps fixed or 2Mbps with auto fallback. 67For WaveLAN/IEEE Turbo adapters, speeds up to 6Mbps are available. 68.Pp 69By default, the 70.Nm 71driver configures the WaveLAN card for ad-hoc operation. 72In this mode, 73stations can communicate among each other without the aid of an access 74point. 75To join a service set, the driver must be set for BSS mode using the 76.Xr wiconfig 8 77utility. 78.Pp 79For more information on configuring this device, see 80.Xr ifconfig 8 . 81.Sh HARDWARE 82Cards supported by the 83.Nm 84driver include: 85.Pp 86.Bl -item -offset indent 87.It 88Lucent Wavelan/IEEE 2.0Mb Bronze 89.It 90Lucent Wavelan/IEEE 2.0Mb Silver 91.It 92Melco AIR CONNECT WLI-PCM-L11 93.It 94DEC/Cabletron RoamAbout 802.11 DS High Rate 95.El 96.Sh DIAGNOSTICS 97.Bl -diag 98.It "wi%d: init failed" 99The WaveLAN failed to come ready after an initialization command was 100issued. 101.It "wi%d: failed to allocate %d bytes on NIC" 102The driver was unable to allocate memory for transmit frames in the 103NIC's on-board RAM. 104.It "wi%d: device timeout" 105The WaveLAN failed to generate an interrupt to acknowledge a transmit 106command. 107One reason can be that the board is mis-configured, see 108.Xr wiconfig 8 . 109.El 110.Sh SEE ALSO 111.Xr arp 4 , 112.Xr netintro 4 , 113.Xr ifconfig 8 , 114.Xr wiconfig 8 115.Rs 116.%T HCF Light programming specification 117.%O http://www.wavelan.com 118.Re 119.Sh HISTORY 120The 121.Nm 122device driver first appeared in 123.Nx 1.5 . 124.Sh AUTHOR 125The 126.Nm 127driver was written by 128.An Bill Paul Aq wpaul@ctr.columbia.edu . 129