share/man/man4/awi.4

   1 .\"     $NetBSD: awi.4,v 1.6 2000/03/22 11:24:33 onoe Exp $
   2 .\" $FreeBSD: src/share/man/man4/awi.4,v 1.11.2.2 2003/02/17 21:20:39 trhodes Exp $
   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 "device awi"
  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,
  96 .Nx ,
  97 only allocates 16kb of
  98 address space per PCMCIA controller, this message is in some sense to
  99 be expected and should not be a cause for alarm.
 100 See
 101 .Xr pcmcia 4
 102 for information on how to increase the memory available to the PCMCIA
 103 controller.
 104 .It "awi0: failed to complete selftest (%s)"
 105 The device failed to complete its self test.
 106 .It "awi0: synced with no-bssid at channel %d"
 107 The device is ready to relay traffic at specified channel.
 108 .It "awi0: synced with %s ssid %s at channel %d"
 109 The device has successfully synchronized with at least one of the
 110 identified stations and is ready to relay traffic.
 111 .It "awi0: associated with %s ssid %s channel %d signal %d"
 112 The device has successfully synchronized with the identified Access
 113 Point and is ready to relay traffic.
 114 .It "awi0: authentication failed (reason %d)"
 115 .It "awi0: association failed (reason %d)"
 116 The access point refuses the association request from the device.
 117 .It "awi0: no recent beacons from %s; rescanning"
 118 The device has not heard a beacon from its currently associated Access
 119 Point recently, and is looking for a new access point.
 120 .It "awi0: transmit timeout"
 121 The device failed to generate an interrupt to acknowledge a
 122 transmitted packet.
 123 .It "awi0: failed to lock interrupt"
 124 The system was unable to obtain the lock to access shared memory.
 125 .It "awi0: command %d failed %x"
 126 The device failed to complete the request from the system.
 127 .El
 128 .Sh BUGS
 129 Doesn't create IBSS itself.
 130 .Sh SEE ALSO
 131 .Xr arp 4 ,
 132 .Xr cnw 4 ,
 133 .Xr ifmedia 4 ,
 134 .Xr miibus 4 ,
 135 .Xr netintro 4 ,
 136 .Xr pcmcia 4 ,
 137 .Xr wi 4 ,
 138 .Xr ifconfig 8
 139 .Rs
 140 .%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
 141 .%O http://www.amd.com
 142 .Re
 143 .Sh HISTORY
 144 The
 145 .Nm
 146 device driver first appeared in
 147 .Nx 1.5 .
 148 .Sh AUTHORS
 149 .An -nosplit
 150 The initial version of the
 151 .Nm
 152 driver was written by
 153 .An Bill Sommerfeld Aq sommerfeld@netbsd.org .
 154 Then the
 155 .Nm
 156 driver module completely rewritten to support cards with DS phy and
 157 to support adhoc mode by
 158 .An Atsushi Onoe Aq onoe@netbsd.org .