blob: 9d848979cde6f70325b01090b1b98fdffe356439 (
plain)
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
|
<table class="head">
<tr>
<td class="head-ltitle">MT7921(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">MT7921(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">mt7921</code> — <span class="Nd">MediaTek
IEEE 802.11ax 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">The driver will auto-load without any user interaction using
<a class="Xr">devmatch(8)</a> if enabled in
<a class="Xr">rc.conf(5)</a>.</p>
<p class="Pp">Only if auto-loading is explicitly disabled, place the following
lines in <a class="Xr">rc.conf(5)</a> to manually load the driver as a
module at boot time:</p>
<div class="Bd Pp Bd-indent Li">
<pre>kld_list="${kld_list} if_mt7921"</pre>
</div>
<p class="Pp">The driver should automatically load any firmware needed for the
particular chipset.</p>
<p class="Pp">It is discouraged to load the driver from
<a class="Xr">loader(8)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">mt7921</code> driver provides support for
MediaTek MT7921E wireless network devices. <code class="Nm">mt7921</code> is
derived from MediaTek's Linux mt76 driver.</p>
<p class="Pp">This driver requires firmware to be loaded before it will work.
The package <span class="Pa">wifi-firmware-mt76-kmod</span> from the
<span class="Pa">ports/net/wifi-firmware-mt76-kmod</span> port needs to be
installed before the driver is loaded. Otherwise no
<a class="Xr">wlan(4)</a> interface can be created using
<a class="Xr">ifconfig(8)</a>. One can use <a class="Xr">fwget(8)</a> to
install the correct firmware package.</p>
<p class="Pp" id="linuxkpi_wlan">The driver uses the
<a class="permalink" href="#linuxkpi_wlan"><b class="Sy">linuxkpi_wlan</b></a>
and
<a class="permalink" href="#linuxkpi"><b class="Sy" id="linuxkpi">linuxkpi</b></a>
compat framework to bridge between the Linux and native
<span class="Ux">FreeBSD</span> driver code as well as to the native
<a class="Xr">net80211(4)</a> wireless stack.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">mt7921</code> driver supports PCIe devices
with the following chipsets:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bd-indent Bl-compact">
<li>MediaTek MT7921E</li>
</ul>
</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">wlan(4)</a>, <a class="Xr">networking(7)</a>,
<a class="Xr">fwget(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">mt7921</code> driver first appeared in
<span class="Ux">FreeBSD 14.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">Certainly.</p>
<p class="Pp">While <code class="Nm">mt7921</code> supports 802.11a/b/g/n/ac/ax
modes, the compatibility code currently only supports 802.11a/b/g modes.
Support for 802.11n/ac/ax is to come.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">November 10, 2024</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
