mt7925 - WiFi Driver Fixes | zbowling.github.io

Overview

This project provides fixes for the MediaTek mt7925 WiFi chipset driver on Linux. The mt7925 is commonly found in many modern laptops, and the mainline Linux kernel driver has some stability issues that can cause crashes and disconnections.

These patches address known crash scenarios and improve overall stability of the WiFi connection.

Installation

Option 1: DKMS (Recommended)

The easiest way to install is using DKMS, which will automatically rebuild the module when you update your kernel.

install.sh

# Clone the repository

$ git clone https://github.com/zbowling/mt7925.git

$ cd mt7925

# Install DKMS module

$ sudo ./install-dkms.sh

# Reload the driver

$ sudo modprobe -r mt7925

$ sudo modprobe mt7925

Option 2: Manual Build

If you prefer to build manually:

build.sh

# Install build dependencies

$ sudo apt install build-essential linux-headers-$(uname -r)

# Build the module

$ make

# Install (temporary - won't survive kernel updates)

$ sudo make install

Troubleshooting

WiFi still disconnecting?

If you're still experiencing disconnections after installing the patched driver:

Check if the patched module is loaded: lsmod | grep mt7925
View kernel logs for errors: dmesg | grep mt7925
Ensure the firmware is up to date. The driver requires firmware files in /lib/firmware/mediatek/

Module won't load?

If Secure Boot is enabled, you may need to sign the module or disable Secure Boot temporarily. See the README for details on module signing.

Affected Devices

This driver fix is known to help with the following devices:

Framework Laptop 16
ASUS ROG laptops (2023-2024 models)
Various laptops with MediaTek RZ616/MT7922 WiFi
Devices with MT7925 chipset

Contributing

Contributions are welcome! If you find additional bugs or have fixes, please submit a pull request on GitHub.

For upstream kernel contributions, patches should be submitted to the linux-wireless mailing list.