187 lines
5.8 KiB
Groff
187 lines
5.8 KiB
Groff
.\" $NetBSD: awi.4,v 1.28 2010/01/15 19:24:49 joerg Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999,2000,2001 The NetBSD Foundation, Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
|
.\" by Bill Sommerfeld
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.Dd January 2, 2006
|
|
.Dt AWI 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm awi
|
|
.Nd
|
|
AMD PCnetMobile IEEE 802.11 PCMCIA wireless network driver
|
|
.Sh SYNOPSIS
|
|
.Cd "awi* at pcmcia? function ?"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver supports various IEEE 802.11 wireless cards
|
|
that run AMD PCnetMobile firmware based on the AMD 79c930 controller
|
|
with the Intersil (formerly Harris) PRISM radio chipset.
|
|
It provides access to 32kb of memory shared between the controller
|
|
and the host.
|
|
All host/device interaction is accomplished via this shared memory, which
|
|
can be accessed either via PCMCIA or I/O memory spaces.
|
|
The
|
|
.Nm
|
|
driver encapsulates all IP and ARP traffic in 802.11 frames.
|
|
.Pp
|
|
The driver works both in infrastructure mode and in ad-hoc (independent
|
|
BSS) mode.
|
|
.Pp
|
|
In infrastructure mode, it communicates with an Access Point,
|
|
which serves as a link-layer bridge between an Ethernet segment and
|
|
the wireless network.
|
|
An access point also provides roaming capability,
|
|
which allows a wireless node to move between access points.
|
|
.Pp
|
|
In ad-hoc mode, the device communicates peer to peer.
|
|
Although it is more efficient to communicate between wireless nodes,
|
|
the coverage is limited spatially due to the lack of roaming capability.
|
|
.Pp
|
|
In addition to these two modes in the IEEE 802.11 specification, the
|
|
.Nm
|
|
driver also supports a variant of ad-hoc mode outside of the spec for
|
|
DS radio cards.
|
|
This makes it possible to communicate with the WaveLAN ad-hoc mode of
|
|
.Xr wi 4
|
|
driver.
|
|
The NWID has no effect in this mode.
|
|
.Pp
|
|
Another mode added to the
|
|
.Nm
|
|
driver can be used with old Melco access points with 2Mbps cards.
|
|
This mode actually uses the IEEE 802.11 ad-hoc mode with encapsulation of
|
|
raw Ethernet packets (including headers) in 802.11 frames.
|
|
.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 -tag -width BayStack_650x -offset indent -compact
|
|
.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
|
|
.It Nokia C020 WLAN
|
|
2Mbps Direct Sequence PCCARD adapter
|
|
.It Farallon SkyLINE
|
|
2Mbps Direct Sequence PCCARD adapter
|
|
.It Zoom Air Model 4000
|
|
.El
|
|
.Pp
|
|
The original Xircom Netwave AirSurfer is supported by the
|
|
.Xr cnw 4
|
|
driver, and the PRISM-II cards are supported by the
|
|
.Xr wi 4
|
|
driver.
|
|
.Sh MEDIA SELECTION
|
|
In addition to default
|
|
.Em Auto
|
|
media type,
|
|
the DS cards support
|
|
.Em DS1
|
|
and
|
|
.Em DS2
|
|
media types, while the FH cards support the
|
|
.Em FH1
|
|
media type.
|
|
For each media type, the
|
|
.Em adhoc
|
|
mediaopt can be used to indicate to the driver to operate in ad-hoc mode.
|
|
The
|
|
.Em flag0
|
|
mediaopt
|
|
should be used only with old access points, which operate in IBSS mode.
|
|
For DS radio cards, the
|
|
.Em adhoc,flag0
|
|
mediaopt can be used for
|
|
.Xr wi 4
|
|
compatible WaveLAN ad-hoc mode.
|
|
.Sh DIAGNOSTICS
|
|
.Bl -diag
|
|
.It "awi0: no suitable CIS info found"
|
|
The device cannot be mapped due to a resource conflict.
|
|
Or, the device failed to initialize its firmware.
|
|
.It "awi0: failed to complete selftest (%s)"
|
|
The device failed to complete its self test.
|
|
In some circumstances, resetting device after power on fails.
|
|
Re-inserting the card or setting the interface up and then down again
|
|
(using
|
|
.Xr ifconfig 8 )
|
|
may also be helpful.
|
|
.It "awi0: transmit timeout"
|
|
The device failed to generate an interrupt to acknowledge a
|
|
transmitted packet.
|
|
.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 SEE ALSO
|
|
.Xr arp 4 ,
|
|
.Xr cnw 4 ,
|
|
.Xr ifmedia 4 ,
|
|
.Xr netintro 4 ,
|
|
.Xr pcmcia 4 ,
|
|
.Xr wi 4 ,
|
|
.Xr ifconfig 8 ,
|
|
.Xr wiconfig 8
|
|
.Rs
|
|
.%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
|
|
.%U http://www.amd.com
|
|
.Re
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
device driver first appeared in
|
|
.Nx 1.5 .
|
|
.Sh AUTHORS
|
|
The initial version of the
|
|
.Nm
|
|
driver was written by
|
|
.An Bill Sommerfeld
|
|
.Aq sommerfeld@NetBSD.org .
|
|
It was then completely rewritten to support cards with the DS phy and
|
|
ad-hoc mode by
|
|
.An Atsushi Onoe
|
|
.Aq onoe@NetBSD.org .
|