6.1.0 — Wi-Fi/Bluetooth watchdog

6.1.0 — watchdog

If Wi‑Fi or Bluetooth drop after install, a systemd unit reloads the same modules the installer uses (mt7902e, btusb_mt7902). It does not reinstall and does not override a radio you turned off (rfkill / nmcli radio wifi off). Repairs are rate-limited.

Enable

sudo ./mt7902.sh watchdog
mt7902-watchdog --check
systemctl status mt7902-watchdog.service

install-all enables the unit automatically. Stop: sudo ./mt7902.sh watchdog-stop. Rollback/remove disables it.

Install (full pack)

git clone https://github.com/discipleartem/mediatek-mt7902-linux-wifi-bluetooth.git
cd mediatek-mt7902-linux-wifi-bluetooth
./tests/run-tests.sh
sudo apt install -y build-essential linux-headers-$(uname -r) git dkms
sudo ./mt7902.sh install-all && sudo reboot

Verified: Acer Aspire A315-59, Ubuntu 24.04.4, kernel 7.0.0-28-generic.

Changelog: CHANGELOG.md

6.0.1 — Linux 7.0 verified

6.0.1 — Linux 7.0

Verified on Acer Aspire A315-59, Ubuntu 24.04.4 LTS, kernel 7.0.0-28-generic:

• Wi‑Fi: mt7902e, interface wlp42s0 UP
• Bluetooth: btusb_mt7902, Powered yes

Out-of-tree backports are documented for kernels 6.6–7.0. In-tree MT7902 is still expected in Linux 7.1+.

./mt7902.sh diagnose now shows MediaTek/mt7902 logs (not unrelated journalctl -p err), plus NetworkManager and a short verdict.

Install

git clone https://github.com/discipleartem/mediatek-mt7902-linux-wifi-bluetooth.git
cd mediatek-mt7902-linux-wifi-bluetooth
./tests/run-tests.sh
sudo apt install -y build-essential linux-headers-$(uname -r) git dkms
sudo ./mt7902.sh install-all && sudo reboot

Rollback if Wi‑Fi/BT do not appear: sudo ./mt7902.sh rollback

Full notes: CHANGELOG.md

v6.0.0 — modular installer & docs cleanup

MediaTek MT7902 Linux Driver 6.0.0

Breaking cleanup of the install pack for MediaTek MT7902 (PCI 14c3:7902).

Highlights

• Modular installer: thin mt7902.sh + lib/*.sh
• Removed legacy stub mt7921e_simple_patch.c and non-working patch / patch-check CLI
• Historical PCI-ID patch archived under archive/mt7921-pci-id/
• GitHub Actions CI (bash -n, shellcheck, make test)
• Docs: SoT in docs/ (+ docs/ru/); GUIDEs removed; slim README

Install

git clone https://github.com/discipleartem/mediatek-mt7902-linux-wifi-bluetooth.git
cd mediatek-mt7902-linux-wifi-bluetooth
./tests/run-tests.sh
sudo apt install -y build-essential linux-headers-$(uname -r) git dkms
sudo ./mt7902.sh install-all && sudo reboot

Docs

• README
• Installation
• Supported hardware
• FAQ

Known limitation

Bluetooth install blacklists stock btusb / btmtk (Realtek USB BT via btusb stops).

See CHANGELOG.md for the full list.

v5.1.0 — MT7902 Linux WiFi + Bluetooth

MediaTek MT7902 Linux Driver 5.1.0

First GitHub Release of the practical Linux fix for MediaTek MT7902 (Filogic 310).

Fixes

• WiFi not working — PCIe 14c3:7902 → module mt7902e
• Bluetooth missing — Opcode 0x0c03 failed: -110 / zero BD address → btusb_mt7902
• Shutdown hangs — systemd helpers

Install

git clone https://github.com/discipleartem/mediatek-mt7902-linux-wifi-bluetooth.git
cd mediatek-mt7902-linux-wifi-bluetooth
./tests/run-tests.sh
sudo apt install -y build-essential linux-headers-$(uname -r) git dkms
sudo ./mt7902.sh install-all && sudo reboot

Docs

• README
• Installation
• Supported hardware
• FAQ

Known limitations

Bluetooth install blacklists stock btusb / btmtk (Realtek USB BT via btusb stops). Secure Boot must allow unsigned/out-of-tree modules.

Tested on Ubuntu 24.04 (Acer Aspire A315-59).