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内核主线。这意味着：

1. 编译自定义内核：可以手动打补丁并编译Linux 6.8内核
2. 升级到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: -110

3.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-grub

3.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 usecs

4. 故障排查与常见问题

4.1 蓝牙仍不可用的处理

如果升级后问题依旧，尝试以下步骤：

1. 检查固件加载：

dmesg | grep mt7921

正常应看到固件加载记录：

mt7921e 0000:03:00.0: firmware: direct-loading firmware mt7921/mt7922_wa.bin

2. 手动加载固件（如必要）：

sudo modprobe -r mt7921e sudo modprobe mt7921e

3. 重置蓝牙服务：

sudo systemctl restart bluetooth

4.2 内核降级方法

如果新内核导致其他问题，可回退到原内核：

1. 查看所有可用内核：

dpkg --list | grep linux-image

2. 删除问题内核：

sudo apt remove linux-image-6.10.0-061000rc4-generic

3. 从GRUB菜单选择旧内核启动

5. 长期维护建议

1. 订阅内核更新通知：

sudo apt install ubuntu-mainline-kernel

2. 设置自动清理旧内核（防止/boot分区爆满）：

sudo apt-mark auto linux-image-6.8.0-*

3. 关注Ubuntu 24.04.1更新（预计2024年8月发布），届时可通过标准渠道升级：

sudo do-release-upgrade

在实际使用中，我发现MT7922的蓝牙连接稳定性相当不错，测试连接蓝牙耳机连续工作8小时无中断。不过需要注意的是，某些蓝牙低功耗设备可能需要额外配置：

# 启用BLE调试模式 sudo btmon -t

这个案例再次印证了Linux硬件兼容性的特点——新硬件往往需要最新内核支持。对于采用新平台的小主机用户，建议在购买前查阅内核支持状态，或者做好手动更新内核的准备。