1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
<table class="head">
<tr>
<td class="head-ltitle">MWL(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">MWL(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">mwl</code> — <span class="Nd">Marvell
88W8363 IEEE 802.11n wireless network driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device mwl</code>
<br/>
<code class="Cd">device mwlfw</code>
<br/>
<code class="Cd">device wlan</code>
<br/>
<code class="Cd">device firmware</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>if_mwl_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">mwl</code> driver provides support for IEEE
802.11n wireless network adapters based on Marvell 88W8363 parts. PCI and/or
CardBus interfaces are supported.</p>
<p class="Pp">This driver requires the firmware built with the
<code class="Nm">mwlfw</code> module to work. Normally this module is loaded
on demand by the driver but it may also be compiled into the kernel.</p>
<p class="Pp">Supported features include 802.11n, power management, BSS, MBSS,
and host-based access point operation modes. All host/device interaction is
via DMA.</p>
<p class="Pp">The <code class="Nm">mwl</code> driver encapsulates IP and ARP
traffic as 802.11 frames, however it can receive either 802.11 or 802.3
frames. Devices support 802.11n, 802.11a, 802.11g, and 802.11b operation
with transmit speeds appropriate to each. The actual transmit speed used is
dependent on signal quality and the “rate control” algorithm
implemented in the firmware. All chips have hardware support for WEP,
AES-CCM, TKIP, and Michael cryptographic operations.</p>
<p class="Pp">The driver supports <code class="Cm">station</code>,
<code class="Cm">hostap</code>, <code class="Cm">mesh</code>, and
<code class="Cm">wds</code> mode operation. Multiple
<code class="Cm">hostap</code> virtual interfaces may be configured for
simultaneous use. When multiple interfaces are configured each may have a
separate mac address that is formed by setting the U/L bits in the mac
address assigned to the underlying device. Any number of
<code class="Cm">wds</code> virtual interfaces may be configured together
with <code class="Cm">hostap</code> interfaces. Multiple
<code class="Cm">station</code> interfaces may be operated together with
<code class="Cm">hostap</code> interfaces to construct a wireless repeater
device. For more information on configuring this device, see
<a class="Xr">ifconfig(8)</a>.</p>
<p class="Pp">Devices supported by the <code class="Nm">mwl</code> driver come
in either Cardbus or mini-PCI packages. Wireless cards in Cardbus slots may
be inserted and ejected on the fly.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">Join an existing BSS network (ie: connect to an access point):</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan create wlandev mwl0 inet 192.168.0.20 \
netmask 0xffffff00"</pre>
</div>
<p class="Pp">Join a specific BSS network with network name
“<code class="Li">my_net</code>”:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan create wlandev mwl0 inet 192.168.0.20 \
netmask 0xffffff00 ssid my_net"</pre>
</div>
<p class="Pp">Join a specific BSS network with WEP encryption:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan0 create wlandev mwl0
ifconfig wlan0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \
wepmode on wepkey 0x8736639624</pre>
</div>
<p class="Pp">Create an 802.11g host-based access point:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan0 create wlandev mwl0 wlanmode hostap
ifconfig wlan0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \
mode 11g</pre>
</div>
<p class="Pp">Create an 802.11a mesh station:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan0 create wlandev mwl0 wlanmode mesh
ifconfig wlan0 meshid my_mesh mode 11a inet 192.168.0.10/24</pre>
</div>
<p class="Pp">Create two virtual 802.11a host-based access points, one with WEP
enabled and one with no security, and bridge them to the fxp0 (wired)
device:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan0 create wlandev mwl0 wlanmode hostap \
ssid paying-customers wepmode on wepkey 0x1234567890 \
mode 11a up
ifconfig wlan1 create wlandev mwl0 wlanmode hostap bssid \
ssid freeloaders up
ifconfig bridge0 create addm wlan0 addm wlan1 addm fxp0 up</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<dl class="Bl-diag">
<dt>mwl%d: unable to setup builtin firmware</dt>
<dd>There was a problem downloading and/or setting up the firmware. The device
is not usable.</dd>
<dt>mwl%d: failed to setup descriptors: %d</dt>
<dd>There was a problem setting up the DMA data structures. This typically is
caused by not being able to allocate contiguous memory.</dd>
<dt>mwl%d: transmit timeout</dt>
<dd>A frame dispatched to the hardware for transmission did not complete in
time. This should not happen.</dd>
<dt>mwl%d: device not present</dt>
<dd>A cardbus device was ejected while active; the request to the firmware was
not completed.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">cardbus(4)</a>, <a class="Xr">intro(4)</a>,
<a class="Xr">mwlfw(4)</a>, <a class="Xr">pci(4)</a>,
<a class="Xr">wlan(4)</a>, <a class="Xr">wlan_ccmp(4)</a>,
<a class="Xr">wlan_tkip(4)</a>, <a class="Xr">wlan_wep(4)</a>,
<a class="Xr">wlan_xauth(4)</a>, <a class="Xr">hostapd(8)</a>,
<a class="Xr">ifconfig(8)</a>, <a class="Xr">wpa_supplicant(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">mwl</code> device driver first appeared in
<span class="Ux">FreeBSD 8.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The driver does not support power-save operation in station mode;
consequently power use is suboptimal (e.g. on a laptop).</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">July 8, 2009</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
