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.9 2007/03/04 02:32:59 swildner Exp $
10 .Nd "AMD PCnetMobile IEEE 802.11 PCMCIA wireless network driver"
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
21 All host/device interaction is via this shared memory, which can be
22 accessed either via PCMCIA memory space or I/O space.
25 driver encapsulates all IP and ARP traffic as 802.11 frames.
27 The driver works both in infrastructure mode and in adhoc (independent
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.
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.
39 In addition to these two mode in IEEE 802.11 specification, the
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
44 driver. The NWID doesn't affect in this mode.
46 For more information on configuring this device, see
51 Cards supported by the
55 .Bl -tag -width BayStack_650x -offset indent
57 1Mbps Frequency Hopping PCCARD adapter
59 2Mbps Direct Sequence PCCARD adapter
61 2Mbps Direct Sequence PCCARD adapter
63 2Mbps Direct Sequence PCCARD adapter
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
72 .\"The original Xircom Netwave AirSurfer is supported by the
80 media types, while the FH cards support
82 media type. For each media type,
84 mediaopt can be used to indicate the driver to operate in adhoc mode.
86 .Em adhoc , Ns Em flag0
87 mediaopt can be used for
89 compatible adhoc mode.
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,
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.
103 for information on how to increase the memory available to the PCMCIA
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
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.
138 .%T Am79C930 PCnet Mobile Single-Chip Wireless LAN Media Access Controller
139 .%O http://www.amd.com
144 device driver first appeared in
148 The initial version of the
150 driver was written by
151 .An Bill Sommerfeld Aq sommerfeld@netbsd.org .
154 driver module completely rewritten to support cards with DS phy and
155 to support adhoc mode by
156 .An Atsushi Onoe Aq onoe@netbsd.org .
158 Doesn't create IBSS itself.