> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/man4/mt7921.4.md).

# mt7921(4)

`mt7921` — MediaTek IEEE 802.11ax 无线网络驱动

## 名称

`mt7921`

## 概要

若在 [rc.conf(5)](/man5/rc.conf.5.md) 中启用了 devmatch(8)，则此驱动无需任何用户干预即可自动加载。

仅当显式禁用了自动加载时，才需在 [rc.conf(5)](/man5/rc.conf.5.md) 中加入以下行，以便在引导时手动以模块形式加载该驱动：

```sh
kld_list="${kld_list} if_mt7921"
```

此驱动会自动加载特定芯片组所需的固件。

不建议从 [loader(8)](/man8/loader.8.md) 加载该驱动。

## 描述

`mt7921` 驱动提供对 MediaTek MT7921E 无线网络设备的支持。`mt7921` 派生自 MediaTek 的 Linux mt76 驱动。

此驱动在运行前需要先加载固件。在加载驱动之前，需要安装来自 `ports/net/wifi-firmware-mt76-kmod` port 的 `wifi-firmware-mt76-kmod` 软件包。否则将无法使用 [ifconfig(8)](/man8/ifconfig.8.md) 创建 [wlan(4)](/man4/wlan.4.md) 接口。可以使用 fwget(8) 来安装正确的固件包。

此驱动使用 **linuxkpi\_wlan** 和 **linuxkpi** 兼容框架，在 Linux 与原生 FreeBSD 驱动代码之间以及与原生 [net80211(4)](/man4/net80211.4.md) 无线协议栈之间进行桥接。

## 硬件

`mt7921` 驱动支持采用以下芯片组的 PCIe 设备：

* MediaTek MT7921E

## 参见

[wlan(4)](/man4/wlan.4.md), [networking(7)](/man7/networking.7.md), fwget(8), [ifconfig(8)](/man8/ifconfig.8.md), wpa\_supplicant(8)

## 历史

`mt7921` 驱动首次出现于 FreeBSD 14.0。

## 缺陷

当然。

虽然 `mt7921` 支持 802.11a/b/g/n/ac/ax 模式，但兼容性代码目前仅支持 802.11a/b/g 模式。对 802.11n/ac/ax 的支持即将推出。