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 "device awi"
  12 .Cd "device wlan"
  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.
  33 An access point also provides roaming capability
  34 which allows wireless nodes to move between access points.
  35 .Pp
  36 In adhoc mode, it communicates peer to peer.
  37 Though it is more efficient to communicate between wireless nodes,
  38 the coverage is limited spatially due to lack of roaming capability.
  39 .Pp
  40 In addition to these two modes in the IEEE 802.11 specification, the
  41 .Nm
  42 driver also supports a variant of adhoc mode out of spec for DS radio cards,
  43 which makes it possible to communicate with adhoc mode of
  44 .Xr wi 8
  45 driver.
  46 The NWID does not affect in this mode.
  47 .Pp
  48 For more information on configuring this device, see
  49 .Xr ifconfig 8 .
  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 .It Nokia C020 WLAN
  71 2Mbps Direct Sequence PCCARD adapter
  72 .It Farallon SkyLINE
  73 2Mbps Direct Sequence PCCARD adapter
  74 .El
  75 .Pp
  76 The original Xircom Netwave AirSurfer is supported by the
  77 .Xr cnw 4
  78 driver.
  79 .Sh MEDIA SELECTION
  80 The DS cards support
  81 .Em DS1
  82 and
  83 .Em DS2
  84 media types, while the FH cards support
  85 .Em FH1
  86 media type.
  87 For each media type,
  88 .Em adhoc
  89 mediaopt can be used to indicate the driver to operate in adhoc mode.
  90 For DS radio cards,
  91 .Em adhoc , Ns Em flag0
  92 mediaopt can be used for
  93 .Xr wi 4
  94 compatible adhoc mode.
  95 In addition to these station modes,
  96 .Em hostap
  97 mediaopt can be used to create a host-based access point.
  98 .Sh DIAGNOSTICS
  99 .Bl -diag
 100 .It "awi0: awi_pccard_probe: bad banner:"
 101 The device failed to initialize its firmware.
 102 .It "awi0: failed to complete selftest (%s)"
 103 The device failed to complete its self test.
 104 In some circumstances, resetting device after power on fails.
 105 Re-inserting the card or down-then-up interface may be helpful.
 106 .It "awi0: transmit timeout"
 107 The device failed to generate an interrupt to acknowledge a
 108 transmitted packet.
 109 .It "awi0: failed to lock interrupt"
 110 The system was unable to obtain the lock to access shared memory.
 111 .It "awi0: command %d failed %x"
 112 The device failed to complete the request from the system.
 113 .El
 114 .Sh SEE ALSO
 115 .Xr arp 4 ,
 116 .Xr card 4 ,
 117 .Xr cnw 4 ,
 118 .Xr miibus 4 ,
 119 .Xr netintro 4 ,
 120 .Xr pccard 4 ,
 121 .Xr wi 4 ,
 122 .Xr wlan 4 ,
 123 .Xr ifconfig 8
 124 .Rs
 125 .%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
 126 .%O http://www.amd.com
 127 .Re
 128 .Sh HISTORY
 129 The
 130 .Nm
 131 device driver first appeared in
 132 .Nx 1.5 .
 133 .Sh AUTHORS
 134 .An -nosplit
 135 The initial version of the
 136 .Nm
 137 driver was written by
 138 .An Bill Sommerfeld Aq sommerfeld@netbsd.org .
 139 Then the
 140 .Nm
 141 driver module was completely rewritten to support cards with DS phy and
 142 to support adhoc mode by
 143 .An Atsushi Onoe Aq onoe@netbsd.org .