View source for Bluetooth di Arch Linux (Pairing TWS)

Panduan setup Bluetooth stack di Arch Linux dari nol sampai TWS (True Wireless Stereo earbuds) tersambung sebagai audio output. Arch tidak menyertakan Bluetooth stack secara default (filosofi minimalis), jadi semua komponen harus di-install manual.

== Arsitektur ==

<pre>
+-------------------+
|  Aplikasi (audio) |
+---------+---------+
          |
+---------v---------+     +------------------+
| PipeWire / Pulse  |<--->| bluetoothd       |
| (audio server +   |     | (daemon BlueZ)   |
|  modul BT/libspa) |     +--------+---------+
+-------------------+              |
                          +--------v---------+
                          | Kernel (btusb,   |
                          | HCI, rfkill)     |
                          +--------+---------+
                                   |
                          +--------v---------+
                          | Adapter BT (HW)  |
                          +------------------+
</pre>

* '''BlueZ''' = Bluetooth stack resmi Linux (daemon <code>bluetoothd</code> + library).
* '''Audio server''' (PipeWire/PulseAudio) yang mengekspos TWS sebagai ''sink''. Pairing sukses tapi tidak ada suara = biasanya masalah di layer ini, bukan di BlueZ.

== Instalasi ==

<pre>
sudo pacman -S bluez bluez-utils
</pre>

* <code>bluez</code> — daemon dan stack utama.
* <code>bluez-utils</code> — tool CLI, terutama <code>bluetoothctl</code>.

'''Modul audio:'''
* PipeWire (modern, default): sudah termasuk via <code>libspa</code>. Pastikan <code>pipewire-pulse</code> ter-install dan jalan sebagai user service.
* PulseAudio klasik: install <code>pulseaudio-bluetooth</code>.

Cek:
<pre>
pacman -Q pipewire-pulse
systemctl --user status pipewire pipewire-pulse wireplumber
</pre>

== Aktivasi Service ==

<pre>
sudo systemctl enable --now bluetooth.service
</pre>

<code>enable --now</code> = auto-start saat boot + langsung aktif sekarang.

Verifikasi adapter terdeteksi:
<pre>
bluetoothctl list
</pre>

Kalau kosong:
<pre>
rfkill list                    # cek soft/hard block
rfkill unblock bluetooth       # buka soft block
</pre>

Hard block = switch fisik/BIOS, tidak bisa di-unblock via software.

== Pairing TWS ==

Masuk shell interaktif:
<pre>
bluetoothctl
</pre>

Di dalam <code>bluetoothctl</code>:
<pre>
power on
agent on
default-agent
scan on
</pre>

Masukkan TWS ke '''pairing mode''' (biasanya tahan tombol di case sampai LED berkedip). Tunggu device muncul:
<pre>
[NEW] Device 12:34:56:78:9A:BC Soundcore R50i
</pre>

Lalu (MAC bisa tab-completion):
<pre>
pair 12:34:56:78:9A:BC
trust 12:34:56:78:9A:BC
connect 12:34:56:78:9A:BC
scan off
exit
</pre>

'''Kenapa <code>trust</code>?''' Tanpa trust, daemon menolak koneksi ulang yang diinisiasi device — TWS tidak akan auto-reconnect saat case dibuka.

== Verifikasi Audio ==

<pre>
pactl list sinks short
</pre>

Harus muncul sink baru, contoh: <code>bluez_output.12_34_56_78_9A_BC.1</code>.

Set default:
<pre>
pactl set-default-sink bluez_output.12_34_56_78_9A_BC.1
</pre>

== Auto-Reconnect Setelah Boot ==

Edit <code>/etc/bluetooth/main.conf</code>:
<pre>
[Policy]
AutoEnable=true
</pre>

Ini membuat controller otomatis <code>power on</code> saat boot. Kombinasi <code>AutoEnable</code> + <code>trust</code> = buka case TWS langsung nyambung.

== Troubleshooting ==

{| class="wikitable"
! Gejala !! Penyebab !! Solusi
|-
| <code>br-connection-profile-unavailable</code> saat connect || Modul audio tidak tersedia (audio server belum jalan / modul BT belum ter-install) || Cek <code>systemctl --user status pipewire pipewire-pulse wireplumber</code>; install <code>pulseaudio-bluetooth</code> kalau pakai PulseAudio
|-
| Adapter tidak muncul di <code>bluetoothctl list</code> || Soft block rfkill, atau driver/firmware belum load || <code>rfkill unblock bluetooth</code>; cek <code>dmesg | grep -i bluetooth</code> untuk firmware yang hilang (<code>linux-firmware</code>)
|-
| Suara jelek / robotik / mono || Profil ke-switch ke HSP/HFP (mode headset dengan mic, kualitas rendah) || <code>pactl set-card-profile bluez_card.XX_XX_... a2dp-sink</code>
|-
| Pairing sukses tapi tidak ada sink audio || Layer audio server bermasalah, bukan BlueZ || Restart user service: <code>systemctl --user restart pipewire pipewire-pulse</code>
|-
| Tidak auto-reconnect setelah reboot || Belum <code>trust</code>, atau controller mati saat boot || <code>trust MAC</code> + <code>AutoEnable=true</code> di main.conf
|-
| Device tidak muncul saat scan || TWS tidak dalam pairing mode, atau sudah paired ke device lain || Reset pairing mode TWS; kalau perlu <code>remove MAC</code> dulu lalu pair ulang
|}

== Catatan ==

* Profil '''A2DP''' = stereo kualitas tinggi (playback only). Profil '''HSP/HFP''' = mono + mic. Audio server otomatis switch ke HSP/HFP saat aplikasi memakai mic — ini normal, bukan bug.
* Codec (SBC, AAC, aptX, LDAC) dinegosiasikan otomatis oleh PipeWire; dukungan codec premium tergantung TWS dan versi PipeWire.

[[Kategori:Linux]]
[[Kategori:Networking]]