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