docs: clarify steps to check for missing A2DP profile

This commit is contained in:
hanku 2025-05-27 20:58:41 +09:00
parent fc90ab1c9b
commit 56141ab1d3

View file

@ -369,13 +369,49 @@ For some devices, make sure to hold the pairing button until rapid blinking star
pactl info | grep Server
----
* List available profiles.
* To confirm whether the A2DP profile is missing and only HSP/HFP is available, use the following command.
[source, bash]
----
pactl list cards
----
Then, look for the Profiles section under your Bluetooth device. You can filter the output using grep to make it easier.
[source, bash]
----
pactl list cards | grep -i 'profile\|name:'
----
If the output shows only headset_head_unit or similar HSP/HFP entries and no a2dp_sink, it means A2DP is not available. This typically indicates:
* The Bluetooth codec (Example: AAC, aptX) may not be supported or enabled in your PipeWire configuration.
* Your device firmware or the system's Bluetooth stack lacks proper support for stereo audio profiles.
* A WirePlumber policy or module might be blocking the A2DP profile.
Example Output (Missing A2DP):
[source, bash]
----
Profiles:
headset_head_unit: Headset Head Unit (HSP/HFP) (available: yes)
off: Off (available: yes)
----
Expected Output (A2DP Present):
[source, bash]
----
Profiles:
a2dp_sink: High Fidelity Playback (A2DP Sink) (available: yes)
headset_head_unit: Headset Head Unit (HSP/HFP) (available: yes)
off: Off (available: yes)
----
If A2DP is missing, you may need to review the bluetooth.lua.d configuration in your WirePlumber setup or check codec support.
*Fix*
* Manually switch to A2DP profile.