在 Raspberry Pi OS 上使用蓝牙

本指南介绍如何在 Raspberry Pi OS 上使用 bluetoothctl 查找蓝牙设备、与设备配对、连接和断开连接。内容还包括选择控制器、移除已保存的设备以及关闭可发现性。示例中作为提示符命令显示的内容，应在启动 bluetoothctl 后输入；请将示例地址替换为系统报告的实际地址。

在 Raspberry Pi 上使用 bluetoothctl 命令行控制工具

在终端中输入 bluetoothctl 启动工具。在它的交互式提示符中输入 scan on，搜索附近的设备。找到目标设备后，记下它的地址，再使用 pair DEVICE_ADDRESS 与其配对。例如，将 DEVICE_ADDRESS 替换为设备的实际地址，如 AA:BB:CC:DD:EE:FF。

配对和连接是两个独立操作。配对后，输入 connect DEVICE_ADDRESS 请求连接。要断开连接，请输入 disconnect DEVICE_ADDRESS。这些命令作用于当前选定的蓝牙控制器。找到设备后，输入 scan off 停止扫描。

此处示例说明的是命令，不保证提示符文字或输出一定如此。结果取决于蓝牙适配器、远端设备及其状态，以及安装的 BlueZ 版本。如果命令不可用，请查看 Raspberry Pi OS 安装情况及其软件包文档，了解适用的蓝牙工具；软件包名称和安装步骤可能因发行版本而异。

在 Raspberry Pi 上管理多个控制器

如果 Raspberry Pi 有多个蓝牙适配器，请先确定要使用哪个控制器，再扫描或管理设备。在 bluetoothctl 提示符中输入 list，查看可用控制器及其地址。然后输入 select CONTROLLER_ADDRESS，并将其替换为目标适配器的地址。之后的蓝牙操作都会使用选定的控制器。

也可以在普通终端中直接运行 bluetoothctl list 来查看控制器列表。提示符命令 select 必须在交互式工具中输入。不要根据某个特定地址前缀来判断控制器，因为硬件和地址分配各不相同。如果不确定列表中的地址对应哪个适配器，请先对照列表确认，再进行选择。

在 Raspberry Pi 上使用 bluetoothctl 移除已保存的设备

在提示符中输入 paired-devices，列出与当前选定控制器配对的设备。找到要忘记的设备地址，然后输入 remove DEVICE_ADDRESS。这会从控制器中移除该设备已保存的配对信息。它不同于用于结束当前连接的 disconnect，也不同于更改信任设置。移除设备前，请仔细核对地址。

使用 bluetoothctl 让 Raspberry Pi 不可被发现

要让附近设备无法发现当前选定的控制器，请在 bluetoothctl 提示符中输入 discoverable off。这只会更改可发现性；不会关闭蓝牙无线电，也不会结束现有连接。控制器仍可执行不要求其他设备先发现它的蓝牙操作。