[src/trunk]: src/share/man/man4 supports 802.11 DS cards as well as FH cards.

[onoe <onoe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/5e22821bc28f
branches:  trunk
changeset: 483982:5e22821bc28f
user:      onoe <onoe%NetBSD.org@localhost>
date:      Wed Mar 22 11:24:33 2000 +0000

description:
supports 802.11 DS cards as well as FH cards.

diffstat:

 share/man/man4/awi.4 |  135 ++++++++++++++++++++++++++++++++------------------
 1 files changed, 85 insertions(+), 50 deletions(-)

diffs (200 lines):

diff -r d8521759ee65 -r 5e22821bc28f share/man/man4/awi.4
--- a/share/man/man4/awi.4      Wed Mar 22 11:22:20 2000 +0000
+++ b/share/man/man4/awi.4      Wed Mar 22 11:24:33 2000 +0000
@@ -1,7 +1,7 @@
-.\"     $NetBSD: awi.4,v 1.5 2000/01/16 12:22:56 abs Exp $
+.\"     $NetBSD: awi.4,v 1.6 2000/03/22 11:24:33 onoe Exp $
 .\"
 .\"
-.\"    $Id: awi.4,v 1.5 2000/01/16 12:22:56 abs Exp $
+.\"    $Id: awi.4,v 1.6 2000/03/22 11:24:33 onoe Exp $
 .\"
 .Dd October 31, 1999
 .Dt AWI 4 
@@ -9,52 +9,86 @@
 .Sh NAME
 .Nm awi
 .Nd
-Bay Networks BayStack 650 IEEE 802.11 PCMCIA wireless network driver
+AMD PCnetMobile IEEE 802.11 PCMCIA wireless network driver
 .Sh SYNOPSIS
 .Cd "awi*     at pcmcia? function ?"
 .Sh DESCRIPTION
 .Pp
-The BayStack 650 is based on an AMD 79c930 controller, which provides
-access to 32kb of memory shared between the controller and the host.
+The
+.Nm
+driver supports various IEEE 802.11 wireless cards
+which run AMD PCnetMobile firmware based on AMD 79c930 controller.
+It provides access to 32kb of memory shared between the controller
+and the host.
 All host/device interaction is via this shared memory, which can be
 accessed either via PCMCIA memory space or I/O space.
 The
 .Nm
-driver encapsulates all IP and ARP traffic as 802.11 frames. Transmit
-speed is fixed at 1Mbps.
+driver encapsulates all IP and ARP traffic as 802.11 frames.
+.Pp
+The driver works both in infrastructure mode and in adhoc (independent
+BSS) mode.
+.Pp
+In infrastructure mode, it communicates with an Access Point
+which serves as a link-layer bridge between an Ethernet and
+the wireless network.  An access point also provides roaming capability
+which allows wireless node to move between access points.
 .Pp
-The driver currently only works in infrastructure mode, communicating
-with an Access Point which serves as a link-layer bridge between an
-Ethernet and the wireless network.
-.Pp 
-This card seems to take between 5 and 20 seconds after it has been brought up
-to synchronize with an AP.  When using 
-.Xr dhclient 8
-to automatically configure an address on this card, it may be
-advisable to delay the invocation of dhclient for about 10 seconds
-after the card is brought up using
-.Xr ifconfig 8
+In adhoc mode, it communicates peer to peer.
+Though it is more efficient to communicate between wireless nodes,
+the coverage is limited spatially due to lack of roaming capability.
+.Pp
+In addition to these two mode in IEEE 802.11 specification, the
+.Nm
+driver also supports a variant of adhoc mode out of spec, which makes
+possible to communicate with adhoc mode of
+.Xr wi 8
+driver.  The NWID doesn't affect in this mode.
 .Pp
 For more information on configuring this device, see
 .Xr ifconfig 8
+and
+.Xr ifmedia 4 .
 .Sh HARDWARE
 Cards supported by the
 .Nm
 driver include:
 .Pp
-.Bl -item -offset indent
-.It
-BayStack 650 1Mbps IEEE 802.11 Frequency Hopping PCCARD adapter
-.It
-BayStack 660 2Mbps IEEE 802.11 Frequency Hopping PCCARD adapter
-.It
-Netwave AirSurfer
-.Dq Plus 
+.Bl -tag -width BayStack_650x -offset indent
+.It BayStack 650
+1Mbps Frequency Hopping PCCARD adapter
+.It BayStack 660
+2Mbps Direct Sequence PCCARD adapter
+.It Icom SL-200
+2Mbps Direct Sequence PCCARD adapter
+.It Melco WLI-PCM
+2Mbps Direct Sequence PCCARD adapter
+.It NEL SSMagic
+2Mbps Direct Sequence PCCARD adapter
+.It Netwave AirSurfer Plus
+1Mbps Frequency Hopping PCCARD adapter
+.It Netwave AirSurfer Pro
+2Mbps Direct Sequence PCCARD adapter
 .El
 .Pp
 The original Xircom Netwave AirSurfer is supported by the 
 .Xr cnw 4
 driver.
+.Sh MEDIA SELECTION
+The DS cards support
+.Em DS1
+and
+.Em DS2
+media types, while the FH cards support
+.Em FH1
+media type.  For each media type,
+.Em adhoc
+mediaopt can be used to indicate the driver to operate in adhoc mode.
+Also,
+.Em adhoc,flag0
+mediaopt can be used for
+.Xr wi 4
+compatible adhoc mode.
 .Sh DIAGNOSTICS
 .Bl -diag
 .It "awi0: unable to allocate memory space; using i/o only"
@@ -68,42 +102,38 @@
 .Xr pcmcia 4
 for information on how to increase the memory available to the PCMCIA
 controller.
-.It "awi0: selftest failed (code %x)"
-The device failed to pass its internal selftest.
-.It "awi0: device failed to complete selftest (code %x)"
-The device failed to complete its self test within 5 seconds.
-.It "awi0: device timeout"
-.It "awi0: timeout waiting for command completion"
-The device failed to generate an interrupt to acknowledge a command.
+.It "awi0: failed to complete selftest (%s)"
+The device failed to complete its self test.
+.It "awi0: synced with %s ssid %s at chanset %d"
+.It "awi0: associated with %s ssid %s channel %d signal %d"
+The device has successfully synchronized with the identified Access
+Point and is ready to relay traffic.
+.It "awi0: authentication failed (reason %d)"
+.It "awi0: association failed (reason %d)"
+The access point refuses the association request from the device.
+.It "awi0: no recent beacons from %s; rescanning"
+The device has not heard a beacon from its currently associated Access
+Point recently, and is looking for a new access point.
 .It "awi0: transmit timeout"
 The device failed to generate an interrupt to acknowledge a
 transmitted packet.
-.It "awi0: large frame truncated"
-The system handed the driver a packet which was too large to transmit
-in one piece.
-.It "awi0: device enable failed"
-The system was unable to power on the card.
-.It "awi0: associated with %s, SSID: %s
-The device has successfully synchronized with the identified Access
-Point and is ready to relay traffic.
-.It "awi0: no recent beacon from %s; rescanning"
-The device has not heard a beacon from its currently associated Access
-Point recently, and is looking for a new access point.
-.It "awi0: received deauth"
-The access point the card was most recently associated with has
-forgotten about us.
+.It "awi0: failed to lock interrupt"
+The system was unable to obtain the lock to access shared memory.
+.It "awi0: command %d failed %x"
+The device failed to complete the request from the system.
 .El
 .Sh BUGS
 .Pp
-Doesn't support ad-hoc mode or WEP.
+Doesn't support WEP.
+Doesn't create IBSS itself.
 .Pp
-Doesn't yet support the BayStack 660 Direct Sequence cards.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 , 
 .Xr pcmcia 4 ,
 .Xr wi 4 ,
 .Xr cnw 4 ,
+.Xr ifmedia 4 ,
 .Xr ifconfig 8
 .Rs
 .%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
@@ -115,7 +145,12 @@
 device driver first appeared in
 .Nx 1.5 .
 .Sh AUTHOR
-The
+The initial version of the
 .Nm
 driver was written by
 .An Bill Sommerfeld Aq sommerfeld%netbsd.org@localhost .
+Then the
+.Nm
+driver module completely rewritten to support cards with DS phy and
+to support adhoc mode by
+.An Atsushi Onoe Aq onoe%netbsd.org@localhost .