share/man/man4/wi.4

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