블루투스 문제 - 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

블루투스가 비활성화된 경우:


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 헤드셋은 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에 문제가 있는 경우 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

블루투스 로그 디버깅


# 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