Networking support  --->
  <*> Bluetooth subsystem support  --->
    <*> RFCOMM protocol support
    <*> BNEP protocol support
    <*> HIDP protocol support
    Bluetooth device drivers  --->
      <*> HCI USB driver
      <*> HCI UART driver
      <*> HCI BCM203x USB driver
      <*> HCI BPA10x USB driver

lsmod | grep bluetooth
# خروجی:
# bluetooth             614400  12 btrtl,btmtk,btintel,btbcm,bnep,btusb
# ecdh_generic           16384  1 bluetooth
# crc16                  16384  2 bluetooth,ext4
 
# مشاهده دستگاه HCI
hciconfig -a
# خروجی:
# hci0: Type: Primary  Bus: USB
#       BD Address: 00:1A:7D:DA:71:13  ACL MTU: 310:10  SCO MTU: 64:8
#       UP RUNNING PSCAN ISCAN
#       RX bytes:1498 acl:0 sco:0 events:43 errors:0
#       TX bytes:945 acl:0 sco:0 commands:43 errors:0

# نصب BlueZ
emerge --ask net-wireless/bluez
# خروجی:
# [ebuild  N    ] net-wireless/bluez-5.79  USE="... -test"
 
# نصب رابط گرافیکی Blueman (اختیاری)
emerge --ask net-wireless/blueman
# [ebuild  N    ] net-wireless/blueman-2.4.4
 
# ابزارهای کمکی (اختیاری)
emerge --ask net-wireless/bluez-tools

# افزودن به runlevel پیش‌فرض
rc-update add bluetooth default
# خروجی:
#  * service bluetooth added to runlevel default
 
# شروع سرویس
rc-service bluetooth start
#  * Starting bluetooth ...
 
# بررسی وضعیت
rc-service bluetooth status
#  * status: started

systemctl enable bluetooth
# Created symlink /etc/systemd/system/bluetooth.target.wants/bluetooth.service → ...
systemctl start bluetooth
systemctl status bluetooth
# Active: active (running)

bluetoothctl
# [bluetooth]#

[bluetooth]# power on
Changing power on succeeded
 
[bluetooth]# agent on
Agent registered
 
[bluetooth]# default-agent
Default agent request successful
 
[bluetooth]# scan on
Discovery started
[CHG] Controller 00:1A:7D:DA:71:13 Discovering: yes
[NEW] Device AA:BB:CC:DD:EE:FF WH-1000XM5
[NEW] Device 11:22:33:44:55:66 MX Master 3S
 
[bluetooth]# pair AA:BB:CC:DD:EE:FF
Attempting to pair with AA:BB:CC:DD:EE:FF
[CHG] Device AA:BB:CC:DD:EE:FF Connected: yes
Request confirmation
[agent] Confirm passkey 123456 (yes/no): yes
[CHG] Device AA:BB:CC:DD:EE:FF Paired: yes
 
[bluetooth]# trust AA:BB:CC:DD:EE:FF
[CHG] Device AA:BB:CC:DD:EE:FF Trusted: yes
Changing AA:BB:CC:DD:EE:FF trust succeeded
 
[bluetooth]# connect AA:BB:CC:DD:EE:FF
Attempting to connect to AA:BB:CC:DD:EE:FF
[CHG] Device AA:BB:CC:DD:EE:FF Connected: yes
Connection successful
 
[bluetooth]# quit

# اجرای applet بلوتوث (اگر خودکار شروع نشد)
blueman-applet &
 
# اجرای مدیر دستگاه‌ها
blueman-manager

Device connected, but no audio output

# بررسی اجرای PipeWire
pgrep -a pipewire
# باید خروجی داشته باشد
 
# بررسی عضویت در گروه‌ها
groups
# باید شامل audio و video باشد
 
# افزودن کاربر به گروه‌ها (در صورت نیاز)
gpasswd -a ali audio
gpasswd -a ali video
# سپس خروج و ورود مجدد
 
# بررسی دستگاه خروجی
wpctl status   # لیست sinkهای صوتی

[bluetooth]# power on
No default controller available

# بررسی دستگاه USB
lsusb | grep -i bluetooth
# Bus 001 Device 004: ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle
 
# بارگذاری ماژول
modprobe btusb
 
# بررسی rfkill
rfkill list bluetooth
# 1: hci0: Bluetooth
#       Soft blocked: yes
rfkill unblock bluetooth
 
# بررسی dmesg
dmesg | grep -i bluetooth
# [   12.345] bluetooth: hci0: RTL: examining hci_ver=08 hci_rev=000b lmp_ver=08

Pairing failed: org.bluez.Error.AuthenticationFailed

# ابتدا دستگاه را از حافظه قبلی پاک کنید
bluetoothctl
[bluetooth]# remove AA:BB:CC:DD:EE:FF
 
# ریست آداپتور
[bluetooth]# power off
[bluetooth]# power on
 
# دوباره جفت کنید
[bluetooth]# scan on
[bluetooth]# pair AA:BB:CC:DD:EE:FF