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 .\" $FreeBSD$
  26 .\"
  27 .Dd April 18, 2023
  28 .Dt MT7921 4
  29 .Os
  30 .Sh NAME
  31 .Nm mt7921
  32 .Nd MediaTek IEEE 802.11ax wireless network driver
  33 .Sh SYNOPSIS
  34 The driver will auto-load without any user interaction using
  35 .Xr devmatch 8
  36 if enabled in
  37 .Xr rc.conf 5 .
  38 .Pp
  39 Only if auto-loading is explicitly disabled, place the following
  40 lines in
  41 .Xr rc.conf 5
  42 to manually load the driver as a module at boot time:
  43 .Bd -literal -offset indent
  44 kld_list="${kld_list} if_mt7921"
  45 .Ed
  46 .Pp
  47 The driver should automatically load any
  48 firmware needed for the particular chipset.
  49 .Pp
  50 It is discouraged to load the driver from
  51 .Xr loader 8 .
  52 .Sh DESCRIPTION
  53 The
  54 .Nm
  55 driver is derived from MediaTek's Linux mt76 driver and provides support for
  56 the following chipsets:
  57 .Pp
  58 .Bl -tag -width Ds -offset indent -compact
  59 .It MediaTek MT7921E (PCIe)
  60 .El
  61 .Pp
  62 This driver requires firmware to be loaded before it will work.
  63 The package
  64 .Pa wifi-firmware-mt76-kmod
  65 from the
  66 .Pa ports/net/wifi-firmware-mt76-kmod
  67 port needs to be installed before the driver is loaded.
  68 Otherwise no
  69 .Xr wlan 4
  70 interface can be created using
  71 .Xr ifconfig 8 .
  72 .Pp
  73 The driver uses the
  74 .\" No LinuxKPI man pages so no .Xr here.
  75 .Em linuxkpi_wlan
  76 and
  77 .Em linuxkpi
  78 compat framework to bridge between the Linux and
  79 native
  80 .Fx
  81 driver code as well as to the native
  82 .Xr net80211 4
  83 wireless stack.
  84 .Pp
  85 While
  86 .Nm
  87 supports all 802.11 a/b/g/n/ac and ax
  88 the compatibility code currently only supports 802.11 a/b/g modes.
  89 Support for 802.11 n/ac is to come.
  90 .Sh BUGS
  91 Certainly.
  92 .Sh SEE ALSO
  93 .Xr wlan 4 ,
  94 .Xr ifconfig 8 ,
  95 .Xr wpa_supplicant 8
  96 .Sh HISTORY
  97 The
  98 .Nm
  99 driver first appeared in
 100 .Fx 14.0 .