MT7921(4)

NAME
mt7921 - MediaTek IEEE 802.11ax wireless network driver

SYNOPSIS
The driver will auto-load without any user interaction using devmatch(8) if enabled in rc.conf(5).

Only if auto-loading is explicitly disabled, place the following lines in rc.conf(5) to manually load the driver as a module at boot time:

    kld_list="${kld_list} if_mt7921"

The driver should automatically load any firmware needed for the particular chipset.

It is discouraged to load the driver from loader(8).

DESCRIPTION
The mt7921 driver provides support for MediaTek MT7921E wireless network devices. mt7921 is derived from MediaTek's Linux mt76 driver.

This driver requires firmware to be loaded before it will work. The package wifi-firmware-mt76-kmod from the ports/net/wifi-firmware-mt76-kmod port needs to be installed before the driver is loaded. Otherwise no wlan(4) interface can be created using ifconfig(8). One can use fwget(8) to install the correct firmware package.

The driver uses the linuxkpi_wlan and linuxkpi compat framework to bridge between the Linux and native FreeBSD driver code as well as to the native net80211(4) wireless stack.

HARDWARE
The mt7921 driver supports PCIe devices with the following chipsets:

•   MediaTek MT7921E

SEE ALSO
wlan(4), networking(7), fwget(8), ifconfig(8), wpa_supplicant(8)

HISTORY
The mt7921 driver first appeared in FreeBSD 14.0.

BUGS
Certainly.

While mt7921 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.