share/man/man4/awi.4

   1 .\"     $NetBSD: awi.4,v 1.6 2000/03/22 11:24:33 onoe Exp $
   2 .\" $FreeBSD$
   3 .\"
   4 .Dd October 31, 1999
   5 .Dt AWI 4
   6 .Os
   7 .Sh NAME
   8 .Nm awi
   9 .Nd "AMD PCnetMobile IEEE 802.11 PCMCIA wireless network driver"
  10 .Sh SYNOPSIS
  11 .Cd "awi*     at pcmcia? function ?"
  12 .Sh DESCRIPTION
  13 The
  14 .Nm
  15 driver supports various IEEE 802.11 wireless cards
  16 which run AMD PCnetMobile firmware based on AMD 79c930 controller
  17 with Intersil (formerly Harris) PRISM radio chipset.
  18 It provides access to 32kb of memory shared between the controller
  19 and the host.
  20 All host/device interaction is via this shared memory, which can be
  21 accessed either via PCMCIA memory space or I/O space.
  22 The
  23 .Nm
  24 driver encapsulates all IP and ARP traffic as 802.11 frames.
  25 .Pp
  26 The driver works both in infrastructure mode and in adhoc (independent
  27 BSS) mode.
  28 .Pp
  29 In infrastructure mode, it communicates with an Access Point
  30 which serves as a link-layer bridge between an Ethernet and
  31 the wireless network.  An access point also provides roaming capability
  32 which allows wireless node to move between access points.
  33 .Pp
  34 In adhoc mode, it communicates peer to peer.
  35 Though it is more efficient to communicate between wireless nodes,
  36 the coverage is limited spatially due to lack of roaming capability.
  37 .Pp
  38 In addition to these two mode in IEEE 802.11 specification, the
  39 .Nm
  40 driver also supports a variant of adhoc mode out of spec for DS radio cards,
  41 which makes possible to communicate with adhoc mode of
  42 .Xr wi 8
  43 driver.  The NWID doesn't affect in this mode.
  44 .Pp
  45 For more information on configuring this device, see
  46 .Xr ifconfig 8
  47 and
  48 .Xr ifmedia 4 .
  49 .Sh HARDWARE
  50 Cards supported by the
  51 .Nm
  52 driver include:
  53 .Pp
  54 .Bl -tag -width BayStack_650x -offset indent
  55 .It BayStack 650
  56 1Mbps Frequency Hopping PCCARD adapter
  57 .It BayStack 660
  58 2Mbps Direct Sequence PCCARD adapter
  59 .It Icom SL-200
  60 2Mbps Direct Sequence PCCARD adapter
  61 .It Melco WLI-PCM
  62 2Mbps Direct Sequence PCCARD adapter
  63 .It NEL SSMagic
  64 2Mbps Direct Sequence PCCARD adapter
  65 .It Netwave AirSurfer Plus
  66 1Mbps Frequency Hopping PCCARD adapter
  67 .It Netwave AirSurfer Pro
  68 2Mbps Direct Sequence PCCARD adapter
  69 .El
  70 .Pp
  71 The original Xircom Netwave AirSurfer is supported by the
  72 .Xr cnw 4
  73 driver.
  74 .Sh MEDIA SELECTION
  75 The DS cards support
  76 .Em DS1
  77 and
  78 .Em DS2
  79 media types, while the FH cards support
  80 .Em FH1
  81 media type.  For each media type,
  82 .Em adhoc
  83 mediaopt can be used to indicate the driver to operate in adhoc mode.
  84 For DS radio cards,
  85 .Em adhoc , Ns Em flag0
  86 mediaopt can be used for
  87 .Xr wi 4
  88 compatible adhoc mode.
  89 .Sh DIAGNOSTICS
  90 .Bl -diag
  91 .It "awi0: unable to allocate memory space; using i/o only"
  92 Indicates that the driver was not able to allocate 32kb of PCMCIA bus
  93 address space into which to map the device; the driver will use the
  94 (slightly slower) i/o-space only access methods to read and write to
  95 the shared memory.  Since by default, NetBSD, only allocates 16kb of
  96 address space per PCMCIA controller, this message is in some sense to
  97 be expected and should not be a cause for alarm.
  98 See
  99 .Xr pcmcia 4
 100 for information on how to increase the memory available to the PCMCIA
 101 controller.
 102 .It "awi0: failed to complete selftest (%s)"
 103 The device failed to complete its self test.
 104 .It "awi0: synced with no-bssid at channel %d"
 105 The device is ready to relay traffic at specified channel.
 106 .It "awi0: synced with %s ssid %s at channel %d"
 107 The device has successfully synchronized with at least one of the
 108 identified stations and is ready to relay traffic.
 109 .It "awi0: associated with %s ssid %s channel %d signal %d"
 110 The device has successfully synchronized with the identified Access
 111 Point and is ready to relay traffic.
 112 .It "awi0: authentication failed (reason %d)"
 113 .It "awi0: association failed (reason %d)"
 114 The access point refuses the association request from the device.
 115 .It "awi0: no recent beacons from %s; rescanning"
 116 The device has not heard a beacon from its currently associated Access
 117 Point recently, and is looking for a new access point.
 118 .It "awi0: transmit timeout"
 119 The device failed to generate an interrupt to acknowledge a
 120 transmitted packet.
 121 .It "awi0: failed to lock interrupt"
 122 The system was unable to obtain the lock to access shared memory.
 123 .It "awi0: command %d failed %x"
 124 The device failed to complete the request from the system.
 125 .El
 126 .Sh BUGS
 127 Doesn't create IBSS itself.
 128 .Sh SEE ALSO
 129 .Xr arp 4 ,
 130 .Xr cnw 4 ,
 131 .Xr ifmedia 4 ,
 132 .Xr netintro 4 ,
 133 .Xr pcmcia 4 ,
 134 .Xr wi 4 ,
 135 .Xr ifconfig 8
 136 .Rs
 137 .%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
 138 .%O http://www.amd.com
 139 .Re
 140 .Sh HISTORY
 141 The
 142 .Nm
 143 device driver first appeared in
 144 .Nx 1.5 .
 145 .Sh AUTHORS
 146 .An -nosplit
 147 The initial version of the
 148 .Nm
 149 driver was written by
 150 .An Bill Sommerfeld Aq sommerfeld@netbsd.org .
 151 Then the
 152 .Nm
 153 driver module completely rewritten to support cards with DS phy and
 154 to support adhoc mode by
 155 .An Atsushi Onoe Aq onoe@netbsd.org .