Ubuntu 24.04安装MT7902无线网卡驱动指南

1. 在Ubuntu 24.04上启用MT7902无线网卡的全过程记录作为一名长期使用Linux的硬件爱好者最近入手了搭载MediaTek MT7902 WiFi 6E/蓝牙5.x模块的华硕Vivobook 16笔记本。这个在Windows下表现优异的无线方案在Linux平台却经历了长达两年的驱动缺失。直到Linux 7.0内核才正式纳入主线支持但Ubuntu 24.04默认使用的仍是较旧内核版本。经过实测我找到了无需等待官方更新的驱动安装方案完整支持WiFi和蓝牙功能。重要提示本方案仅适用于PCIe接口的MT7902模块设备ID 7902SDIO接口设备需要其他解决方案。执行前请通过lspci | grep 7902确认设备存在。2. 驱动安装前的准备工作2.1 硬件与系统环境确认我的测试平台配置如下笔记本型号ASUS Vivobook 16 (M1603QA)无线模块MediaTek AW-XB552NF (PCIe接口)操作系统Ubuntu 24.04 LTS (内核版本6.8.0-31-generic)路由器小米AX6000 WiFi 6路由器通过终端命令验证硬件识别情况$ lspci -nn | grep 7902 02:00.0 Network controller [0280]: MEDIATEK Corp. Device [14c3:7902]2.2 开发工具链安装编译驱动需要基本的开发环境sudo apt update sudo apt install -y git build-essential linux-headers-$(uname -r)这里特别要注意linux-headers的版本必须与当前运行内核完全一致可通过uname -r查询。3. WiFi驱动编译与安装详解3.1 获取社区维护的驱动代码开发者hmtheboy154已将驱动反向移植到Linux 6.6-6.19内核我们直接克隆其仓库git clone https://github.com/hmtheboy154/mt7902 cd mt7902/3.2 编译过程的技术细节执行编译时建议使用多线程加速make -j$(nproc)这里的-j参数指定并行编译任务数nproc会自动获取CPU核心数。编译过程中会生成以下关键文件mt7902e.ko内核模块主体firmware/mt7902_*.bin无线固件文件3.3 安装与加载驱动安装命令序列sudo make install # 安装内核模块 sudo make install_fw # 安装固件文件 sudo modprobe mt7902e # 加载模块为避免每次重启手动加载可添加到自动加载列表echo mt7902e | sudo tee /etc/modules-load.d/mt7902e.conf3.4 功能验证与性能测试驱动加载后通过以下命令观察内核日志dmesg | grep mt7902正常情况会显示硬件初始化信息包括ASIC版本、固件构建时间等。使用iperf3进行吞吐量测试路由器IP为192.168.31.12# 下载测试 iperf3 -t 60 -c 192.168.31.12 -i 10 -R # 上传测试 iperf3 -t 60 -c 192.168.31.12 -i 10在我的测试环境中5GHz频段下获得了400-450Mbps的实际吞吐接近600Mbps的理论连接速率。4. 蓝牙功能实现方案4.1 专用分支的获取与编译蓝牙驱动位于仓库的独立分支git clone https://github.com/hmtheboy154/mt7902 -b bluetooth_backport btusb_mt7902 cd btusb_mt7902/ make -j$(nproc) sudo make install sudo make install_fw4.2 冲突模块处理技巧原有蓝牙驱动会产生冲突必须卸载sudo rmmod btusb btmtk sudo modprobe btusb_mt7902永久解决方案是创建黑名单配置echo blacklist btusb btmtk | sudo tee /etc/modprobe.d/blacklist_btusb.conf4.3 蓝牙功能验证通过图形界面或命令行启用蓝牙bluetoothctl [bluetooth]# power on [bluetooth]# scan on成功扫描到周边设备并完成文件传输测试。5. 常见问题排查指南5.1 驱动加载失败处理若出现Exec format error错误通常原因包括内核头文件版本不匹配解决方案apt install linux-headers-$(uname -r)存在模块冲突按前文方法移除冲突模块5.2 WiFi连接不稳定优化在/etc/modprobe.d/mt7902e.conf中添加参数options mt7902e disable_ps1这会禁用节能模式提升传输稳定性代价是略微增加功耗。5.3 蓝牙音频延迟调整编辑/etc/bluetooth/main.conf[General] FastConnectabletrue JustWorksRepairingalways6. 维护与升级建议当系统内核升级后需要重新编译驱动cd mt7902/ git pull make clean make -j$(nproc) sudo make install建议将驱动目录保留在本地或添加git remote跟踪原仓库更新。目前该驱动已进入Linux 7.0主线待Ubuntu更新内核后即可过渡到官方驱动。这个方案让我在官方支持前提前用上了MT7902的全部功能实测连续工作一周无异常断连。对于同样受困于Linux无线驱动问题的用户希望这份详细记录能节省你们的摸索时间。