🛠️ Fix MediaTek MT7902 WiFi & Bluetooth on Linux (Kernel 6.14 - 6.17+)

Important

Context: This guide resolves the notorious -110 Bluetooth timeout and missing WiFi networks on the MediaTek MT7902 combo card found in ASUS laptops (e.g., Vivobook 14 X1502VA).

The Fix: The default kernel drivers often fail to initialize the hardware or load the correct firmware. This solution installs specific firmware blobs and compiles custom btusb and mt76 drivers from the OnlineLearningTutorials repository, specifically patched for newer kernels.

---

📋 Prerequisites

1. OS: Linux Mint 22.3 / Ubuntu 24.04 (or similar Debian-based distro).
2. Kernel: Version 6.17 (HWE) or newer is highly recommended.
   • Check version: uname -r
   • Upgrade Kernel (if needed): sudo apt update && sudo apt full-upgrade -y && sudo reboot
3. Internet: A working connection is required to download build tools.
   • Note for Iran/Restricted Regions: If apt or git fails, ensure your proxy (e.g., V2rayN) is configured for the terminal or use the socks5h:// method in /etc/apt/apt.conf.d/.
4. Tools: sudo privileges.

---

🚀 Automated Installation Script

This repository includes an automated script (install_mt7902.sh) that handles everything: installing dependencies, fetching the driver source, installing firmware, compiling the modules (with manual compression to fix Makefile errors), and disabling Bluetooth autosuspend.

1. Download the Script

Download the script directly from this repository using wget:

wget https://raw.githubusercontent.com/mrcactus-afk/mt7902-linux-fix/main/install_mt7902.sh