Ubuntu 24.04下MT7922蓝牙驱动问题解决方案
1. 解决Ubuntu 24.04下MediaTek MT7922蓝牙模块失效问题
最近在GEEKOM AE7等迷你PC上搭载的MediaTek MT7922无线网卡（支持WiFi 6和蓝牙5.3）出现了一个典型问题：在Ubuntu 24.04系统下，WiFi功能正常但蓝牙完全无法启用。这其实是由于Linux 6.8内核缺乏对该硬件蓝牙部分的驱动支持所致。作为一名长期折腾Linux硬件的开发者，我在自己的GEEKOM AE7设备上完整走通了解决方案，下面将详细说明问题成因和具体修复步骤。
这个问题的核心在于硬件ID识别。MT7922模块的蓝牙部分在设备树中注册的硬件ID是PCI\VEN_14C3&DEV_7922，而Linux 6.8内核的mt7921e驱动虽然能识别WiFi部分，却没有包含对应的蓝牙固件加载逻辑。查看内核日志会发现关键报错："Bluetooth: hci0: Opcode 0x0c03 failed: -110"，这个-110错误码表示设备响应超时，本质是驱动未能正确初始化蓝牙控制器。
2. 解决方案选择与技术背景
2.1 内核补丁发展历程
2024年3月，开发者Ian Morrisson提交了一个关键补丁(patch)，为Azurewave AW-XB591NF（即GEEKOM使用的MT7922型号）添加了硬件支持。该补丁随后被合并到Linux 6.10内核主线。这意味着：
- 编译自定义内核：可以手动打补丁并编译Linux 6.8内核
- 升级到Linux 6.10：等待或主动安装新内核
对于大多数用户而言，第二种方案显然更友好。Canonical已经将Linux 6.10内核加入Ubuntu主线仓库(mainline)，虽然正式版镜像尚未发布，但我们可以手动安装RC测试版。
重要提示：mainline内核属于"尝鲜"版本，不建议在生产环境使用。如果设备用于关键任务，建议等待8月15日发布的Ubuntu 24.04.1正式更新。
2.2 硬件兼容性说明
目前确认可用的设备型号：
- Azurewave AW-XB591NF（GEEKOM AE7标配）
- 其他使用MT7922芯片的模块可能需要额外补丁
通过以下命令可查看硬件ID：
lspci -nn | grep 14C3正常应显示类似输出：
03:00.0 Network controller [0280]: MEDIATEK Corp. Device [14c3:7922]3. 详细操作步骤
3.1 检查当前系统状态
首先确认系统现状：
# 查看当前内核版本 uname -a # 检查蓝牙错误日志 dmesg | grep -i bluetooth # 检查MT7922硬件识别 lspci -nnk | grep -A3 14C3典型的问题系统输出：
Linux hostname 6.8.0-38-generic #38-Ubuntu SMP PREEMPT_DYNAMIC Fri Jun 7 15:25:01 UTC 2024 x86_64 x86_64 x86_64 GNU/Linux [ 9.446360] Bluetooth: hci0: Opcode 0x0c03 failed: -1103.2 下载并安装Linux 6.10内核
虽然Ubuntu官方仓库尚未更新，但我们可以从mainline服务器手动获取。以下是具体步骤：
# 创建临时工作目录 mkdir ~/kernel-update && cd ~/kernel-update # 下载6.10-rc4内核包（截至2024年6月的最新测试版） wget https://kernel.ubuntu.com/mainline/v6.10-rc4/amd64/linux-headers-6.10.0-061000rc4-generic_6.10.0-061000rc4.202406161734_amd64.deb wget https://kernel.ubuntu.com/mainline/v6.10-rc4/amd64/linux-headers-6.10.0-061000rc4_6.10.0-061000rc4.202406161734_all.deb wget https://kernel.ubuntu.com/mainline/v6.10-rc4/amd64/linux-image-unsigned-6.10.0-061000rc4-generic_6.10.0-061000rc4.202406161734_amd64.deb wget https://kernel.ubuntu.com/mainline/v6.10-rc4/amd64/linux-modules-6.10.0-061000rc4-generic_6.10.0-061000rc4.202406161734_amd64.deb # 安装所有deb包 sudo dpkg -i *.deb # 更新GRUB引导 sudo update-grub3.3 重启并验证
执行重启后，检查新内核是否生效：
uname -a应显示：
Linux hostname 6.10.0-061000rc4-generic #202406161734 SMP PREEMPT_DYNAMIC Sun Jun 16 21:47:04 UTC 2024 x86_64 x86_64 x86_64 GNU/Linux蓝牙状态检查：
dmesg | grep -i bluetooth成功驱动的输出应包含：
[ 1.555268] Bluetooth: hci0: HW/SW Version: 0x008a008a, Build Time: 20240219103618 [ 3.807004] Bluetooth: hci0: Device setup in 2201591 usecs4. 故障排查与常见问题
4.1 蓝牙仍不可用的处理
如果升级后问题依旧，尝试以下步骤：
- 检查固件加载：
dmesg | grep mt7921正常应看到固件加载记录：
mt7921e 0000:03:00.0: firmware: direct-loading firmware mt7921/mt7922_wa.bin- 手动加载固件（如必要）：
sudo modprobe -r mt7921e sudo modprobe mt7921e- 重置蓝牙服务：
sudo systemctl restart bluetooth4.2 内核降级方法
如果新内核导致其他问题，可回退到原内核：
- 查看所有可用内核：
dpkg --list | grep linux-image- 删除问题内核：
sudo apt remove linux-image-6.10.0-061000rc4-generic- 从GRUB菜单选择旧内核启动
5. 长期维护建议
- 订阅内核更新通知：
sudo apt install ubuntu-mainline-kernel- 设置自动清理旧内核（防止/boot分区爆满）：
sudo apt-mark auto linux-image-6.8.0-*- 关注Ubuntu 24.04.1更新（预计2024年8月发布），届时可通过标准渠道升级：
sudo do-release-upgrade在实际使用中，我发现MT7922的蓝牙连接稳定性相当不错，测试连接蓝牙耳机连续工作8小时无中断。不过需要注意的是，某些蓝牙低功耗设备可能需要额外配置：
# 启用BLE调试模式 sudo btmon -t这个案例再次印证了Linux硬件兼容性的特点——新硬件往往需要最新内核支持。对于采用新平台的小主机用户，建议在购买前查阅内核支持状态，或者做好手动更新内核的准备。