Bluetooth の問題 - Ubuntu.Fan

基本的なチェック


# Bluetooth service status
systemctl status bluetooth
 
# Bluetooth adapter information (hciconfig is deprecated; use bluetoothctl/btmgmt)
bluetoothctl show
bluetoothctl list   # List all adapters
 
# RF switch status
rfkill list bluetooth

Bluetooth が無効になっている場合:


sudo rfkill unblock bluetooth
sudo systemctl restart bluetooth

Bluetoothctlの使用


sudo bluetoothctl

一般的なコマンド:


power on              # Turn on Bluetooth
agent on              # Enable agent
default-agent         # Set as default agent
scan on               # Scan for devices
devices               # List discovered devices
pair XX:XX:XX:XX:XX   # Pair
trust XX:XX:XX:XX:XX  # Trust device
connect XX:XX:XX:XX:XX # Connect
info XX:XX:XX:XX:XX   # View device info
remove XX:XX:XX:XX:XX # Remove device
quit                  # Exit

よくある問題

デバイスを検出できません


# Confirm the Bluetooth adapter is powered on
bluetoothctl power on
 
# Rescan
sudo bluetoothctl
scan on

それでもデバイスが見つからない場合は、カーネルログを確認してください。


sudo dmesg | grep -i bluetooth
sudo dmesg | grep -i "hci\|btusb"

ペアリング失敗

以前のペアリングレコードを削除して、再度ペアリングします。


sudo bluetoothctl
remove XX:XX:XX:XX:XX:XX
scan on
pair XX:XX:XX:XX:XX:XX

一部のデバイスでは、PIN コード (通常は 0000 または 1234) の入力が必要です。
Bluetooth キャッシュをクリアします。


sudo rm -rf /var/lib/bluetooth/*
sudo systemctl restart bluetooth

ペアリングしたが接続できない


# Trust the device first
sudo bluetoothctl
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX

「接続に失敗しました: org.bluez.Error.Failed」が表示された場合:


# Restart the Bluetooth stack
sudo systemctl restart bluetooth
sudo modprobe -r btusb && sudo modprobe btusb

接続後に頻繁に切断される


# View Bluetooth logs
journalctl -u bluetooth -f
 
# Disable Bluetooth power management
sudo nano /etc/bluetooth/main.conf

[Policy] セクションを追加または変更します。


[Policy]
AutoEnable=true
 
[General]
FastConnectable=true

サービスを再起動します。


sudo systemctl restart bluetooth

Bluetooth ヘッドセットの音質が悪い

Bluetooth ヘッドセットは、A2DP (高品質オーディオ) の代わりに SCO/HSP プロトコル (通話モード) を使用している可能性があります。


# Check the current audio protocol
wpctl status
 
# Switch to A2DP in PipeWire
# In GNOME Sound settings, select the output profile as "High Fidelity Playback (A2DP Sink)"

Bluetooth キーボード/マウスの遅延

hcitool は非推奨になりました。接続パラメータはカーネルと BlueZ によって自動的にネゴシエートされるようになりました。遅延のトラブルシューティングを行うには、まず bluetoothctl info XX:XX:XX:XX:XX:XX との接続を確認し、次に btmgmt でアダプターを検査/管理します。


# View adapter info and current connections
btmgmt info
btmgmt con      # List current connections

BlueZ のアップグレード

Ubuntu 26.04 には、BlueZ Bluetooth スタックが付属しています。バージョンを確認します。


bluetoothd --version

互換性の問題が発生した場合は、新しいバージョンをインストールします (利用可能な場合)。


sudo apt update
sudo apt install --only-upgrade bluez

USB Bluetooth アダプター

内蔵 Bluetooth に問題がある場合は、USB Bluetooth アダプターを使用できます。


# Confirm detection
lsusb | grep -i bluetooth
 
# Load driver
sudo modprobe btusb
 
# If there are multiple adapters, list and choose which one to use
bluetoothctl list                    # List all adapters and their MACs
bluetoothctl select XX:XX:XX:XX:XX:XX # Select a specific adapter
bluetoothctl power on                 # Power on that adapter

Bluetooth ログのデバッグ


# Enable verbose logging
sudo nano /etc/systemd/system/bluetooth.service.d/override.conf


[Service]
ExecStart=
ExecStart=/usr/libexec/bluetooth/bluetoothd -d


sudo systemctl daemon-reload
sudo systemctl restart bluetooth
journalctl -u bluetooth -f