Skip to Content

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 bluetooth

Wenn Bluetooth deaktiviert ist:

sudo rfkill unblock bluetooth sudo systemctl restart bluetooth

Verwenden von Bluetoothctl

sudo bluetoothctl

Allgemeine 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 # Exit

Häufige Probleme

Geräte können nicht erkannt werden

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

Wenn 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

  1. 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
  1. Bei einigen Geräten ist die Eingabe eines PIN-Codes erforderlich, normalerweise 0000 oder 1234

  2. Leeren Sie den Bluetooth-Cache:

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

Gepaart, aber keine Verbindung möglich

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

Wenn 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 btusb

Häufige Verbindungsabbrüche nach dem Verbinden

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

Fügen Sie im Abschnitt [Policy] Folgendes hinzu oder ändern Sie es:

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

Starten Sie den Dienst neu:

sudo systemctl restart bluetooth

Schlechte 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 connections

BlueZ aktualisieren

Ubuntu 26.04 wird mit dem BlueZ Bluetooth-Stack geliefert. Überprüfen Sie die Version:

bluetoothd --version

Wenn Kompatibilitätsprobleme auftreten, installieren Sie eine neuere Version (falls verfügbar):

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

USB-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 adapter

Debuggen von Bluetooth-Protokollen

# 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