Bring in some fixes from FreeBSD.
[dragonfly.git] / 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.10 2007/12/30 11:56:54 swildner Exp $
4 .\"
5 .Dd December 30, 2007
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 To compile this driver into the kernel,
13 place the following lines in your
14 kernel configuration file:
15 .Bd -ragged -offset indent
16 .Cd "device awi"
17 .Cd "device wlan"
18 .Ed
19 .Pp
20 Alternatively, to load the driver as a
21 module at boot time, place the following line in
22 .Xr loader.conf 5 :
23 .Bd -literal -offset indent
24 if_awi_load="YES"
25 .Ed
26 .Sh DESCRIPTION
27 The
28 .Nm
29 driver supports various IEEE 802.11 wireless cards
30 which run AMD PCnetMobile firmware based on AMD 79c930 controller
31 with Intersil (formerly Harris) PRISM radio chipset.
32 It provides access to 32kb of memory shared between the controller
33 and the host.
34 All host/device interaction is via this shared memory, which can be
35 accessed either via PCMCIA memory space or I/O space.
36 The
37 .Nm
38 driver encapsulates all IP and ARP traffic as 802.11 frames.
39 .Pp
40 The driver works both in infrastructure mode and in adhoc (independent
41 BSS) mode.
42 .Pp
43 In infrastructure mode, it communicates with an Access Point
44 which serves as a link-layer bridge between an Ethernet and
45 the wireless network.
46 An access point also provides roaming capability
47 which allows wireless nodes to move between access points.
48 .Pp
49 In adhoc mode, it communicates peer to peer.
50 Though it is more efficient to communicate between wireless nodes,
51 the coverage is limited spatially due to lack of roaming capability.
52 .Pp
53 In addition to these two modes in IEEE the 802.11 specification, the
54 .Nm
55 driver also supports a variant of adhoc mode out of spec for DS radio cards,
56 which makes it possible to communicate with the adhoc mode of the
57 .Xr wi 4
58 driver.
59 The NWID does not affect in this mode.
60 .Pp
61 For more information on configuring this device, see
62 .Xr ifconfig 8
63 and
64 .Xr ifmedia 4 .
65 .Sh HARDWARE
66 Cards supported by the
67 .Nm
68 driver include:
69 .Pp
70 .Bl -tag -width BayStack_650x -offset indent
71 .It BayStack 650
72 1Mbps Frequency Hopping PCCARD adapter
73 .It BayStack 660
74 2Mbps Direct Sequence PCCARD adapter
75 .It Icom SL-200
76 2Mbps Direct Sequence PCCARD adapter
77 .It Melco WLI-PCM
78 2Mbps Direct Sequence PCCARD adapter
79 .It NEL SSMagic
80 2Mbps Direct Sequence PCCARD adapter
81 .It Netwave AirSurfer Plus
82 1Mbps Frequency Hopping PCCARD adapter
83 .It Netwave AirSurfer Pro
84 2Mbps Direct Sequence PCCARD adapter
85 .El
86 .\".Pp
87 .\"The original Xircom Netwave AirSurfer is supported by the
88 .\".Xr cnw 4
89 .\"driver.
90 .Sh MEDIA SELECTION
91 The DS cards support
92 .Em DS1
93 and
94 .Em DS2
95 media types, while the FH cards support
96 .Em FH1
97 media type.
98 For each media type, the
99 .Em adhoc
100 mediaopt can be used to indicate the driver to operate in adhoc mode.
101 For DS radio cards,
102 .Em adhoc , Ns Em flag0
103 mediaopt can be used for
104 .Xr wi 4
105 compatible adhoc mode.
106 .Sh DIAGNOSTICS
107 .Bl -diag
108 .It "awi0: awi_pccard_probe: bad banner:"
109 The device failed to initialize its firmware.
110 .It "awi0: failed to complete selftest (%s)"
111 The device failed to complete its self test.
112 In some circumstances, resetting device after power on fails.
113 Re-inserting the card or down-then-up interface may be helpful.
114 .It "awi0: synced with no-bssid at channel %d"
115 The device is ready to relay traffic at specified channel.
116 .It "awi0: synced with %s ssid %s at channel %d"
117 The device has successfully synchronized with at least one of the
118 identified stations and is ready to relay traffic.
119 .It "awi0: associated with %s ssid %s channel %d signal %d"
120 The device has successfully synchronized with the identified Access
121 Point and is ready to relay traffic.
122 .It "awi0: authentication failed (reason %d)"
123 .It "awi0: association failed (reason %d)"
124 The access point refuses the association request from the device.
125 .It "awi0: no recent beacons from %s; rescanning"
126 The device has not heard a beacon from its currently associated Access
127 Point recently, and is looking for a new access point.
128 .It "awi0: transmit timeout"
129 The device failed to generate an interrupt to acknowledge a
130 transmitted packet.
131 .It "awi0: failed to lock interrupt"
132 The system was unable to obtain the lock to access shared memory.
133 .It "awi0: command %d failed %x"
134 The device failed to complete the request from the system.
135 .El
136 .Sh SEE ALSO
137 .Xr arp 4 ,
138 .\".Xr cnw 4 ,
139 .Xr ifmedia 4 ,
140 .Xr netintro 4 ,
141 .Xr pccard 4 ,
142 .Xr wi 4 ,
143 .Xr ifconfig 8
144 .Rs
145 .%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
146 .%O http://www.amd.com
147 .Re
148 .Sh HISTORY
149 The
150 .Nm
151 device driver first appeared in
152 .Nx 1.5 .
153 .Sh AUTHORS
154 .An -nosplit
155 The initial version of the
156 .Nm
157 driver was written by
158 .An Bill Sommerfeld Aq sommerfeld@netbsd.org .
159 Then the
160 .Nm
161 driver module was completely rewritten to support cards with DS phy and
162 to support adhoc mode by
163 .An Atsushi Onoe Aq onoe@netbsd.org .
164 .Sh BUGS
165 Doesn't create IBSS itself.