在 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。這只會變更可被發現狀態，不會關閉藍牙無線電，也不會中斷現有連線。即使其他裝置無法發現控制器，它仍可執行不需要被其他裝置發現的藍牙操作。