]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/man/man4/mt7921.4
Remove $FreeBSD$: two-line nroff pattern
[FreeBSD/FreeBSD.git] / share / man / man4 / mt7921.4
1 .\"-
2 .\" Copyright (c) 2023 Bjoern A. Zeeb
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\"    notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\"    notice, this list of conditions and the following disclaimer in the
11 .\"    documentation and/or other materials provided with the distribution.
12 .\"
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23 .\" SUCH DAMAGE.
24 .\"
25 .Dd April 18, 2023
26 .Dt MT7921 4
27 .Os
28 .Sh NAME
29 .Nm mt7921
30 .Nd MediaTek IEEE 802.11ax wireless network driver
31 .Sh SYNOPSIS
32 The driver will auto-load without any user interaction using
33 .Xr devmatch 8
34 if enabled in
35 .Xr rc.conf 5 .
36 .Pp
37 Only if auto-loading is explicitly disabled, place the following
38 lines in
39 .Xr rc.conf 5
40 to manually load the driver as a module at boot time:
41 .Bd -literal -offset indent
42 kld_list="${kld_list} if_mt7921"
43 .Ed
44 .Pp
45 The driver should automatically load any
46 firmware needed for the particular chipset.
47 .Pp
48 It is discouraged to load the driver from
49 .Xr loader 8 .
50 .Sh DESCRIPTION
51 The
52 .Nm
53 driver is derived from MediaTek's Linux mt76 driver and provides support for
54 the following chipsets:
55 .Pp
56 .Bl -tag -width Ds -offset indent -compact
57 .It MediaTek MT7921E (PCIe)
58 .El
59 .Pp
60 This driver requires firmware to be loaded before it will work.
61 The package
62 .Pa wifi-firmware-mt76-kmod
63 from the
64 .Pa ports/net/wifi-firmware-mt76-kmod
65 port needs to be installed before the driver is loaded.
66 Otherwise no
67 .Xr wlan 4
68 interface can be created using
69 .Xr ifconfig 8 .
70 .Pp
71 The driver uses the
72 .\" No LinuxKPI man pages so no .Xr here.
73 .Em linuxkpi_wlan
74 and
75 .Em linuxkpi
76 compat framework to bridge between the Linux and
77 native
78 .Fx
79 driver code as well as to the native
80 .Xr net80211 4
81 wireless stack.
82 .Pp
83 While
84 .Nm
85 supports all 802.11 a/b/g/n/ac and ax
86 the compatibility code currently only supports 802.11 a/b/g modes.
87 Support for 802.11 n/ac is to come.
88 .Sh BUGS
89 Certainly.
90 .Sh SEE ALSO
91 .Xr wlan 4 ,
92 .Xr ifconfig 8 ,
93 .Xr wpa_supplicant 8
94 .Sh HISTORY
95 The
96 .Nm
97 driver first appeared in
98 .Fx 14.0 .