跳转到内容
Shane Docs

Ubuntu 上的蓝牙驱动与排错

本文涵盖安装 BlueZ、确保固件与内核模块加载、使用 bluetoothctl 配对设备的步骤。

1 安装 BlueZ 与工具

Section titled “1 安装 BlueZ 与工具”
Terminal window
sudo apt update
sudo apt install -y bluez bluez-tools bluetooth
sudo systemctl enable --now bluetooth

2 检查硬件与模块

Section titled “2 检查硬件与模块”
Terminal window
lsusb
lspci -nnk | grep -i bluetooth -A3
lsmod | grep btusb

若 btusb 未加载，尝试：sudo modprobe btusb。

3 使用 bluetoothctl 配对

Section titled “3 使用 bluetoothctl 配对”
Terminal window
bluetoothctl
# 在交互提示符内
power on
agent on
default-agent
scan on
# 等待设备出现
pair <MAC>
trust <MAC>
connect <MAC>

4 排错要点

Section titled “4 排错要点”
  1. 检查 rfkill：rfkill list all — 若被阻塞，用 sudo rfkill unblock all 解除。
  2. 查看蓝牙服务日志：journalctl -u bluetooth -n 200。
  3. 若缺失固件，dmesg | grep -i bluetooth 通常会显示文件名；安装 linux-firmware 或厂商固件包。
  4. 若配对失败，尝试移除设备（remove <MAC>）后重新配对。

为什么这很重要

Section titled “为什么这很重要”

这个主题是构建可靠 Linux 开发流程的重要组成部分。对它有清晰的理解，会让后续任务变得更容易，因为你能更快地判断某一步是否缺失或使用不当。

实用建议

Section titled “实用建议”
  • 在安全的测试环境中尝试这里展示的命令和配置。
  • 比较这些概念在不同发行版或工具之间的适用差异。
  • 记下一次实践中哪些步骤成功，哪些失败，这样下次遇到问题时更容易定位。
  • 将这篇文章与系列中相关内容结合起来，加深整体理解。

常见误区

Section titled “常见误区”
  • 跳过验证步骤，默认系统已经配置正确。
  • 不对命令中的路径、软件包名称或工具版本进行适配，直接复制粘贴执行。
  • 把这个主题当成孤立的技巧，而不是整个开发流程的一部分。