Grundlegende Kontrollen
# 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 bluetoothWenn Bluetooth deaktiviert ist:
sudo rfkill unblock bluetooth
sudo systemctl restart bluetoothVerwenden von Bluetoothctl
sudo bluetoothctlAllgemeine Befehle:
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 # ExitHäufige Probleme
Geräte können nicht erkannt werden
# Confirm the Bluetooth adapter is powered on
bluetoothctl power on
# Rescan
sudo bluetoothctl
scan onWenn Geräte immer noch nicht gefunden werden, überprüfen Sie das Kernel-Protokoll:
sudo dmesg | grep -i bluetooth
sudo dmesg | grep -i "hci\|btusb"Kopplungsfehler
- Entfernen Sie den vorherigen Kopplungsdatensatz und koppeln Sie erneut:
sudo bluetoothctl
remove XX:XX:XX:XX:XX:XX
scan on
pair XX:XX:XX:XX:XX:XX-
Bei einigen Geräten ist die Eingabe eines PIN-Codes erforderlich, normalerweise
0000oder1234 -
Leeren Sie den Bluetooth-Cache:
sudo rm -rf /var/lib/bluetooth/*
sudo systemctl restart bluetoothGepaart, aber keine Verbindung möglich
# Trust the device first
sudo bluetoothctl
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XXWenn Sie die Fehlermeldung „Verbindung konnte nicht hergestellt werden: org.bluez.Error.Failed“ erhalten:
# Restart the Bluetooth stack
sudo systemctl restart bluetooth
sudo modprobe -r btusb && sudo modprobe btusbHäufige Verbindungsabbrüche nach dem Verbinden
# View Bluetooth logs
journalctl -u bluetooth -f
# Disable Bluetooth power management
sudo nano /etc/bluetooth/main.confFügen Sie im Abschnitt [Policy] Folgendes hinzu oder ändern Sie es:
[Policy]
AutoEnable=true
[General]
FastConnectable=trueStarten Sie den Dienst neu:
sudo systemctl restart bluetoothSchlechte Audioqualität des Bluetooth-Headsets
Bluetooth-Headsets verwenden möglicherweise das SCO/HSP-Protokoll (Anrufmodus) anstelle von A2DP (hochwertiges Audio).
# 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-Tastatur-/Maus-Latenz
hcitool ist veraltet; Verbindungsparameter werden nun automatisch vom Kernel und BlueZ ausgehandelt. Um Latenzprobleme zu beheben, bestätigen Sie zunächst die Verbindung mit bluetoothctl info XX:XX:XX:XX:XX:XX und überprüfen/verwalten Sie dann den Adapter mit btmgmt:
# View adapter info and current connections
btmgmt info
btmgmt con # List current connectionsBlueZ aktualisieren
Ubuntu 26.04 wird mit dem BlueZ Bluetooth-Stack geliefert. Überprüfen Sie die Version:
bluetoothd --versionWenn Kompatibilitätsprobleme auftreten, installieren Sie eine neuere Version (falls verfügbar):
sudo apt update
sudo apt install --only-upgrade bluezUSB-Bluetooth-Adapter
Wenn das integrierte Bluetooth problematisch ist, können Sie einen USB-Bluetooth-Adapter verwenden:
# 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 adapterDebuggen von Bluetooth-Protokollen
# Enable verbose logging
sudo nano /etc/systemd/system/bluetooth.service.d/override.conf[Service]
ExecStart=
ExecStart=/usr/libexec/bluetooth/bluetoothd -dsudo systemctl daemon-reload
sudo systemctl restart bluetooth
journalctl -u bluetooth -f